分享方式：

Databricks CLI 的組態設定檔

  • 文章

注意

此資訊適用于處於公開預覽狀態 的 Databricks CLI 0.205 版和更新版本 。 若要尋找 Databricks CLI 的版本，請執行 databricks -v 。

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

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

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

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

提示

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

例如，您可以有名為 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>

提示

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

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

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

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

databricks auth profiles