Databricks CLI 教程

Databricks 命令行接口（也称为 Databricks CLI）实用工具提供了一个易于使用的接口，可从终端、命令提示符或自动化脚本自动执行Azure Databricks平台。 请参阅 Databricks CLI。

本文演示如何快速安装和配置 Databricks CLI。

确认本地计算机要求

本教程做出如下假设：

• 对于 Linux 或 macOS，已安装Homebrew。

  注意

  有关无法使用 Homebrew 安装 CLI 的其他方法，请参阅 安装或更新 Databricks CLI。

• 对于 Windows，已安装 winget、Chocolatey 或 Windows Subsystem for Linux （WSL）。

  注意

  使用 Chocolatey 安装 Databricks CLI 是试验性的。 有关安装 CLI 的其他方法，请参阅 安装或更新 Databricks CLI。

安装 Databricks CLI

1. 安装 Databricks CLI：

   Linux、macOS

   运行以下两个命令，使用 Homebrew 安装 Databricks CLI：

   brew tap databricks/tap
   brew install databricks
   

   Windows

   可以使用 winget、Chocolatey 或 Windows Subsystem for 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. 通过 WSL 安装 curl 和 zip。 有关详细信息，请参阅操作系统文档。

   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 工作区的访问权限。

1. 通过对每个目标帐户或工作区运行以下命令，使用 Databricks CLI 在本地启动 OAuth 令牌管理。

   对于帐户级别操作，请在以下命令中替换以下占位符：

   • 将 <account-console-url> 替换为 Azure Databricks https://accounts.azuredatabricks.net。
   • 将 <account-id> 替换为Azure Databricks帐户 ID。 请参阅查找账户ID。

   databricks auth login --host <account-console-url> --account-id <account-id>
   

   对于 workspace 级别操作，在以下命令中，将 <workspace-url> 替换为 Azure Databricks per-workspace URL，例如 https://adb-1234567890123456.7.azuredatabricks.net。

   databricks auth login --host <workspace-url>
   

2. Databricks CLI 会提示保存输入的信息作为 Azure Databricks configuration 配置文件。 按 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 令牌信息。

后续步骤

• 要了解如何使用 CLI，请参阅Databricks CLI 的基本用法。
• 有关可用 CLI 命令的概述，请参阅 Databricks CLI 命令。
• 如果 CLI 未运行或生成了意外结果，请参阅验证 CLI 安装。