Freigeben über

Databricks JDBC Driver

Hinweis

Der JDBC-Treiber-Quellcode von Databricks ist öffentlich unter der Apache 2.0-Lizenz verfügbar.

Dies spiegelt das Engagement von Databricks für Transparenz, Zusammenarbeit und die Kraft der communitygesteuerten Entwicklung wider. Beiträge von Entwicklern, Benutzern und der Community sind willkommen. Informationen zu den ersten Schritten finden Sie in den Beitragsrichtlinien.

Mit dem DATAbricks WORKBENCH-Treiber können Sie Tools wie DataGrip, DBeaver und SQL Workbench/J mit Azure Databricks über Java Database Connectivity (WORKBENCH) verbinden, eine branchenüblich festgelegte Spezifikation für den Zugriff auf Datenbankverwaltungssysteme.

Dieser Treiber hat die JDBC-APIs implementiert und bietet grundlegende Funktionalitäten einschließlich OAuth, Cloud Fetch und Funktionen wie die Datenaufnahme des Unity-Katalogs. Es läuft im nativen Abfragemodus und unterstützt native parametrisierte Abfragen. Außerdem kann es mit Statement Execution APIs, die die vorteilhafte Funktion zur Speicherung der Abfrageergebnisse bieten, oder mit Thrift ausgeführt werden.

Hinweis

Auf IBM AIX-Betriebssystemen wird das Apache Arrow-Ergebnisformat nicht unterstützt. Da Cloud Fetch auf Arrow basiert, wird Cloud Fetch auch auf AIX nicht unterstützt. Um Fehler während der SQL-Ausführung zu vermeiden, deaktivieren Sie Arrow, indem Sie die CONNECTION-Verbindungseigenschaft FESTLEGEN: EnableArrow=0

Dieser Artikel enthält Informationen über die Installation und Verwendung des Databricks JDBC-Treibers, Version 3 und höher. Informationen über den Databricks JDBC Driver (Simba) unterhalb Version 3 finden Sie unter Databricks JDBC Driver (Simba).

Anforderungen

Um den Databricks JDBC Driver zu verwenden, müssen die folgenden Anforderungen erfüllt sein:

  • Java Runtime Environment (JRE) 11.0 oder höher. CI-Tests werden auf JRE 11, 17 und 21 unterstützt.

Eine dedizierte JDK 8-Verzweigung ist für Benutzer verfügbar, die Kompatibilität mit Java 8 erfordern. Benutzer können nach Bedarf einen JAR aus dieser Verzweigung erstellen. Dieser Branch wird regelmäßig mit dem Haupt-Branch synchronisiert, und Community-Beiträge sind willkommen, um ihn auf dem neuesten Stand zu halten. Siehe Databricks JDBC-Treiber JDK 8 Branche.

Hinweis

Aufgrund einer Änderung in JDK 16, die ein Kompatibilitätsproblem mit der von JDBC-Treiber verwendeten Apache Arrow-Bibliothek verursacht hat, können Laufzeitfehler auftreten, wenn der JDBC-Treiber mit JDK 16 oder höher verwendet wird. Um diese Fehler zu vermeiden, starten Sie Ihre Anwendung oder Ihren Treiber mit der folgenden JVM-Befehlsoption neu.

--add-opens=java.base/java.nio=org.apache.arrow.memory.core ALL-UNNAMED

Installieren Sie den Treiber

Der Databricks JDBC-Treiber wird im Maven Repository veröffentlicht.

Um den Treiber zu installieren, verwenden Sie eine der folgenden Vorgehensweisen:

  • Fügen Sie für Maven-Projekte die folgende Abhängigkeit zur Projektdatei pom.xml hinzu, um Maven anzuweisen, den JDBC-Treiber automatisch in der angegebenen Version herunterzuladen.

    <dependency>
  <groupId>com.databricks</groupId>
  <artifactId>databricks-jdbc</artifactId>
  <version>3.0.5</version>
  <scope>runtime</scope>
</dependency>

  • Bei Gradle-Projekten fügen Sie der Builddatei des Projekts die folgende Abhängigkeit hinzu, um Gradle anzuweisen, den JDBC-Treiber mit der angegebenen Version automatisch herunterzuladen:

    implementation 'com.databricks:databricks-jdbc:3.0.5'

Informationen zum Anzeigen der Abhängigkeitssyntax für andere Projekttypen, und zum Abrufen der neuesten Versionsnummer des Databricks JDBC-Treibers finden Sie im Maven Repository.

Nächste Schritte

Weitere Ressourcen

  • Last updated on