Параметры вычислений для драйвера JDBC Databricks (Simba)

Примечание.

Эта страница относится к драйверу JDBC Simba (устаревшая версия), версиям ниже версии 3. Databricks настоятельно рекомендует перейти на драйвер JDBC Databricks для подключения JDBC . Она включает такие улучшения, как поддержка представлений метрик каталога Unity, транзакции, охватывающие несколько инструкций SQL, хранимые процедуры, более быстрое получение больших результатов и встроенная телеметрия клиента.

На этой странице описывается настройка параметров вычислительных ресурсов Azure Databricks для драйвера JDBC Databricks.

Примечание.

Драйвер JDBC не поддерживает подключение к кластерам заданий.

Обязательные параметры

Настройте следующие параметры для подключения к вычислительному ресурсу Azure Databricks:

Настройка Описание
Host Значение имени узла сервера из вычислительного ресурса Azure Databricks.
Port 443
HTTPPath Значение HTTP пути из вычислительного ресурса Azure Databricks.
SSL 1
Schema (необязательно) Имя схемы по умолчанию.
Catalog (необязательно) Имя каталога по умолчанию.

Формат URL-адреса подключения

Используйте следующий формат для URL-адреса подключения JDBC:

jdbc:databricks://<server-hostname>:443;httpPath=<http-path>[;<setting1>=<value1>;<setting2>=<value2>;<settingN>=<valueN>]

Пример Java

В следующем примере показано, как установить подключение с помощью Java:

// ...
String url = "jdbc:databricks://<server-hostname>:443";
Properties p = new java.util.Properties();
p.put("httpPath", "<http-path>");
p.put("<setting1>", "<value1>");
p.put("<setting2>", "<value2>");
p.put("<settingN>", "<valueN>");
// ...
Connection conn = DriverManager.getConnection(url, p);
// ...

Полный пример см. в разделе "Параметры проверки подлинности" для драйвера JDBC Databricks (Simba).

Замените <setting> и <value> заполнители вашими параметрами проверки подлинности и любыми параметрами возможностей драйвера.

Сведения о получении значений <server-hostname> и <http-path>см. в следующих разделах.

Чтобы получить сведения о подключении для кластера Azure Databricks :

  1. Выполните вход в рабочую область Azure Databricks.
  2. На боковой панели щелкните Вычислительная среда.
  3. В списке доступных кластеров щелкните имя целевого кластера.
  4. На вкладке "Конфигурация" разверните дополнительные параметры.
  5. Перейдите на вкладку JDBC/ODBC .
  6. Скопируйте необходимые сведения о подключении, такие как имя узла сервера, порт и путь HTTP.

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

  1. Выполните вход в рабочую область Azure Databricks.
  2. На боковой панели в разделе SQL щелкните "Хранилища SQL".
  3. В списке доступных хранилищ щелкните имя целевого хранилища.
  4. На вкладке "Сведения о подключении" скопируйте необходимые сведения о подключении, например имя узла сервера, порт и путь HTTP.

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

  • Разрешение "CAN ATTACH TO" для подключения к работающему кластеру.
  • Разрешение CAN RESTART позволяет автоматически запускать кластер, если при подключении он находится в завершенном состоянии.

Чтобы использовать драйвер с SQL-хранилищем Databricks, вызывающему пользователю или служебному субъекту требуется разрешение на использование. Если хранилище Databricks SQL было остановлено, оно запускается автоматически.

Примечание.

При использовании Microsoft Power BI в режиме DirectQuery рекомендуется использовать хранилища SQL Databricks.