JDBC драйвер#
Пользователи CedrusData могут использовать оригинальный JDBC драйвер Trino для подключения к кластеру из Java-приложений и программ, которые поддерживают JDBC.
Ниже приведена документация JDBC драйвера Trino.
Требования#
JDBC драйвер Trino требует Java версии 8 и выше.
Все пользователи, которые подключаются к CedrusData через JDBC драйвер, должны иметь доступ на чтение к схеме
system.jdbc.
Установка#
JDBC драйвер Trino представляет собой JAR-файл, который вы можете скачать из
Maven Central
или получить из архива CedrusData из директории jdbc/.
После получения JDBC драйвера, добавьте его в ваше приложение. Процедура регистрации зависит от приложения. Если вы регистрируете драйвер в стороннем приложении (например, Apache Superset или Tableau), вам необходимо следовать инструкции по установке JDBC драйверов для данного приложения.
Если вы разрабатываете собственное Java-приложение, вам необходимо добавить JAR файл в classpath. Например, если вы используете систему сборки Maven, добавьте следующую зависимость к своему проекту:
<dependency>
<groupId>io.trino</groupId>
<artifactId>trino-jdbc</artifactId>
<version>406</version>
</dependency>
Подключение#
После того, как JDBC драйвер зарегистрирован в приложении, вы можете использовать его для подключения к CedrusData.
JDBC драйвер Trino поддерживает следующие форматы URL, где host:port это адрес coordinator узла:
jdbc:trino://host:port
jdbc:trino://host:port/catalog
jdbc:trino://host:port/catalog/schema
Вы можете указать в URL дополнительные параметры конфигурации в формате key=value. Полный список доступных
параметров конфигурации приведен ниже.
jdbc:trino://host:port?key1=value2&key2=value2
jdbc:trino://host:port/catalog?key1=value2&key2=value2
jdbc:trino://host:port/catalog/schema?key1=value2&key2=value2
JDBC драйвер Trino требует, что бы при подключении всегда было указано имя пользователя, даже если безопасность CedrusData отключена. В противном случае вы получите следующую ошибку:
Authentication failed: Basic authentication or X-Trino-User must be sent
Ниже приведен пример Java-кода для подключения к coordinator узлу, запущенному на локальном компьютере на порту
8080, с использованием каталога tpch и схемы sf1 по умолчанию:
// Передача параметров через объект Properties.
String url = "jdbc:trino://localhost:8080/tpch/sf1";
Properties properties = new Properties();
properties.setProperty("user", "test");
Connection connection = DriverManager.getConnection(url, properties);
// Передача параметров через URL.
String url = "jdbc:trino://localhost:8080/tpch/sf1?user=test";
Connection connection = DriverManager.getConnection(url);
Примечание
Современные приложения обычно не требуют имя класса JDBC драйвера. Если ваше приложение запрашивает имя класса JDBC
драйвера, используйте io.trino.jdbc.TrinoDriver.
Параметры подключения#
Общие параметры#
Имя |
Описание |
|---|---|
|
Имя пользователя СedrusData. Если безопасность CedrusData отключена, необходимо предоставить произвольное непустое значение. |
|
Пароль пользователя СedrusData. |
|
Имя пользователя сессии для имперсонации. |
|
Адрес HTTP proxy в формате |
|
Адрес SOCKS proxy в формате |
|
Дополнительная информация о клиенте. |
|
Теги клиента для выбор групп ресурсов. Например: |
|
Токен трассировки для сопоставления запросов между системами. |
|
Имя источника запроса к CedrusData. Данный параметр имеет приоритет
перед |
|
Префикс, который будет добавлен к свойству |
|
Токен доступа для JWT. |
|
Extra credentials для подключения к источникам данных. Представляет собой список
пар ключ-значение. Например, строка |
|
Роли авторизации для работы с каталогами CedrusData. Представляет собой список
пар ключ-значение в формате |
|
Параметры сессии SQL запросов CedrusData. Представляет собой список
пар ключ-значение. Например, |
|
Установите в |
|
Позволяет переиспользовать внешние токены аутентификации между несколькими JDBC подключениями
одного и того же пользователя до тех пора, пока не произойдет инвалидация токена (например,
при перезапуске клиента). Допустимые значения: |
|
Отключить компрессию передаваемых данных. |
|
Когда параметр включен, паттерны имен, передаваемые в методы |
Параметры SSL#
Имя |
Описание |
|---|---|
|
Использовать TLS/HTTPS для подключения. |
|
Имя метода TLS верификации. Допустимые значения: |
|
Путь к файлу PEM или JKS, который содержит доверенный сертификат для подключения к кластеру CedrusData. Используйте данный параметр только при подключении к кластеру CedrusData в котором включена certificate authentication. |
|
Пароль KeyStore (при наличии). |
|
Тип KeyStore. Значение по умолчанию равно значению параметра Java |
|
Путь к файлу TrustStore для проверки серверных HTTPS сертификатов. |
|
Пароль к файлу TrustStore. |
|
Тип TrustStore. Значение по умолчанию равно значению параметра Java |
|
Автоматически использовать системный TrustStore операционной системы.
Для Windows используется TrustStore |
Параметры Kerberos#
Имя |
Описание |
|---|---|
|
Kerberos service name координатора CedrusData. Данный параметр необходим для аутентификации Kerberos. |
|
Principal, который будет использован для аутентификации в координаторе CedrusData. |
|
Использовать канонический hostname координатора CedrusData для Kerberos service principal путем преобразования текущего hostname в IP-адрес и последующего обратного DNS lookup для этого IP адреса. Включено по умолчанию. |
|
Kerberos service principal паттерн координатора CedrusData. Значение по
умолчанию |
|
Путь к файлу конфигурации Kerberos. |
|
Путь к keytab файлу Kerberos. |
|
Путь к Kerberos credential cache. |
|
Установите значение |