共用方式為

Databricks CLI 教學課程

  • 發行項

注意

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

Databricks 命令行介面（也稱為 Databricks CLI）公用程式提供易於使用的介面，從終端機、命令提示字元或自動化腳本將 Azure Databricks 平台自動化。

本文示範如何使用本機開發計算機快速開始使用 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. 安裝 curl 並 zip 透過 WSL。 如需詳細資訊，請參閱操作系統的檔。

    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 但收到錯誤，例如 command not found: databricks，或如果您執行 databricks -v 且版本號碼為 0.18 或以下，則表示您的電腦找不到正確的 Databricks CLI 可執行檔版本。 若要修正此問題，請參閱 確認 CLI 安裝。

安裝 Databricks CLI 之後，請完成下列步驟：

注意

本教學課程假設您想要使用 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-url> 為您的 Azure Databricks 個別工作區 URL，例如 https://adb-1234567890123456.7.azuredatabricks.net。

    databricks auth login --host <workspace-url>

  2. Databricks CLI 會提示您儲存輸入為 Azure Databricks 組態設定文件的資訊。 按 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 令牌資訊。

下一步

設定 Databricks CLI 之後：