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

GitフォルダServerless

備考

ベータ版

この機能はベータ版です。

Git Folder Serverless は、ノートブックやファイルを含む Git フォルダー内のアセット間で共有される単一のServerless コンピュート リソースを提供します。Git Folder Serverless を使用すると、新しいサーバーレス コンピュート リソースを起動したり、ノートブックやファイルごとに環境をセットアップしたりすることなく、マルチファイルでのオーサリングが可能になります。環境は、Git フォルダーのルートにある pyproject.toml ファイルによって管理されます。

要件​

GitフォルダServerlessを使用するには：

  • プロジェクトは Gitフォルダー 内にある必要があります。
  • GitフォルダをGitフォルダエディタで開く必要があります。
  • Gitフォルダーにルートのpyproject.tomlファイルが含まれている場合、environment_versionは5以降に設定する必要があります。

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

  • 同じGitフォルダ内のノートブックとファイルは、1つのGit Folder Serverlessコンピュートリソースにアタッチされ、pyproject.tomlによって管理される環境を使用します。
  • 関連付けられたGitフォルダ内のアセットのみが、コンピュートリソースにアタッチできます。
  • あるノートブックで定義されたPython変数は、別のノートブックでは使用できません。
  • Gitフォルダー内のアタッチされたノートブックまたはファイルから開かれた Webターミナル は、同じコンピュートリソース上で実行されます。

GitフォルダエディタでGit Folder Serverlessを使用する​

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

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

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

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

  5. [Git Folder Serverless] を選択します。

    環境バージョン5でGitフォルダServerlessが選択されている状態のコンピュートドロップダウンメニュー

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

別の資産から同じコンピュートを使用するには、同じGitフォルダ内の別のノートブックまたはファイルを開き、 [Git Folder Serverless] を選択します。資産は、pyproject.tomlによって管理されるコンピュートと環境を共有します。

以下を使用して環境を管理します： pyproject.toml​

Git Folder Serverlessは、フォルダのルートにある pyproject.toml ファイルを使用して、Gitフォルダ全体のPython依存関係を管理します。これは、 環境 サイドペインで構成された依存関係が1つのノートブックに適用される標準のServerlessノートブックとは異なります。

ノートブックコマンドを使用するか、pyproject.toml を編集することで、依存関係の追加や環境変更の適用を行うことができます。

ノートブックコマンドの使用​

  1. Git Folder Serverlessにアタッチされたノートブックを開きます。

  2. Git フォルダーのルートに pyproject.toml ファイルが存在するかどうかを確認します。存在しない場合は、 [環境] サイドペインを開き、 [pyproject.toml を作成] をクリックします。

  3. %uv add <package>を実行して、ルートのpyproject.tomlファイルに依存関係を追加します。例えば：

    Python
    %uv add cowsay

  4. %uv syncを実行して、共有環境に依存関係を適用し、uv.lockを生成または更新します。

    Python
    %uv sync

編集 pyproject.toml​

  1. Gitフォルダエディタで、Gitフォルダのルートに pyproject.toml ファイルが存在するかどうかを確認します。存在しない場合は、 Environment サイドペインを開き、 Create pyproject.toml をクリックします。

  2. pyproject.tomlファイルを開きます。

  3. dependencies リストを手動で編集します。例えば：

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

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

  4. pyproject.tomlファイルエディタの上部で、 Apply をクリックして、環境の変更をGit Folder Serverlessに適用します。

更新された環境は、同じGitフォルダのServerlessコンピュートにアタッチされたノートブックおよびファイルで使用できます。環境を調査するには、 [環境] サイドパネルを開きます。Serverless環境のバージョンおよびインストール済みの依存関係に関する情報については、「Serverless環境の構成」を参照してください。

Gitを通じた共同作業​

Git Folder Serverlessコンピュートリソースを起動したユーザーのみが、そのリソース上でワークロードを実行できます。別のユーザーが同じGitフォルダを開いた場合、既存のコンピュートリソース上でノートブックやファイルを実行することはブロックされます。

Databricksでは、各コラボレーターが個人のワークスペースフォルダ内のGitフォルダにリポジトリをクローンすることを推奨しています。その後、各コラボレーターは、クローン用に pyproject.toml によって管理される個別のコンピュートリソースと環境を取得します。

Branch、commit、プッシュ、プルを使用して、リモート Git リポジトリ経由で変更をやり取りします。Git フォルダーでの共同作業を参照してください。

制限事項​

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

その他のリソース​

このページの見出し