Databricks CLI 教學課程

注意

Databricks CLI 的使用受限於 Databricks 授權 和 Databricks 隱私權聲明，包括任何使用數據條款。

Databricks 命令列介面（亦稱為 Databricks CLI）工具提供易於使用的介面，讓您能從終端機、命令提示字元或自動化腳本自動化 Azure Databricks 平台。 請參見 Databricks CLI。

本文示範如何快速安裝和設定 Databricks CLI。

確認本機電腦需求

本教學課程假設：

安裝 Databricks CLI

  1. 安裝 Databricks 的 CLI：

    Linux、macOS

    執行下列兩個命令，使用 Homebrew 安裝 Databricks CLI：

    brew tap databricks/tap
brew install databricks

    Windows

    你可以使用 winget、Chocolatey 或 Windows 子系統 Linux 版 （WSL） 來安裝 Databricks 的 CLI。 如果您無法使用 winget、Chocolatey 或 WSL，您應該略過此步驟，然後使用命令提示字元或 PowerShell 來從來源安裝 Databricks CLI。

    注意

    使用 Chocolatey 安裝 Databricks CLI 是 實驗性的。

    若要使用 winget 來安裝 Databricks CLI，請執行下列兩個命令，然後重新啟動命令提示字元：

    winget search databricks
winget install Databricks.DatabricksCLI

    若要使用 Chocolatey 安裝 Databricks CLI，請執行下列命令：

    choco install databricks-cli

    若要使用 WSL 來安裝 Databricks CLI：

    1. 透過 WSL 安裝 curl 和 zip。 如需詳細資訊，請參閱作業系統的文件。

    2. 執行下列命令，使用 WSL 安裝 Databricks CLI：

      curl -fsSL https://raw.githubusercontent.com/databricks/setup-cli/main/install.sh | sh

  2. 執行下列命令來確認已安裝 Databricks CLI，其中顯示已安裝 Databricks CLI 的目前版本。 此版本應該是 0.205.0 或更新版本：

    databricks -v

設定工作區的存取權

接下來，設定 Databricks 工作區的存取權。

注意

這個教學使用 OAuth 用戶對機器（U2M）認證，透過你的 Azure Databricks 使用者帳號來驗證 CLI。 若要將 CLI 設定為使用其他 Databricks 驗證類型，請參閱 Databricks CLI 的驗證。

  1. 針對每個目標帳戶或工作區執行下列命令，使用 Databricks CLI 在本機起始 OAuth 令牌管理。

    針對 帳戶層級作業，在下列命令中，替換以下佔位符：

    databricks auth login --host <account-console-url> --account-id <account-id>

    對於 workspace 層級操作，以下指令中將 <workspace-url> 替換為你的 Azure Databricks 每個工作區 URL，例如 https://adb-1234567890123456.7.azuredatabricks.net。

    databricks auth login --host <workspace-url>

  2. Databricks CLI 會提示你將輸入的資訊儲存為 Azure Databricks configuration profile。 按 Enter 以接受建議的設定檔名稱，或輸入新或現有設定檔的名稱。 任何具有相同名稱的現有設定檔，會被您輸入的資訊覆蓋。 您可以使用個人資料，在多個帳戶或工作區之間快速切換您的驗證上下文。

    若要取得任何現有設定檔的清單，請在個別的終端機或命令提示字元中，使用 Databricks CLI 執行命令 databricks auth profiles。 若要檢視特定設定檔的現有設定，請執行 命令 databricks auth env --profile <profile-name>。

  3. 在你的網頁瀏覽器中，完成螢幕上的指示，登入你的 Azure Databricks 帳號或工作區。

  4. 若要檢視配置檔目前的 OAuth 令牌值和令牌即將到期的時間戳，請執行下列其中一個命令：

    針對 帳戶層級作業，請執行下列命令：

    • databricks auth token -p <profile-name>
    • databricks auth token --host <workspace-url> --account-id <account-id>
    • databricks auth token --host <workspace-url> --account-id <account-id> -p <profile-name>

    如果您有多個具有相同 --host 和 --account-id 值的配置檔，您可能需要同時指定 --host、--account-id和 -p 選項，以協助 Databricks CLI 尋找正確的相符 OAuth 令牌資訊。

    針對 工作區層級作業，請執行下列命令：

    • databricks auth token -p <profile-name>
    • databricks auth token --host <workspace-url>
    • databricks auth token --host <workspace-url> -p <profile-name>

    如果您有多個具有相同 --host 值的配置檔，您可能需要同時指定 --host 和 -p 選項，以協助 Databricks CLI 尋找正確的相符 OAuth 令牌資訊。

下一步

  • Last updated on