Driver JDBC do Trino
Observação
Desativaremos o Microsoft Azure HDInsight no AKS em 31 de janeiro de 2025. Para evitar o encerramento abrupto das suas cargas de trabalho, você precisará migrá-las para o Microsoft Fabric ou para um produto equivalente do Azure antes de 31 de janeiro de 2025. Os clusters restantes em sua assinatura serão interrompidos e removidos do host.
Somente o suporte básico estará disponível até a data de desativação.
Importante
Esse recurso está atualmente na visualização. Os Termos de uso complementares para versões prévias do Microsoft Azure incluem mais termos legais que se aplicam aos recursos do Azure que estão em versão beta, em versão prévia ou ainda não lançados em disponibilidade geral. Para obter informações sobre essa versão prévia específica, confira Informações sobre a versão prévia do Azure HDInsight no AKS. Caso tenha perguntas ou sugestões de recursos, envie uma solicitação no AskHDInsight com os detalhes e siga-nos para ver mais atualizações sobre a Comunidade do Azure HDInsight.
O Trino com HDInsight no AKS fornece o driver JDBC que dá suporte à autenticação do Microsoft Entra e adiciona alguns parâmetros para ele.
Instalar
O arquivo jar do driver JDBC está incluído no pacote da CLI do Trino, Instalar a CLI do Trino para HDInsight no AKS. Se a CLI já estiver instalada, será possível localizá-la no sistema de arquivos no seguinte caminho:
Windows:
C:\Program Files (x86)\Microsoft SDKs\Azure\TrinoCli-<version>\libLinux:
~/lib/trino-cli
Autenticação
O driver JDBC do Trino dá suporte a vários métodos de autenticação do Microsoft Entra. A tabela a seguir descreve os parâmetros e métodos de autenticação importantes. Para obter mais informações, consulte Autenticação.
| Parâmetro | Significado | Obrigatório | Descrição |
|---|---|---|---|
| auth | Nome do método de autenticação | Não | Determina como as credenciais de usuário são fornecidas. Se não for especificado, usará AzureDefault. |
| azureClient | ID de cliente da entidade de serviço/aplicativo | Sim para AzureClientSecret, AzureClientCertificate. |
|
| azureTenant | ID de locatário do Entra ID da Microsoft | Sim para AzureClientSecret, AzureClientCertificate. |
|
| azureCertificatePath | Caminho do arquivo para certificado | Sim para AzureClientCertificate. |
Caminho para o arquivo pfx/pem com certificado. |
| azureUseTokenCache | Usar cache de token ou não | Não | Se fornecido, o token de acesso será armazenado em cache e reutilizado nos modos AzureDefault, AzureInteractive, AzureDeviceCode. |
| azureScope | Escopo do token | Não | Cadeia de caracteres de escopo do Microsoft Entra para solicitar um token. |
| password | Segredo do cliente para entidade de serviço | Sim para AzureClientSecret. |
Segredo/senha para entidade de serviço ao usar o modo AzureClientSecret. |
| accessToken | Token de acesso JWT | Não | Se o token de acesso for obtido externamente, poderá ser fornecido usando esse parâmetro. Nesse caso, o parâmetro auth não será permitido. |
Exemplo – cadeias de conexão
| Descrição | Cadeia de conexão JDBC |
|---|---|
| AzureDefault | jdbc:trino://cluster1.pool1.region1.projecthilo.net |
| Autenticação interativa do navegador | jdbc:trino://cluster1.pool1.region1.projecthilo.net?auth=AzureInteractive |
| Usar cache de token | jdbc:trino://cluster1.pool1.region1.projecthilo.net?auth=AzureInteractive&azureUseTokenCache=true |
| Entidade de serviço com segredo | jdbc:trino://cluster1.pool1.region1.projecthilo.net?auth=AzureClientSecret&azureTenant=11111111-1111-1111-1111-111111111111&azureClient=11111111-1111-1111-1111-111111111111&password=placeholder |
Usando o driver JDBC no código Java
Localize o arquivo jar de JDBC e instale-o no repositório maven local:
mvn install:install-file -Dfile=<trino-jdbc-*.jar> -DgroupId=io.trino -DartifactId=trino-jdbc -Dversion=<trino-jdbc-version> -Dpackaging=jar -DgeneratePom=true
Baixar e desempacotar o exemplo de código java que se conecta ao Trino usando JDBC. Consulte o README.md incluído para obter detalhes e exemplos.
Usar o driver JDBC do Trino de código aberto
Também é possível obter o token de acesso externamente e passá-lo para o driver JDBC do Trino de código aberto, código java de exemplo com essa autenticação está incluído em usar o driver JDBC na seção de código java.