Bagikan melalui


Pengaturan kemampuan driver untuk Driver ODBC Databricks

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

Driver ODBC Datbricks menyediakan pengaturan kemampuan driver khusus dan canggih 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>.

Dukungan kueri ANSI SQL-92 di ODBC

Driver ODBC menerima SQL kueri dalam dialek ANSI SQL-92 dan menerjemahkan kueri ke dialek SQL Databricks. Namun, jika aplikasi Anda menghasilkan Databricks SQL secara langsung atau aplikasi Anda menggunakan sintaks SQL standar non-ANSI SQL-92 khusus untuk Azure Databricks, Databricks merekomendasikan agar Anda mengatur UseNativeQuery=1 sebagai konfigurasi koneksi. Dengan pengaturan itu, driver melewati kueri SQL kata demi kata ke Azure Databricks.

Mengekstrak hasil kueri besar di ODBC

Untuk mencapai performa terbaik saat Anda mengekstrak hasil kueri yang besar, gunakan versi terbaru driver ODBC yang menyertakan 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 disiapkan dalam penyebaran Azure Databricks Anda.

Hasil kueri diunggah ke lokasi penyimpanan DBFS internal sebagai file serial Arrow hingga 20 MB. Saat driver mengirimkan permintaan pengambilan setelah kueri selesai, Azure Databricks menghasilkan dan mengembalikan tanda tangan akses bersama ke file yang diunggah. Driver ODBC kemudian menggunakan URL untuk mengunduh hasilnya langsung dari DBFS.

Cloud Fetch hanya digunakan untuk hasil kueri yang lebih besar dari 1 MB. Hasil yang lebih kecil diambil langsung dari Azure Databricks.

Azure Databricks secara otomatis mengumpulkan akumulasi file yang ditandai untuk dihapus setelah 24 jam. File-file bertanda ini sepenuhnya dihapus 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 pengelogan di driver ODBC untuk Windows, atur bidang berikut di Administrator Sumber Data ODBC untuk DSN terkait:

  • Atur bidang Tingkat Log dari FATAL untuk mencatat hanya peristiwa parah melalui TRACE untuk mencatat semua aktivitas driver.
  • Atur bidang Jalur Log ke jalur lengkap ke folder tempat Anda ingin menyimpan file log.
  • Atur bidang File Nomor Maks ke jumlah maksimum file log yang akan disimpan.
  • Atur bidang Ukuran File Maks ke ukuran maksimum setiap file log dalam megabyte.

Untuk mengaktifkan pengelogan di driver ODBC untuk komputer non-Windows, atur properti berikut di string koneksi DSN atau DSN-less terkait:

  • Atur LogLevel properti dari 1 ke hanya mencatat peristiwa 6 parah untuk mencatat semua aktivitas driver.
  • Atur LogPath properti ke jalur lengkap ke folder tempat Anda ingin menyimpan file log.
  • Atur LogFileCount properti ke jumlah maksimum file log yang akan disimpan.
  • Atur LogFileSize properti ke ukuran maksimum setiap file log dalam byte.

Untuk informasi selengkapnya, lihat bagian Configuring Logging Options on Windows dan Configuring Logging Options on a Non-Windows Machine di Panduan Driver Databricks JDBC.