configure команда

Note

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

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

Команда configure в интерфейсе командной строки Databricks позволяет выполнять проверку подлинности интерфейса командной строки Databricks с помощью Azure Databricks с помощью личных маркеров доступа Azure Databricks или токенов Microsoft Entra ID (ранее Azure Active Directory).

Note

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

Обратите внимание, что в этой статье рассматриваются только личные токены доступа Azure Databricks и токен аутентификации Microsoft Entra ID для возможности вызова команд уровня рабочей области. Дополнительные параметры конфигурации проверки подлинности см. в разделе "Проверка подлинности" для интерфейса командной строки Databricks.

настройка Databricks

Настройте профиль в ~/.databrickscfg файле. Профиль конфигурации — это коллекция параметров, содержащих сведения о проверке подлинности, такие как URL-адрес рабочей области Azure Databricks и значение маркера доступа.

Профиль конфигурации имеет программное имя, например DEFAULT, DEVили PROD. Добавление нескольких профилей в .databrickscfg файл позволяет быстро выполнять команды в различных рабочих областях, указав имя целевого профиля подключения в параметре команды --profile . Если параметр не указан --profile в команде, поддерживающей этот параметр, команда будет использовать DEFAULT профиль подключения по умолчанию.

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

Чтобы получить сведения о существующих профилях конфигурации, используйте группуauth команд.

Вы можете изменить путь по умолчанию к .databrickscfg файлу, задав переменную DATABRICKS_CONFIG_FILEсреды.

Если эта команда вызывается в неинтерактивном режиме, он считывает маркер из stdin. Хост должен быть указан с флагом --host или переменной окружения DATABRICKS_HOST.

databricks configure [flags]

Options

--configure-cluster

    Запросы на настройку кластера

--host string

    URL хоста рабочей области Databricks

URL-адрес узла рабочей области — это URL-адрес для каждой рабочей области с форматом https://adb-<workspace-id>.<random-number>.azuredatabricks.net. Чтобы получить URL-адрес по рабочей области, см. URL-адрес по рабочей области.

--profile string

    Имя профиля подключения для настройки. (по умолчанию "DEFAULT")

Глобальные флаги

Examples

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

databricks configure

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

databricks configure --profile my-profile

В следующем примере настраивается аутентификация с конкретным узлом:

databricks configure --host https://my-workspace.cloud.databricks.com

Следующий пример настраивает аутентификацию в соответствии с конфигурацией кластера:

databricks configure --configure-cluster

Глобальные флаги

--debug

  Следует ли включить ведение журнала отладки.

-h или --help

    Отобразить справку по интерфейсу командной строки Databricks, связанной группе команд или отдельной команде.

--log-file струна

    Строка, представляющая файл для записи журналов выходных данных. Если этот флаг не указан, по умолчанию используется запись журналов выходных данных в stderr.

--log-format формат

    Тип формата журнала: text или json. Значение по умолчанию — text.

--log-level струна

    Строка, представляющая уровень формата журнала. Если не указано, уровень формата журнала отключен.

типа -o, --output

    Тип выходных данных команды: text или json. Значение по умолчанию — text.

-p, --profile струна

    Имя профиля в ~/.databrickscfg файле, используемого для выполнения команды. Если флаг не указан, используется профиль DEFAULT, если он существует.

--progress-format формат

    Формат для отображения журналов хода выполнения: default, appendinplace, илиjson

-t, --target струна

    Если применимо, целевой объект пакета для использования

Создайте профиль конфигурации.

Чтобы создать профиль конфигурации, выполните configure команду:

databricks configure --host <workspace-url>

Команда предлагает вам ввести ваш персональный токен доступа Azure Databricks или токен Microsoft Entra ID (ранее Azure Active Directory), который соответствует указанному :

✔ Databricks Token:

После ввода маркера доступа маркер доступа хранится в файле ~/.databrickscfg в Linux или macOS или %USERPROFILE%\.databrickscfg в Windows по умолчанию. Файл содержит запись профиля подключения по умолчанию с именем DEFAULT:

[DEFAULT]
host  = <workspace-url>
token = <access-token>

Чтобы использовать другое имя для профиля подключения вместо DEFAULT, добавьте --profile опцию в configure команду, например:

databricks configure --host <workspace-url> --profile <profile-name>

Tip

Вы можете нажать Tab после --profile или -p, чтобы отобразить список существующих доступных профилей конфигурации для выбора, а не вводить имя профиля конфигурации вручную.

Все существующие сведения о узле и маркере в указанном профиле подключения перезаписываются с помощью новых сведений о узле и маркере.