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

注：

この情報は、パブリックプレビュー段階の Databricks CLI バージョン 0.205 以降に適用されます。 Databricks CLI のバージョンを確認するには、 databricks -vを実行します。

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

ログ記録を有効にする

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

旗	説明
`--log-file`	出力ログを書き込むファイルを表す文字列。このフラグが指定されていない場合、デフォルトでは出力ログが stderr に書き込まれます。
`--log-format`	`text` 出力ログをテキストに書き込む場合は `json`、出力ログを JSON に書き込む場合は使用します。このフラグが指定されていない場合、出力ログはテキストとして書き込まれます。
`--log-level`	ログ形式のレベルを表す文字列。指定しない場合、ログ形式レベルは無効になります。

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

error を使用して、 error レベルのメッセージのみを記録します。
warn を使用して、 warn レベルと error レベルでメッセージをログに記録します。
info をクリックして、 info、 error、および warn レベルでメッセージをログに記録します。
debug を使用して、 debug、 info、 error、および warn レベルでメッセージをログに記録します。 (--debug は --log-level debugと同等です。
trace を使用して、 trace、 debug、 info、 error、および 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

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

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

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

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

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

databricks clusters list --log-level info