Share via

Руководство по интерфейсу командной строки Databricks

  • Статья

Примечание.

Эта информация относится к Интерфейсу командной строки Databricks версии 0.205 и выше, которые находятся в общедоступной предварительной версии. Чтобы найти версию интерфейса командной строки Databricks, выполните команду databricks -v.

Интерфейс командной строки Databricks (также известный как служебная программа Databricks CLI) предоставляет простой интерфейс для автоматизации платформы Azure Databricks из терминала, командной строки или скриптов автоматизации.

В этой статье показано, как использовать локальный компьютер разработки для быстрого начала работы с интерфейсом командной строки Databricks. См. сведения о интерфейсе командной строки Databricks?.

В следующем практическом руководстве предполагается:

Выполните следующие действия:

  1. Если он еще не установлен, установите интерфейс командной строки Databricks следующим образом:

    Linux, macos

    Используйте Homebrew для установки интерфейса командной строки Databricks, выполнив следующие две команды:

    brew tap databricks/tap
brew install databricks

    Windows

    Вы можете использовать winget, Chocolatey или подсистема Windows для Linux (WSL) для установки интерфейса командной строки Databricks. Если вы не можете использовать winget, Chocolatey или WSL, следует пропустить эту процедуру и использовать командную строку или PowerShell для установки интерфейса командной строки Databricks из источника .

    Примечание.

    Установка интерфейса командной строки Databricks с помощью Chocolatey является экспериментальной.

    Чтобы установить winget интерфейс командной строки Databricks, выполните следующие две команды, а затем перезапустите командную строку:

    winget search databricks
winget install Databricks.DatabricksCLI

    Чтобы использовать Chocolatey для установки интерфейса командной строки Databricks, выполните следующую команду:

    choco install databricks-cli

    Чтобы использовать WSL для установки интерфейса командной строки Databricks:

    1. Установите curl и zip через WSL. Дополнительные сведения см. в документации по операционной системе.

    2. Используйте WSL для установки интерфейса командной строки Databricks, выполнив следующую команду:

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

  2. Убедитесь, что интерфейс командной строки Databricks установлен, выполнив следующую команду, которая отображает текущую версию установленного интерфейса командной строки Databricks. Эта версия должна быть 0.205.0 или более поздней:

    databricks -v

    Примечание.

    Если вы выполняете, но получите ошибку, напримерcommand not found: databricks, или если вы запускаете databricksdatabricks -v, а номер версии 0.18 или ниже указан, это означает, что компьютер не может найти правильную версию исполняемого файла Интерфейса командной строки Databricks. Чтобы устранить эту проблему, см . статью "Проверка установки CLI".

После установки интерфейса командной строки Databricks выполните следующие действия:

Примечание.

В этом руководстве предполагается, что для проверки подлинности интерфейса командной строки с помощью учетной записи пользователя Azure Databricks необходимо использовать проверку подлинности OAuth на компьютере (U2M). Чтобы настроить интерфейс командной строки для использования других типов проверки подлинности Databricks, ознакомьтесь с проверкой подлинности для интерфейса командной строки Databricks.

  1. Используйте интерфейс командной строки Databricks для локального запуска управления маркерами OAuth, выполнив следующую команду для каждой целевой учетной записи или рабочей области.

    Для операций на уровне учетной записи в следующей команде замените следующие заполнители:

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

    Для операций на уровне рабочей области в следующей команде замените <workspace-url> URL-адрес Azure Databricks для каждой рабочей области, напримерhttps://adb-1234567890123456.7.azuredatabricks.net.

    databricks auth login --host <workspace-url>

  2. Интерфейс командной строки Databricks предлагает сохранить сведения, введенные в качестве профиля конфигурации Azure Databricks. Нажмите, Enter чтобы принять предлагаемое имя профиля, или введите имя нового или существующего профиля. Любой существующий профиль с тем же именем перезаписывается с введенными сведениями. Вы можете использовать профили для быстрого переключения контекста проверки подлинности между несколькими учетными записями или рабочими областями.

    Чтобы получить список существующих профилей, в отдельном терминале или командной строке используйте интерфейс командной строки Databricks для выполнения команды 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 значениями, вам может потребоваться указать -p--host--account-idи параметры вместе, чтобы помочь 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 одинаковыми значениями, может потребоваться указать и -p параметры --host вместе, чтобы помочь Databricks CLI найти правильные соответствующие сведения о маркере OAuth.

Следующие шаги

После настройки интерфейса командной строки Databricks: