メインコンテンツまでスキップ

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

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

important

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

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

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. [Add dependent Library ] ダイアログで、 ライブラリ ソースワークスペース を選択します。
  4. ライブラリまたはrequirements.txtファイルをアップロードするか、ワークスペース内のライブラリまたはrequirements.txtファイルを参照するか、次のようにワークスペースの ファイルを「ファイルパス 」フィールドにワークスペースの場所を入力します。 /Workspace/Users/someone@example.com/<path-to-library>/<library-name>.<ext>
  5. [ インストール ] をクリックします。

ワークスペース ファイルからノートブックへのライブラリのインストール

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

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