您可以使用 Databricks Terraform 提供者來自動化 Unity 目錄設定。 本文提供 Terraform 供應商 Unity Catalog 部署指南與資源參考文件的連結,以及需求、驗證與部署建議。
Requirements
若要使用 Terraform 自動化 Unity 目錄設定,您必須具備下列項目:
- 您的Azure Databricks帳戶必須是Premium方案。
- 在您的 Azure 租戶中,您必須擁有建立以下權限:
- 一個用於 Azure Data Lake Storage 的儲存帳號。 請參考 建立一個儲存帳號用於 Azure Data Lake Storage。
- 用於保存系統分配的受控身份的新資源。 這要求您必須是租戶中任何訂用帳戶的資源群組中的
Contributor或Owner。
為了使用 Databricks Terraform 提供者來設定 Unity Catalog 的中繼存放區、中繼存放區的儲存、任何外部儲存,以及所有相關的存取憑證,您必須具備下列條件:
- 一個 Azure 帳戶。
- 在你的 Azure 帳號裡有一個帳號層級的管理員使用者。
- 在你本地的開發機器上,你必須具備:
Terraform CLI。 請參閱 在 Terraform 網站上下載 Terraform。
Azure CLI 是透過擁有
az login或Contributor權限的使用者,使用Owner指令來登入您的訂閱。 請參見 如何安裝 Azure CLI。 若要以使用者帳號或服務主體登入,請參見 以 Azure CLI 登入。注意
當你使用自動化工具、系統、腳本和應用程式進行驗證時,透過
az login指令登入並使用Microsoft Entra ID服務主體,是安全最佳實踐。 請參見以服務主體登入及與Azure服務主體認證。
若要使用 Databricks Terraform 提供者來設定所有其他 Unity Catalog 的基礎設施元件,您必須具備以下條件:
- Azure Databricks 工作區。
- 在你本地的開發機器上,你必須具備:
- Terraform CLI。 請參閱 在 Terraform 網站上下載 Terraform。
- 下列其中一項:
Databricks CLI 版本 0.205 或以上, 您可以通過執行 進行配置。 請參見 安裝或更新 Databricks CLI 與 個人存取權杖認證(舊有)。
注意
作為安全性最佳做法,當您使用自動化工具、系統、腳本和應用程式進行驗證時,Databricks 建議您使用屬於 服務主體的個人存取令牌, 而不是工作區使用者。 若要建立服務主體的權杖,請參閱 管理服務主體的權杖。
Azure CLI 是透過
az login指令登入。 請參見 如何安裝 Azure CLI。 若要以使用者帳號或服務主體登入,請參見 以 Azure CLI 登入。注意
當你使用自動化工具、系統、腳本和應用程式進行驗證時,透過
az login指令登入並使用Microsoft Entra ID服務主體,是安全最佳實踐。 請參見以服務主體登入及與Azure服務主體認證。以下兩個 Azure Databricks 環境變數:
- 將
DATABRICKS_HOST設定為 工作區實例 URL的值,例如https://dbc-1234567890123456.cloud.databricks.com ,設定為你的Azure Databricks 個人存取令牌 或 Microsoft Entra ID(前稱Azure Active Directory)令牌 的值。 另請參閱 監視和撤銷個人存取憑證。
若要設定這些環境變數,請參閱您的作系統檔。
注意
作為安全性最佳做法,當您使用自動化工具、系統、腳本和應用程式進行驗證時,Databricks 建議您使用屬於 服務主體的個人存取令牌, 而不是工作區使用者。 若要建立服務主體的權杖,請參閱 管理服務主體的權杖。
- 將
Terraform 供應商 Unity Catalog 部署指南和資源參考文件
若要瞭解如何部署所有必要條件並啟用工作區的 Unity 目錄,請參閱 Databricks Terraform 提供者檔中 部署必要資源及啟用 Unity 目錄。
如果您已經有一些 Unity 目錄基礎結構元件,您可以使用 Terraform 視需要部署其他 Unity 目錄基礎結構元件。 請參閱上一段所引用的指南中的每個章節,還有 Databricks Terraform 提供者文件 中的Unity Catalog 部分。
驗證、規劃、部署或移除資源
- 若要驗證 Terraform 設定的語法,而不部署它們,請執行
terraform validate命令。 - 若要顯示 Terraform 部署設定時所採取的動作,請執行
terraform plan命令。 此命令實際上不會部署組態。 - 若要部署組態,請執行
terraform apply命令。 - 若要刪除已部署的資源,請執行
terraform destroy命令。