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

バンドルおよびエクスプローラーの機能

Databricks IDE 拡張機能は、Visual Studio Code 内に追加機能を提供し、Declarative Automation Bundles の定義、デプロイ、実行、およびワークスペースファイルと Unity Catalog カタログの探索を可能にします。

Databricks IDE 拡張機能をインストールするには、Databricks IDE 拡張機能のインストールを参照してください。

プロジェクトにおける宣言型自動化バンドルのサポート​

Databricks IDE 拡張機能は、宣言型オートメーションバンドルプロジェクトに以下の機能を追加します。

  • Visual Studio Code UI を使用した宣言型オートメーションバンドルの簡単な認証と構成 ( AuthType プロファイルの選択を含む)。Databricks IDE 拡張機能の承認を設定するを参照してください。
  • Databricks 拡張機能の ターゲット セレクター。バンドルのターゲット環境をすばやく切り替えることができます。「ターゲット デプロイメント ワークスペースの変更」を参照してください。
  • 拡張機能の [Override Jobs cluster in bundle] (バンドル内のジョブクラスターをオーバーライド) オプションを使用すると、クラスターを簡単に上書きできます。
  • Bundles リソース エクスプローラー ビューを使用すると、Visual Studio Code UI を使用してバンドル リソースを参照し、1 回のクリックでローカル Databricks アセット バンドルのリソースをリモート Databricks ワークスペースにデプロイし、Visual Studio Code からワークスペースにデプロイされたリソースに直接移動できます。バンドル・リソース・エクスプローラーを参照してください。
  • Visual Studio Code UI を使用してバンドル変数を参照および編集できる、 バンドル変数ビュー 。バンドル変数を参照してください。

バンドルリソースエクスプローラー​

Databricks IDE 拡張機能の バンドル リソース エクスプローラー ビューでは、プロジェクトのバンドル設定内のリソース定義を使用して、パイプライン データセットやそのスキーマを含むリソースを表示します。また、リソースのデプロイと実行、パイプラインの検証と部分的な更新の実行、パイプラインのランイベントと診断の表示、リモートの Databricks ワークスペース内のリソースへの移動も可能です。バンドル設定リソースの詳細については、リソースを参照してください。

たとえば、単純なジョブ定義があるとします。

YAML
resources:
jobs:
my-notebook-job:
name: 'My Notebook Job'
tasks:
- task_key: notebook-task
existing_cluster_id: 1234-567890-abcde123
notebook_task:
notebook_path: notebooks/my-notebook.py

拡張機能の バンドル リソース エクスプローラー ビューには、ノートブック ジョブ リソースが表示されます。

バンドルリソースエクスプローラー

ジョブのデプロイと実行​

バンドルをデプロイするには、クラウド( バンドルのデプロイ )アイコンをクリックします。

バンドルのデプロイ

ジョブを実行するには、 バンドルリソースエクスプローラー ビューで、ジョブの名前(この例では マイ ノートブック ジョブ )を選択します。 次に、プレイ ( バンドルのデプロイとリソースの実行 ) アイコンをクリックします。

バンドルをデプロイしてリソースを実行する

実行中のジョブを表示するには、「 バンドル・リソース・エクスプローラー 」ビューで、ジョブ名を展開し、「 実行状況 」をクリックしてから、リンク ( 外部リンクを開く ) アイコンをクリックします。

外部にジョブリンクを開く

パイプラインの問題を検証して診断する​

パイプラインの場合、検証と部分的な更新をトリガーするには、パイプラインを選択し、チェック ( バンドルのデプロイとパイプラインの検証 ) アイコンを選択します。 実行のイベントが表示され、Visual Studio Codeの 問題 パネル内でエラーを診断できます。

バンドルをデプロイし、パイプラインを検証する

パイプライン実行イベント

バンドル変数​

Databricks IDE 拡張機能の バンドル変数ビュー には、バンドル構成で定義されているカスタム変数と関連設定が表示されます。 バンドル変数ビュー を使用して、変数を直接定義することもできます。これらの値は、バンドル構成ファイルで設定された値を上書きします。カスタム変数に関する情報については、カスタム変数を参照してください。

たとえば、拡張機能の Bundle Variables View ビューには、次のように表示されます。

バンドル変数ビュー

このバンドル構成で定義されている変数 my_custom_var の場合:

YAML
variables:
my_custom_var:
description: 'Max workers'
default: '4'

resources:
jobs:
my_job:
name: my_job

tasks:
- task_key: notebook_task
job_cluster_key: job_cluster
notebook_task:
notebook_path: ../src/notebook.ipynb

job_clusters:
- job_cluster_key: job_cluster
new_cluster:
spark_version: 13.3.x-scala2.12
node_type_id: i3.xlarge
autoscale:
min_workers: 1
max_workers: ${var.my_custom_var}

ワークスペース ファイル システム​

Databricks IDE 拡張機能ペインの Workspace File System ビューを使用すると、Databricks ワークスペース ファイルを Visual Studio Code または Cursor で直接表示および開くことができます。ノートブックをクリックして、Databricks で開きます。拡張機能ペインのコントロールを使用して、IDE からワークスペースにファイルやフォルダーを作成したり、ファイルを upload したりすることもできます。

Unity Catalog​

Databricks IDE 拡張機能ペインの Unity Catalog ビューには、Databricks カタログが表示されます。この拡張機能ビューのコントロールを使用して、Databricks でカタログ、スキーマ、またはその他のデータ資産を開きます。