この記事では、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
-
[Logs: Max Field Length](ログ: 最大フィールド長) または
databricks.logs.maxFieldLength
-
[Logs: Truncation Depth](ログ: 切り詰めの深さ) または
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 が発生する"
問題: プロジェクト内のローカル コードをリモートの Azure Databricks ワークスペースに同期しようとすると、ターミナルに同期が開始されたことが示されますが、表示されるのはエラー メッセージ spawn unknown system error -86
のみです。 また、[構成] ペインの [Sync Destination] (同期先) セクションは保留中の状態のままです。
考えられる原因: 開発用コンピューターのオペレーティング システムに対して、Visual Studio Code 用の Databricks 拡張機能のバージョンが正しくありません。
推奨される解決策: 拡張機能をアンインストールし、開発用コンピューターのオペレーティング システムの拡張機能を最初から インストールして開 きます。
使用状況ログを Databricks に送信する
ローカル コードをリモートの Azure 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 サポートに送信します。 - また、問題のコンテキストでターミナル ([ビュー] > [ターミナル]) のコンテンツをコピーし、このコンテンツを Databricks サポートに送信します。
コード同期の問題ではないエラー ログを Databricks サポートに送信するには、以下に従います。
- コマンド パレット ([ビュー] > [コマンド パレット]) から、Databricks: Open full logs コマンドを実行します。
- 表示される
sdk-and-extension-logs.json
ファイルのみを Databricks サポートに送信します。