Подключение к SQL Workbench/J
В этой статье объясняется, как использовать SQL Workbench/J с Azure Databricks.
Примечание.
В этой статье описывается инструмент SQL Workbench/J, который не предоставляется и не поддерживается Databricks. Чтобы связаться с поставщиком, воспользуйтесь форумом поддержки SQL Workbench/J в группах Google.
Требования
Драйвер JDBC Databricks. Скачайте драйвер JDBC Databricks на локальный компьютер разработки, извлекая
DatabricksJDBC42.jar
файл из скачаированногоDatabricksJDBC42-<version>.zip
файла.Примечание.
Эта статья была протестирована с помощью macOS, SQL Workbench/J Build 130, Zulu OpenJDK 21.0.1 и Databricks JDBC Driver 2.6.36.
Для проверки подлинности Azure Databricks, если вы не используете проверку подлинности маркера личного доступа Azure Databricks, вы можете пропустить создание личного маркера доступа позже в этих требованиях. Дополнительные сведения о доступных типах проверки подлинности Azure Databricks см. в параметрах проверки подлинности для драйвера JDBC Databricks.
Кластер хранилища SQL в рабочей области Azure Databricks.
- Справочник по конфигурации вычислений.
- Создание хранилища SQL.
Сведения о подключении для кластера или хранилища SQL, в частности имя узла сервера, порт и путь HTTP.
- Получение сведений о подключении для вычислительного ресурса Azure Databricks.
Маркер личного доступа Azure Databricks или токен Microsoft Entra ID (ранее Azure Active Directory). Чтобы создать личный маркер доступа, сделайте следующее:
- В рабочей области Azure Databricks щелкните имя пользователя Azure Databricks в верхней строке и выберите "Параметры " в раскрывающемся списке.
- Щелкните "Разработчик".
- Рядом с маркерами доступа нажмите кнопку "Управление".
- Щелкните Generate new token (Создание нового маркера).
- (Необязательно) Введите комментарий, который поможет определить этот маркер в будущем и изменить время существования маркера по умолчанию в течение 90 дней. Чтобы создать маркер без времени существования (не рекомендуется), оставьте поле время существования (дни) пустым (пустым).
- Щелкните Создать.
- Скопируйте отображаемый маркер в безопасное расположение и нажмите кнопку "Готово".
Примечание.
Не забудьте сохранить скопированный маркер в безопасном расположении. Не делитесь скопированным маркером с другими пользователями. Если вы потеряете скопированный маркер, вы не сможете повторно создать тот же маркер. Вместо этого необходимо повторить эту процедуру, чтобы создать новый маркер. Если вы потеряете скопированный маркер или считаете, что маркер скомпрометирован, Databricks настоятельно рекомендует немедленно удалить этот маркер из рабочей области, щелкнув значок корзины (отозвать) рядом с маркером на странице маркеров доступа.
Если вы не можете создавать или использовать маркеры в рабочей области, это может быть связано с тем, что администратор рабочей области отключил маркеры или не предоставил вам разрешение на создание или использование маркеров. Обратитесь к администратору рабочей области или следующему:
Примечание.
В качестве рекомендации по обеспечению безопасности при проверке подлинности с помощью автоматизированных средств, систем, сценариев и приложений Databricks рекомендуется использовать личные маркеры доступа, принадлежащие субъектам-службам, а не пользователям рабочей области. Сведения о создании маркеров для субъектов-служб см. в разделе "Управление маркерами" для субъекта-службы.
Процедура подключения к Workbench/J
Чтобы подключиться к Workbench/J, выполните следующие действия:
- Запустите SQL Workbench/J.
- Выберите Файл > Окно подключения.
- В диалоговом окне Выбор профиля подключения щелкните Управление драйверами.
- В поле Имя введите
Databricks
. - В поле "Библиотека" щелкните значок "Выбрать JAR-файлы". Перейдите в каталог, в котором вы извлекли
DatabricksJDBC42.jar
файл из скачаемогоDatabricksJDBC42-<version>.zip
файла, и выберите JAR-файл. Затем нажмите кнопку " Выбрать". - Убедитесь, что поле "Имя класса" заполнено
com.databricks.client.jdbc.Driver
. - Щелкните OK.
- В поле Имя введите
- Щелкните значок создания профиля подключения.
- Введите имя профиля.
- В поле "Драйвер" выберите Databricks (com.databricks.client.jdbc.Driver).
- В поле URL-адреса введите URL-адрес JDBC для ресурса Azure Databricks. Синтаксис поля URL-адреса для URL-адресов JDBC см. в параметрах проверки подлинности драйвера JDBC Databricks.
- Щелкните Тест.
- Дважды нажмите кнопку ОК .