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>\libLinux:
~/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.