Databricks OSS ODBC ovladač

Important

Ovladač Databricks OSS ODBC, verze 0.5.0, je ve fázi beta. Informace o obecně dostupném ovladači verze 2.x najdete v dokumentaci ovladače Databricks ODBC.

Chcete-li nahlásit problém nebo požádat o funkci, dokud je ovladač ve verzi Beta, kontaktujte svůj tým pro účet Databricks.

Databricks OSS ODBC ovladač je ovladač ODBC 3.8 pro sklady Databricks SQL a Lakehouse//RT . Je navržen jako kompatibilní náhrada za Databricks ODBC ovladač verze 2.x pro podporované pracovní zátěže. Stávající aplikace, DSN a spojovací řetězce, které používají běžnou funkcionalitu 2.x, by obecně měly fungovat bez změn.

Požadavky

Databricks OSS ODBC ovladač a Databricks ODBC ovladač verze 2.x používají stejný registrovaný název ODBC ovladače, identifikátory balíčků, instalační cesty a názvy knihoven. Instalace jedné verze přes druhou nahradí stávající instalaci. Pro změnu ovladačů přeinstalujte balíček pro verzi, kterou chcete použít.

Databricks OSS ODBC ovladač je podporován na následujících platformách:

Operační systém	Balík a architektura	Požadavek
Windows	MSI pro x64 a x86	Architektura ovladače musí odpovídat architektuře aplikace.
macOS	Universal .pkg pro Intel a Apple Silicon	macOS 13.3 nebo vyšší.
Linux	.deb .rpm a pro x86_64, aarch64 a i686	glibc 2.28 nebo vyšší a kompatibilní správce ovladačů ODBC.

Také potřebujete Server Hostname a HTTP cestu pro Databricks SQL nebo Lakehouse//RT sklad. Viz Podrobnosti o připojení pro výpočetní prostředek Azure Databricks.

Nainstalujte Databricks OSS ODBC ovladač

1. V archivu ovladačů Databricks OSS ODBC si stáhněte Databricks OSS ODBC ovladač verze 0.5.0 pro váš operační systém a architekturu.
2. Nainstalujte stažený balíček:

   • Ve Windows rozbalte stažené soubory a spusťte 32bitové nebo 64bitové MSI. Instalátor zaregistruje Databricks ODBC ovladač ve Windows ODBC Driver Manageru.

   • Na macOS spusťte DatabricksODBC-<version>-macOS.pkg.

   • Na Linuxu nainstalujte .deb.rpm nebo balíček a zaregistrujte ovladač u unixODBC:

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

Knihovny ovladačů jsou instalovány na stejných místech jako verze 2.x:

• Windows 64bitová verze: C:\Program Files\Databricks ODBC Driver\lib\databricksodbc64.dll
• Windows 32bitová verze: 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

Konfigurace připojení

Začněte se svým existujícím 2.x DSN nebo připojovací řetězec. Běžné vlastnosti jako Driver, Host, Port, HTTPPath, SSL, Catalog a Schema jsou kompatibilní. Ovladač také přijímá běžné vlastnosti 2.x, které nejsou potřeba na HTTP transportu, aby bylo možné stávající DSN znovu použít.

Pro vytvoření DSN nebo DSN-less připojovací řetězec s těmito nastaveními viz Vytvořit ODBC DSN pro ovladač Databricks ODBC nebo Vytvořit ODBC DSN připojovací řetězec pro ovladač Databricks ODBC.

Pro nové spojení použijte vlastnosti uvedené v následujícím příkladu. Pro DSN zadejte stejné páry klíč-hodnota pomocí správce ovladačů ODBC.

Následující příklad používá autentizaci OAuth uživatele ke stroji (U2M). Pro lepší čitelnost jsou vložena zalomení řádků. Nezahrnujte je do připojovací řetězec:

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

Podporují se následující metody ověřování:

Metoda ověřování	Properties
OAuth uživatel-ke-stroji (U2M)	AuthMech=11;Auth_Flow=2. PWD není vyžadováno. Persistentní cache tokenů je ve výchozím nastavení povolena. Nastavte EnableTokenCache=0 ho tak, aby byl vypnutý, nebo nastavte TokenCachePassPhrase použití heslové fráze při šifrování cache.
OAuth komunikace mezi stroji (M2M)	AuthMech=11;Auth_Flow=1;Auth_Client_ID=<client-id>;Auth_Client_Secret=<client-secret>.
Předávání tokenu OAuth	AuthMech=11;Auth_Flow=0;Auth_AccessToken=<oauth-token>.
Osobní přístupový token pro Azure Databricks	AuthMech=3;UID=token;PWD=<personal-access-token>.

Migrace z verze 2.x

1. Projděte si známá omezení funkcí používaných vaší aplikací.
2. Nahrajte nainstalovanou verzi 2.x a zálohujte si DSN, spojovací řetězce a konfigurační soubory ovladačů.
3. Nainstalujte ovladač Databricks OSS ODBC.
4. Použijte své stávající DSN nebo připojovací řetězec.
5. Vytváření testovacích spojení, objevování metadat, připravené příkazy, vazby parametrů, rušení, získávání velkých výsledků a reprezentativní aplikační workflow.

Databricks OSS ODBC ovladač dokáže hlásit specifičtější názvy typů Databricks a deklarovanou desetinnou přesnost a škálování než 2.x. Ověřujte aplikace, které přesně porovnávají hodnoty metadat.

Chcete-li se po nahrazení instalace vrátit k předchozímu stavu, znovu nainstalujte požadovaný balíček 2.x a obnovte zálohovanou konfiguraci.

Známá omezení

Následující omezení platí, když je ovladač ve verzi Beta:

• Ovladač podporuje Databricks SQL a warehouse Lakehouse//RT. Nepodporuje univerzální výpočetní metodu.
• SQL se vždy odesílá přímo do Azure Databricks. Ovladač neprovádí překlad SQL-92 dostupný ve verzi 2.x. UseNativeQuery je akceptováno jako kompatibilní, ale chování se nemění.
• Asynchronní provedení je podporováno a SQL_ATTR_ASYNC_ENABLESQLCompleteAsync není podporováno.
• Operace PUT, GET a REMOVE se soubory ve svazcích Unity Catalog nejsou podporovány.
• Binární vstupní parametry nejsou podporovány.
• Parametrová pole, včetně pyodbc fast_executemany s hodnotami řetězců a Unicode, jsou podporována, ale ovladač odesílá jeden požadavek na řádek.
• Velké výsledky automaticky používají Cloud Fetch a nelze je vynutit jako vložené. Načítání výsledků podporuje datové typy Databricks SQL kromě FILE a OBJECT. Komplexní hodnoty se vracejí jako text.
• HTTPS proxy podporují základní autentizaci, ale ne Kerberos nebo SPNEGO autentizaci.
• Konfigurace pro zrušení certifikátů a šifrované vzájemné TLS soukromé klíče nejsou podporovány.
• Některé pokročilé vlastnosti 2.x nejsou podporovány. Ovladač zaznamená varování, když vlastnost není použita.