次の方法で共有

サーバーレス基本環境を管理する

Important

この機能は パブリック プレビュー段階です。

このページでは、ワークスペース全体でサーバーレス基本環境を作成および管理する方法について説明します。

Permissions

  • ワークスペースの基本環境を作成および管理できるのは、ワークスペース管理者だけです。
  • すべてのワークスペース ユーザーは、ワークスペースの基本環境にアクセスできます。
  • すべてのワークスペース ユーザーは、カスタム サーバーレス環境の仕様を作成できます。

Azure Databricks での基本環境のしくみ

Azure Databricks では、基本環境は、 サーバーレス環境バージョンと、サーバーレス ノートブック用の追加の Python 依存関係のセットを定義する共有可能な YAML 仕様です。 ワークスペース管理者は基本環境を作成および管理するため、ユーザーは一貫性のあるキャッシュされた環境からすばやく開始し、必要に応じて独自のライブラリを追加できます。

環境仕様の作成とエクスポート

有効な YAML 仕様を作成する最も簡単な方法は、[ 環境 ] サイド パネルで環境をビルドし、[ 環境のエクスポート] ボタンを使用して YAML ファイルをダウンロードすることです。

  1. ノートブックを開き、サーバーレス コンピューティングに接続します。
  2. ノートブックのサイド パネルの [環境環境] アイコンをクリックします。
  3. 環境バージョンを選択 します。 Databricks では、ワークスペースでサポートされている最新のサーバーレス環境バージョンを使用することをお勧めします。
  4. [ 依存関係 ] フィールドに、基本環境に必要な依存関係を追加します。 各依存関係を入力した後、[ 依存関係の追加] をクリックします。 依存関係を追加する方法の詳細については、「 ノートブックに依存関係を追加する」を参照してください。
  5. 環境パネルの下部にある [ 適用 ] をクリックして、仕様が有効であることを確認します。
  6. Kebab メニュー アイコン [Kebab] メニュー アイコン をクリックします。環境パネルの下部にある [ 環境のエクスポート] をクリックします。
  7. YAML ファイルに名前を付け、ワークスペース フォルダーまたは Unity カタログ ボリュームに追加します。

環境仕様の例

次の YAML の例は、 MLflow プロジェクト環境の仕様に基づいています。 これは、いくつかのライブラリ依存関係を持つ基本環境を定義します。

environment_version: '4'
dependencies:
  - --index-url https://pypi.org/simple
  - -r "/Workspace/Shared/requirements.txt"
  - my-library==6.1
  - /Workspace/Shared/Path/To/simplejson-3.19.3-py3-none-any.whl
  - git+https://github.com/databricks/databricks-cli

ワークスペースに基本環境を追加する

環境仕様を基本環境としてワークスペースに追加するには:

  1. ワークスペースで、[ 設定] に移動します。
  2. [ ワークスペース管理者] で 、[コンピューティング] を選択 します。
  3. サーバーレス コンピューティングの基本環境の横にある [管理] をクリックします。
  4. [ 新しい環境の作成] をクリックします。
  5. 基本環境に名前を付けます。 これは、ユーザーが [基本環境 ] ドロップダウン メニューに表示する名前です。
  6. ファイル ピッカーを使用して、環境仕様の YAML ファイルを選択します。 ワークスペース ファイルまたは Unity カタログ ボリュームを参照できます。
  7. Create をクリックしてください。

基本環境の構築が開始されます。 基本環境の一覧の [状態] 列を確認します。 準備ができたら、 使用準備完了に 変わります。

注

基本環境の構築と更新に関連する使用状況レコードには、billing_origin_product列がBASE_ENVIRONMENTSに設定されています。 さらに、特定の基本環境 ID が usage_metadata.base_environment_id 列に入力されます。

ワークスペースの既定の基本環境を設定する

既定では、ワークスペース内のサーバーレス ノートブックでは基本環境は使用されません。 ワークスペース管理者は、既定ですべての新しいノートブックに適用する基本環境を選択できます。

  1. ワークスペースで、[ 設定] に移動します。
  2. [ ワークスペース管理者] で 、[コンピューティング] を選択 します。
  3. サーバーレス コンピューティングの基本環境の横にある [管理] をクリックします。
  4. 基本環境の横にある星アイコンをクリックして、既定として設定します。

新しいサーバーレス ノートブックはすべて、既定で選択した基本環境になります。

基本環境を更新する

基本環境ファイルを編集してバージョン番号を更新したり、依存関係を追加または削除したりできます。

基本環境の一覧で、更新する基本環境の YAML ファイル パスをクリックします。 これにより、新しいタブでファイルが開きます。そこでファイルの内容を確認または更新できます。 変更は自動的に保存されます。

YAML 仕様を更新したら、ノートブックとジョブが最新の構成を取得できるように、基本環境を更新する必要があります。

  1. 更新する基本環境の横にある kebab メニュー アイコンの Kebab メニュー アイコン をクリックします。次に、[ 最新の情報に更新] を選択します。
  2. [Confirm](確認) をクリックします。

新しいセッションでは、更新された基本環境が使用されるようになりました。 更新プログラムを取得するには、既存のノートブック セッションを再起動する必要があります。

制限事項

基本環境には、次の制限があります。

  • カスタム 基本環境は、サーバーレス Python、Python ホイール、ノートブック タスクの種類でのみサポートされます。 その他のタスクの種類はサポートされていません。
  • ワークスペースの基本環境は、ジョブではサポートされていません。 唯一の例外はノートブック タスクです。ワークスペースの基本環境を使用できるのは、ノートブックの環境設定で環境が直接構成されている場合のみです。
  • 関連する依存関係のみが実行時にインストールされます。
  • サーバーレス環境バージョン 1 はサポートされていません。 バージョン 2 以降を使用します。
  • 基本環境は、すべてのワークスペース ユーザーが使用できます。
  • ワークスペースは、10 個の基本環境に制限されています。
  • Last updated on