安装或更新 Databricks CLI
注意
此信息适用于 Databricks CLI 0.205 及更高版本,这些版本为公共预览版。 若要查找你的 Databricks CLI 的版本,请运行 databricks -v
。
本文介绍如何安装或更新 Databricks CLI。 请参阅什么是 Databricks CLI?。
安装
若要安装 Databricks CLI 0.205 或更高版本,请执行以下操作:
- Linux 或 macOS:使用 Homebrew、curl 或源代码生成。
- Windows:使用 WinGet、Chocolatey、适用于 Linux 的 Windows 子系统 (WSL) 或 源内部版本。
也可从 Azure Databricks 工作区用户界面中获取 Databricks CLI。 请参阅运行 Databricks CLI 命令。
更新
若要更新以前安装的 Databricks CLI 0.205 或更高版本,请执行以下操作:
- Linux 或 macOS:使用 Homebrew、curl 或源代码生成。
- Windows:使用 WinGet、Chocolatey、适用于 Linux 的 Windows 子系统 (WSL) 或 源内部版本。
适用于 Linux 或 macOS 的 Homebrew 安装
如果选择此安装方法,请使用 Homebrew 自动下载并安装最新的 Databricks CLI 可执行文件版本。
在终端中,只需运行以下两个 Homebrew 命令即可安装 CLI:
brew tap databricks/tap
brew install databricks
然后继续配置 Databricks CLI 身份验证。
如果你不确定是否已安装 Homebrew,或者上述 Homebrew 命令失败,请按照以下长说明操作:
通过在 Linux shell 提示符或 macOS 终端处运行以下命令来检查是否已安装 Homebrew。 如果已安装 Homebrew,将显示 Homebrew 版本号:
brew -v
如果尚未安装 Homebrew,请通过运行以下命令安装它:
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
然后运行以下命令来确认是否已安装 Homebrew,如果安装成功,会显示 Homebrew 版本号:
brew -v
通过运行以下命令,使用 Homebrew 将 GitHub 中的 databricks/homebrew-tap 存储库添加到可用 Homebrew Tap 存储库列表:
brew tap databricks/tap
通过运行以下命令,使用 Homebrew 指示
databricks/homebrew-tap
存储库下载并安装 Databricks CLI 可执行文件:brew install databricks
确认 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 安装。继续配置 Databricks CLI 身份验证。
适用于 Windows 的 WinGet 安装
如果选择此安装方法,请使用 winget 自动下载并安装最新的 Databricks CLI 可执行文件版本。
在命令提示符下,运行以下两个
winget
命令来安装 CLI,然后重启命令提示符:winget search databricks winget install Databricks.DatabricksCLI
确认 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 安装。继续配置 Databricks CLI 身份验证。
适用于 Windows 的 Chocolatey 安装
注意
使用 Chocolatey 安装 Databricks CLI 是试验性的。
对于此安装选项,请使用 Chocolatey 自动下载并安装最新的 Databricks CLI 可执行文件版本。
在命令提示符下,运行以下
choco
命令以安装 CLI:choco install databricks-cli
确认 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 安装。继续配置 Databricks CLI 身份验证。
适用于 Linux、macOS 和 Windows 的 curl 安装
如果选择此安装方法,请使用 curl 下载并安装最新的 Databricks CLI 可执行文件版本。
对于 Windows,Databricks 建议使用适用于 Linux 的 Windows 子系统 (WSL)。 你还必须安装 unzip
。 有关安装说明,请参阅操作系统的文档。 如果无法使用 WSL,请跳过此过程,改为使用命令提示符或 PowerShell 从源安装 Databricks CLI。
必须安装
curl
。 你可以通过从 Linux shell 提示符、macOS 终端或 WSL 上的 Bash 运行以下命令来检查是否已安装curl
。 如果已安装curl
,将显示curl
版本号:curl -V
如果尚未安装
curl
,请按照操作系统和体系结构的curl
发布和下载页上的说明安装它。 若要了解计算机的体系结构,请参阅操作系统的文档。然后运行以下命令来验证
curl
安装,此时将会显示curl
版本号:curl -V
通过运行以下命令,使用
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 上的路径
/usr/local/bin/databricks
以及 Windows 上的路径C:\Windows\databricks.exe
中下载并安装 Databricks CLI 可执行文件。如果由于某种原因已安装 Databricks CLI,则会出现以下错误:“目标路径
<path>
已存在”。若要解决此问题,必须从上面的路径中手动删除 Databricks CLI 可执行文件,然后再次运行curl
命令。确认 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 安装。继续配置 Databricks CLI 身份验证。
适用于 Linux、macOS 和 Windows 的源安装
如果选择此安装方法,需要手动下载 .zip
文件,然后从下载的 .zip
文件中手动提取 Databricks CLI 可执行文件。
将最新的 Databricks CLI
.zip
文件下载到本地开发计算机上,如 GitHub 上“Databricks CLI”存储库中的版本部分所列。 最新版本在版本列表中带有一个Latest
标签。 最新预发行版带有Pre-release
标签,它更适合试验和早期采用者。 从发布的Assets
部分下载的.zip
文件必须与开发计算机的操作系统和体系结构匹配:Filename 体系结构 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
系列 /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
的校验和文件。 若要运行校验和验证,请参阅操作系统的文档。- Linux:终端命令
提取下载的
.zip
文件的内容。 若要提取.zip
文件,请参阅操作系统的文档。在提取的内容中,会显示一个与
.zip
文件同名的文件夹。 此文件夹包含 Databricks CLI 可执行文件。 可以将 Databricks CLI 可执行文件保留在原处,或者将其复制或移动到其他位置。确认 Databricks CLI 是否已正确安装。 为此,请在 Linux shell 提示符、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 应用。
继续配置 Databricks CLI 身份验证。
适用于 Linux 或 macOS 的 Homebrew 更新
对于此更新选项,请使用 Homebrew 将以前安装的 Databricks CLI 0.205 或更高版本自动更新到最新版本。
在 Linux shell 提示符或 macOS 终端处运行以下命令,使用 Homebrew 下载并更新到最新版本的 Databricks CLI 可执行文件:
brew upgrade databricks
确认 Databricks CLI 是否已正确更新。 为此,请通过使用
-v
选项或运行version
命令查看 Databricks CLI 可执行文件的版本:databricks -v # Or: databricks version
如果显示了预期的更新版本号,则表示 Databricks CLI 已正确安装。
有关 Databricks CLI 版本的列表,请参阅 GitHub 中“Databricks CLI”存储库的版本部分。 最新版本在版本列表中带有一个
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 或更高版本到最新版本。
在命令提示符下,通过运行以下命令,使用
winget
下载最新版本的 Databricks CLI 可执行文件并更新到该最新版本:winget upgrade Databricks.DatabricksCLI
确认 Databricks CLI 是否已正确安装。 为此,请通过使用
-v
选项或运行version
命令查看 Databricks CLI 可执行文件的版本:databricks -v # Or: databricks version
如果显示了预期的更新版本号,则表示 Databricks CLI 已正确安装。
有关 Databricks CLI 版本的列表,请参阅 GitHub 中“Databricks CLI”存储库的版本部分。 最新版本在版本列表中带有一个
Latest
标签。注意
如果运行
databricks
但收到错误(如command not found: databricks
),或者如果运行databricks -v
而列出的版本号为 0.18 或更低,则表示计算机找不到正确版本的 Databricks CLI 可执行文件。 若要修复此问题,请参阅验证 CLI 安装。
适用于 Windows 的 Chocolatey 更新
注意
使用 Chocolatey 更新 Databricks CLI 是试验性的。
对于此更新选项,请使用 Chocolatey 自动下载最新的 Databricks CLI 版本并将以前安装的 Databricks CLI 0.205 或更高版本更新到最新版本。
在命令提示符下,通过运行以下命令,使用
choco
下载最新版本的 Databricks CLI 可执行文件并更新到该最新版本:choco upgrade databricks-cli
确认 Databricks CLI 是否已正确安装。 为此,请通过使用
-v
选项或运行version
命令查看 Databricks CLI 可执行文件的版本:databricks -v # Or: databricks version
如果显示了预期的更新版本号,则表示 Databricks CLI 已正确安装。
有关 Databricks CLI 版本的列表,请参阅 GitHub 中“Databricks CLI”存储库的版本部分。 最新版本在版本列表中带有一个
Latest
标签。注意
如果运行
databricks
但收到错误(如command not found: databricks
),或者如果运行databricks -v
而列出的版本号为 0.18 或更低,则表示计算机找不到正确版本的 Databricks CLI 可执行文件。 若要修复此问题,请参阅验证 CLI 安装。
适用于 Linux、macOS 和 Windows 的 curl 更新
对于此更新选项,请使用 curl 下载最新 Databricks CLI 版本或将以前安装的 Databricks CLI 0.205 或更高版本更新到最新版本。
对于 Windows,Databricks 建议使用适用于 Linux 的 Windows 子系统 (WSL)。 你必须已安装 unzip
。 有关安装说明,请参阅操作系统的文档。 如果无法使用 WSL,则应跳过此过程,改为使用命令提示符或 PowerShell 从源更新 Databricks CLI。
从 macOS 和 Linux 上的路径
/usr/local/bin/databricks
或 Windows 上的路径C:\Windows\databricks.exe
删除 Databricks CLI 可执行文件的现有安装。在 Linux shell 提示符、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 上的路径
/usr/local/bin/databricks
以及 Windows 上的路径C:\Windows\databricks.exe
中下载并安装 Databricks CLI 可执行文件。如果出现以下错误,则必须从上面的路径中手动删除 Databricks CLI 可执行文件,然后再次运行
curl
命令:“目标路径<path>
已存在”。确认 Databricks CLI 是否已正确更新。 为此,请从终端使用
-v
选项或运行version
命令查看 Databricks CLI 可执行文件的版本:databricks -v # Or: databricks version
如果显示了预期的更新版本号,则表示 Databricks CLI 已正确安装。
有关 Databricks CLI 版本的列表,请参阅 GitHub 中“Databricks CLI”存储库的版本部分。 最新版本在版本列表中带有一个
Latest
标签。注意
如果运行
databricks
但收到错误(如command not found: databricks
),或者如果运行databricks -v
而列出的版本号为 0.18 或更低,则表示计算机找不到正确版本的 Databricks CLI 可执行文件。 若要修复此问题,请参阅验证 CLI 安装。
适用于 Linux、macOS 和 Windows 的源更新
对于此更新选项,请手动下载 .zip
文件,然后从下载的 .zip
文件中手动提取 Databricks CLI 可执行文件。
- (可选)从以前的任何手动源安装过程中删除 Databricks CLI 可执行文件、
.zip
文件和.zip
文件的提取文件夹。 - 按照适用于 Linux、macOS 和 Windows 的源安装中的说明继续操作。