安裝或更新 Databricks CLI

  • 發行項

注意

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

本文說明如何安裝或更新 Databricks CLI。 請參閱 什麼是 Databricks CLI？。

安裝

若要安裝 Databricks CLI 0.205 版或更新版本：

您也可以從 Azure Databricks 工作區使用者介面內取得 Databricks CLI。 請參閱 從 Azure Databricks 工作區內執行 Databricks CLI。

更新

若要更新舊版 Databricks CLI 0.205 版或更新版本：

適用於 Linux 或 macOS 的 Homebrew 安裝

針對此安裝選項，您可以使用 Homebrew 來自動下載並安裝最新的 Databricks CLI 可執行檔版本。

從終端機中，只要執行下列兩個 Homebrew 命令來安裝 CLI：

brew tap databricks/tap
brew install databricks

然後繼續進行 Databricks CLI 的驗證。

如果您不確定是否已安裝 Homebrew，或先前的 Homebrew 命令失敗，請遵循下列較長的指示：

  1. 從 Linux 殼層提示字元或 macOS 終端機執行下列命令，檢查 Homebrew 是否已安裝。 如果已安裝 Homebrew，則會顯示 Homebrew 版本號碼：

    brew -v

  2. 如果尚未安裝 Homebrew，請執行下列命令加以安裝：

    /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

    然後執行下列命令來驗證 Homebrew 安裝，其中顯示 Homebrew 版本號碼：

    brew -v

  3. 執行下列命令，使用 Homebrew 將 GitHub 中的 databricks/homebrew-tap 存放庫新增至可用的 Homebrew Tap 存放庫列表：

    brew tap databricks/tap

  4. 執行下列命令，使用 Homebrew 指示存放 databricks/homebrew-tap 庫下載並安裝 Databricks CLI 可執行檔：

    brew install databricks

  5. 確認是否已正確安裝 Databricks CLI。 若要這樣做，請使用 -v 選項或執行 version 命令來檢視 Databricks CLI 可執行檔的版本：

    databricks -v

# Or:
databricks version

    如果列出 0.205.0 或更新版本號碼，表示 Databricks CLI 已正確安裝。

    注意

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

  6. 繼續進行 Databricks CLI 的驗證。

適用於 Windows 的 WinGet 安裝

針對此安裝選項，您可以使用 winget 來自動下載並安裝最新的 Databricks CLI 可執行檔版本。

  1. 從命令提示字元中，執行下列兩 winget 個命令來安裝 CLI，然後重新啟動命令提示字元：

    winget search databricks
winget install Databricks.DatabricksCLI

  2. 確認是否已正確安裝 Databricks CLI。 若要這樣做，請使用 -v 選項或執行 version 命令來檢視 Databricks CLI 可執行檔的版本：

    databricks -v

# Or:
databricks version

    如果列出 0.205.0 或更新版本號碼，表示 Databricks CLI 已正確安裝。

    注意

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

  3. 繼續進行 Databricks CLI 的驗證。

適用於 Windows 的 Chocolatey 安裝

注意

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

針對此安裝選項，您可以使用 Chocolatey 自動下載並安裝最新的 Databricks CLI 可執行檔版本。

  1. 從命令提示字元中，執行下列 choco 命令以安裝 CLI：

    choco install databricks-cli

  2. 確認是否已正確安裝 Databricks CLI。 若要這樣做，請使用 -v 選項或執行 version 命令來檢視 Databricks CLI 可執行檔的版本：

    databricks -v

# Or:
databricks version

    如果列出 0.205.0 或更新版本號碼，表示 Databricks CLI 已正確安裝。

    注意

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

  3. 繼續進行 Databricks CLI 的驗證。

適用於Linux、macOS和 Windows 的 curl 安裝

針對此安裝選項，您可以使用 curl 下載並安裝最新的 Databricks CLI 可執行檔版本。

針對 Windows，Databricks 建議您使用 Windows 子系統 Linux 版 （WSL） 。 您必須 unzip 安裝 。 如需安裝指示，請參閱作業系統的檔。 如果您無法使用 WSL，請略過此程式，並使用命令提示字元或 PowerShell 來 改為從來源 安裝 Databricks CLI。

  1. curl 必須安裝。 您可以從 Linux 殼層提示字元、macOS 終端機或 WSL 上的 Bash 執行下列命令，以檢查是否已 curl 安裝 。 如果 curl 已安裝，則會 curl 顯示版本號碼：

    curl -V

  2. 如果 curl 尚未安裝，請依照操作系統和架構的 [ curl發行與下載 ] 頁面上的指示進行安裝。 若要取得計算機的架構，請參閱作業系統的檔。

    然後執行下列命令來驗證 curl 安裝，其中顯示 curl 版本號碼：

    curl -V

  3. 使用 curl 執行下列命令來下載並安裝 Databricks CLI 可執行檔（請注意，您必須在所有作業系統上指定正確的大寫和小寫字元 -fsSL ）：

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

    注意

    若要在執行腳本之前檢視腳本的內容，請參閱 GitHub 中 Databricks CLI 安裝程式存放庫中的 install.sh 檔案。

    針對 Windows，您應該以系統管理員身分執行此命令。

    若為Linux和macOS，如果錯誤訊息指出 /usr/local/bin 無法寫入，請使用 再次 sudo執行 命令。

    此命令會在macOS和Linux C:\Windows\databricks.exe 和 Windows 的路徑中/usr/local/bin/databricks下載並安裝 Databricks CLI 可執行檔。

    如果因為某些原因而已安裝 Databricks CLI，則會出現下列錯誤：「目標路徑 <path> 已經存在」。 若要修正此問題，您必須從上述路徑手動刪除 Databricks CLI 可執行檔，然後再次執行 curl 命令。

  4. 確認是否已正確安裝 Databricks CLI。 若要這樣做，請使用 -v 選項或執行 version 命令來檢視 Databricks CLI 可執行檔的版本：

    databricks -v

# Or:
databricks version

    如果列出 0.205.0 或更新版本號碼，表示 Databricks CLI 已正確安裝。

    注意

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

  5. 繼續進行 Databricks CLI 的驗證。

Linux、macOS 和 Windows 的來源安裝

在此安裝選項中，您會手動下載 .zip 檔案，然後從下載 .zip 的檔案手動擷取 Databricks CLI 可執行檔。

  1. 下載到本機開發計算機最新的 Databricks CLI 檔案，如 GitHub 中 Databricks CLI .zip 存放庫的 Releases 區段所列。 最新版本的 Latest 標籤位於發行清單中。 最新的發行前版本有一個 Pre-release 標籤，更適合實驗和早期採用者。 .zip您從發行的 Assets 區段下載的檔案必須符合開發電腦的作業系統和架構：

    檔案名稱 架構
    databricks_cli_X.Y.Z_darwin_amd64.zip macOS、Intel 64 位 / x86_64
    databricks_cli_X.Y.Z_darwin_arm64.zip macOS、Apple Silicon / M Series / arm64
    databricks_cli_X.Y.Z_linux_amd64.zip Linux、Intel 64 位 / x86_64
    databricks_cli_X.Y.Z_linux_arm64.zip Linux、ARM 64 位 / arm64
    databricks_cli_X.Y.Z_windows_386.zip Windows、Intel 32 位 / x86
    databricks_cli_X.Y.Z_windows_amd64.zip Windows、Intel 64 位 / AMD64
    databricks_cli_X.Y.Z_windows_arm64.zip Windows、ARM 64 位 / ARM64

    若要取得計算機的架構，請參閱作業系統的檔。 例如：

    • Linux：終端機 uname -m命令、 lscpu或 sudo lshw -c cpu。
    • macOS：Apple 圖示選單>關於此 Mac，或終端機命令 uname -m。
    • Windows：命令提示字元或 PowerShell 命令 echo %PROCESSOR_ARCHITECTURE%。

    如果您需要驗證其中.zip一個檔案的完整性，Databricks 會在與.zip檔案相同的清單中提供名為 databricks_cli_X.Y.Z_SHA256SUMS 的總和檢查碼檔案。 若要執行總和檢查碼驗證，請參閱作業系統的檔。

  2. 擷取下載 .zip 文件的內容。 若要擷取 .zip 檔案，請參閱作業系統的檔。

  3. 在擷取的內容中，資料夾會出現與檔案相同的名稱 .zip 。 此資料夾內部是 Databricks CLI 可執行檔。 您可以將 Databricks CLI 可執行檔留在該處，也可以複製或移動至另一個位置。

  4. 確認是否已正確安裝 Databricks CLI。 若要這樣做，請從 Linux 殼層提示字元、macOS 終端機或 Windows 命令提示字元，使用 -v 選項或執行 version 命令來檢視 Databricks CLI 可執行檔的版本：

    databricks -v

# Or:
databricks version

    如果列出 0.205.0 或更新版本號碼，表示 Databricks CLI 已正確安裝。

    注意

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

    針對macOS，您可能需要授權系統能夠先執行 Databricks CLI。 請參閱 從不明開發人員開啟 Mac 應用程式。

  5. 繼續進行 Databricks CLI 的驗證。

Linux 或 macOS 的 Homebrew 更新

針對此更新選項，您可以使用 Homebrew ，將 Databricks CLI 0.205 版或更新版本的先前安裝自動更新為最新版本。

  1. 從 Linux 殼層提示字元或 macOS 終端機，執行下列命令，使用 Homebrew 下載並更新至最新版的 Databricks CLI 可執行檔：

    brew upgrade databricks

  2. 確認 Databricks CLI 是否已正確更新。 若要這樣做，請使用 -v 選項或執行 version 命令來檢視 Databricks CLI 可執行檔的版本：

    databricks -v

# Or:
databricks version

    如果預期的更新版本號碼顯示，則會正確安裝 Databricks CLI。

    如需 Databricks CLI 版本的清單，請參閱 GitHub 中 Databricks CLI 存放庫的 Releases 區段。 最新版本的 Latest 標籤位於發行清單中。

    注意

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

適用於 Windows 的 WinGet 更新

針對此更新選項，您可以使用 winget 自動下載舊版 Databricks CLI 0.205 版或更新為最新版本。

  1. 從命令提示字元中，執行下列命令，使用 winget 下載並更新至最新版的 Databricks CLI 可執行檔：

    winget upgrade Databricks.DatabricksCLI

  2. 確認是否已正確安裝 Databricks CLI。 若要這樣做，請使用 -v 選項或執行 version 命令來檢視 Databricks CLI 可執行檔的版本：

    databricks -v

# Or:
databricks version

    如果預期的更新版本號碼顯示，則會正確安裝 Databricks CLI。

    如需 Databricks CLI 版本的清單，請參閱 GitHub 中 Databricks CLI 存放庫的 Releases 區段。 最新版本的 Latest 標籤位於發行清單中。

    注意

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

Windows 的 Chocolatey 更新

注意

使用 Chocolatey 更新 Databricks CLI 是 實驗性的。

針對此更新選項，您可以使用 Chocolatey 自動下載舊版 Databricks CLI 0.205 版或更新為最新版本。

  1. 從命令提示字元中，執行下列命令，使用 choco 下載並更新至最新版的 Databricks CLI 可執行檔：

    choco upgrade databricks-cli

  2. 確認是否已正確安裝 Databricks CLI。 若要這樣做，請使用 -v 選項或執行 version 命令來檢視 Databricks CLI 可執行檔的版本：

    databricks -v

# Or:
databricks version

    如果預期的更新版本號碼顯示，則會正確安裝 Databricks CLI。

    如需 Databricks CLI 版本的清單，請參閱 GitHub 中 Databricks CLI 存放庫的 Releases 區段。 最新版本的 Latest 標籤位於發行清單中。

    注意

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

Linux、macOS 和 Windows 的 curl 更新

針對此更新選項，您可以使用 curl 自動下載及更新 Databricks CLI 0.205 版或更新為最新版本的先前安裝。

針對 Windows，Databricks 建議您使用 Windows 子系統 Linux 版 （WSL） 。 您必須安裝 unzip 。 如需安裝指示，請參閱作業系統的檔。 如果您無法使用 WSL，您應該略過此程式，並使用命令提示字元或 PowerShell 來 改為從來源 更新 Databricks CLI。

  1. 從 macOS 和 Linux C:\Windows\databricks.exe 或 Windows 的路徑/usr/local/bin/databricks中刪除 Databricks CLI 可執行檔的現有安裝。

  2. 從 Linux 殼層提示字元、macOS 終端機或 Windows 命令提示字元，使用 curl 執行下列命令來下載並安裝最新版的 Databricks CLI 可執行檔（請注意，您必須為 -fsSL指定正確的大寫和小寫字元）：

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

    注意

    若要在執行腳本之前檢視腳本的內容，請參閱 GitHub 中 Databricks CLI 安裝程式存放庫中的 install.sh 檔案。

    針對 Windows，您應該以系統管理員身分執行此命令。

    若為Linux和macOS，如果錯誤訊息指出 /usr/local/bin 無法寫入，請使用 再次 sudo執行 命令。

    此命令會在macOS和Linux C:\Windows\databricks.exe 和 Windows 的路徑中/usr/local/bin/databricks下載並安裝 Databricks CLI 可執行檔。

    如果出現下列錯誤，您必須從上述路徑手動刪除 Databricks CLI 可執行檔，然後再次執行 curl 命令：「目標路徑 <path> 已經存在」。

  3. 確認 Databricks CLI 是否已正確更新。 若要這樣做，請從終端機檢視 Databricks CLI 可執行檔的版本，方法是使用 -v 選項或執行 version 命令：

    databricks -v

# Or:
databricks version

    如果預期的更新版本號碼顯示，則會正確安裝 Databricks CLI。

    如需 Databricks CLI 版本的清單，請參閱 GitHub 中 Databricks CLI 存放庫的 Releases 區段。 最新版本的 Latest 標籤位於發行清單中。

    注意

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

Linux、macOS 和 Windows 的來源更新

針對此更新選項，您會手動下載檔案 .zip ，然後從下載 .zip 的檔案手動擷取 Databricks CLI 可執行檔。

  1. 或者，從任何先前的手動來源安裝程式中刪除 Databricks CLI 可執行檔、 .zip 檔案和 .zip 檔案的解壓縮資料夾。
  2. 請遵循Linux、macOS和 Windows 來源安裝中的指示繼續進行。

從 Azure Databricks 工作區內執行 Databricks CLI

您可以從連線至執行中叢集的筆記本內的Web終端機，或直接從執行中叢集的Web終端機存取 Databricks CLI。 可用的 CLI 一律為最新版本，而驗證是以目前的用戶為基礎。 叢集必須符合下列需求：

  • 叢集必須已安裝 Databricks Runtime 15.0 或更新版本。
  • 叢集必須使用單一使用者或無隔離共用的叢集存取模式。 不支援共用 叢集存取模式。
  • 不支援無伺服器計算。
  • 私人連結不得啟用工作區。

若要從筆記本的 Web 終端機存取 CLI，請執行下列動作：

  1. 連線 筆記本到符合上述需求的叢集。

  2. 在筆記本右側提要欄位的底部，按下 [ 開啟底部] 面板 圖示 在筆記本中開啟底部面板。

  3. 使用出現的 [終端機] 窗格中的 CLI。 例如，下列命令會列印目前使用者的相關信息：

    databricks current-user me

若要從叢集的 Web 終端機存取 CLI，請執行下列動作：

  1. 在工作區的提要欄位中，按兩下 [ 計算]。

  2. 在 [ 所有用途計算 ] 索引標籤上，按兩下符合上述需求的叢集名稱。

  3. 按一下 [開始] 。

  4. 叢集啟動之後，在 [ 應用程式] 索引標籤上，按兩下 [Web 終端機]。

  5. 在出現的 Databricks Web 終端機中使用 CLI。 例如，下列命令會列印目前使用者的相關信息：

    databricks current-user me