Поделиться через

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

Примечание.

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

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

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

В этой статье показано, как быстро установить и настроить интерфейс командной строки Databricks.

Подтверждение требований к локальному компьютеру

В этом руководстве предполагается, что:

Установка интерфейса командной строки Databricks

  1. Установите интерфейс командной строки Databricks:

    Linux, macOS

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

    brew tap databricks/tap
brew install databricks

    Виндоус

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

    Примечание.

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

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

    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

Настройка доступа к рабочей области

Затем настройте доступ к рабочей области Databricks.

Примечание.

В этом руководстве используется проверка подлинности OAuth от пользователя к машине (U2M) для аутентификации интерфейса командной строки с использованием вашей учетной записи пользователя Azure Databricks. Чтобы настроить интерфейс командной строки для использования других типов проверки подлинности 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 значениями, возможно, вам придется указать --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.

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

  • Last updated on