安装或更新 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 shell 提示符或 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 建议使用适用于 Linux 的 Windows 子系统 (WSL)。 你还必须安装 unzip。 有关安装说明，请参阅操作系统的相关文档。 如果无法使用 WSL，请跳过此过程，改为使用命令提示符或 PowerShell 从源安装 Databricks CLI。

  1. 必须安装 curl。 你可以通过从 Linux shell 提示符、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 上的路径 /usr/local/bin/databricks 以及 Windows 上的路径 C:\Windows\databricks.exe 中下载并安装 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 .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 的校验和文件。 若要运行校验和验证，请参阅操作系统的文档。

  2. 提取下载的 .zip 文件的内容。 若要提取 .zip 文件，请参阅操作系统的文档。

  3. 在提取的内容中，会显示一个与 .zip 文件同名的文件夹。 此文件夹包含 Databricks CLI 可执行文件。 可以将 Databricks CLI 可执行文件保留在原处，或者将其复制或移动到其他位置。

  4. 确认 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 应用。

  5. 继续配置 Databricks CLI 身份验证。

适用于 Linux 或 macOS 的 Homebrew 更新

对于此更新选项，请使用 Homebrew 将以前安装的 Databricks CLI 0.205 或更高版本自动更新到最新版本。

  1. 在 Linux shell 提示符或 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”存储库的版本部分。 最新版本在版本列表中带有一个 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”存储库的版本部分。 最新版本在版本列表中带有一个 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 或更高版本更新到最新版本。

  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”存储库的版本部分。 最新版本在版本列表中带有一个 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。

  1. 从 macOS 和 Linux 上的路径 /usr/local/bin/databricks 或 Windows 上的路径 C:\Windows\databricks.exe 删除 Databricks CLI 可执行文件的现有安装。

  2. 在 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> 已存在”。

  3. 确认 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 可执行文件。

  1. （可选）在上述手动安装过程中删除 Databricks CLI 可执行文件、.zip 文件以及在之前的任何手动源安装过程中将 .zip 文件提取到的文件夹。
  2. 按照适用于 Linux、macOS 和 Windows 的源安装中的说明继续操作。

从 Azure Databricks 工作区内运行 Databricks CLI

可以从连接到正在运行的群集的笔记本内部的 Web 终端访问 Databricks CLI，也可以从正在运行的群集的 Web 终端进行访问。 可用的 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