Bagikan melalui

Pengaturan fitur driver untuk Driver ODBC Databricks (Simba)

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 mengunggah hasilnya ke lokasi penyimpanan DBFS internal sebagai file Arrow yang telah diserialisasi dengan ukuran hingga 20 MB. Setelah kueri selesai, driver mengirim permintaan pengambilan, dan Azure Databricks mengembalikan tanda tangan akses bersama ke file yang diunggah. Driver kemudian menggunakan URL ini untuk mengunduh hasil langsung dari DBFS.

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 menghapus file sampah yang terakumulasi, menandainya untuk dihapus setelah 24 jam dan menghapusnya secara permanen setelah 24 jam tambahan.

Untuk mempelajari lebih lanjut tentang arsitektur Cloud Fetch, lihat Bagaimana Kami Mencapai Konektivitas Bandwidth Tinggi Dengan Alat BI.

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 Mengonfigurasi Opsi Pengelogan di Mesin Non-Windows di Panduan Driver ODBC Databricks.

  • Last updated on