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

Visual Studio Code の Databricks 拡張機能のトラブルシューティング

この記事では、Visual Studio Code の Databricks 拡張機能を使用するときに発生する一般的なエラーに関する情報と、トラブルシューティング情報を提供します。 「Visual Studio Code の Databricks 拡張機能とは」を参照してください。

Databricks ログ出力の表示

Databricks 拡張機能は、任意の種類のコマンドを実行するときに、Visual Studio Code の [表示] > [出力 ] パネルで詳細なログ出力を提供します。 これらのログを使用して、成功を確認し、発生した可能性のある問題を確認できます。 コマンドに応じて、これらのログは次の出力チャンネルにあります。

  • Databricks バンドル ログ
  • Databricks Connect
  • Databricks ログ
  • Databricksノートブック

出力チャンネルを切り替えるには、Visual Studio Code 出力 ビューの右上隅にあるドロップダウンを選択します。

[出力 ] ビューには、[ ログ: 有効 ] がオンになっているか、[databricks.logs.enabled] が [true] に設定されている場合、切り捨てられた情報が表示されます。詳細情報を表示するには、「 Visual Studio Code の Databricks 拡張機能の設定」の説明に従って、次の設定を変更します。

  • Logs: Max Array Length または databricks.logs.maxArrayLength
  • ログ: 最大フィールド長 または databricks.logs.maxFieldLength
  • ログ:切り捨ての深さまたは databricks.logs.truncationDepth

プロキシ経由での同期時のエラー

問題 : Visual Studio Code の Databricks 拡張機能を実行してプロキシ経由でローカル プロジェクトを同期しようとすると、次のようなエラー メッセージが表示され、同期操作は失敗します: Get "https://<workspace-instance>/api/2.0/preview/scim/v2/Me": EOF.

考えられる原因 : Visual Studio Code はプロキシを見つける方法を認識していません。

推奨されるソリューション : 次のコマンドを実行してターミナルから Visual Studio Code を再起動し、同期を再試行します。

Bash
env HTTPS_PROXY=<proxy-url>:<port> code

上記のコマンドでは、次のようになります。

  • <proxy-url> をプロキシへの完全URLに置き換えてください。
  • <port> をプロキシの正しいポートに置き換えます。

エラー: ローカル コードを同期しようとすると、"不明なシステム エラー -86 が生成されます"

問題 : プロジェクト内のローカル コードをリモート Databricks ワークスペースに同期しようとすると、 ターミナル には同期が開始されたことが表示されますが、エラー メッセージ spawn unknown system error -86のみが表示されます。 また、[ 設定 ] ウィンドウの [同期先 ] セクションは保留中の状態のままです。

考えられる原因 : 開発マシンのオペレーティング システムに Visual Studio Code の Databricks 拡張機能のバージョンが正しくインストールされていません。

推奨されるソリューション : 拡張機能をアンインストールしてから、開発マシンのオペレーティング システムの 拡張機能を最初からインストールして開きます

使用状況ログを Databricks に送信する

ローカル コードをリモート Databricks ワークスペースに同期する際に問題が発生した場合は、次の手順を実行して、使用状況ログと関連情報を Databricks サポートに送信できます。

  1. ログ記録を有効にするには、 [ ログ: 有効 ] 設定をオンにするか、「Visual Studio Code の Databricks 拡張機能の設定」で説明されているように、databricks.logs.enabledtrueに設定します。ログ記録を有効にした後は、必ず Visual Studio Code を再起動してください。
  2. 問題の再現を試みます。
  3. コマンド パレット (メイン メニューから [表示] > [コマンド パレット ]) から、 Databricks: Open full logs コマンドを実行します。
  4. 表示された databricks-cli-logs.json ファイルと sdk-and-extension-logs.json ファイルを Databricks サポートに送信します。
  5. また、問題のコンテキストで ターミナル ( View > Terminal ) の内容をコピーし、この内容を Databricks サポートに送信します。

コード同期の問題に関するものではないエラー ログを Databricks サポートに送信するには、次のようにします。

  1. コマンド パレット ( View > コマンド パレット ) から、 Databricks: Open full logs コマンドを実行します。
  2. 表示された sdk-and-extension-logs.json ファイルのみを Databricks サポートに送信します。