Properti koneksi yang didukung

Artikel ini menjelaskan properti koneksi yang didukung oleh Driver Databricks JDBC, versi 3 ke atas.

Properti autentikasi

Properti autentikasi berikut didukung oleh Driver Databricks JDBC. Untuk detail tentang mengonfigurasi setiap metode autentikasi, lihat Pengaturan autentikasi untuk Driver Databricks JDBC. Properti tidak membedakan huruf besar dan kecil.

Harta benda	Nilai standar	Deskripsi
`AuthMech`	Diperlukan	Mekanisme autentikasi, di mana `3` menentukan mekanisme adalah token akses pribadi Azure Databricks, dan `11` menentukan mekanismenya adalah token OAuth 2.0. Properti tambahan diperlukan untuk setiap mekanisme. Lihat Pengaturan autentikasi untuk Driver Databricks JDBC.
`Auth_AccessToken`	`null`	Token OAuth Azure Databricks atau JSON Web Token (JWT) dari penyedia identitas eksternal. Diperlukan ketika `Auth_Flow` adalah `0` (pass-through token). Jika Anda meneruskan token IdP eksternal, Azure Databricks menukarnya dengan token Azure Databricks menggunakan federasi token.
`Auth_Flow`	`0`	Alur autentikasi OAuth2 untuk koneksi driver. Properti ini diperlukan jika `AuthMech` adalah `11`. Nilai yang valid adalah `0` (pass-through token), `1` (kredensial klien M2M), `2` (berbasis browser U2M), dan `3` (identitas terkelola Azure).
`Auth_JWT_Alg`	`RS256`	Algoritma autentikasi JWT untuk kunci pribadi. Algoritma yang didukung adalah: RSA: RS256, RS384, RS512, PS256, PS384, PS512 dan EC: ES256, ES384, ES512
`Auth_JWT_Key_File`	`null`	Jalur ke file kunci privat (format PEM) untuk autentikasi JWT.
`Auth_JWT_Key_Passphrase`	`null`	Frase sandi untuk mendekripsi kunci privat terenkripsi.
`Auth_KID`	`null`	Pengidentifikasi Kunci (KID) diperlukan untuk autentikasi JWT. Ini wajib saat menggunakan kunci privat JWT.
`Auth_RefreshToken`	`null`	Token penyegaran OAuth2 yang digunakan untuk mengambil token akses baru.
`Auth_Scope`	`all-apis`	Cakupan autentikasi untuk alur OAuth2.
`Azure_workspace_resource_id`	`null`	ID Sumber Daya Azure ruang kerja Azure Databricks Anda. Diperlukan saat `Auth_Flow3` (identitas terkelola Azure).
`AzureTenantId`	`null`	ID penyewa Azure untuk autentikasi khusus Azure. Diperlukan saat menggunakan perwakilan layanan terkelola Azure dengan `Auth_Flow` diatur ke `1`.
`EnableOIDCDiscovery`	`1`	Jika diatur ke `1`, URL penemuan OpenID Connect akan digunakan.
`EnableTokenCache`	`1`	Jika diatur ke `1`, memungkinkan caching token OAuth untuk meningkatkan performa. Atur ke `0` untuk menolak penembolokan token untuk autentikasi U2M (`Auth_Flow=2`).
`GoogleCredentialsFile`	`null`	Jalur ke file kunci JSON untuk autentikasi akun Google Service.
`GoogleServiceAccount`	`null`	Mengaktifkan autentikasi menggunakan akun layanan Google.
`OAuth2ClientId`	`null`	ID klien OAuth2 untuk autentikasi. Diperlukan ketika `Auth_Flow` ( `1` M2M). Atur ini ke UUID perwakilan layanan atau ID Aplikasi. Untuk `Auth_Flow3` (identitas terkelola Azure), atur ini ke ID Client identitas terkelola (hanya diperlukan untuk identitas terkelola yang ditetapkan pengguna). Untuk U2M (`Auth_Flow=2`), `databricks-sql-jdbc` digunakan secara default.
`OAuth2ConnAuthAuthorizeEndpoint`	`null`	URL titik akhir otorisasi yang digunakan dalam alur OAuth2.
`OAuth2ConnAuthTokenEndpoint`	`null`	URL titik akhir token untuk alur OAuth2.
`OAuth2RedirectUrlPort`	`8020`	Port URL pengalihan OAuth2 untuk alur autentikasi berbasis browser.
`OIDCDiscoveryEndpoint`	`null`	URL penemuan OpenID Connect yang digunakan untuk mengambil konfigurasi OIDC.
`OAuth2Secret`	`null`	Nilai rahasia OAuth perwakilan layanan. Diperlukan ketika `Auth_Flow` ( `1` kredensial klien M2M).
`TokenCachePassPhrase`	`null`	Frase sandi yang digunakan untuk enkripsi cache token OAuth U2M. Diperlukan ketika `Auth_Flow` ( `2` U2M). Ini mencegah autentikasi berbasis browser berulang dengan menyimpan kredensial.
`UID`	`null`	Nama pengguna untuk autentikasi. Diperlukan ketika `AuthMech` ( `3` token akses pribadi). Atur ini ke string `token`literal .
`PWD` atau `password`	`null`	Kata sandi untuk autentikasi. Diperlukan ketika `AuthMech` ( `3` token akses pribadi). Atur ini ke nilai token akses pribadi Azure Databricks Anda.
`UseJWTAssertion`	`false`	Mengaktifkan autentikasi JWT kunci privat untuk kasus penggunaan M2M di mana autentikasi rahasia klien dibatasi.

Properti koneksi dan proksi

Properti koneksi dan proksi berikut didukung oleh Driver Databricks JDBC. Properti tidak membedakan huruf besar dan kecil.

Harta benda	Nilai standar	Deskripsi
`AsyncExecPollInterval`	`200`	Waktu dalam milidetik antara setiap polling untuk status pelaksanaan kueri secara asinkron. Asinkron mengacu pada fakta bahwa panggilan RPC yang digunakan untuk menjalankan kueri terhadap Spark bersifat asinkron. Ini tidak berarti bahwa operasi asinkron JDBC didukung.
`CFProxyAuth`	`0`	Jika diatur ke `1`, driver menggunakan pengguna dan kata sandi autentikasi proksi, yang diwakili oleh `CFProxyUID` dan `CFProxyPwd`.
`CFProxyHost`	`null`	String yang mewakili nama host proksi yang digunakan ketika `UseCFProxy` juga disetel ke `1`.
`CFProxyPort`	`null`	Bilangan bulat yang mewakili jumlah port proksi yang akan digunakan saat `UseCFProxy` juga diatur ke `1`.
`CFProxyPwd`	`null`	Sebuah string yang mewakili kata sandi yang akan digunakan untuk autentikasi proksi saat `CFProxyAuth` dan `UseCFProxy` juga disetel ke `1`.
`CFProxyUID`	`null`	String yang mewakili nama pengguna untuk digunakan dalam autentikasi proksi saat `CFProxyAuth` dan `UseCFProxy` juga diatur ke `1`.
`ConnCatalog` atau `catalog`	`SPARK`	Nama katalog default yang akan digunakan.
`ConnSchema` atau `schema`	`default`	Nama skema default yang akan digunakan. Ini dapat ditentukan baik dengan mengganti `<schema>` di URL dengan nama skema yang akan digunakan atau dengan mengatur properti `ConnSchema` ke nama skema yang akan digunakan.
`ProxyAuth`	`0`	Jika diatur ke `1`, driver menggunakan pengguna dan kata sandi autentikasi proksi, yang diwakili oleh `ProxyUID` dan `ProxyPwd`.
`ProxyHost`	`null`	String yang mewakili nama host proksi yang digunakan ketika `UseProxy` juga disetel ke `1`.
`ProxyPort`	`null`	Bilangan bulat yang mewakili jumlah port proksi yang akan digunakan saat `UseProxy` juga diatur ke `1`.
`ProxyIgnoreList`	`""` (string kosong)	Daftar host atau domain yang dipisahkan koma yang melewati proksi saat `UseProxy` diatur ke `1`. Misalnya: `localhost,127.0.0.1`.
`ProxyPwd`	`null`	Sebuah string yang mewakili kata sandi yang akan digunakan untuk autentikasi proksi saat `ProxyAuth` dan `UseProxy` juga disetel ke `1`.
`ProxyUID`	`null`	String yang mewakili nama pengguna untuk digunakan dalam autentikasi proksi saat `ProxyAuth` dan `UseProxy` juga diatur ke `1`.
`UseCFProxy`	`0`	Jika diatur ke `1`, driver akan menggunakan pengaturan penjemputan proxy cloud apabila tersedia, jika tidak, akan menggunakan proxy reguler.
`UseProxy`	`0`	Jika diatur ke `1`, driver menggunakan pengaturan proksi yang disediakan (misalnya: `ProxyAuth`, `ProxyHost`, `ProxyPort`, `ProxyPwd`, dan `ProxyUID`).
`UseSystemProxy`	`0`	Jika diatur ke `1`, driver menggunakan pengaturan proksi yang telah diatur pada tingkat sistem. Jika ada properti proksi tambahan yang diatur dalam URL koneksi, properti proksi tambahan ini mengambil alih properti yang telah ditetapkan di tingkat sistem.

Properti konfigurasi penyimpanan kepercayaan SSL

Properti konfigurasi penyimpanan kepercayaan SSL berikut didukung oleh Driver Databricks JDBC. Properti tidak membedakan huruf besar dan kecil.

Harta benda	Nilai standar	Deskripsi
`AcceptUndeterminedRevocation`	`0`	Jika diatur ke `1`, menerima sertifikat dengan status pencabutan yang tidak ditentukan saat pemeriksaan pencabutan sertifikat diaktifkan.
`AllowSelfSignedCerts`	`0`	Jika diatur ke `1`, driver memungkinkan koneksi ke server dengan sertifikat SSL yang ditandatangani sendiri.
`CheckCertRevocation`	`1`	Apakah driver memeriksa pencabutan sertifikat SSL. Atur ke `0` untuk menerima sertifikat yang dicabut.
`SSL`	`1`	Apakah konektor berkomunikasi dengan server Spark melalui soket yang diaktifkan SSL.
`SSLKeyStore`	`null`	Jalur ke file penyimpanan kunci SSL untuk autentikasi sertifikat klien. Secara default, autentikasi TLS khusus server dilakukan sehingga sertifikat klien tidak diperlukan.
`SSLKeyStorePwd`	`null`	Kata sandi untuk file penyimpanan kunci SSL.
`SSLKeyStoreType`	`JKS`	Jenis penyimpanan kunci SSL. Nilai yang valid adalah `JKS`, , `PKCS12JCEKS`, `DKS` dan `PKCS11`.
`SSLTrustStore`	`null`	Jalur ke file penyimpanan kepercayaan untuk validasi sertifikat SSL.
`SSLTrustStorePassword`	`null`	Kata sandi untuk file penyimpanan sertifikat, jika dilindungi kata sandi.
`SSLTrustStoreType`	`JKS`	Jenis toko kepercayaan, misalnya JKS atau PKCS12. Jika tidak ditentukan, driver secara default akan menggunakan penyimpanan kepercayaan JKS. Jenis yang valid adalah `JKS`, `PKCS12`, dan `BCFKS`.
`UseSystemTrustStore`	`0`	Jika diatur ke `1`, driver menggunakan penyimpanan kepercayaan default sistem untuk verifikasi sertifikat SSL.

Jenis toko sertifikat

Driver JDBC mendukung mode SSL berikut dan jenis penyimpanan kepercayaan.

Mode sertifikat yang ditandatangani sendiri

Untuk menggunakan mode sertifikat yang ditandatangani sendiri, atur properti AllowSelfSignedCerts=1koneksi . Mode ini menggunakan pabrik soket trust-all yang menerima sertifikat apa pun.

Penyimpanan kepercayaan kustom

Untuk menggunakan penyimpanan kepercayaan kustom, tentukan file penyimpanan kepercayaan kustom di SSLTrustStore properti koneksi. Penyimpanan kepercayaan ini dimuat langsung dari jalur yang ditentukan dan menggunakan sertifikat SSL untuk validasi. Ini bisa dalam format JKS, PKCS12, atau format lain yang didukung.

Anda harus menentukan properti koneksi tambahan berikut:

SSLTrustStore: Jalur ke file penyimpanan kepercayaan
SSLTrustStorePassword: Kata sandi untuk penyimpanan kepercayaan (jika diperlukan)
SSLTrustStoreType: Jenis penyimpanan sertifikat (opsional, menggunakan JKS secara default jika tidak ditentukan)

Java penyimpanan kepercayaan properti sistem

Untuk menggunakan penyimpanan kepercayaan properti sistem, atur UseSystemTrustStore=1 dan pastikan Anda tidak menentukan penyimpanan kepercayaan kustom. Sebagai gantinya, tentukan penyimpanan kepercayaan menggunakan properti sistem Java javax.net.ssl.trustStore. Properti ini diatur pada tingkat JVM menggunakan parameter -D flag, misalnya:

java -Djavax.net.ssl.trustStore=/path/to/truststore.jks -Djavax.net.ssl.trustStorePassword=changeit ...

Driver JDBC pertama-tama memeriksa properti sistem Java javax.net.ssl.trustStore. Jika diatur, ia menggunakan file trust store ini sebagai pengganti default JDK. Jika tidak ada properti sistem yang diatur, gunakan penyimpanan kepercayaan default (kacert) JDK, yang dialokasikan di $JAVA_HOME/lib/security/cacerts atau jalur serupa.

Penyimpanan kepercayaan default JDK (cacerts)

JDK dilengkapi dengan penyimpanan kepercayaan bawaan yang disebut kacert yang berisi sertifikat dari Otoritas Sertifikat terkenal, yang memungkinkan verifikasi sertifikat yang dikeluarkan oleh CA tersebut. Penyimpanan kepercayaan ini biasanya terletak di $JAVA_HOME/lib/security/cacerts dengan kata sandi default "changeit" atau "changeme".

Untuk menggunakan penyimpanan kepercayaan default JDK, atur UseSystemTrustStore=1 dan pastikan Anda tidak menentukan penyimpanan kepercayaan kustom atau penyimpanan kepercayaan properti sistem Java. Jika penyimpanan kepercayaan juga ditentukan menggunakan properti sistem Java javax.net.ssl.trustStore, penyimpanan tersebut diabaikan, yang memastikan driver hanya menggunakan sertifikat dari penyimpanan kepercayaan JDK default.

Urutan penyimpanan kepercayaan berdasarkan prioritas

Driver menggunakan urutan prioritas berikut untuk menentukan penyimpanan kepercayaan mana yang akan digunakan:

Penyimpanan kepercayaan kustom yang ditentukan dalam SSLTrustStore properti koneksi
Penyimpanan kepercayaan yang ditentukan dalam properti sistem Java javax.net.ssl.trustStore (saat UseSystemTrustStore=1)
Penyimpanan kepercayaan default JDK (cacerts)

Rekomendasi keamanan

Agar koneksi Anda tetap aman, Databricks merekomendasikan hal berikut:

Untuk lingkungan produksi:
- Jangan gunakan mode sertifikat yang ditandatangani sendiri (AllowSelfSignedCerts=1).
- Gunakan sertifikat resmi yang ditandatangani CA.
- Gunakan UseSystemTrustStore=1 kecuali Anda memerlukan bank kepercayaan kustom.
Untuk pangkalan kepercayaan kustom:
- Gunakan saat menyambungkan ke server dengan sertifikat yang tidak ada di penyimpanan kepercayaan default.
- Pastikan toko kepercayaan berisi rantai sertifikat yang lengkap.
- Lindungi file penyimpanan kepercayaan dengan izin yang sesuai.

Coba lagi properti strategi

Properti strategi ulang berikut didukung oleh Driver JDBC Databricks (OSS). Properti tidak membedakan huruf besar dan kecil.

Harta benda	Nilai standar	Deskripsi
`RateLimitRetry`	`1`	Jika diatur ke `1`, memungkinkan coba lagi pada kesalahan batas laju.
`RateLimitRetryTimeout`	`120`	Pengaturan waktu tunggu jeda batas laju dalam detik.
`TemporarilyUnavailableRetry`	`1`	Jika diatur ke `1`, memungkinkan coba lagi pada kesalahan yang tidak tersedia untuk sementara waktu.
`TemporarilyUnavailableRetryTimeout`	`900`	Batas waktu tunggu ulang untuk kesalahan yang tidak tersedia sementara, dalam hitungan detik.
`VolumeOperationRetryableHttpCode`	`408,429,500,502,503,504`	Daftar kode HTTP yang dapat dipisahkan dengan koma untuk pengambilan volume Katalog Unity.
`VolumeOperationRetryTimeout`	`15`	Batas waktu ulang untuk permintaan HTTP penyerapan volume Unity Catalog, dalam menit.

Properti manajemen performa dan koneksi

Properti manajemen performa dan koneksi berikut didukung oleh Driver JDBC Databricks (OSS). Properti tidak membedakan huruf besar dan kecil.

Harta benda	Nilai standar	Deskripsi
`CloudFetchThreadPoolSize`	`16`	Ukuran kumpulan utas untuk operasi pengambilan data cloud.
`DefaultStringColumnLength`	`255`	Jumlah maksimum karakter yang dapat dimuat dalam kolom STRING untuk pelaporan metadata.
`HttpConnectionPoolSize`	`100`	Ukuran kumpulan koneksi HTTP maksimum.
`IdleHttpConnectionExpiry`	`60`	Waktu habis koneksi HTTP yang menganggur, dalam hitungan detik.
`RowsFetchedPerBlock`	`2000000`	Jumlah maksimum baris yang dikembalikan kueri pada satu waktu. Ini hanya berlaku untuk hasil sebaris.
`SocketTimeout`	`900`	Batas waktu soket untuk operasi jaringan, dalam detik.

Properti Konfigurasi SQL

Properti konfigurasi SQL berikut didukung oleh Driver Databricks JDBC. Ini juga dijelaskan dalam parameter Konfigurasi . Properti tidak membedakan huruf besar dan kecil.

Harta benda	Nilai standar	Deskripsi
`ansi_mode`	`TRUE`	Apakah akan mengaktifkan perilaku ANSI SQL yang ketat untuk fungsi dan aturan konversi tertentu.
`enable_photon`	`TRUE`	Apakah akan mengaktifkan mesin kueri vektor Photon.
`legacy_time_parser_policy`	`EXCEPTION`	Metode yang digunakan untuk mengurai dan memformat tanggal dan tanda waktu. Nilai yang valid adalah `EXCEPTION`, `LEGACY`, dan `CORRECTED`.
`max_file_partition_bytes`	`128m`	Jumlah maksimum byte untuk dikemas ke dalam satu partisi saat membaca dari sumber berbasis file. Pengaturan dapat berupa bilangan bulat positif dan secara opsional menyertakan ukuran seperti `b` (byte), `k` atau `kb` (1024 byte).
`query_tags`	`""` (string kosong)	Daftar tag kunci-nilai yang dipisahkan koma untuk dilampirkan ke kueri SQL untuk pelacakan dan analitik di `system.query.history`.
`read_only_external_metastore`	`false`	Mengontrol apakah metastore eksternal dibuat bersifat baca-saja.
`statement_timeout`	`172800`	Mengatur batas waktu pernyataan SQL antara 0 dan 172800 detik.
`timezone`	`UTC`	Atur zona waktu lokal. ID wilayah dalam formulir `area/city`, seperti Amerika/Los_Angeles atau offset zona dalam format (+\|-)HH, (+\|-)HH:mm atau (+\|-)HH:mm:ss, misalnya -08, +01:00 atau -13:33:33. Selain itu, `UTC` didukung sebagai alias untuk +00:00
`use_cached_result`	`true`	Apakah Databricks SQL menyimpan cache dan menggunakan kembali hasil jika memungkinkan.

Pengaturan Pencatatan

Properti pengelogan berikut didukung oleh Driver Databricks JDBC. Properti tidak membedakan huruf besar dan kecil.

Harta benda	Nilai standar	Deskripsi
`LogFileCount`	`10`	Jumlah maksimum file log yang diizinkan
`LogFileSize`	`10`	Ukuran file log maksimum yang diizinkan, ditentukan dalam MB
`LogLevel`	`OFF`	Tingkat pengelogan, yang merupakan nilai 0 hingga 6: 0: Nonaktifkan semua pengelogan. 1: Aktifkan pencatatan log pada tingkat FATAL, yang mencatat peristiwa kesalahan yang sangat serius yang akan menyebabkan konektor dihentikan. 2: Aktifkan pencatatan log pada level ERROR, yang mencatat kejadian kesalahan yang mungkin masih memungkinkan konektor untuk terus berjalan. 3: Aktifkan pengelogan pada tingkat PERINGATAN, yang mencatat peristiwa yang mungkin mengakibatkan kesalahan jika tindakan tidak diambil. 4: Aktifkan pengelogan pada tingkat INFO, yang mencatat informasi umum yang menjelaskan kemajuan konektor. 5: Aktifkan pengelogan pada tingkat DEBUG, yang mencatat informasi terperinci yang berguna untuk men-debug konektor. 6: Aktifkan pengelogan pada tingkat TRACE, yang mencatat semua aktivitas konektor. Gunakan properti ini untuk mengaktifkan atau menonaktifkan pengelogan di konektor dan untuk menentukan jumlah detail yang disertakan dalam file log.
`LogPath`	Untuk menentukan jalur default untuk log, driver menggunakan nilai yang ditetapkan untuk properti sistem ini, dalam urutan prioritas ini: `user.dir` `java.io.tmpdir` Dengan kata lain, direktori saat ini adalah `.`	Jalur lengkap ke folder tempat konektor menyimpan file log saat pengelogan diaktifkan, sebagai string. Untuk memastikan bahwa URL koneksi kompatibel dengan semua aplikasi JDBC, hindari penulisan backslash (`\`) di jalur file Anda dengan mengetikkan backslash tambahan. Jika nilai `LogPath` tidak valid, konektor mengirimkan informasi yang dicatat ke aliran output standar (System.out).

Mengaktifkan dan mengonfigurasi pengelogan

Driver JDBC mendukung Simple Logging Facade untuk Java (SLF4J) dan java.util.logging (JUL) frameworks. Driver menggunakan kerangka kerja pengelogan JUL secara default.

Untuk mengaktifkan dan mengonfigurasi pengelogan untuk driver JDBC:

Aktifkan kerangka kerja pengelogan yang ingin Anda gunakan:
- Untuk pengelogan SLF4J, atur properti sistem -Dcom.databricks.jdbc.loggerImpl=SLF4JLOGGER dan berikan implementasi pengikatan SLF4J (kompatibel dengan SLF4J versi 2.0.13 ke atas) dan file konfigurasi yang sesuai di classpath.
- Untuk pengelogan JUL, atur properti sistem -Dcom.databricks.jdbc.loggerImpl=JDKLOGGER. Ini adalah default.
Atur properti LogLevel pada string koneksi ke tingkat informasi yang diinginkan untuk disertakan dalam file log.
Atur properti LogPath pada string koneksi ke jalur lengkap ke folder tempat Anda ingin menyimpan file log.

Misalnya, URL koneksi berikut memungkinkan pengelogan tingkat 6 dan menyimpan file log ke folder C:temp:
```
jdbc: databricks://localhost:11000;LogLevel=6;LogPath=C:\\temp
```
Mulai ulang aplikasi JDBC Anda dan sambungkan kembali ke server untuk menerapkan pengaturan.

Properti fitur lainnya

Properti berikut mengaktifkan fitur di Driver Databricks JDBC. Properti tidak membedakan huruf besar dan kecil.

Harta benda	Nilai standar	Deskripsi
`EnableArrow`	`1`	Mengaktifkan serialisasi Apache Arrow untuk transfer tataan hasil. Cloud Fetch mengandalkan Arrow, jadi menonaktifkan Arrow juga menonaktifkan Cloud Fetch. Atur ke `0` untuk menonaktifkan. Versi 3.3.1 ke atas mendukung Arrow dengan JDK 16 ke atas. Versi 3.2.1 ke bawah dengan JDK 16 ke atas mungkin menghasilkan kesalahan runtime. Untuk mengatasinya, mulai ulang aplikasi atau driver Anda dengan opsi `--add-opens=java.base/java.nio=org.apache.arrow.memory.core,ALL-UNNAMED`JVM . Panah dan Cloud Fetch tidak didukung di IBM AIX.
`EnableComplexDatatypeSupport`	`0`	Jika diatur ke `1`, dukungan untuk jenis data kompleks (ARRAYs, STRUCTs, MAPs) sebagai objek Java asli alih-alih string diaktifkan.
`EnableDirectResults`	`1`	Jika diatur ke `1`, memungkinkan hasil langsung untuk meningkatkan performa kueri.
`EnableGeoSpatialSupport`	`0`	Jika diatur ke `1`, memungkinkan dukungan untuk jenis data geospasial (GEOMETRI dan GEOGRAFI) sebagai objek Java terstruktur. Memerlukan `EnableComplexDatatypeSupport=1` dan `EnableArrow=1` (Arrow diaktifkan secara default). Saat dinonaktifkan, kolom geospasial dikembalikan sebagai STRING dalam format EWKT. Lihat Fungsi geospasial ST.
`EnableSqlScripting`	`1` atau `true`	Mengaktifkan dukungan pembuatan skrip SQL untuk blok pernyataan majemuk (BEGIN... END) dan panggilan prosedur tersimpan. Tersedia di driver versi 1.0.10 ke atas dengan Databricks Runtime 16.3 ke atas. Prosedur tersimpan memerlukan Databricks Runtime 17.0 ke atas dan driver versi 3.0.1 ke atas. Gunakan `Statement` atau `PreparedStatement` untuk memanggil prosedur. `CallableStatement` tidak didukung. Untuk sintaks dan contoh, lihat Pembuatan skrip SQL.
`EnableMetricViewMetadata`	`0`	Jika diatur ke `1`, memungkinkan operasi metadata yang ditingkatkan untuk tampilan metrik. Lihat Bekerja dengan metadata tampilan metrik menggunakan Driver Databricks JDBC.
`EnableTelemetry`	`0`	Jika diatur ke `1`, telemetri diaktifkan. Lihat Telemetri.
`EnableVolumeOperations`	`1`atau `true`	Properti informasi klien untuk mengaktifkan operasi volume pada stream. Lihat Mengelola file dalam volume dengan Driver Databricks JDBC. Secara bawaan, properti ini juga memungkinkan operasi REMOVE pada volume. Penting: Anda harus mengatur ini sebagai properti info klien. Menyediakannya hanya di URL koneksi tidak mengaktifkan operasi volume untuk aliran.
`MaxBatchSize`	`500`	Ukuran batch maksimum untuk operasi batch dan pemrosesan data.
`QueryResultCompressionType`	1	Nilai yang valid adalah 0 (tanpa kompresi), dan 1 (untuk kompresi LZ4). Driver secara otomatis mengambil alih ke 0 (tanpa kompresi) untuk hasil sebaris terlepas dari pengaturan yang dikonfigurasi
`UserAgentEntry`	`browser`	Entri User-Agent yang akan disertakan dalam permintaan HTTP. Nilai ini dalam format berikut: `[ProductName]/[ProductVersion] [Comment]`
`UseThriftClient`	`1`	Apakah driver JDBC harus menggunakan klien Thrift atau API Eksekusi Pernyataan.
`VolumeOperationAllowedLocalPaths`	``	Daftar jalur lokal yang diizinkan, dipisahkan oleh koma, untuk mengunduh dan mengunggah berkas pada proses pemasukkan volume Katalog Unity. Jalur termasuk sub-direktori juga. Ketika tidak ditentukan, ini kembali ke nilai `StagingAllowedLocalPaths`, lalu ke string kosong yang menentukan tidak ada batasan. Lihat Mengelola file menggunakan volume. Penting: Jika penyiapan berada di lingkungan multi-penyewa (seperti alat BI atau layanan pengembang), dan pengguna mengontrol URL JDBC lengkap, layanan harus mengatur properti ini ke lokasi kotak pasir atau jalur yang tidak ada. Ini mencegah pengguna menulis file arbitrase dan mengganggu penyebaran internal layanan.

Koleksi telemetri

Telemetry memungkinkan Databricks untuk menyederhanakan debugging dan memberikan pemecahan masalah tepat waktu dengan mengumpulkan:

Rincian lingkungan klien (versi driver, runtime, rincian sistem operasi)
Konfigurasi koneksi JDBC (tidak termasuk data PII apapun)
Pengukuran latensi operasi
Format hasil eksekusi (inline JSON, Arrow, dll.)
Jenis Operasi (kueri eksekusi, kueri metadata, operasi volume)
Data klasifikasi kesalahan
Jumlah Percobaan Ulang

Nota

Databricks menjaga standar privasi yang ketat dengan memastikan tidak ada pengumpulan konten kueri, hasil, atau informasi pribadi yang dapat diidentifikasi (PII).

Saran dan Komentar

Apakah halaman ini membantu?

Last updated on 2026-04-27