Databricks CLI のトラブルシューティング
注:
この情報は、Databricks CLI バージョン 0.205 以降に適用されます。 Databricks CLI は パブリック プレビュー段階です。
Databricks CLI 使用には、 Databricks ライセンス および Databricks プライバシー通知(使用データのプロビジョニングを含む)が適用されます。
Databricks CLI に関する問題のトラブルシューティングを行うには、次の情報を使用してください。
ログ記録を有効にする
コマンドが失敗したり、期待どおりの出力が生成されなかった場合は、ログを使用して何が問題だったのかを特定することができます。 Databricks CLI がさまざまなコマンド イベント、警告、エラーについて出力するメッセージをログに記録できます。 これらのメッセージをログに記録するには、次の Databricks CLI コマンド オプションを指定します。
旗 |
説明 |
---|---|
|
出力ログを書き込むファイルを表す文字列。 このフラグが指定されていない場合、デフォルトでは出力ログが stderr に書き込まれます。 |
|
|
|
ログ形式のレベルを表す文字列。 指定しない場合、ログ形式レベルは無効になります。 |
--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