Databricks OSS ODBC-Treiber

Important

Der Databricks OSS ODBC-Treiber, Version 0.5.0, befindet sich in der Beta. Informationen zum allgemein verfügbaren Treiber der Version 2.x finden Sie in der Dokumentation des Databricks ODBC Treibers.

Um ein Problem zu melden oder eine Funktion anzufordern, während der Treiber in der Beta ist, wenden Sie sich an Ihr Databricks-Kontoteam.

Der Databricks OSS ODBC-Treiber ist ein ODBC 3.8-Treiber für Databricks SQL und Lakehouse//RT-Warehouses. Es ist als kompatibler Ersatz für Databricks ODBC Driver Version 2.x für unterstützte Arbeitslasten konzipiert. Bestehende Anwendungen, DSNs und Verbindungsstrings, die gemeinsame 2.x-Funktionalität verwenden, sollten in der Regel ohne Änderungen funktionieren.

Anforderungen

Der Databricks OSS ODBC Driver und der Databricks ODBC Driver Version 2.x verwenden denselben registrierten ODBC-Treibernamen, Paketkennungen, Installationspfade und Bibliotheksnamen. Wenn eine Version über eine andere installiert wird, wird die bestehende Installation ersetzt. Um den Treiber zu wechseln, installiere das Paket für die Version, die du verwenden möchtest, neu.

Der Databricks OSS ODBC-Treiber wird auf folgenden Plattformen unterstützt:

Betriebssystem	Paketdatei und Architektur	Anforderung
Windows	MSI für x64 und x86	Die Treiberarchitektur muss mit der Anwendungsarchitektur übereinstimmen.
macOS	Universal .pkg für Intel- und Apple-Silizium	macOS 13.3 oder höher.
Linux	.deb und .rpm für x86_64, aarch64 und i686	glibc 2.28 oder höher und einen kompatiblen ODBC-Treibermanager.

Du brauchst außerdem den Server-Hostname und den HTTP-Pfad für ein Databricks SQL- oder Lakehouse//RT-Data-Warehouse. Siehe Abrufen von Verbindungsdetails für eine Azure Databricks-Compute-Ressource.

Installieren Sie den Databricks OSS ODBC-Treiber

1. Im Databricks OSS ODBC Driver-Archiv laden Sie die Databricks OSS ODBC Driver Version 0.5.0 für Ihr Betriebssystem und Ihre Architektur herunter.
2. Installieren Sie das heruntergeladene Paket:

   • Unter Windows entpacken Sie den Download und führen Sie das 32-Bit- oder 64-Bit-MSI-Paket aus. Der Installer registriert den ODBC-Treiber von Databricks im Windows ODBC Driver Manager.

   • Auf macOS führen Sie DatabricksODBC-<version>-macOS.pkg aus.

   • Installieren Sie unter Linux das Paket .deb oder .rpm und registrieren Sie den Treiber mit unixODBC:

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

Die Treiberbibliotheken sind an denselben Standorten wie in Version 2.x installiert:

• 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

Konfigurieren einer Verbindung

Beginnen Sie mit Ihrer vorhandenen 2.x-DSN oder Verbindungszeichenfolge. Gemeinsame Eigenschaften wie Driver, Host, Port, HTTPPath, SSL, Catalog und Schema sind kompatibel. Der Treiber akzeptiert außerdem gängige 2.x-Eigenschaften, die auf seinem HTTP-Transport nicht benötigt werden, sodass bestehende DSNs wiederverwendet werden können.

Informationen zum Erstellen einer DSN- oder einer DSN-losen Verbindungszeichenfolge mit diesen Einstellungen finden Sie unter Erstellen einer ODBC-DSN-Datei für den Databricks-ODBC-Treiber oder Erstellen einer DSN-losen Verbindungszeichenfolge für den Databricks-ODBC-Treiber.

Für eine neue Verbindung verwenden Sie die Eigenschaften im folgenden Beispiel. Für ein DSN geben Sie dieselben Schlüssel-Wert-Paare mit Ihrem ODBC-Treibermanager ein.

Im folgenden Beispiel wird die OAuth-Authentifizierung vom Benutzer zum System (U2M) verwendet. Zeilenumbrüche dienen der besseren Lesbarkeit. Fügen Sie sie nicht in die Verbindungszeichenfolge ein:

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

Die folgenden Authentifizierungsmethoden werden unterstützt:

Authentifizierungsmethode	Eigenschaften
OAuth-Benutzer-zu-Computer (U2M)	AuthMech=11;Auth_Flow=2. PWD ist nicht erforderlich. Persistent Token-Caching ist standardmäßig aktiviert. Setze EnableTokenCache=0, um es zu deaktivieren, oder setze TokenCachePassPhrase, um beim Verschlüsseln des Caches eine Passphrase zu verwenden.
OAuth Machine-to-Machine (M2M)	AuthMech=11;Auth_Flow=1;Auth_Client_ID=<client-id>;Auth_Client_Secret=<client-secret>.
OAuth-Token-Passthrough	AuthMech=11;Auth_Flow=0;Auth_AccessToken=<oauth-token>.
Persönliches Zugriffstoken für Azure Databricks	AuthMech=3;UID=token;PWD=<personal-access-token>.

Von Version 2.x migrieren

1. Überprüfen Sie die bekannten Einschränkungen für die von Ihrer Anwendung genutzten Funktionen.
2. Notieren Sie sich die installierte 2.x-Version und sichern Sie Ihre DSNs, Verbindungszeichenfolgen und Treiberkonfigurationsdateien.
3. Installieren Sie den Databricks OSS ODBC-Treiber.
4. Verwenden Sie Ihr bestehendes DSN oder Ihre Verbindungszeichenfolge erneut.
5. Testverbindungserstellung, Metadatenerkennung, vorbereitete Anweisungen, Parameterbindung, Stornierung, Wiederherstellung großer Ergebnisse und repräsentative Anwendungs-Workflows.

Der Databricks-OSS-ODBC-Treiber kann detailliertere Databricks-Typnamen sowie die deklarierte Dezimalgenauigkeit und Skalierung melden als die Version 2.x. Überprüfen Sie Anwendungen, die Metadatenwerte exakt vergleichen.

Um nach dem Austausch einer Installation zurückzurollen, installieren Sie das erforderliche 2.x-Paket und stellen Sie die gesicherte Konfiguration wieder her.

Bekannte Einschränkungen

Die folgenden Einschränkungen gelten, solange sich der Treiber in der Beta befindet:

• Der Treiber unterstützt Databricks, SQL- und Lakehouse//RT-Warehouses. Es unterstützt nicht All-Purpose Compute.
• SQL wird immer direkt an Azure Databricks gesendet. Der Treiber führt die in 2.x verfügbare SQL-92-Übersetzung nicht durch. UseNativeQuery wird zur Kompatibilität akzeptiert, ändert aber kein Verhalten.
• Asynchrone Ausführung durch SQL_ATTR_ASYNC_ENABLE und SQLCompleteAsync wird nicht unterstützt.
• PUT, GET, und REMOVE Operationen für Dateien in Unity-Katalog-Volumes werden nicht unterstützt.
• Binäre Eingabeparameter werden nicht unterstützt.
• Parameterarrays, einschließlich pyodbc fast_executemany mit String- und Unicode-Werten, werden unterstützt, aber der Treiber sendet pro Zeile eine Ausführungsanfrage.
• Große Ergebnisse nutzen Cloud Fetch automatisch und können nicht inline erzwungen werden. Der Ergebnisabruf unterstützt Databricks SQL-Datentypen mit Ausnahme von FILE und OBJECT. Komplexe Werte werden als Text zurückgegeben.
• HTTPS-Proxys unterstützen die Basic-Authentifizierung, aber keine Kerberos- oder SPNEGO-Authentifizierung.
• Die Konfiguration der Zertifikatssperrung und verschlüsselte gegenseitige TLS-Privatschlüssel werden nicht unterstützt.
• Einige fortgeschrittene 2.x-Eigenschaften werden nicht unterstützt. Der Fahrer meldet eine Warnung, wenn eine Eigenschaft nicht angewendet wird.