Compartir vía


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.