Partilhar via


Controlador Trino JDBC

Nota

Vamos desativar o Azure HDInsight no AKS em 31 de janeiro de 2025. Antes de 31 de janeiro de 2025, você precisará migrar suas cargas de trabalho para o Microsoft Fabric ou um produto equivalente do Azure para evitar o encerramento abrupto de suas cargas de trabalho. Os clusters restantes na sua subscrição serão interrompidos e removidos do anfitrião.

Apenas o apoio básico estará disponível até à data da reforma.

Importante

Esta funcionalidade está atualmente em pré-visualização. Os Termos de Utilização Suplementares para Pré-visualizações do Microsoft Azure incluem mais termos legais que se aplicam a funcionalidades do Azure que estão em versão beta, em pré-visualização ou ainda não disponibilizadas para disponibilidade geral. Para obter informações sobre essa visualização específica, consulte Informações de visualização do Azure HDInsight no AKS. Para perguntas ou sugestões de recursos, envie uma solicitação no AskHDInsight com os detalhes e siga-nos para obter mais atualizações na Comunidade do Azure HDInsight.

Trino com HDInsight no AKS fornece driver JDBC, que suporta autenticação Microsoft Entra e adiciona poucos parâmetros para ele.

Instalar

O jar do driver JDBC está incluído no pacote Trino CLI, Install Trino CLI for HDInsight on AKS. Se a CLI já estiver instalada, você poderá encontrá-la em seu sistema de arquivos no seguinte caminho:

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

Linux: ~/lib/trino-cli

Autenticação

O driver JDBC Trino suporta vários métodos de autenticação do Microsoft Entra. A tabela a seguir descreve os parâmetros importantes e os métodos de autenticação. Para obter mais informações, veja Autenticação.

Parâmetro Significado Necessário Description
autenticação Nome do método de autenticação Não Determina como as credenciais do usuário são fornecidas. Se não for especificado, usa AzureDefault.
azureClient ID do cliente da entidade de serviço/aplicativo Sim para AzureClientSecret, AzureClientCertificate.
azureTenant ID do locatário Microsoft Entra Sim para AzureClientSecret, AzureClientCertificate.
azureCertificatePath Caminho do arquivo para o 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 é armazenado em cache e reutilizado nos AzureDefault, AzureInteractive, AzureDeviceCode modos.
azureScope Escopo do token Não Cadeia de caracteres de escopo do Microsoft Entra para solicitar um token com.
password Segredo do cliente para a entidade de serviço Sim para AzureClientSecret. Segredo/senha para a entidade de serviço ao usar o AzureClientSecret modo.
accessToken Token de acesso JWT Não Se o token de acesso obtido externamente, pode ser fornecido usando este parâmetro. Neste caso, auth o parâmetro não é permitido.

Exemplo - cadeias de conexão

Description Cadeia de ligaçã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
Principal 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 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

Faça o download e descompacte o código java de exemplo que se conecta ao Trino usando JDBC. Consulte os README.md incluídos para obter detalhes e exemplos.

Usando o driver JDBC Trino de código aberto

Você também pode obter o token de acesso externamente e passá-lo para o driver JDBC Trino de código aberto, o código java de exemplo com esta autenticação está incluído no uso do driver JDBC na seção de código java.