`configure` 命令群組

注意

此資訊適用於 Databricks CLI 0.205 版和更新版本。 Databricks CLI 處於公開預覽狀態。

Databricks CLI 使用受限於 Databricks 授權和 Databricks 隱私權注意事項，包括任何使用量數據布建。

configure Databricks CLI 內的命令群組可讓您使用 Azure Databricks 個人存取令牌或Microsoft Entra ID （先前稱為 Azure Active Directory）令牌，向 Azure Databricks 驗證 Databricks CLI。

注意

作為安全性最佳做法，當您使用自動化工具、系統、指令碼和應用程式進行驗證時，Databricks 建議您使用屬於服務主體的個人存取權杖，而不是工作區使用者。若要建立服務主體的權杖，請參閱管理服務主體的權杖。

請注意，本文僅涵蓋 Azure Databricks 個人存取令牌和Microsoft Entra ID 令牌驗證，以啟用工作區層級命令的呼叫。如需其他驗證組態選項，請參閱 Databricks CLI 的驗證。

重要

執行此命令之前，請務必設定 Databricks CLI。

您可以將 configure 命令附加至 databricks configure 來執行這些命令。若要顯示 configure 命令的說明，請執行 databricks configure -h。

建立組態配置檔

組 態配置檔 是設定的集合，其中包含驗證資訊，例如 Azure Databricks 工作區 URL 和存取令牌值。組態設定檔具有程式設計名稱，例如 DEFAULT、 DEV或 PROD。

若要建立組態配置檔，請執行 configure 命令，如下所示：

databricks configure --host <workspace-url>

針對 <workspace-url>，輸入每個工作區的 URL 格式為 https://adb-<workspace-id>.<random-number>.azuredatabricks.net。若要取得個別工作區 URL，請參閱個別工作區 URL。

✔ Databricks Token:

輸入存取令牌之後，存取令牌會儲存在 Linux 或 macOS 的檔案 ~/.databrickscfg 中，或 %USERPROFILE%\.databrickscfg 預設儲存在 Windows 上。檔案包含名為 DEFAULT的預設連線設定檔專案：

[DEFAULT]
host  = <workspace-url>
token = <access-token>

若要對連線設定檔使用不同的名稱， DEFAULT而不是，請將選項新增 --profile 至 configure 命令，例如：

databricks configure --host <workspace-url> --profile <profile-name>

提示

可以在 --profile 或 -p 之後按 Tab 以顯示現有可用組態設定檔的清單，以從中選擇，而不是手動輸入組態設定檔名稱。

指定連接配置檔內的任何現有主機和令牌資訊，會以新的主機和令牌資訊覆寫。

將多個連線配置檔新增至 .databrickscfg 檔案，可讓您在命令的選項中指定目標連線配置檔的名稱，以快速跨各種工作區執行命令 --profile 。如果您未在支援此選項的命令中指定 --profile 選項，則命令預設會使用 DEFAULT 連線配置檔。

例如，您可以有名為 DEV 的連接配置檔，其會參考您用於開發工作負載的 Azure Databricks 工作區，以及另一個名為 connection profile 的連線配置檔，該配置檔 PROD 會參考用於生產工作負載的不同 Azure Databricks 工作區。

您可以藉由設定環境變數 DATABRICKS_CONFIG_FILE來變更此.databrickscfg檔案的預設路徑。若要了解如何設定環境變數，請參閱您的作業系統文件。

若要取得現有組態配置檔的相關信息，請使用驗證命令群組。