安裝或更新 Databricks CLI

注意

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

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

本文說明如何安裝或更新 Databricks CLI。 請參閱什麼是 Databricks CLI？。 若要設定 Databricks CLI 的驗證，請參閱 Databricks CLI 的驗證。

安裝

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

• Linux 或 macOS：使用 Homebrew、 curl 或 來源組建。
• Windows：使用 WinGet、Chocolatey、Windows 子系統 Linux 版 （WSL）或來源組建。

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

更新

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

• Linux 或 macOS：使用 Homebrew、 curl 或 來源組建。
• Windows：使用 WinGet、Chocolatey、Windows 子系統 Linux 版 （WSL）或來源組建。

適用於 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 安裝。

提示

若要降級 Databricks CLI 的版本，請參閱 GitHub 中 databricks/homebrew-tap 存放庫中的指示。

適用於 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 來源安裝中的指示繼續進行。