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	ログフォーマットレベルを表す文字列。有効なログレベルはerror 、 warn 、 info 、 debug 、 trace 、 disabledです。デフォルトのレベルはdisabledで、これは何もログに記録されないことを意味します。--debugは--log-level debugと同等です。

以下のコマンド例は、指定されたコマンドのトレースメッセージをJSON形式でdatabricks-cli.logという名前のファイルにログ記録します。

Bash

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

Terraformのダウンロード中にエラーが発生しました。

Databricks CLI の一部のバージョンでは、有効期限切れのキーが原因で、 databricks bundle deployを実行すると次のエラーが発生します。

error downloading Terraform: unable to verify checksums signature: openpgp: key expired

このエラーを解決するには、Databricks CLIを最新のパッチ適用済みバージョンにアップグレードしてください。これにより、検証メカニズムが更新され、新しいキーで動作するようになります。現在使用しているCLIのマイナーバージョンに対応するパッチ適用済みのバージョンにアップグレードしてください。

• バイナリインストール ：GitHubのDatabricks CLIリリースページからパッチ適用済みのバージョンをダウンロードしてください。

• setup- CLI (インストール スクリプトまたはGitHub Actionsとして): 構成内のバージョンを、 GitHubのDatabricks CLIリリース ページからパッチ適用済みのバージョンに更新します。

  例えば、GitHub Actionsで0.296.1を使用するには、次のようにします。

  YAML

  - uses: databricks/setup-cli@main
    with:
      version: 0.296.1

コマンドが終了しない

databricks cluster listなどのコマンドを実行してハングしているように見える場合は、Databricks CLI のバージョンを最新バージョンに更新してください。以前のバージョンの CLI では、リスト内の項目数が多い場合でも完全なリストを読み込もうとするため、コマンドが完了しないように見えました。