Databricks CLI 的組態配置檔

注意

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

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

本文說明如何使用 Databricks CLI 搭配配置文件。 它假設您已經安裝 Databricks CLI，並建立 Databricks 組態配置檔檔案。 請參閱 安裝或更新 Databricks CLI 和 Azure Databricks 組態設定檔。

取得組態設定檔的相關資訊

將多個組態配置檔新增至 .databrickscfg 檔案，可讓您在命令的 --profile 或 -p 旗標中指定目標組態配置檔的名稱，以快速跨各種工作區執行命令。 如果未指定，則會使用 DEFAULT 配置檔。

提示

您可以在 --profile 或 -p 之後按 Tab，以顯示要從中選擇的現有可用組態配置檔清單。

例如，您可以有名為 DEV 的組態配置檔，該配置檔會參考用於開發工作負載的 Azure Databricks 工作區，以及名為 PROD 的個別組態配置檔，該配置檔會參考用於生產工作負載的不同 Azure Databricks 工作區。

根據預設，Databricks CLI 會在 Unix、Linux 或 macOS 上的 [使用者首頁] 資料夾中，或 Windows 上的 [使用者首頁] 資料夾中尋找 .databrickscfg~ 檔案 %USERPROFILE% 。 若要變更 .databrickscfg 檔案的預設路徑，請將環境變數 DATABRICKS_CONFIG_FILE 設定為不同的路徑。 請參閱 .databrickscfg 特定環境變數和字段。

若要取得現有組態配置檔的相關信息，請執行 auth env 命令：

databricks auth env --profile <configuration-profile-name>

# Or:
databricks auth env --host <account-console-url>

# Or:
databricks auth env --host <workspace-url>

例如，以下是使用 Azure Databricks 個人存取令牌驗證設定之設定檔的輸出：

{
  "env": {
    "DATABRICKS_AUTH_TYPE": "pat",
    "DATABRICKS_CONFIG_PROFILE": "DEFAULT",
    "DATABRICKS_HOST": "https://dbc-a1b2345c-d6e7.cloud.databricks.com",
    "DATABRICKS_TOKEN": "dapi123..."
  }
}

若要取得所有可用設定檔的相關信息，請執行 auth profiles 命令：

databricks auth profiles

Name                     Host                                            Valid
DEFAULT                  https://dbc-a1b2345c-d6e7.cloud.databricks.com  YES
Development              https://dbc-a1b2345c-d6e7.cloud.databricks.com  YES
Staging                  https://dbc-a1b2345c-d6e7.cloud.databricks.com  YES
Production               https://dbc-a1b2345c-d6e7.cloud.databricks.com  YES

auth profiles 命令的輸出不會顯示任何存取權杖。 若要顯示存取令牌，請執行上述 auth env 命令。

重要

Databricks CLI 不適用於 .netrc 檔案。 您可以在環境中有檔案 .netrc 以供其他用途使用，但 Databricks CLI 不會使用該 .netrc 檔案。

測試組態配置檔

若要測試組態配置檔並確認您已正確設定驗證，請執行連線至工作區的命令。

如果您未指定設定檔，則會使用預設配置檔。 例如，下列命令會列出與 DEFAULT 設定檔相關聯的 Azure Databricks 工作區中可用的 Databricks Runtime 版本。

注意

此命令假設您沒有任何環境變數設定優先於 DEFAULT 配置檔中的設定。 如需詳細資訊，請參閱 評估的驗證順序。

databricks clusters spark-versions

若要驗證特定配置檔，請使用 -p 旗標來提供配置檔名稱。

databricks clusters spark-versions -p PROD