Databricks OSS ODBC Driver

Important

Driver ODBC OSS Databricks, versi 0.5.0, berstatus Beta. Untuk informasi tentang driver versi 2.x yang tersedia secara umum, lihat dokumentasi Driver ODBC Databricks.

Untuk melaporkan masalah atau meminta fitur saat driver masih dalam tahap Beta, hubungi tim akun Databricks Anda.

Databricks OSS ODBC Driver adalah driver ODBC 3.8 untuk Databricks SQL dan gudang data Lakehouse//RT. Perangkat ini dirancang sebagai pengganti kompatibel untuk Databricks ODBC Driver versi 2.x untuk beban kerja yang didukung. Aplikasi, DSN, dan string koneksi yang sudah ada dan menggunakan fungsionalitas umum 2.x umumnya tetap berfungsi tanpa perubahan.

Requirements

Databricks OSS ODBC Driver dan Databricks ODBC Driver versi 2.x menggunakan nama driver ODBC yang terdaftar, pengenal paket, jalur instalasi, dan nama pustaka yang sama. Menginstal satu versi di atas versi lainnya akan menggantikan instalasi yang sudah ada. Untuk mengganti driver, instal ulang paket untuk versi yang ingin Anda gunakan.

Driver ODBC Databricks OSS didukung di platform berikut:

Sistem operasi	Paket dan arsitektur	Requirement
Windows	MSI untuk x64 dan x86	Arsitektur driver harus sesuai dengan arsitektur aplikasi.
macOS	Universal .pkg untuk silikon Intel dan Apple	macOS 13.3 atau versi lebih baru.
Linux	.deb dan .rpm untuk x86_64, aarch64, dan i686	glibc 2.28 atau yang lebih baru dan manajer driver ODBC yang kompatibel.

Anda juga memerlukan Server Hostname dan HTTP Path untuk Databricks SQL atau gudang data Lakehouse//RT. Lihat Dapatkan detail koneksi untuk sumber daya komputasi Azure Databricks.

Instal driver ODBC OSS Databricks

1. Di arsip Databricks OSS ODBC Driver, unduh Databricks OSS ODBC Driver versi 0.5.0 untuk sistem operasi dan arsitektur Anda.
2. Instal paket yang diunduh:

   • Pada Windows, ekstrak file yang diunduh dan jalankan MSI 32-bit atau 64-bit. Penginstal mendaftarkan Databricks ODBC Driver dengan Windows ODBC Driver Manager.

   • Di macOS, jalankan DatabricksODBC-<version>-macOS.pkg.

   • Di Linux, instal paket .deb atau .rpm dan daftarkan driver ke unixODBC:

     sudo odbcinst -i -d -f /opt/databricks/databricksodbc/Setup/odbcinst.ini
     

Library driver diinstal di lokasi yang sama dengan versi 2.x:

• Windows 64-bit:C:\Program Files\Databricks ODBC Driver\lib\databricksodbc64.dll
• Windows 32-bit:C:\Program Files (x86)\Databricks ODBC Driver\lib\databricksodbc32.dll
• macOS: /Library/databricks/databricksodbc/lib/libdatabricksodbc.dylib
• Linux 64-bit: /opt/databricks/databricksodbc/lib/64/libdatabricksodbc64.so
• Linux 32-bit: /opt/databricks/databricksodbc/lib/32/libdatabricksodbc32.so

Konfigurasikan koneksi

Mulailah dengan DSN 2.x atau string koneksi yang sudah ada. Properti umum seperti Driver, Host, Port, HTTPPath, SSL, Catalog, , dan Schema kompatibel. Driver juga menerima properti 2.x umum yang tidak diperlukan pada transport HTTP sehingga DSN yang sudah ada dapat digunakan kembali.

Untuk membuat DSN atau string koneksi tanpa DSN dengan pengaturan ini, lihat Membuat DSN ODBC untuk Driver ODBC Databricks atau Membuat string koneksi tanpa DSN ODBC untuk Driver ODBC Databricks.

Untuk koneksi baru, gunakan properti seperti pada contoh berikut. Untuk DSN, masukkan pasangan kunci-nilai yang sama di pengelola driver ODBC Anda.

Contoh berikut menggunakan autentikasi pengguna-ke-mesin (U2M) OAuth. Pemisah baris disertakan untuk keterbacaan. Jangan sertakan mereka dalam string koneksi:

Driver=<path-to-driver>;
Host=<server-hostname>;
Port=443;
HTTPPath=<http-path>;
SSL=1;
AuthMech=11;
Auth_Flow=2;
Catalog=main;
Schema=default

Metode autentikasi berikut didukung:

Metode autentikasi	Properties
OAuth user-to-machine (U2M) (pengguna-ke-mesin)	AuthMech=11;Auth_Flow=2. PWD tidak diwajibkan. Penyimpanan cache token persisten diaktifkan secara bawaan. Atur EnableTokenCache=0 untuk menonaktifkannya, atau atur TokenCachePassPhrase untuk menggunakan frasa sandi saat mengenkripsi cache.
OAuth mesin-ke-mesin (M2M)	AuthMech=11;Auth_Flow=1;Auth_Client_ID=<client-id>;Auth_Client_Secret=<client-secret>.
penerusan token OAuth	AuthMech=11;Auth_Flow=0;Auth_AccessToken=<oauth-token>.
Token akses pribadi Azure Databricks	AuthMech=3;UID=token;PWD=<personal-access-token>.

Migrasi dari versi 2.x

1. Tinjau batasan yang diketahui untuk fitur yang digunakan aplikasi Anda.
2. Catat versi 2.x yang terpasang dan cadangkan DSN, string koneksi, serta file konfigurasi driver Anda.
3. Instal Driver ODBC Databricks OSS.
4. Gunakan kembali DSN atau string koneksi yang sudah ada.
5. Pengujian pembuatan koneksi, penemuan metadata, pernyataan yang disiapkan, pengikatan parameter, pembatalan, pengambilan hasil besar, dan alur kerja aplikasi representatif.

Driver Databricks OSS ODBC dapat melaporkan nama tipe Databricks yang lebih spesifik dan presisi serta skala desimal yang dideklarasikan dibandingkan 2.x. Validasi aplikasi yang membandingkan nilai metadata secara tepat.

Untuk melakukan rollback setelah mengganti instalasi, instal ulang paket 2.x yang diperlukan dan pulihkan konfigurasi yang telah dicadangkan.

Batasan yang diketahui

Batasan berikut berlaku selama driver dalam tahap Beta:

• Driver ini mendukung Databricks SQL dan warehouse Lakehouse//RT. Perangkat ini tidak mendukung komputasi serbaguna.
• SQL selalu dikirim langsung ke Azure Databricks. Driver tidak melakukan terjemahan SQL-92 yang tersedia di 2.x. UseNativeQuery diterima untuk kompatibilitas tetapi tidak mengubah perilaku.
• Eksekusi asinkron melalui SQL_ATTR_ASYNC_ENABLE dan SQLCompleteAsync tidak didukung.
• PUT, GET, dan REMOVE operasi untuk file dalam volume Unity Catalog tidak didukung.
• Parameter input biner tidak didukung.
• Array parameter, termasuk pyodbc fast_executemany dengan nilai string dan Unicode, didukung, tetapi driver mengirimkan satu permintaan eksekusi per baris.
• Hasil besar menggunakan Cloud Fetch secara otomatis dan tidak dapat dipaksa secara inline. Pengambilan hasil mendukung tipe data SQL Databricks kecuali FILE dan OBJECT. Nilai kompleks dikembalikan sebagai teks.
• Proxy HTTPS mendukung autentikasi dasar, tetapi tidak mendukung autentikasi Kerberos atau SPNEGO.
• Konfigurasi pencabutan sertifikat dan kunci privat TLS mutual terenkripsi tidak didukung.
• Beberapa properti 2.x lanjutan tidak didukung. Driver mencatat peringatan ketika properti tidak diterapkan.