ライブラリをボリュームからインストールする

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

ボリュームの詳細については、 Unity Catalogボリュームとは何ですか?」を参照してください。 アクセスの制御やオブジェクトの作成など、 Unity Catalogの操作に関する情報については、 Unity Catalogとは」を参照してください。

ライブラリの完全な互換性の詳細については、 「クラスター スコープのライブラリ」を参照してください。

ボリュームへのライブラリのロード

ライブラリをボリュームにロードするには:

  1. カタログ アイコン左側のサイドバーで [カタログ] をクリックします

  2. カタログ エクスプローラ ツリーで、ボリュームに移動します。

  3. +追加」をクリックし、「 このボリュームにアップロード」を選択します。

  4. [ ファイルをボリュームにアップロード] ダイアログが表示されます。 アップロードするファイルをドラッグアンドドロップまたは参照し、[ アップロード]をクリックします。

ボリュームからクラスターへのライブラリーのインストール

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

ボリュームからクラスターにライブラリをインストールするには:

  1. コンピュートアイコン 左側のサイドバー で [コンピュート ]をクリックします

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

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

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

  5. [ライブラリ ソース]で、 [ボリューム]を選択します。

  6. ライブラリまたはrequirements.txtファイルをアップロードするか、ボリュームブラウザでライブラリまたはrequirements.txtファイルを参照するか、 「ボリュームファイルパス」フィールドにその場所を次のように入力します: /Volumes/<catalog>/<schema>/<volume>/<path-to-library>/<file-name>.<ext>

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

依存ライブラリをボリュームからワークフロー タスクに追加する

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

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

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

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

  4. ライブラリまたはrequirements.txtファイルをアップロードするか、ボリュームブラウザでライブラリまたはrequirements.txtファイルを参照するか、 「ボリュームファイルパス」フィールドにその場所を次のように入力します: /Volumes/<catalog>/<schema>/<volume>/<path-to-library>/<file-name>.<ext>

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

ボリュームからノートブックへのライブラリのインストール

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

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

次のコードは、Python wheel ファイルをノートブック スコープのライブラリとしてボリュームからノートブックにインストールする方法を示しています。

%pip install /Volumes/<catalog>/<schema>/<volume>/<path-to-library>/mypackage-0.0.1-py3-none-any.whl

または

%pip install /Volumes/<catalog>/<schema>/<volume>/<path-to-project>/requirements.txt