Профили конфигурации для интерфейса командной строки Databricks

Примечание.

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

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

Получение сведений о профилях конфигурации

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

  1. Переменная DATABRICKS_CONFIG_PROFILE среды, если задана.
  2. Параметр default_profile в [__settings__] разделе .databrickscfg, если он присутствует. Это можно задать с помощью databricks auth switch. См. databricks auth switch.
  3. Профиль DEFAULT.

Совет

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

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

По умолчанию интерфейс командной строки Databricks ищет файл .databrickscfg в папке ~ (вашем домашнем каталоге) в Unix, Linux или macOS либо в папке %USERPROFILE% (вашем домашнем каталоге) в Windows. Чтобы изменить путь по умолчанию файла .databrickscfg, задайте для переменной среды DATABRICKS_CONFIG_FILE другой путь. См. поля, специфичные для .databrickscfg.

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

databricks auth describe --profile <configuration-profile-name>

Например, ниже показан вывод для профиля, настроенного с аутентификацией с помощью персонального токена доступа Azure Databricks:

Host: https://dbc-a1b2345c-d6e7.cloud.databricks.com
User: user@example.com
Authenticated with: pat
-----
Current configuration:
  ✓ host: https://dbc-a1b2345c-d6e7.cloud.databricks.com (from ~/.databrickscfg config file)
  ✓ token: ******** (from ~/.databrickscfg config file)
  ✓ profile: <configuration-profile-name> (from --profile flag)
  ✓ auth_type: pat

Примечание.

Команда auth env устарела. Используйте databricks auth describe, чтобы проверить конфигурацию профиля, или databricks auth token, чтобы получить кэшированный токен доступа OAuth.

Чтобы получить сведения обо всех доступных профилях, выполните команду auth profiles:

databricks auth profiles

Name                     Host                                            Valid
DEFAULT                  https://dbc-a1b2345c-d6e7.cloud.databricks.com  YES
Development              https://dbc-a1b2345c-d6e7.cloud.databricks.com  YES
Staging                  https://dbc-a1b2345c-d6e7.cloud.databricks.com  YES
Production               https://dbc-a1b2345c-d6e7.cloud.databricks.com  YES

Выходные данные auth profiles команды не отображают маркеры доступа. Чтобы отобразить сведения о токене для конкретного профиля, выполните databricks auth describe --profile <profile-name> или databricks auth token --profile <profile-name>.

Внимание

Интерфейс командной строки Databricks не работает с файлом .netrc. Файл в вашей .netrc среде можно использовать в других целях, но интерфейс командной строки Databricks не будет использовать этот .netrc файл.

Тестирование профилей конфигурации

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

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

Примечание.

Эта команда предполагает, что у вас нет набора переменных среды, которые имеют приоритет над параметрами в профиле DEFAULT. Дополнительные сведения см. в разделе Порядок проверки подлинности.

databricks clusters spark-versions

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

databricks clusters spark-versions -p PROD
  • Last updated on