Udostępnij przez

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ż funkcja Cloud Fetch opiera się na arrow, funkcja Cloud Fetch nie jest również 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) w wersji wcześniejszej niż 3, sprawdź Databricks JDBC Driver (Simba).

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

W wyniku zmiany zestawu JDK 16, która spowodowała problem ze zgodnością z biblioteką Apache Arrow używaną przez sterownik JDBC, błędy środowiska uruchomieniowego mogą wystąpić podczas korzystania ze sterownika JDBC z zestawem JDK 16 lub nowszym. Aby zapobiec tym błędom, uruchom ponownie aplikację lub sterownik przy użyciu następującej opcji polecenia 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.0.5</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.0.5'

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