Trino JDBC-Treiber

Hinweis

Azure HDInsight on AKS wird am 31. Januar 2025 eingestellt. Vor dem 31. Januar 2025 müssen Sie Ihre Workloads zu Microsoft Fabric oder einem gleichwertigen Azure-Produkt migrieren, um eine abruptes Beendigung Ihrer Workloads zu vermeiden. Die verbleibenden Cluster in Ihrem Abonnement werden beendet und vom Host entfernt.

Bis zum Einstellungsdatum ist nur grundlegende Unterstützung verfügbar.

Wichtig

Diese Funktion steht derzeit als Vorschau zur Verfügung. Die zusätzlichen Nutzungsbedingungen für Microsoft Azure-Vorschauen enthalten weitere rechtliche Bestimmungen, die für Azure-Features in Betaversionen, in Vorschauversionen oder anderen Versionen gelten, die noch nicht allgemein verfügbar gemacht wurden. Informationen zu dieser spezifischen Vorschau finden Sie unter Informationen zur Vorschau von Azure HDInsight on AKS. Bei Fragen oder Funktionsvorschlägen senden Sie eine Anfrage an AskHDInsight mit den entsprechenden Details, und folgen Sie uns für weitere Updates in der Azure HDInsight-Community.

Trino mit HDInsight on AKS bietet einen JDBC-Treiber, der die Microsoft Entra-Authentifizierung unterstützt und einige wenige Parameter hinzufügt.

Installieren

Die JAR-Datei des JDBC-Treibers ist im Trino-Befehlszeilenschnittstellenpaket enthalten. Informationen zum Installieren der Trino-Befehlszeilenschnittstelle für HDInsight on AKS finden Sie hier. Falls die Befehlszeilenschnittstelle bereits installiert ist, finden Sie sie in Ihrem Dateisystem unter folgendem Pfad:

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

Linux: ~/lib/trino-cli

Authentifizierung

Der Trino-JDBC-Treiber unterstützt verschiedene Methoden der Microsoft Entra-Authentifizierung. In der folgenden Tabelle werden die wichtigen Parameter und Authentifizierungsmethoden beschrieben. Weitere Informationen finden Sie unter Authentifizierung.

Parameter	Bedeutung	Erforderlich	Beschreibung
auth	Name der Authentifizierungsmethode	Nein	Bestimmt, wie Benutzeranmeldeinformationen bereitgestellt werden. Ohne Angabe dieses Parameters wird AzureDefault verwendet.
azureClient	Client-ID des Dienstprinzipals/der Anwendung	Ja für AzureClientSecret, AzureClientCertificate
azureTenant	Microsoft Entra-Mandanten-ID	Ja für AzureClientSecret, AzureClientCertificate
azureCertificatePath	Dateipfad zum Zertifikat	Ja für AzureClientCertificate	Pfad zur PFX-/PEM-Datei mit Zertifikat
azureUseTokenCache	Gibt an, ob der Tokencache verwendet werden soll.	Nein	Wird der Parameter angegeben, wird das Zugriffstoken zwischengespeichert und in den Modi AzureDefault, AzureInteractive, AzureDeviceCode wiederverwendet.
azureScope	Tokenbereich	Nein	Microsoft Entra-Bereichszeichenfolge zum Anfordern eines Tokens
password	Geheimer Clientschlüssel für Dienstprinzipal	Ja für AzureClientSecret	Geheimnis/Kennwort für den Dienstprinzipal bei Verwendung des Modus AzureClientSecret
accessToken	JWT-Zugriffstoken	Nein	Wenn das Zugriffstoken extern abgerufen wurde, kann es mithilfe dieses Parameters bereitgestellt werden. In diesem Fall ist der Parameter auth nicht zulässig.

Beispiel: Verbindungszeichenfolgen

Beschreibung	Verbindungszeichenfolge für JDBC
AzureDefault	jdbc:trino://cluster1.pool1.region1.projecthilo.net
Interaktive Browserauthentifizierung	jdbc:trino://cluster1.pool1.region1.projecthilo.net?auth=AzureInteractive
Verwenden des Tokencache	jdbc:trino://cluster1.pool1.region1.projecthilo.net?auth=AzureInteractive&azureUseTokenCache=true
Dienstprinzipal mit Geheimnis	jdbc:trino://cluster1.pool1.region1.projecthilo.net?auth=AzureClientSecret&azureTenant=11111111-1111-1111-1111-111111111111&azureClient=11111111-1111-1111-1111-111111111111&password=placeholder

Verwenden des JDBC-Treibers in Java-Code

Suchen Sie die JDBC-JAR-Datei, und installieren Sie sie im lokalen Maven-Repository:

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

Laden Sie Java-Beispielcode, der über JDBC eine Verbindung mit Trino herstellt, herunter, und entpacken Sie ihn. Details und Beispiele finden Sie in „README.md“.

Verwenden des Open-Source-basierten Trino-JDBC-Treibers

Sie können das Zugriffstoken auch extern abrufen und an den Open-Source-basierten Trino-JDBC-Treiber übergeben. Java-Beispielcode mit dieser Authentifizierung finden Sie im Abschnitt zur Verwendung des JDBC-Treibers in Java-Code.