configure группа команд

Примечание.

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

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

Примечание.

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

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

Внимание

Перед выполнением этой команды обязательно настройте интерфейс командной строки Databricks.

Команды выполняются configure путем добавления их в databricks configure. Чтобы отобразить справку по команде configure , выполните команду databricks configure -h.

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

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

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

databricks configure --host <workspace-url>

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

В командной строке вы вводите личный маркер доступа Azure Databricks или маркер Microsoft Entra ID (ранее Azure Active Directory), который сопоставляется с указанным<workspace-url>:

✔ 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>

Совет

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

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

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

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

Путь по умолчанию к этому .databrickscfg файлу можно изменить, задав переменную DATABRICKS_CONFIG_FILEсреды. Сведения о настройке переменных среды см. в документации операционной системы.

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