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