Драйвер JDBC Trino
Внимание
Эта функция в настоящее время доступна для предварительного ознакомления. Дополнительные условия использования для предварительных версий Microsoft Azure включают более юридические термины, применимые к функциям Azure, которые находятся в бета-версии, в предварительной версии или в противном случае еще не выпущены в общую доступность. Сведения об этой конкретной предварительной версии см. в статье Azure HDInsight в предварительной версии AKS. Для вопросов или предложений функций отправьте запрос на AskHDInsight с подробными сведениями и следуйте за нами для получения дополнительных обновлений в сообществе Azure HDInsight.
Trino с HDInsight в AKS предоставляет драйвер JDBC, который поддерживает проверку подлинности Microsoft Entra и добавляет для него несколько параметров.
Установка
Jar-файл драйвера JDBC включен в пакет Trino CLI, установите Trino CLI для HDInsight в AKS. Если интерфейс командной строки уже установлен, его можно найти в файловой системе по следующему пути:
Windows:
C:\Program Files (x86)\Microsoft SDKs\Azure\TrinoCli-<version>\libLinux:
~/lib/trino-cli
Проверка подлинности
Драйвер Trino JDBC поддерживает различные методы проверки подлинности Microsoft Entra. В следующей таблице описываются важные параметры и методы проверки подлинности. Дополнительные сведения см. в разделе Authenticate to the Speech API (Аутентификация в API речи).
| Параметр | Значение | Обязательное поле | Описание |
|---|---|---|---|
| auth | Имя метода проверки подлинности | No | Определяет, как предоставляются учетные данные пользователя. Если параметр не указан, используется AzureDefault. |
| azureClient | Идентификатор клиента субъекта-службы или приложения | Да для AzureClientSecret, AzureClientCertificate. |
|
| azureTenant | Идентификатор клиента Microsoft Entra | Да для AzureClientSecret, AzureClientCertificate. |
|
| azureCertificatePath | Путь к файлу к сертификату | Да для AzureClientCertificate. |
Путь к pfx/pem-файлу с сертификатом. |
| azureUseTokenCache | Использование кэша маркеров или нет | No | Если он указан, маркер доступа кэшируется и повторно используется в AzureDefault, AzureInteractive, AzureDeviceCode режимах. |
| azureScope | Область действия маркера | No | Строка Microsoft Entra область запрашивать маркер. |
| password | Секрет клиента для субъекта-службы | Да для AzureClientSecret. |
Секрет или пароль для субъекта-службы при использовании AzureClientSecret режима. |
| accessToken | Маркер доступа JWT | No | Если маркер доступа получен вневне, его можно указать с помощью этого параметра. В этом случае auth параметр не разрешен. |
Пример — строка подключения
| Description | Строка подключения 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.