Databricks CLI のトラブルシューティング
この情報は、Databricks CLI バージョン 0.205 以降に適用されます。 Databricks CLI は パブリック プレビュー段階です。
Databricks CLI 使用には、 Databricks ライセンス および Databricks プライバシー通知(使用データのプロビジョニングを含む)が適用されます。
Databricks CLI の問題のトラブルシューティングを行うには、次の情報を使用します。
ログ記録を有効にする
コマンドが失敗した場合、または予期した出力が生成されない場合は、ロギングを使用して、問題の原因を特定できます。 Databricks CLI が出力する、さまざまなコマンド イベント、警告、エラーに関するメッセージをログに記録できます。 これらのメッセージをログに記録するには、次の Databricks CLI コマンド オプションを指定します。
旗 | 説明 |
|---|---|
| 出力ログを書き込むファイルを表す文字列。 このフラグが指定されていない場合、デフォルトでは出力ログが stderr に書き込まれます。 |
|
|
| ログ形式のレベルを表す文字列。 指定しない場合、ログ形式レベルは無効になります。 |
--log-level には、次のレベルのいずれかを指定してください。
errorerrorレベルでのみメッセージをログに記録します。warnを使用して、warnレベルとerrorレベルでメッセージをログに記録します。infoを使用して、info、error、およびwarnレベルでメッセージをログに記録します。debugdebug、info、error、warnレベルでメッセージを記録します。 (--debugは--log-level debugと同等です。)tracetrace、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
コマンドが終了しない
databricks cluster listなどのコマンドを実行してハングしているように見える場合は、Databricks CLI のバージョンを最新バージョンに更新してください。以前のバージョンの CLI では、リスト内の項目数が多い場合でも完全なリストを読み込もうとするため、コマンドが完了しないように見えました。