ワークスペース ファイルからライブラリをインストールする

  • [アーティクル]

この記事では、パッケージまたは requirements.txt ファイルをワークスペース ファイルにアップロードし、Azure Databricks のクラスターにインストールするために必要な手順について説明します。 ライブラリは、汎用コンピューティングまたはジョブ コンピューティングにインストールできます。

重要

この記事では、ライブラリをワークスペース ファイルとして格納する方法について説明します。 これは、非推奨のワークスペース ライブラリとは異なります。

ワークスペース ファイルの詳細については、「ワークスペースを移動する」を参照してください。

ワークスペース ファイルに requirements.txt ファイルをアップロードするには、Databricks Runtime 15.0 以降が必要です。 ライブラリの互換性の詳細については、「ライブラリ」を参照してください。

ワークスペース ファイルにライブラリを読み込む

ライブラリは、他のファイルを読み込むのと同じ方法でワークスペース ファイルにライブラリに読み込むことができます。

ライブラリをワークスペース ファイルに読み込むには:

  1. 左側のサイドバーの ワークスペース アイコン [ワークスペース] をクリックします。
  2. ライブラリをアップロードするワークスペース内の場所に移動します。
  3. 右上の Kebab メニュー をクリックし、[インポート] を選択します。
  4. [インポート] ダイアログが表示されます。 [インポート元:] には、[ファイル] または [URL] を選択します。 アップロードするファイルをドラッグ アンド ドロップまたは参照するか、ファイルへの URL パスを指定します。
  5. [インポート] をクリックします。

ワークスペース ファイルからクラスターにライブラリをインストールする

クラスターにライブラリをインストールすると、そのクラスターで実行されているすべてのノートブックがそのライブラリにアクセスできます。

ワークスペース ファイルからクラスターにライブラリをインストールするには:

  1. 左側のサイドバーで、コンピューティング アイコン [コンピューティング] をクリックします。
  2. クラスターの一覧でクラスターの名前をクリックします。
  3. [ライブラリ] タブをクリックします。
  4. [新規インストール] をクリックします。 [Install library] (ライブラリのインストール) ダイアログが表示されます。
  5. [ライブラリ ソース] には、[ワークスペース] を選択します。
  6. ライブラリまたは requirements.txt ファイルをアップロードし、ワークスペースでライブラリまたはrequirements.txt を参照するか、[Workspace File Path] (ワークスペース ファイル パス) フィールドにそのワークスペースの場所を入力します (例: /Workspace/Users/someone@example.com/<path-to-library>/<library-name>.<ext>)。
  7. [インストール] をクリックします。

ワークスペース ファイルからワークフロー タスクに依存ライブラリを追加する

ワークスペース ファイルからタスクに依存ライブラリを追加できます。 「Databricks タスクを構成および編集する」を参照してください。

ワークスペース ファイルからの依存ライブラリを使用してワークフロー タスクを構成するには以下を実行します:

  1. ワークフロー内の既存のタスクを選択するか、新しいタスクを作成します。
  2. [依存ライブラリ] の横で、[+ 追加] をクリックします。
  3. [依存ライブラリの追加] ダイアログで、[ライブラリ ソース] には [ライブラリ ソース] ワークスペースを選択します。
  4. ライブラリまたは requirements.txt ファイルをアップロードし、ワークスペースでライブラリまたはrequirements.txt ファイルを参照するか、[Workspace File Path] (ワークスペース ファイル パス) フィールドにそのワークスペースの場所を入力します (例: /Workspace/Users/someone@example.com/<path-to-library>/<library-name>.<ext>)。
  5. [インストール] をクリックします。

ワークスペース ファイルからノートブックにライブラリをインストールする

Python ライブラリをノートブックに直接インストールして、ノートブックに固有のカスタム環境を作成できます。 たとえば、同じライブラリの別のバージョンを必要とするクラスター上の他のユーザーに影響を与えることなく、ノートブックで特定のバージョンのライブラリを使用できます。 詳細については、「ノートブック スコープのライブラリ」を参照してください。

ノートブックにライブラリをインストールすると、現在のノートブックと、そのノートブックに関連付けられているすべてのジョブのみがそのライブラリにアクセスできます。 同じクラスターにアタッチされている他のノートブックは影響を受けません。