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