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

Uyarı

Bu sayfa, sürüm 3'ün altındaki Databricks JDBC sürücü sürümleri için geçerlidir. Databricks JDBC sürücüsü sürüm 3 ve üzeri için bkz. Databricks JDBC Sürücüsü.

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
• Varsayılan katalog ve şema
• İzleme için sorgu etiketleri
• JDBC'de büyük sorgu sonuçlarını ayıklayın
• JDBC'de ok serileştirme
• JDBC'de Bulut Getirme
• Günlüğü etkinleştir

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'e özgü ANSI SQL-92 olmayan söz dizimini kullanıyorsa, bağlantı yapılandırmanızda UseNativeQuery=1 ayarlayın. Bu ayar, çeviri yapmadan SQL sorgularını Azure Databricks'e 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.

Sorgu çalıştırdığınızda Azure Databricks, sonuçları 20 MB'a kadar ok serileştirilmiş dosyalar olarak iç DBFS depolama konumuna yükler. Sorgu tamamlandıktan sonra sürücü getirme istekleri gönderir ve Azure Databricks karşıya yüklenen dosyalara paylaşılan erişim imzalarını döndürür. Ardından sürücü sonuçları doğrudan DBFS'den 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'ten daha küçük sonuçlar alır.

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

Cloud Fetch mimarisi hakkında daha fazla bilgi edinmek için BI Araçlarıyla Yüksek Bant Genişliğine Sahip Bağlantıyı Nasıl Elde Ettiğimize bakın.

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.