Databricks Terraform プロバイダーのトラブルシューティング

この記事では、Databricks Terraform プロバイダーを使用する際の一般的なエラーのトラブルシューティング情報を提供します。 Databricks Terraform プロバイダーに関する情報については、「Databricks Terraform プロバイダー」を参照してください。

注：

Terraform 固有のサポートについては、HashiCorp Discuss ウェブサイトで最新の Terraform トピックを参照してください。 Databricks Terraform プロバイダーに固有の問題については、databrickslabs/terraform-provider-databricks GitHub リポジトリの「問題」を参照してください。

エラー：プロバイダーのインストールに失敗しました

問題：terraform.lock.hcl ファイルをバージョン管理システムにチェックインしていない場合、 terraform init コマンドを実行すると、Failed to install provider というメッセージが表示されます。追加の出力には、次のようなメッセージが含まれる場合があります。

Error while installing databrickslabs/databricks: v1.0.0: checksum list has no SHA-256 hash for "https://github.com/databricks/terraform-provider-databricks/releases/download/v1.0.0/terraform-provider-databricks_1.0.0_darwin_amd64.zip"

原因：Terraform の構成が、古い Databricks Terraformプロバイダーを参照しています。

ソリューション：

すべての .tf ファイルで databrickslabs/databricks を databricks/databricks に置き換えます。

これらの置き換えを自動化するには、更新する .tf ファイルを含む親フォルダーから次の Python コマンドを実行します。
```
python3 -c "$(curl -Ls https://dbricks.co/updtfns)"
```
次の Terraform コマンドを実行し、プロンプトが表示されたら変更を承認します。
```
terraform state replace-provider databrickslabs/databricks databricks/databricks
```
このコマンドの詳細については、Terraform ドキュメントの「コマンド: プロバイダーの置き換えの状態」を参照してください。
次の Terraform コマンドを実行して変更を確認します。
```
terraform init
```

エラー: 使用可能なプロバイダーパッケージのクエリに失敗しました

問題：terraform.lock.hcl ファイルをバージョン管理システムにチェックインしていない場合、 terraform init コマンドを実行すると、Failed to query available provider packages というメッセージが表示されます。

原因：Terraform の構成が、古い Databricks Terraformプロバイダーを参照しています。

ソリューション：「エラー: プロバイダーのインストールに失敗しました」のソリューション指示に従います。

ログ記録を有効にする

問題のトラブルシューティングを支援するために、Databricks Terraform プロバイダーは、 TF_LOG 環境変数を DEBUG または Terraform がサポートするその他のログレベルに設定することで有効にできるログを出力します。

デフォルトでは、ログは stderrに送信されます。ログをファイルに送信するには、 TF_LOG_PATH 環境変数をターゲット・ファイル・パスに設定します。

たとえば、次のコマンドを実行して、デバッグレベルでログ記録を有効にし、現在の作業ディレクトリを基準にした tf.log という名前のファイルにモノクロ形式でログを出力し、 terraform apply コマンドを実行できます。

TF_LOG=DEBUG TF_LOG_PATH=tf.log terraform apply -no-color

Terraform ログの詳細については、「デバッグ Terraform」を参照してください。