Databricks ODBC Sürücüsü için sürücü özelliği ayarları

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

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

ODBC'de ilk şemayı ayarlama

ODBC sürücüsü, bağlantı yapılandırması olarak Schema=<schema-name> ayarlayarak şemayı belirtmenize olanak tanır. Bu, çalıştırmaya USE <schema-name>eşdeğerdir.

İ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 ODBC bağlantı yapılandırmanıza parametresini ssp_query_tags ekleyin:

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, ssp_query_tags=team:engineering,env:prod.

ODBC'de ANSI SQL-92 sorgu desteği

Eski Spark ODBC 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.

ODBC'de büyük sorgu sonuçlarını ayıklama

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

ODBC'de ok serileştirme

ODBC sürücüsü sürüm 2.6.15 ve üzeri, Apache Ok kullanan iyileştirilmiş sorgu sonuçları serileştirme biçimini destekler.

ODBC'de Bulut Getirme

ODBC sürücüsü sürüm 2.6.17 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:

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

Yavaş indirmeleri tanılama

4 Cloud Fetch indirme hızı ölçümlerini görmek için (BİlGİ) olarak ve LogPath günlük klasörünün tam yoluna ayarlayınLogLevel. 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, Kasım 2025'den sonra yayımlanan ODBC 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.

Günlü kaydını etkinleştir

ODBC sürücüsünde günlüğe kaydetmeyi etkinleştirmek için LogLevel özelliğini 1 (yalnızca ciddi olaylar) ile 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 ODBC Sürücü Kılavuzu'ndaki Windows Olmayan Bir Makinede Günlük Seçeneklerini Yapılandırma bölümüne bakın.

  • Last updated on