Udostępnij za pośrednictwem

Sterownik JDBC usługi Databricks

Uwaga

Kod źródłowy sterownika JDBC usługi Databricks jest publicznie dostępny w ramach licencji apache 2.0.

Odzwierciedla to zaangażowanie usługi Databricks w zakresie przejrzystości, współpracy i możliwości tworzenia aplikacji opartych na społeczności. Udziały deweloperów, użytkowników i społeczności są mile widziane. Aby rozpocząć pracę, zapoznaj się z Wytycznymi dotyczącymi współtworzenia.

Sterownik JDBC usługi Databricks umożliwia łączenie narzędzi, takich jak DataGrip, DBeaver i SQL Workbench/J z usługą Azure Databricks za pośrednictwem usługi Java Database Connectivity (JDBC), standardowej specyfikacji branżowej na potrzeby uzyskiwania dostępu do systemów zarządzania bazami danych.

Ten sterownik zaimplementował interfejsy API JDBC i zapewnia podstawowe funkcje, w tym OAuth, Cloud Fetch oraz takie funkcje jak ingestia woluminów w Unity Catalog. Uruchamia natywny tryb zapytań i obsługuje natywne zapytania sparametryzowane i może działać przy użyciu interfejsu API do wykonywania instrukcji, co zapewnia funkcję przechowywania korzystnych wyników zapytań, lub przy użyciu Thrift.

Uwaga

W systemach operacyjnych IBM AIX format wyniku apache Arrow nie jest obsługiwany. Ponieważ Cloud Fetch opiera się na Arrow, funkcja ta również nie jest obsługiwana w systemie AIX. Aby uniknąć błędów podczas wykonywania sql, wyłącz strzałkę, ustawiając właściwość połączenia JDBC: EnableArrow=0

Ten artykuł zawiera informacje na temat instalowania i używania sterownika JDBC usługi Databricks w wersji 3 lub nowszej. Aby uzyskać informacje o sterowniku JDBC usługi Databricks (Simba), poniżej wersji 3, zobacz Simba JDBC Driver (starsza wersja).

Wymagania

Aby móc korzystać ze sterownika JDBC usługi Databricks, należy spełnić następujące wymagania:

  • Środowisko uruchomieniowe Java (JRE) w wersji 11.0 lub nowszej. Testowanie CI jest obsługiwane w JRE 11, 17 i 21.

Dedykowana gałąź JDK 8 jest dostępna dla użytkowników, którzy wymagają zgodności z językiem Java 8. Użytkownicy mogą w razie potrzeby utworzyć plik JAR z tej gałęzi. Ta gałąź jest okresowo synchronizowana z gałęzią główną, ale wkład społeczności jest mile widziany, aby była aktualizowana. Zobacz Gałąź sterownika JDBC JDK 8 usługi Databricks.

Uwaga

Sterowniki w wersji 3.2.1 lub nowszej mogą powodować błędy środowiska uruchomieniowego z zestawem JDK 16 lub nowszym ze względu na zmianę zestawu JDK, która ma wpływ na bibliotekę Apache Arrow. Aby uniknąć tych błędów, uruchom ponownie aplikację lub sterownik przy użyciu następującej opcji JVM:

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

Instalowanie sterownika

Sterownik JDBC usługi Databricks jest publikowany w repozytorium Maven.

Aby zainstalować sterownik, możesz wykonać dowolną z następujących czynności:

  • W przypadku projektów Maven dodaj następującą zależność do pliku projektu pom.xml , aby poinstruować narzędzie Maven, aby automatycznie pobrać sterownik JDBC z określoną wersją:

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

  • W przypadku projektów Gradle dodaj następującą zależność do pliku kompilacji projektu, aby poinstruować narzędzie Gradle o automatycznym pobraniu sterownika JDBC z określoną wersją:

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

Aby wyświetlić składnię zależności dla innych typów projektów i uzyskać najnowszy numer wersji sterownika JDBC usługi Databricks, zobacz repozytorium Maven.

Następne kroki

Dodatkowe zasoby

  • Last updated on