メインコンテンツまでスキップ
に最終更新

Gitフォルダおよびバンドル用の共有Serverlessの使用

備考

ベータ版

この機能はベータ版です。使用するには、ワークスペース管理者は プレビュー ページから プロジェクトスコープの共有コンピュート を有効にする必要があります。Databricksのプレビューを管理を参照してください。

共有Serverlessを使用すると、同じGitフォルダまたはバンドル内のノートブックとファイルは、Serverlessコンピュートとエディター内のPython環境を共有します。環境をカスタマイズするには、フォルダーのルートに pyproject.toml ファイルを追加します。Gitフォルダまたはバンドルのコンピュートオプションを選択します：

要件​

共有コンピュートと環境​

  • 同じGitフォルダーまたはバンドル内のノートブックとファイルは、エディター内のコンピュートとPython環境を共有します。フォルダーのルートにあるオプションのpyproject.tomlファイルは、共有環境を定義します。
  • 関連付けられたGitフォルダーまたはバンドル内のノートブックとファイルのみが、その共有コンピュートリソースにアタッチできます。
  • 共有コンピュートリソースは、ユーザーごとに分離されます。共有コンピュートリソースに最初にノートブックまたはファイルを添付したユーザーのみが、そのリソースでワークロードを実行できます。
  • ノートブックの実行は隔離されたままです。あるノートブックで定義されたPython変数は、別のノートブックでは使用できません。
  • 添付されたノートブックまたはファイルから開かれたWebターミナルは、同じコンピュートリソース上で実行されます。

Gitフォルダー向け共有Serverless​

Gitフォルダー用共有Serverlessを使用して、Gitフォルダー内のノートブックおよびファイルで作業します。

Git フォルダーエディターでノートブックとファイルに添付​

  1. ワークスペースのサイドバーで「 ワークスペース 」をクリックし、Gitフォルダに移動します。

  2. [エディターで開く] をクリックします。

  3. Gitフォルダー内のノートブックまたはファイルを開きます。

  4. コンピュートのドロップダウンメニューをクリックします。

  5. Git フォルダー用共有Serverless を選択します。

    共有Serverlessコンピュートのコンピュートドロップダウンオプション（ベータバッジとpyproject.tomlの環境付き）

  6. ノートブックまたはファイルをランして、コンピュートリソースを起動します。

別のノートブックまたはファイルから同じコンピュートを使用するには、同じGitフォルダーで開き、 Gitフォルダー用のShared Serverless を選択します。

Gitを通じて共同作業する​

Databricksでは、各共同作業者が個人のワークスペースフォルダーのGitフォルダーにリポジトリをクローンすることをお勧めします。これにより、各共同作業者は自分のクローンに対して個別のコンピュートリソースと環境を取得できます。

Branch、commit、push、pullを使用して、リモート Git リポジトリを通じて変更を交換します。Gitフォルダーで共同作業するを参照してください。

アセットバンドル用の共有Serverless​

アセットバンドルに共有Serverlessを使用して、ワークスペース内のバンドル内のノートブックとファイルで作業します。バンドルのルートには databricks.yml が含まれており、共有環境を定義する pyproject.toml ファイルを含めることができます。

バンドルエディターでノートブックとファイルを添付​

  1. ワークスペースサイドバーで [ ワークスペース ] をクリックし、バンドルに移動します。
  2. バンドル名の右側にある [エディターで開く] をクリックします。
  3. バンドル内のノートブックまたはファイルを開きます。
  4. コンピュートのドロップダウンメニューをクリックします。
  5. [Shared Serverless for Asset Bundles] を選択します。
  6. ノートブックまたはファイルをランして、コンピュートリソースを起動します。

別のノートブックまたはファイルから同じコンピュートを使用するには、同じバンドルで開き、 アセットバンドル用共有Serverless を選択します。

Gitを通じてコラボレーションを行うには、各コラボレーターにリポジトリを個人のワークスペースフォルダーのGitフォルダーにクローンさせます。Gitを通じたコラボレーションを参照してください。

環境の管理 pyproject.toml​

共有Serverlessは、Gitフォルダーまたはバンドルルートにあるpyproject.tomlファイルを使用して、プロジェクトのPython依存関係を管理します。標準のServerlessノートブックは、 [環境] サイドペインで各ノートブック用に構成された依存関係を使用します。

ルートのpyproject.tomlファイルを作成し、依存関係を管理する前にServerless環境のバージョンを設定します。pyproject.tomlの作成と編集をご覧ください。その後、ノートブックのコマンドを使用して依存関係を追加するか、ファイルを直接編集できます。

ノートブックコマンドを使用する​

  1. Gitフォルダーの共有Serverless または アセットバンドルの共有Serverless に添付されたノートブックを開きます。

  2. ルート pyproject.toml ファイルに依存関係を追加するには %uv add <package> をランします。例：

    Python
    %uv add cowsay

コマンドはpyproject.toml、uv.lock、および共有環境を更新します。%uv addの後に%uv syncをランする必要はありません。pyproject.tomlに直接加えた変更を適用するには、%uv syncを使用します。

作成および編集 pyproject.toml​

  1. Gitフォルダーの共有Serverless または アセットバンドルの共有Serverless に添付されたノートブックを開きます。

  2. [環境] サイドパネルを開きます。

  3. [pyproject.toml で管理] カードで、新規ファイルアイコン。 [pyproject.toml の作成] をクリックしてルートファイルを作成します。ファイルがすでに存在する場合は、新しいウィンドウアイコン。 [pyproject.toml の表示] をクリックします。ファイルがエディタで開きます。

    [Managed by pyproject.toml]の横にある[Create pyproject.toml]アイコンとツールチップが表示されている環境サイドペイン。

  4. dependenciesリストを編集します。生成された[tool.databricks.environment]セクションを保持するか、存在しない場合は追加します。environment_versionをサポートされているバージョン（5以上）に設定します。例えば：

    Toml
    [project]
    name = "my-project"
    version = "0.1.0"
    dependencies = [
      "simplejson==3.18.1",
    ]

    [tool.databricks.environment]
    environment_version = "5"

  5. pyproject.toml ファイルエディタの上部にある [適用] をクリックします。

    [Apply]ボタンとそのツールチップを示すpyproject.tomlファイルエディター。

更新された環境は、同じ共有コンピュートリソースに接続されたノートブックおよびファイルで使用できます。環境を検査するには、 [環境] サイドペインを開きます。Serverless環境のバージョンとインストールされている依存関係の情報については、「Serverless環境の設定」を参照してください。

ノートブックのスケジュール設定​

Gitフォルダーまたはバンドルエディターから共有Serverlessに接続されているノートブックをスケジュールすると、Databricksはファイルが存在する場合、ルート pyproject.toml ファイルをジョブのプロジェクト環境として使用します。以下のステップに従ってバンドルをデプロイします。

  1. Gitフォルダーまたはバンドルエディターで、共有Serverlessに接続されているノートブックを開きます。
  2. Gitフォルダまたはバンドルにルート pyproject.toml ファイルがある場合は、タスクに必要な依存関係が宣言されていることを確認してください。
  3. スケジュール をクリックします。
  4. コンピュート ドロップダウンリストで、Serverlessコンピュートを選択します。
  5. スケジュールを設定し、 [作成] をクリックします。

作成 をクリックした後、ジョブ設定を確認します。

  • Gitフォルダー： Gitフォルダーにルートpyproject.tomlファイルがある場合は、ジョブのタスク設定の [プロジェクト環境] がそれを指していることを確認してください。選択を変更するには、ジョブタスクの環境設定を参照してください。

  • バンドル: バンドルエディターは、resources/フォルダーに生成されたジョブYAMLファイルを開きます。

    1. バンドルにルートのpyproject.tomlファイルがある場合は、環境のspec内のproject_environmentが、生成されたYAMLファイルを基準とした相対パスでそのファイルを指していることを確認します。バンドル内のプロジェクト環境を構成するを参照してください。
    2. バンドルをデプロイしてジョブを作成します。

    開発モードでは、スケジュールはdefaultで一時停止されます。宣言型オートメーションバンドルのデプロイモードを参照してください。

ノートブックのスケジュール設定オプションについては、スケジュールされたノートブックジョブの作成と管理を参照してください。

制限​

  • コンピュートの共有は、Serverless使用ポリシーの範囲に限定されます。同じGitフォルダーまたはバンドル内のノートブックおよびファイルで異なる使用ポリシーを使用する場合、コンピュートリソースを共有する代わりに個別のコンピュートリソースが割り当てられます。

その他のリソース​

このページの見出し