Databricks CLI のトラブルシューティング

注:

この情報は、Databricks CLI バージョン 0.205 以降に適用されます。 Databricks CLI は パブリック プレビュー段階です。

Databricks CLI 使用には、 Databricks ライセンス および Databricks プライバシー通知(使用データのプロビジョニングを含む)が適用されます。

Databricks CLI に関する問題のトラブルシューティングを行うには、次の情報を使用してください。

ログ記録を有効にする

コマンドが失敗したり、期待どおりの出力が生成されなかった場合は、ログを使用して何が問題だったのかを特定することができます。 Databricks CLI がさまざまなコマンド イベント、警告、エラーについて出力するメッセージをログに記録できます。 これらのメッセージをログに記録するには、次の Databricks CLI コマンド オプションを指定します。

説明

--log-file

出力ログを書き込むファイルを表す文字列。 このフラグが指定されていない場合、デフォルトでは出力ログが stderr に書き込まれます。

--log-format

text 出力ログをテキストに書き込む場合は json、出力ログを JSON に書き込む場合は使用します。 このフラグが指定されていない場合、出力ログはテキストとして書き込まれます。

--log-level

ログ形式のレベルを表す文字列。 指定しない場合、ログ形式レベルは無効になります。

--log-levelには、次のいずれかのレベルを指定します。

  • error を使用して、 error レベルのメッセージのみを記録します。

  • warn を使用して、 warn レベルと error レベルでメッセージをログに記録します。

  • info をクリックして、 infoerror、および warn レベルでメッセージをログに記録します。

  • debug を使用して、 debuginfoerror、および warn レベルでメッセージをログに記録します。 (--debug--log-level debugと同等です。

  • trace を使用して、 tracedebuginfoerror、および warn レベルでメッセージをログに記録します。

  • disabled をクリックして、メッセージをログに記録しません。 これは、 --log-levelが指定されていない場合のデフォルトです。

次のコマンド例では、指定されたコマンドのみのerrorメッセージをdatabricks-cli.logという名前のテキスト ファイルに記録します。 デフォルトではメッセージがテキスト形式で記録されるため、 --log-format textはオプションです。

databricks clusters list --log-file databricks-cli.log --log-format text --log-level error

次のコマンド例では、指定されたコマンドのtracedebuginfoerror 、およびwarnメッセージをdatabricks-cli.logという名前のファイルに JSON 形式で記録します。

databricks clusters list --log-file databricks-cli.log --log-format json --log-level trace

次のコマンド例では、指定されたコマンドのdebuginfoerror 、およびwarnメッセージをテキスト形式でdatabricks-cli.logという名前のファイルに記録します。 --log-formatが指定されていないため、メッセージはテキスト形式で記録されます。

databricks clusters list --log-file databricks-cli.log --log-level debug

次のコマンド例では、指定されたコマンドのinfoerror 、およびwarnメッセージを stderr に記録します。 --log-formatが指定されていないため、メッセージはテキスト形式で記録されます。

databricks clusters list --log-level info