Драйвер Trino JDBC

Статья
09/20/2024

Важный

Azure HDInsight на AKS прекращено 31 января 2025 г. Узнайте больше из этого объявления.

Необходимо перенести рабочие нагрузки в Microsoft Fabric или эквивалентный продукт Azure, чтобы избежать резкого завершения рабочих нагрузок.

Важный

Эта функция сейчас доступна в предварительной версии. Дополнительные условия использования для предварительных версий Microsoft Azure включают дополнительные юридические термины, применимые к функциям Azure, которые находятся в бета-версии, в предварительной версии или в противном случае еще не выпущены в общую доступность. Чтобы получить информацию об этой конкретной предварительной версии, см. сведения о предварительной версии Azure HDInsight на AKS. Для вопросов или предложений по функциям отправьте запрос на AskHDInsight с указанием деталей и подписывайтесь на обновления в Azure HDInsight Community.

Trino с HDInsight на AKS предоставляет драйвер JDBC, который поддерживает аутентификацию Microsoft Entra и добавляет несколько параметров для этой аутентификации.

Установить

Jar-файл драйвера JDBC включен в пакет Trino CLI, установить Trino CLI для HDInsight на AKS. Если интерфейс командной строки уже установлен, его можно найти в файловой системе по следующему пути:

Windows: C:\Program Files (x86)\Microsoft SDKs\Azure\TrinoCli-<version>\lib

Linux: ~/lib/trino-cli

Аутентификация

Драйвер Trino JDBC поддерживает различные методы проверки подлинности Microsoft Entra. В следующей таблице описываются важные параметры и методы проверки подлинности. Для получения дополнительной информации см. раздел проверки подлинности.

Параметр	Значение	Обязательно	Описание
аутентификация / авторизация	Имя метода проверки подлинности	Нет	Определяет, как предоставляются учетные данные пользователя. Если не указано, использует `AzureDefault`.
azureClient	Идентификатор клиента сервисного субъекта или приложения	Да для `AzureClientSecret, AzureClientCertificate`.
azureTenant	Идентификатор клиента Microsoft Entra	Да для `AzureClientSecret, AzureClientCertificate`.
azureCertificatePath	Путь к файлу сертификата	Да для `AzureClientCertificate`.	Путь к pfx/pem-файлу с сертификатом.
AzureИспользоватьКэшТокена	Использовать кэш токенов или нет	Нет	Если предоставлен, маркер доступа кэшируется и повторно используется в режимах `AzureDefault, AzureInteractive, AzureDeviceCode`.
azureScope	Область токена	Нет	Строка области Microsoft Entra для запроса токена с.
пароль	Секрет клиента для субъекта-службы	Да для `AzureClientSecret`.	Секрет или пароль для сервисного принципала при использовании в режиме `AzureClientSecret`.
accessToken	Маркер доступа JWT	Нет	Если маркер доступа получен вневне, его можно указать с помощью этого параметра. В этом случае параметр `auth` не разрешен.

Пример — строки подключения

Описание	Строка подключения JDBC
AzureDefault	`jdbc:trino://cluster1.pool1.region1.projecthilo.net`
Интерактивная проверка подлинности браузера	`jdbc:trino://cluster1.pool1.region1.projecthilo.net?auth=AzureInteractive`
Использование кэша токенов	`jdbc:trino://cluster1.pool1.region1.projecthilo.net?auth=AzureInteractive&azureUseTokenCache=true`
Субъект-служба с секретом	`jdbc:trino://cluster1.pool1.region1.projecthilo.net?auth=AzureClientSecret&azureTenant=11111111-1111-1111-1111-111111111111&azureClient=11111111-1111-1111-1111-111111111111&password=placeholder`

Использование драйвера JDBC в коде Java

Найдите JAR-файл JDBC и установите его в локальный репозиторий maven:

mvn install:install-file -Dfile=<trino-jdbc-*.jar> -DgroupId=io.trino -DartifactId=trino-jdbc -Dversion=<trino-jdbc-version> -Dpackaging=jar -DgeneratePom=true

Скачайте и распакуйте пример кода Java, подключающегося к Trino с помощью JDBC. Дополнительные сведения и примеры см. в README.md.

Использование драйвера JDBC с открытым исходным кодом Trino

Вы также можете внешне получить токен доступа и передать его в драйвер с открытым кодом Trino JDBC, пример кода на Java с этой аутентификацией включен в с использованием драйвера JDBC в разделе кода на Java.

Поделиться через