Pengaturan kemampuan driver untuk Driver ODBC Databricks

Halaman ini menjelaskan cara mengonfigurasi pengaturan kemampuan driver khusus dan tingkat lanjut untuk Driver ODBC Databricks.

Driver ODBC Databricks menyediakan pengaturan kemampuan driver khusus dan tingkat lanjut berikut.

Mengatur skema awal di ODBC

Driver ODBC memungkinkan Anda menentukan skema dengan mengatur Schema=<schema-name> sebagai konfigurasi koneksi. ini setara dengan menjalankan USE <schema-name>.

Tag query untuk pelacakan

Penting

Fitur ini ada di Pratinjau Privat. Untuk meminta akses, hubungi tim akun Anda.

Lampirkan tag kunci-nilai ke kueri SQL Anda untuk tujuan pelacakan dan analitik. Tag kueri muncul dalam system.query.history tabel untuk identifikasi dan analisis kueri.

Untuk menambahkan tag kueri ke koneksi Anda, sertakan ssp_query_tags parameter dalam konfigurasi koneksi ODBC Anda:

Tentukan tag kueri sebagai pasangan nilai kunci yang dipisahkan koma, di mana setiap kunci dan nilai dipisahkan oleh titik dua. Contohnya, ssp_query_tags=team:engineering,env:prod.

Dukungan kueri ANSI SQL-92 di ODBC

Driver Spark ODBC warisan menerima kueri SQL dalam dialek ANSI SQL-92 dan menerjemahkannya ke Databricks SQL sebelum mengirimkannya ke server.

Jika aplikasi Anda menghasilkan Databricks SQL secara langsung atau menggunakan sintaks non-ANSI SQL-92 khusus untuk Azure Databricks, atur UseNativeQuery=1 dalam konfigurasi koneksi Anda. Pengaturan ini meneruskan kueri SQL verbatim ke Azure Databricks tanpa terjemahan.

Mengekstrak hasil kueri besar di ODBC

Untuk mencapai performa terbaik saat Anda mengekstrak hasil kueri besar, gunakan versi terbaru driver ODBC, yang mencakup pengoptimalan berikut.

Serialisasi panah di ODBC

Driver ODBC versi 2.6.15 ke atas mendukung format serialisasi hasil kueri yang dioptimalkan yang menggunakan Apache Arrow.

Pengambilan Cloud di ODBC

Driver ODBC versi 2.6.17 ke atas mendukung Cloud Fetch, kemampuan yang mengambil hasil kueri melalui penyimpanan cloud yang dikonfigurasi dalam penyebaran Azure Databricks Anda.

Saat Anda menjalankan kueri, Azure Databricks menyimpan hasilnya di penyimpanan cloud ruang kerja Anda sebagai file berseri Panah hingga 20 MB. Setelah kueri selesai, driver mengirim permintaan pengambilan, dan Azure Databricks mengembalikan URL shared access signature (SAS) ke file hasil. Driver kemudian menggunakan URL ini untuk mengunduh hasil langsung dari penyimpanan Azure.

Cloud Fetch hanya berlaku untuk hasil kueri yang lebih besar dari 1 MB. Driver mengambil hasil yang lebih kecil langsung dari Azure Databricks.

Azure Databricks secara otomatis mengumpulkan akumulasi file dengan menandainya untuk dihapus setelah 24 jam dan menghapusnya secara permanen 24 jam kemudian.

Prasyarat jaringan

Jika jaringan Anda bersifat privat, Anda harus mengonfigurasi pengaturan berikut agar Cloud Fetch berfungsi:

• Izinkan *.blob.core.windows.net dan *.store.core.windows.net di lingkungan jaringan Anda.
• Tambahkan unduhan dan pencabutan sertifikat yang diperlukan ke daftar izinkan Anda.
• Jika dukungan firewall diaktifkan di akun penyimpanan ruang kerja Azure Databricks Anda, konfigurasikan gateway data jaringan virtual atau gateway data lokal untuk mengizinkan akses privat ke akun penyimpanan.

Untuk menonaktifkan Cloud Fetch, atur EnableQueryResultDownload=0 dalam konfigurasi koneksi Anda.

Mendiagnosis pengunduhan lambat

Atur LogLevel ke 4 (INFO) dan LogPath ke jalur lengkap folder log untuk melihat metrik kecepatan unduhan Cloud Fetch. Kecepatan pengunduhan log driver per gugus, sehingga kumpulan hasil besar menghasilkan beberapa baris log. Driver juga mencatat peringatan ketika kecepatan berada di bawah sekitar 1 MB/dtk. Fitur ini tersedia dalam versi driver ODBC yang dirilis setelah November 2025.

Jika unduhan lambat atau terhenti, token SAS dapat kedaluwarsa sebelum driver selesai mengunduh semua file hasil. Periksa pembatasan bandwidth atau kemacetan jaringan antara klien dan Azure Blob Storage.

Aktifkan pencatatan log

Untuk mengaktifkan pencatatan di driver ODBC, atur LogLevel properti ke nilai antara 1 (peristiwa parah saja) dan 6 (semua aktivitas driver). Atur LogPath properti ke jalur lengkap folder tempat Anda ingin menyimpan file log.

Untuk informasi selengkapnya, lihat Konfigurasi Opsi Pengelogan di Mesin non-Windows di Panduan Driver ODBC Databricks.