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

Примечание.

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

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

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

• Установка или обновление интерфейса командной строки Databricks
• Проверка подлинности для интерфейса командной строки Databricks

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

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

Совет

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

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

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

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

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

# Or:
databricks auth env --host <account-console-url>

# Or:
databricks auth env --host <workspace-url>

Например, ниже приведены выходные данные для профиля, настроенного с проверкой подлинности личного маркера доступа Azure Databricks:

{
  "env": {
    "DATABRICKS_AUTH_TYPE": "pat",
    "DATABRICKS_CONFIG_PROFILE": "<configuration-profile-name>",
    "DATABRICKS_HOST": "<workspace-url>",
    "DATABRICKS_TOKEN": "<token-value>"
  }
}

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

databricks auth profiles

Выходные данные (многоточие представляют опущенное содержимое для краткости):

{
  "profiles": [
    {
      "name": "<configuration-profile-name>",
      "host": "<workspace-url>",
      "cloud": "<cloud-id>",
      "auth_type": "<auth-type>",
      "valid": true
    },
    {
      "...": "..."
    }
  ]
}

Выходные данные auth profiles команды не отображают маркеры доступа. Чтобы отобразить маркер доступа, выполните указанную выше auth env команду.

Важно!

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

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

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

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

databricks clusters spark-versions

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

Чтобы проверка правильно ли настроить профили конфигурации, можно выполнить команду, например следующую, с одним из имен профилей конфигурации на уровне рабочей области. Эта команда содержит список доступных версий среды выполнения Databricks для рабочей области Azure Databricks, связанной с указанным профилем конфигурации, представленной здесь заполнителем <configuration-profile-name>:

databricks clusters spark-versions -p <configuration-profile-name>

Совет

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

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

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

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

databricks auth profiles