Databricks IDE拡張のためのDatabricks Connectを用いたデバッグコード

この記事では、Databricks IDE拡張機能内のDatabricks Connect統合を使って、個々のPython(.py)ファイルを実行・デバッグする方法を説明します。 拡張機能に関する情報は 、Databricks IDE拡張を参照してください。

Databricks Connect 統合では、ノートブック セルを実行およびデバッグすることもできます。 Databricks IDE拡張機能を使ったDatabricks Connectでノートブックセルを実行・デバッグする方法をご覧ください。

要件

Databricks IDE拡張機能内でDatabricks Connectを使用する前に、まず Databricks Connectの要件を満たす必要があります。 これらの要件には、Unity カタログ対応ワークスペース、コンピューティング要件、Pythonのローカル インストールのバージョン要件などが含まれます。

Python仮想環境をアクティブ化する

Python プロジェクトの Python virtual 環境をアクティブにします。 Python仮想環境は、プロジェクトで互換性のあるバージョンの Python パッケージとPython パッケージ (この場合は Databricks Connect パッケージ) を使用していることを確認するのに役立ちます。

[構成] ウィンドウで、次の操作を実行します。

  1. Python Environment の下にある赤い Activate Virtual Environment 項目をクリックします。
  2. [コマンド パレット] で、Venv または Conda を選択します。
  3. インストールする依存関係を選択します (存在する場合)。

Databricks Connect をインストールする

Configuration ビューのPython Environment 内で以下:

  1. 赤い [databricks-connect のインストール] 再生ボタンをクリックします。
  2. クラスターを接続します。
    • 拡張機能で [クラスター] セクションがまだ構成されていない場合は、次のメッセージが表示されます: [Please attach a cluster to use Databricks Connect] (Databricks Connect を使用するクラスターをアタッチしてください)。 [Attach Cluster] (クラスターのアタッチ) をクリックし、Databricks Connect の要件を満たしているクラスターを選びます。
    • [クラスター]セクションは構成されているが、クラスターが Databricks Connect に適合していない場合は、赤い [Databricks Connect disabled] (Databricks Connect は無効) ボタンをクリックし、[Attach Cluster] (クラスターのアタッチ) をクリックして、適合するクラスターを選びます。
  3. Databricks Connect パッケージ (およびその依存関係) がまだインストールされていない場合、次のメッセージが表示されます: "対話型デバッグと自動補完には Databricks Connect が必要です。" 環境 <environment-name> にインストールしますか。 [インストール] をクリックします。
  4. Visual Studio Codeステータス バーに、赤い Databricks Connect が無効になっている場合 ボタンが表示されたら、それをクリックし、画面上の指示に従って有効にします。
  5. [Databricks Connect enabled] (Databricks Connect は有効) ボタンが表示されたら、Databricks Connect を使用する準備ができています。

メモ

Poetry を使用すると、次のコマンドを実行して、pyproject.toml および poetry.lock ファイルをインストールされている Databricks Connect パッケージ (およびその依存関係) と同期することができます。 必ず 16.4.1 を、あなたのプロジェクトにDatabricks IDE拡張機能でインストールされたものと一致するバージョンのDatabricks Connectパッケージに置き換えてください。

poetry add databricks-connect==16.4.1

Python コードを実行またはデバッグする

Databricks Connect を有効にした後、Python ファイル (.py) を実行またはデバッグします。

  1. プロジェクトで、実行またはデバッグするPython ファイルを開きます。

  2. Python ファイル内にデバッグ ブレークポイントを設定します。

  3. エディター タブの一覧の横にある [Databricks で実行] アイコンをクリックし、[Databricks Connect を使用して現在のファイルをデバッグ] をクリックします。

    アイコンから現在のファイルをデバッグする

    出力は [デバッグ コンソール] ペインに表示されます。

    .py ファイルを右クリックし、[Databricks で実行] をクリック>Databricks Connectを使用して現在のファイルをデバッグすることもできます。

    コンテキスト メニューから現在のファイルをデバッグする

  • Last updated on