Azure Databricks 配置檔案

Azure Databricks 組態配置檔（有時稱為 組態配置檔、組態配置檔，或只是 profile）包含 Azure Databricks 需要驗證的設定和其他資訊。 Azure Databricks 組態配置檔會儲存在 Azure Databricks 中，組態配置檔 檔案（.databrickscfg），以供您使用的工具、SDK、腳本和應用程式使用。 若要瞭解您的工具、SDK、腳本和應用程式是否支援 Azure Databricks 組態設定檔，請參閱提供者的檔。 所有實作 Databricks 用戶端整合驗證的參與工具和 SDK 都支援 Azure Databricks 組態配置檔。

建立 Azure Databricks 組態配置文件檔案

若要建立 Azure Databricks 組態配置檔檔案，請執行 Databricks CLIdatabricks configure 命令，或遵循下列步驟：

1. 使用您慣用的文本編輯器，在 Unix、Linux 或 macOS 的 ~ （您的使用者首頁） 資料夾中建立名為 .databrickscfg 的檔案，如果您還沒有檔案，請在 Windows 上建立 %USERPROFILE% （您的使用者首頁） 資料夾。 別忘了檔名開頭的點 （.）。 將下列內容新增至此檔案：

   [<some-unique-name-for-this-configuration-profile>]
   <field-name> = <field-value>
   

2. 在上述內容中，替換下列 values，然後儲存檔案：

   • <some-unique-name-for-this-configuration-profile> 組態配置檔的唯一名稱，例如 DEFAULT、DEVELOPMENT、PRODUCTION或類似名稱。 您可以在相同的 .databrickscfg 檔案中有多個組態配置檔，但每個組態配置檔在此檔案中都必須有唯一的名稱。
   • <field-name> 和 <field-value> 是一個必要欄位的名稱和值，用於目標 Databricks 驗證類型。 如需要提供的特定資訊，請參閱本文稍早的該驗證類型一節。
   • 針對目標 Databricks 驗證類型的每個額外必要欄位，新增 <field-name> 和 <field-value> 組。

例如，針對 Azure Databricks 個人存取令牌驗證，.databrickscfg 檔案看起來可能如下所示：

[DEFAULT]
host  = https://adb-1234567890123456.7.azuredatabricks.net
token = dapi123...

若要建立其他組態配置檔，請在相同的 .databrickscfg 檔案中指定不同的配置檔名稱。 例如，若要指定個別的 Azure Databricks 工作區，每個工作區都有自己的 Azure Databricks 個人存取令牌：

[DEFAULT]
host  = https://adb-1234567890123456.7.azuredatabricks.net
token = dapi123...

[DEVELOPMENT]
host  = https://adb-2345678901234567.8.azuredatabricks.net
token = dapi234...

您也可以針對 Azure Databricks 帳戶和不同的 Databricks 驗證類型，在 .databrickscfg 檔案中指定不同的設定檔名稱，例如：

[DEFAULT]
host  = https://adb-1234567890123456.7.azuredatabricks.net
token = dapi123...

[DEVELOPMENT]
azure_workspace_resource_id = /subscriptions/bc0cd1.../resourceGroups/my-resource-group/providers/Microsoft.Databricks/workspaces/my-workspace
azure_tenant_id             = bc0cd1...
azure_client_id             = fa0cd1...
azure_client_secret         = aBC1D~...

提示

您可以使用 Databricks CLI 來測試組態設定檔。 請參閱 測試您的組態設定檔。