Controlador JDBC de Trino

Nota:

Retiraremos Azure HDInsight en AKS el 31 de enero de 2025. Antes del 31 de enero de 2025, deberá migrar las cargas de trabajo a Microsoft Fabric o un producto equivalente de Azure para evitar la terminación repentina de las cargas de trabajo. Los clústeres restantes de la suscripción se detendrán y quitarán del host.

Solo el soporte técnico básico estará disponible hasta la fecha de retirada.

Importante

Esta funcionalidad actualmente está en su versión preliminar. En Términos de uso complementarios para las versiones preliminares de Microsoft Azure encontrará más términos legales que se aplican a las características de Azure que están en versión beta, en versión preliminar, o que todavía no se han lanzado con disponibilidad general. Para más información sobre esta versión preliminar específica, consulte la Información de Azure HDInsight sobre la versión preliminar de AKS. Para plantear preguntas o sugerencias sobre la característica, envíe una solicitud en AskHDInsight con los detalles y síganos para obtener más actualizaciones sobre Comunidad de Azure HDInsight.

Trino con HDInsight en AKS proporciona un controlador JDBC, que admite la autenticación de Microsoft Entra y le agrega algunos parámetros.

Instalación

El archivo jar del controlador JDBC se incluye en el paquete Trino CLI, Instalar Trino CLI para HDInsight en AKS. Si la CLI ya está instalada, puede encontrarlo en el sistema de archivos en la siguiente ruta de acceso:

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

Linux: ~/lib/trino-cli

Autenticación

El controlador JDBC de Trino admite varios métodos de autenticación de Microsoft Entra. En la tabla siguiente se describen los parámetros importantes y los métodos de autenticación. Para más información, consulte Autenticación.

Parámetro	Significado	Obligatorio	Descripción
auth	Nombre del método de autenticación	No	Determina cómo se proporcionan las credenciales de usuario. Si no se especifica, usa AzureDefault.
azureClient	Identificador de cliente de la entidad de servicio o la aplicación	Sí para AzureClientSecret, AzureClientCertificate.
azureTenant	Identificador de inquilino de Microsoft Entra	Sí para AzureClientSecret, AzureClientCertificate.
azureCertificatePath	Ruta de acceso de archivo al certificado	Sí para AzureClientCertificate.	Ruta de acceso al archivo pfx/pem con el certificado.
azureUseTokenCache	Uso del caché de tokens o no	No	Si se proporciona, el token de acceso se almacena en caché y se reutiliza en AzureDefault, AzureInteractive, AzureDeviceCode modos.
azureScope	Ámbito del token	No	Cadena de ámbito de Microsoft Entra con la que solicitar un token.
password	Secreto de cliente para la entidad de servicio	Sí para AzureClientSecret.	Secreto/contraseña para la entidad de servicio al usar el modo AzureClientSecret.
accessToken	Token de acceso de JWT	No	Si el token de acceso obtenido externamente, se puede proporcionar mediante este parámetro. En este caso, no se permite auth parámetro.

Ejemplo: cadenas de conexión

Descripción	Cadena de conexión JDBC
AzureDefault	jdbc:trino://cluster1.pool1.region1.projecthilo.net
Autenticación interactiva del explorador	jdbc:trino://cluster1.pool1.region1.projecthilo.net?auth=AzureInteractive
Uso de la caché de tokens	jdbc:trino://cluster1.pool1.region1.projecthilo.net?auth=AzureInteractive&azureUseTokenCache=true
Entidad de servicio con secreto	jdbc:trino://cluster1.pool1.region1.projecthilo.net?auth=AzureClientSecret&azureTenant=11111111-1111-1111-1111-111111111111&azureClient=11111111-1111-1111-1111-111111111111&password=placeholder

Uso del controlador JDBC en código Java

Busque el archivo jar JDBC e instálelo en el repositorio local de Maven:

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

Descargue y desempaquete el código java de ejemplo que se conecta a Trino mediante JDBC. Consulte README.md incluidos para obtener más información y ejemplos.

Uso del controlador JDBC de Trino de código abierto

También puede obtener un token de acceso externamente y pasarlo al controlador Trino JDBC de código abierto. El código Java de muestra con esta autenticación se incluye en el uso del controlador JDBC en la sección de código Java.