共用方式為

Databricks CLI 的組態配置檔

  • 發行項

注意

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

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

本文介紹了如何設定 Databricks CLI 與 Azure Databricks 帳戶和工作區之間的驗證。 請參閱什麼是 Databricks CLI？。

本文假設您已經安裝 Databricks CLI，並設定 CLI 以進行驗證。 請參閱：

取得組態配置檔的相關信息

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

提示

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

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

根據預設，Databricks CLI 會在 Unix、Linux 或 macOS 上的 [使用者首頁] 資料夾中，或 Windows 上的 [使用者首頁] 資料夾中尋找 .databrickscfg ~ 檔案 %USERPROFILE% 。 您可以藉由設定環境變數 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": "<configuration-profile-name>",
    "DATABRICKS_HOST": "<workspace-url>",
    "DATABRICKS_TOKEN": "<token-value>"
  }
}

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

databricks auth profiles

輸出 (為了簡潔起見，省略符號代表省略的內容)：

{
  "profiles": [
    {
      "name": "<configuration-profile-name>",
      "host": "<workspace-url>",
      "cloud": "<cloud-id>",
      "auth_type": "<auth-type>",
      "valid": true
    },
    {
      "...": "..."
    }
  ]
}

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

重要

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

測試您的 DEFAULT 組態設定檔設定

若要檢查您是否正確設定驗證，您可以執行如下的命令，其中列出與 DEFAULT 配置文件相關聯的 Azure Databricks 工作區可用的 Databricks 運行時間版本。

下列呼叫假設您沒有任何特殊的環境變數集，其優先順序高於配置檔 DEFAULT 中的設定。 如需詳細資訊，請參閱 評估的驗證順序。

databricks clusters spark-versions

測試組態配置檔

若要檢查您是否已正確設定任何組態配置檔，您可以使用其中一個工作區層級組態設定檔名稱來執行命令，例如下列命令。 此命令會列出與指定組態配置文件相關聯的 Azure Databricks 工作區可用的 Databricks 運行時間版本，以佔位元 <configuration-profile-name>表示：

databricks clusters spark-versions -p <configuration-profile-name>

提示

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

若要列出特定設定檔的詳細資料，請執行下列命令：

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

若要列出所有可用設定檔的詳細資料，請執行下列命令：

databricks auth profiles