Databricks OSS ODBC Sürücüsü

Important

Databricks OSS ODBC Sürücüsü, sürüm 0.5.0, beta sürümündedir. Genel kullanıma sunulan 2.x sürüm sürücüsü hakkında bilgi için Databricks ODBC Driver dokümantasyonuna bakınız.

Sürücü Beta'dayken bir sorun bildirmek veya bir özellik isteğinde bulunmak için Databricks hesap ekibinizle iletişime geçin.

Databricks OSS ODBC Sürücüsü, Databricks SQL ve Lakehouse//RT depoları için bir ODBC 3.8 sürücüsüdür. Desteklenen iş yükleri için Databricks ODBC Driver sürüm 2.x yerine geçebilecek uyumlu bir alternatif olarak tasarlanmıştır. Yaygın 2.x işlevselliğini kullanan mevcut uygulamalar, DSN'ler ve bağlantı dizileri genellikle değişiklik olmadan çalışmalıdır.

Requirements

Databricks OSS ODBC Sürücüsü ve Databricks ODBC Sürücüsü sürüm 2.x, aynı kayıtlı ODBC sürücü adını, paket tanımlayıcılarını, kurulum yollarını ve kütüphane adlarını kullanır. Bir sürümü diğerinin üzerine kurmak, mevcut kurulumu değiştirir. Sürücü değiştirmek için, kullanmak istediğiniz sürüm için paketi yeniden yükleyin.

Databricks OSS ODBC Sürücüsü aşağıdaki platformlarda desteklenmektedir:

İşletim Sistemi	Paket ve mimari	Gereksinim
Windows	x64 ve x86 için MSI	Sürücü mimarisi uygulama mimarisiyle uyumlu olmalıdır.
macOS	Intel ve Apple silicon için Universal .pkg	macOS 13.3 veya üstü.
Linux	.deb ve .rpm x86_64, aarch64 ve i686 için	glibc 2.28 veya üzeri ve uyumlu bir ODBC sürücü yöneticisi gerekir.

Databricks SQL veya Lakehouse//RT ambarı için Sunucu Ana Bilgisayar Adı ve HTTP Yolu da gerekir. Bkz. Azure Databricks işlem kaynağı için bağlantı ayrıntılarını alma.

Databricks OSS ODBC Sürücüsünü Yükleyin

1. Databricks OSS ODBC Sürücü arşivinden, işletim sisteminiz ve mimariniz için Databricks OSS ODBC Sürücüsü sürüm 0.5.0'ı indirin.
2. İndirilen paketi kurun:

   • Windows'ta indirilen dosyayı ayıklayın ve 32 bit veya 64 bit MSI paketini çalıştırın. Yükleyici, Databricks ODBC Driver'ı Windows ODBC Sürücü Yöneticisi'ne kaydeder.

   • macOS'ta çalıştırın DatabricksODBC-<version>-macOS.pkg.

   • Linux'ta .deb veya .rpm paketini yükleyin ve sürücüyü unixODBC'ye kaydedin:

     sudo odbcinst -i -d -f /opt/databricks/databricksodbc/Setup/odbcinst.ini
     

Sürücü kütüphaneleri, sürüm 2.x ile aynı konumlara yüklenmiştir:

• Windows 64 bit:C:\Program Files\Databricks ODBC Driver\lib\databricksodbc64.dll
• Windows 32-bit: C:\Program Files (x86)\Databricks ODBC Driver\lib\databricksodbc32.dll
• macOS: /Library/databricks/databricksodbc/lib/libdatabricksodbc.dylib
• Linux 64-bit: /opt/databricks/databricksodbc/lib/64/libdatabricksodbc64.so
• Linux 32-bit: /opt/databricks/databricksodbc/lib/32/libdatabricksodbc32.so

Bağlantı yapılandırma

Mevcut 2.x DSN'niz veya bağlantı dizenizle başlayın. Host, Port, HTTPPath, SSL, Catalog, Schema ve Driver gibi ortak özellikler uyumludur. Sürücü ayrıca HTTP taşımasında gerekli olmayan yaygın 2.x özelliklerini kabul eder ve böylece mevcut DSN'ler yeniden kullanılabilir.

Bu ayarlarla bir DSN veya DSN'siz bir bağlantı dizesi oluşturmak için Databricks ODBC Sürücüsü için bir ODBC DSN oluşturma ya da Databricks ODBC Sürücüsü için DSN'siz bir ODBC bağlantı dizesi oluşturma konularına bkz.

Yeni bir bağlantı için aşağıdaki örnekteki özellikleri kullanın. DSN için, aynı anahtar-değer çiftlerini ODBC sürücü yöneticinizi kullanarak girin.

Aşağıdaki örnek, OAuth kullanıcıdan makineye (U2M) kimlik doğrulamasını kullanır. Okunabilirlik için satır sonları da dahildir. Bunları bağlantı dizesi'e dahil etmeyin:

Driver=<path-to-driver>;
Host=<server-hostname>;
Port=443;
HTTPPath=<http-path>;
SSL=1;
AuthMech=11;
Auth_Flow=2;
Catalog=main;
Schema=default

Aşağıdaki kimlik doğrulama yöntemleri desteklenir:

Kimlik doğrulama yöntemi	Properties
OAuth kullanıcıdan makineye (U2M)	AuthMech=11;Auth_Flow=2. PWD zorunlu değildir. Kalıcı token önbelleğe alma varsayılan olarak etkinleştirilmiştir. EnableTokenCache=0 bunu devre dışı bırakmak için ayarlayın veya önbelleği şifrelerken parola kullanmak için TokenCachePassPhrase ayarlayın.
OAuth makineler arası (M2M)	AuthMech=11;Auth_Flow=1;Auth_Client_ID=<client-id>;Auth_Client_Secret=<client-secret>.
OAuth belirteci aktarma	AuthMech=11;Auth_Flow=0;Auth_AccessToken=<oauth-token>.
Azure Databricks kişisel erişim belirteci	AuthMech=3;UID=token;PWD=<personal-access-token>.

2.x sürümünden geçiş

1. Uygulamanızın kullandığı özelliklerin bilinen sınırlamalarını gözden geçirin.
2. Yüklü 2.x sürümünü kaydedin ve DSN'lerinizi, bağlantı dizelerini ve sürücü yapılandırma dosyalarınızı yedekleyin.
3. Databricks OSS ODBC sürücüsünü yükleyin.
4. Mevcut DSN'inizi veya bağlantı dizesi'inizi tekrar kullanın.
5. Test bağlantısı oluşturma, meta veri keşfi, hazırlanmış ifadeler, parametre bağlama, iptal, büyük sonuç alımı ve temsilci uygulama iş akışları.

Databricks OSS ODBC Sürücüsü, 2.x'ten daha spesifik Databricks tip adlarını ve ondalık hassasiyet ile ölçek bildirimlerini bildirebilir. Meta veri değerlerini tam olarak karşılaştıran uygulamaları doğrulayın.

Kurulumu değiştirdikten sonra geri almak için gerekli 2.x paketi yeniden yükleyip yedeklenmiş yapılandırmayı geri getirin.

Bilinen sınırlamalar

Sürücü Beta'dayken aşağıdaki sınırlamalar geçerlidir:

• Sürücü, Databricks SQL ve Lakehouse//RT depolarını destekliyor. Çok amaçlı hesaplamayı desteklemez.
• SQL her zaman doğrudan Azure Databricks'e gönderilir. Sürücü, 2.x'te mevcut olan SQL-92 çevirisini gerçekleştirmez. UseNativeQuery uyumluluk açısından kabul edilir ama davranışı değiştirmez.
• Asenkron uygulama ile SQL_ATTR_ASYNC_ENABLE desteklenmiyor SQLCompleteAsync .
• PUT, GET ve REMOVE işlemleri, Unity Catalog birimlerindeki dosyalar için desteklenmez.
• İkili giriş parametreleri desteklenmez.
• Dizi ve Unicode değerleriyle pyodbc fast_executemany dahil olmak üzere parametre dizileri desteklenir, ancak sürücü her satır için bir çalıştırma talebi gönderir.
• Büyük sonuçlar Cloud Fetch'i otomatik olarak kullanır ve zorla inline alınamaz. Sonuç alımı, Databricks SQL veri tiplerini destekler, hariç FILE ve OBJECT. Karmaşık değerler metin olarak döner.
• HTTPS proxy'leri temel kimlik doğrulamayı destekler, ancak Kerberos veya SPNEGO kimlik doğrulamasını desteklemez.
• Sertifika iptal yapılandırması ve karşılıklı TLS için şifrelenmiş özel anahtarlar desteklenmemektedir.
• Bazı gelişmiş 2.x özellikleri desteklenmemektedir. Sürücü, bir özellik uygulanmadığında uyarı günlüğüne yazar.