Bagikan melalui

Databricks JDBC Driver

Nota

Kode sumber Driver Databricks JDBC tersedia untuk umum di bawah lisensi Apache 2.0.

Hal ini mencerminkan komitmen Databricks terhadap transparansi, kolaborasi, dan kekuatan pengembangan berbasis komunitas. Kontribusi dari pengembang, pengguna, dan komunitas dipersilakan. Untuk memulai, lihat Panduan Kontribusi.

Driver Databricks JDBC memungkinkan Anda menyambungkan alat seperti DataGrip, DBeaver, dan SQL Workbench/J ke Azure Databricks melalui Java Database Connectivity (JDBC), spesifikasi standar industri untuk mengakses sistem manajemen database.

Driver ini telah menerapkan API JDBC dan menyediakan fungsionalitas inti termasuk OAuth, Cloud Fetch, dan fitur seperti penyerapan volume Unity Catalog. Ini menjalankan mode kueri asli dan mendukung kueri berparameter asli, serta dapat berjalan menggunakan API Eksekusi Pernyataan, yang menyediakan fitur penyimpanan hasil kueri yang bermanfaat, atau Thrift.

Nota

Pada sistem operasi IBM AIX, format hasil Apache Arrow tidak didukung. Karena Cloud Fetch mengandalkan Arrow, Cloud Fetch juga tidak didukung di AIX. Untuk menghindari kesalahan selama eksekusi SQL, nonaktifkan Panah dengan mengatur properti koneksi JDBC: EnableArrow=0

Artikel ini menyediakan informasi tentang menginstal dan menggunakan Driver Databricks JDBC, versi 3 ke atas. Untuk informasi tentang Driver Databricks JDBC (Simba), di bawah versi 3, lihat Driver JDBC Databricks (Simba).

Persyaratan

Untuk menggunakan Driver Databricks JDBC, persyaratan berikut harus dipenuhi:

  • Java Runtime Environment (JRE) 11.0 atau lebih tinggi. Pengujian CI didukung pada JRE 11, 17, dan 21.

Cabang JDK 8 khusus tersedia untuk pengguna yang memerlukan kompatibilitas dengan Java 8. Pengguna dapat membangun JAR dari cabang ini sesuai kebutuhan. Cabang ini disinkronkan dengan cabang utama secara berkala, tetapi kontribusi komunitas dipersilakan untuk terus memperbaruinya. Lihat Driver Databricks JDBC cabang JDK 8.

Nota

Sebagai akibat dari perubahan JDK 16 yang menyebabkan masalah kompatibilitas dengan pustaka Apache Arrow yang digunakan oleh driver JDBC, kesalahan runtime dapat terjadi saat menggunakan driver JDBC dengan JDK 16 atau lebih tinggi. Untuk mencegah kesalahan ini, mulai ulang aplikasi atau driver Anda menggunakan opsi perintah JVM berikut:

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

Pasang driver

Driver Databricks JDBC diterbitkan di Repositori Maven.

Untuk menginstal driver, Anda dapat melakukan salah satu hal berikut:

  • Untuk proyek Maven, tambahkan dependensi berikut ke file proyek pom.xml untuk menginstruksikan Maven mengunduh driver JDBC secara otomatis dengan versi yang ditentukan:

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

  • Untuk proyek Gradle, tambahkan dependensi berikut ke file build proyek untuk menginstruksikan Gradle mengunduh driver JDBC secara otomatis dengan versi yang ditentukan:

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

Untuk melihat sintaks dependensi untuk jenis proyek lain, dan untuk mendapatkan nomor versi terbaru Driver Databricks JDBC, lihat Repositori Maven.

Langkah berikutnya

Sumber daya tambahan

  • Last updated on