Sdílet prostřednictvím

Ovladač Databricks JDBC

Poznámka:

Zdrojový kód ovladače Databricks JDBC je veřejně dostupný v rámci licence Apache 2.0.

To odráží závazek Databricks k transparentnosti, spolupráci a síle vývoje řízeného komunitou. Jsou vítány příspěvky od vývojářů, uživatelů a komunity. Pokud chcete začít, přečtěte si pokyny pro přispívání.

Ovladač Databricks JDBC umožňuje připojit nástroje, jako jsou DataGrip, DBeaver a SQL Workbench/J , k Azure Databricks prostřednictvím služby Java Database Connectivity (JDBC), standardní specifikace pro přístup k systémům pro správu databází.

Tento ovladač implementoval JDBC API rozhraní a poskytuje základní funkce, včetně OAuth, Cloud Fetch a funkcí, jako je zpracování svazků v Unity Catalog. Se spouští v nativním režimu dotazu a podporuje nativní parametrizované dotazy a lze spustit pomocí rozhraní API pro spouštění příkazů, která poskytuje výhodnou funkci uchovávání výsledků dotazu, nebo Thrift.

Poznámka:

V operačních systémech IBM AIX není formát výsledku Apache Arrow podporován. Vzhledem k tomu, že Cloud Fetch spoléhá na šipku, cloudový fetch se také v AIX nepodporuje. Pokud se chcete vyhnout chybám při provádění SQL, zakažte šipku nastavením vlastnosti připojení JDBC: EnableArrow=0

Tento článek obsahuje informace o instalaci a používání ovladače Databricks JDBC verze 3 a vyšší. Informace o ovladači Databricks JDBC (Simba) pro verze nižší než 3 najdete v tématu Databricks JDBC Driver (Simba).

Požadavky

Pokud chcete použít ovladač Databricks JDBC, musí být splněny následující požadavky:

  • Java Runtime Environment (JRE) 11.0 nebo vyšší. Testování CI se podporuje v JRE 11, 17 a 21.

Vyhrazená větev JDK 8 je dostupná pro uživatele, kteří vyžadují kompatibilitu s Javou 8. Uživatelé můžou podle potřeby vytvořit soubor JAR z této větve. Tato větev se pravidelně synchronizuje s hlavní větví, ale příspěvky komunity jsou vítány, aby se aktualizovaly. Viz větev ovladače Databricks JDBC pro JDK 8.

Poznámka:

V důsledku změny sady JDK 16, která způsobila problém s kompatibilitou s knihovnou Apache Arrow používanou ovladačem JDBC, může dojít k chybám za běhu při použití ovladače JDBC s JDK 16 nebo vyšší. Pokud chcete těmto chybám zabránit, restartujte aplikaci nebo ovladač pomocí následující možnosti příkazu JVM:

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

Instalace ovladače

Ovladač Databricks JDBC se publikuje v úložišti Maven.

Chcete-li nainstalovat ovladač, můžete provést některou z následujících věcí:

  • V případě projektů Maven přidejte do souboru projektu pom.xml následující závislost, která dává Mavenu pokyn, aby ovladač JDBC automaticky stáhl se zadanou verzí:

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

  • V případě projektů Gradle přidejte do souboru sestavení projektu následující závislost, která dá Gradle pokyn, aby ovladač JDBC automaticky stáhl se zadanou verzí:

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

Pokud chcete zobrazit syntaxi závislostí pro jiné typy projektů a získat nejnovější číslo verze ovladače Databricks JDBC, podívejte se na úložiště Maven.

Další kroky

Dodatečné zdroje

  • Last updated on