Databricks JDBC Sürücüsü (Simba) için sürücü özelliği ayarları

Uyarı

Bu sayfa, Simba JDBC Sürücüsü (Eski), sürüm 3'ün altındaki sürümler için geçerlidir. Databricks, JDBC bağlantısı için Databricks JDBC Sürücüsüne geçiş yapmanızı kesinlikle önerir. Unity Kataloğu ölçüm görünümleri desteği, birden çok SQL deyimine yayılan işlemler, saklı yordamlar, daha hızlı büyük sonuç alma ve yerleşik istemci telemetrisi gibi iyileştirmeler içerir.

Bu sayfada Databricks JDBC Sürücüsü için özel ve gelişmiş sürücü özellik ayarlarının nasıl yapılandırıldığı açıklanır.

Databricks JDBC Sürücüsü aşağıdaki özel ve gelişmiş sürücü özelliği ayarlarını sağlar.

JDBC'de ANSI SQL-92 sorgu desteği

Eski Spark JDBC sürücüleri ANSI SQL-92 diyalektindeki SQL sorgularını kabul eder ve bunları sunucuya göndermeden önce Databricks SQL'e çevirir.

Uygulamanız databricks SQL'i doğrudan oluşturuyorsa veya Azure Databricks özgü ANSI SQL-92 olmayan söz dizimi kullanıyorsa, bağlantı yapılandırmanızda UseNativeQuery=1 ayarlayın. Bu ayar, ÇEVIRI olmadan SQL sorgularını Azure Databricks geçirir.

Varsayılan katalog ve şema

Varsayılan kataloğu ve şemayı belirtmek için JDBC bağlantı URL'sine ConnCatalog=<catalog-name>;ConnSchema=<schema-name> ekleyin.

İzleme için sorgu etiketleri

Önemli

Bu özellik, Özel Önizleme sürümündedir. Erişim istemek için hesap ekibinize başvurun.

İzleme ve analiz amacıyla SQL sorgularınıza anahtar-değer etiketleri ekleyin. Sorgu etiketleri, sorgu belirleme ve analiz için tabloda görünür system.query.history .

Bağlantınıza sorgu etiketleri eklemek için JDBC bağlantı URL'nize parametresini ssp_query_tags ekleyin:

jdbc:databricks://<server-hostname>:443;httpPath=<http-path>;ssp_query_tags=key1:value1,key2:value2

Sorgu etiketlerini virgülle ayrılmış anahtar-değer çiftleri olarak tanımlayın; burada her anahtar ve değer iki nokta üst üste ile ayrılır. Örneğin, key1:value1,key2:value2.

JDBC'de büyük sorgu sonuçlarını ayıklayın

Büyük sorgu sonuçlarını ayıklarken en iyi performansı elde etmek için, JDBC sürücüsünün aşağıdaki iyileştirmeleri içeren en son sürümünü kullanın.

JDBC'de ok serileştirme

JDBC sürücü sürümü 2.6.16 ve üzeri, Apache Arrow kullanan iyileştirilmiş bir sorgu sonuçları serileştirme biçimini destekler.

JDBC'de Bulut Getirme

JDBC sürücü sürümü 2.6.19 ve üzeri, Azure Databricks dağıtımınızda yapılandırılan bulut depolama alanı aracılığıyla sorgu sonuçlarını getiren Cloud Fetch özelliğini destekler.

Bir sorgu çalıştırdığınızda, Azure Databricks sonuçları çalışma alanınızın bulut depolama alanında 20 MB'a kadar ok serileştirilmiş dosyaları olarak depolar. Sorgu tamamlandıktan sonra sürücü getirme istekleri gönderir ve Azure Databricks sonuç dosyalarına shared access signature (SAS) URL'leri döndürür. Sürücü daha sonra sonuçları doğrudan Azure depolama alanından indirmek için bu URL'leri kullanır.

Bulut Getirme yalnızca 1 MB'tan büyük sorgu sonuçları için geçerlidir. Sürücü doğrudan Azure Databricks daha küçük sonuçlar alır.

Azure Databricks, birikmiş dosyaları 24 saat sonra silinmek üzere işaretleyerek ve 24 saat sonra kalıcı olarak kaldırarak otomatik olarak çöp toplar.

Ağ önkoşulları

Ağınız özelse, Cloud Fetch'in çalışması için aşağıdaki ayarları yapılandırmanız gerekir:

• ağ ortamınızda ve'ye *.blob.core.windows.net izin verin*.store.core.windows.net.
• Gerekli sertifika indirmelerini ve iptallerini izin verme listenize ekleyin.
• Azure Databricks çalışma alanı depolama hesabınızda güvenlik duvarı desteği etkinleştirildiyse depolama hesabına özel erişime izin vermek için virtual ağ geçidi veya on-premises data gateway yapılandırın.

Cloud Fetch'i devre dışı bırakmak için bağlantı yapılandırmanızda ayarlayın EnableQueryResultDownload=0 .

Yavaş indirmeleri tanılama

LogLevel Cloud Fetch indirme hızı ölçümlerini görmek için (BİlGİ) olarak ve 4 günlük klasörünün tam yoluna ayarlayınLogPath. Sürücü öbek başına indirme hızını günlüğe kaydeder, böylece büyük sonuç kümeleri birden çok günlük satırı oluşturur. Sürücü ayrıca hız yaklaşık 1 MB/sn'nin altına düştüğünde bir uyarı kaydeder. Bu özellik, Aralık 2025'te yayımlanan JDBC (Simba) sürücü sürümlerinde kullanılabilir.

İndirmeler yavaşsa veya durdurulduysa, sürücü tüm sonuç dosyalarını indirmeyi bitirmeden ÖNCE SAS belirteçlerinin süresi dolabilir. İstemci ile Azure Blob Depolama arasında bant genişliği azaltma veya ağ tıkanıklığı olup olmadığını denetleyin.

Log kaydını etkinleştir

JDBC sürücüsünde günlüğe kaydetmeyi etkinleştirmek için LogLevel özelliğini 1 (yalnızca ciddi olaylar) ve 6 (tüm sürücü etkinliği) arasında bir değere ayarlayın. LogPath özelliğini, günlük dosyalarını kaydetmek istediğiniz klasörün tam yoluna ayarlayın.

Daha fazla bilgi için Databricks JDBC Sürücü Kılavuzu'nda Kayıt Tutmayı Yapılandırma bölümüne bakın.