Настройте авторизацию расширения Databricks IDE.

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

Расширение Databricks IDE реализует части единого стандарта аутентификации Databricks, который позволяет настраивать авторизацию на базе OAuth 2.0 на базе Azure Databricks один раз, а затем использовать эту конфигурацию между несколькими инструментами и SDK Azure Databricks без дальнейших изменений в конфигурации авторизации и аутентификации. Он также обеспечивает автоматическое обновление активных маркеров доступа, что снижает сложность процесса при разработке.

Databricks рекомендует интерактивную авторизацию пользователя OAuth, которую легко настроить с помощью расширения Databricks IDE. См. настройку OAuth авторизации и проверки подлинности.

В противном случае, если вы используете Аутентификация с Azure Databricks с использованием токенов личного доступа (устаревшая версия), Авторизация доступа к Azure Databricks с помощью OAuth, или Аутентификация с помощью учетных записей службы Microsoft Entra, см. раздел Настройка проверки подлинности с помощью профиля конфигурации. Сведения о аутентификации с помощью Azure CLI см. в разделе Настройка аутентификации Azure CLI.

Примечание.

Расширение Databricks IDE не поддерживает аутентификацию с использованием управляемых идентичностей Azure (ранее Azure Managed Service Identities (MSI)), но Databricks Connect, используемый без расширения Databricks IDE, поддерживает. Сведения об установке Databricks Connect см. в разделе Install Databricks Connect для Python.

Настройка авторизации и проверки подлинности OAuth

Azure Databricks поддерживает авторизацию и проверку подлинности на основе OAuth 2.0, а также упрощает управление маркерами доступа с помощью единой проверки подлинности Databricks. Дополнительные сведения об авторизации пользователей и служебных субъектов с помощью Azure Databricks см. в разделе Authorize access to Azure Databricks resources.

Чтобы завершить настройку авторизации OAuth, откройте свой проект VSCode с включённым расширением Databricks IDE:

1. В представлении Конфигурация нажмите Тип проверки подлинности, затем нажмите значок шестеренки (Вход в рабочую область Databricks).

   

2. Если у вас уже есть профиль конфигурации проверки подлинности в этом списке с меткой Аутентификация с помощью OAuth (от пользователя к компьютеру), и вы знаете, что он соответствует целевому узлу Databricks, выберите его из списка и выполните следующие действия:

   1. Если появится запрос, выполните все инструкции на экране в веб-браузере, чтобы завершить проверку подлинности с помощью Azure Databricks.
   2. Если также появится запрос, разрешите доступ ко всем API .
   3. Перейдите сразу к выбору вычислений для выполнения кода и заданий.

3. В командной палитре для выберите метод проверки подлинности, нажмите OAuth (пользователь на компьютер).

4. Для опции Выбор метода проверки подлинности выберите OAuth (пользователь к машине).

5. Введите имя профиля проверки подлинности, связанного с Azure Databricks.

6. В представлении конфигурации нажмите кнопку "Вход в Databricks".

   

7. В палитре команд для Выберите метод проверки подлинностивыберите имя только что созданного профиля конфигурации проверки подлинности.

8. Если появится запрос, выполните все инструкции на экране в веб-браузере, чтобы завершить проверку подлинности с помощью Azure Databricks. Если также появится запрос, разрешите доступ ко всем API .

9. После успешного входа вернитесь к Visual Studio Code.

Настройте аутентификацию через профиль конфигурации

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

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

1. В представлении Конфигурация нажмите Тип проверки подлинности, затем нажмите значок шестеренки (Вход в рабочую область Databricks).

   

2. В Палитре команд выберите в списке целевой профиль конфигурации Azure Databricks.

   Совет

   Целевой узел рабочей области можно изменить позже, отредактировав значение целевого параметра workspace в файле конфигурации databricks.yml, связанном с проектом. См цели.

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

1. При открытии проекта и расширения в представлении конфигурации щелкните «Тип проверки подлинности» или «Войти в Databricks», а затем щелкните значок шестеренки (вход в рабочую область Databricks).

   

2. В палитре команд выберите личный токен доступа.

3. Выполните запросы на экране, чтобы выполнить следующие действия:

   1. Введите имя профиля проверки подлинности, связанного с Azure Databricks.
   2. Создайте личный маркер доступа в рабочей области Azure Databricks, а затем скопируйте значение маркера.
   3. Вернитесь к расширению и введите значение скопированного маркера.

Расширение создает в вашем проекте папку .databricks с файлом под именем databricks.env, если она еще не существует. Этот файл содержит введённый вами хост рабочего пространства, а также другие детали конфигурации Azure Databricks, используемые расширением Databricks IDE.

Расширение также добавляет скрытый .gitignore файл в проект, если файл не существует или если существующий .gitignore файл не найден в родительских папках. Если создается новый .gitignore файл, расширение добавляет .databricks/ запись в этот новый файл. Если расширение находит существующий файл, оно добавляет .gitignore запись в существующий .databricks/ файл.

Настройка проверки подлинности Azure CLI

Azure Databricks поддерживает проверку подлинности с помощью локально установленной Azure CLI. Это позволяет создавать короткоживущие (на один час) токены Microsoft Entra ID, что снижает риск случайной утечки более долговечных токенов, например, личных токенов доступа Azure Databricks, через коммиты в системе контроля версий или другими способами.

Имея открытые проект и расширение, а также локально установленный Azure CLI, выполните следующее:

1. В окне конфигурации нажмите «Настройка Databricks».

   Примечание.

   Если Настройка Databricks не отображается, нажмите на значок шестеренки (Настройка рабочей области) рядом с Конфигурацией.

   

2. В палитре команд для хоста Databricks введите URL вашего рабочего пространства, например, . Нажмите клавишу ВВОД.

3. Выберите Azure CLI.