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

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

重要

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

ワークスペース ファイルの詳細については、 「ワークスペースのナビゲート」を参照してください。

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

ライブラリをワークスペースファイルにロードする

他のファイルをロードするのと同じ方法で、ライブラリをワークスペース ファイルにロードできます。

ライブラリをワークスペース ファイルにロードするには:

  1. クリックワークスペースアイコン左側のサイドバーのワークスペース。

  2. ライブラリをアップロードするワークスペース内の場所に移動します。

  3. 右上の をクリックし ケバブメニュー 、[ インポート] を選択します。

  4. [ インポート ] ダイアログが表示されます。 [ インポート元: ] で [ファイル ] または [URL] を選択します。 アップロードするファイルをドラッグ&ドロップまたは参照するか、ファイルへのURLパスを指定します。

  5. 「インポート」をクリックします。

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

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

ワークスペース ファイルからクラスターにライブラリをインストールするには、次の手順を実行します。

  1. クリックコンピュートアイコン左側のサイドバーにあるコンピュート。

  2. クラスター リストでクラスターの名前をクリックします。

  3. 「ライブラリ」タブをクリックします。

  4. [ 新規インストール] をクリックします。 [ライブラリのインストール]ダイアログが表示されます。

  5. [ライブラリ ソース]で、 [ワークスペース]を選択します。

  6. ライブラリまたはrequirements.txtファイルをアップロードするか、ワークスペースでライブラリまたはrequirements.txtを参照するか、次のようにワークスペースの場所を「ワークスペース ファイル パス」フィールドに入力します。 /Workspace/Users/someone@example.com/<path-to-library>/<library-name>.<ext>

  7. 「インストール」をクリックします。

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

従属ライブラリは、ワークスペース ファイルからタスクに追加できます。 「Databricks タスクの構成と編集」を参照してください。

ワークスペース ファイルの依存ライブラリを使用してワークフロー タスクを構成するには、次の手順を実行します。

  1. ワークフロー内の既存のタスクを選択するか、新しいタスクを作成します。

  2. [依存ライブラリ]の横にある[+ 追加]をクリックします。

  3. [依存ライブラリの追加]ダイアログで、 [ライブラリ ソース]の[ワークスペース]を選択します。

  4. ライブラリまたはrequirements.txtファイルをアップロードするか、ワークスペースでライブラリまたはrequirements.txtファイルを参照するか、次のように「ワークスペース ファイル パス」フィールドにワークスペースの場所を入力します。 /Workspace/Users/someone@example.com/<path-to-library>/<library-name>.<ext>

  5. 「インストール」をクリックします。

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

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

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