Migrieren von Simba Spark ODBC-Treiber zu Databricks ODBC-Treiber

Databricks hat den ODBC-Treiber im Februar 2026 umbenannt. Dieses Handbuch hilft Ihnen beim Migrieren vorhandener Verbindungen vom älteren Simba Spark ODBC-Treiber zum Databricks ODBC-Treiber.

Databricks verteilt keine neuen Versionen des älteren Simba-Treibers mehr, aber vorhandene Versionen bleiben zwei Jahre lang unterstützt. Databricks empfiehlt die Migration zum neuen Treiber, um Zugriff auf die neuesten Features und Verbesserungen zu erhalten. Beide Treiber können während der Migration koexistieren, sodass Sie inkrementell über Anwendungen hinweg migrieren, testen, ohne die Produktion zu unterbrechen, und bei Bedarf schnell einen Rollback durchführen.

Was sich geändert hat

Nur der Treibername und die Installationspfade wurden geändert. Alle Verbindungsparameter und -funktionen bleiben unverändert.

Bestandteil	Simba Spark ODBC-Treiber	Databricks ODBC-Treiber
Windows-Installationspfad	C:\Program Files\Simba Spark ODBC Driver	C:\Program Files\Databricks ODBC Driver
Linux-Installationspfad	/opt/simba/spark	/opt/databricks/databricksodbc
macOS-Installationspfad	/Library/simba/spark	/Library/databricks/databricksodbc
Umgebungsvariable	SIMBASPARKINI	DATABRICKSODBCINI

Schritte bei der Migration

Führen Sie diese Schritte aus, um vom älteren Simba ODBC-Treiber zum Databricks ODBC-Treiber zu migrieren.

Schritt 1: Installieren des neuen Treibers

Laden Sie die Downloadseite des Databricks ODBC-Treibers herunter , und führen Sie das Installationsprogramm für Ihre Plattform aus.

Windows

Führen Sie das .msi Installationsprogramm aus, und folgen Sie den Anweisungen.

Linux (RPM)

sudo rpm -i databricks-odbc-*.rpm

Linux (DEB)

sudo dpkg -i databricks-odbc_*.deb

MacOS

Öffnen Sie die .dmg Datei, und führen Sie das .pkg Installationsprogramm aus.

Schritt 2: Aktualisieren von Verbindungszeichenfolgen

Ändern Sie den Treibernamen in Ihren Verbindungszeichenfolgen:

Before:

Driver={Simba Spark ODBC Driver};Host=...

After:

Driver={Databricks ODBC Driver};Host=...

Alle anderen Parameter (Host, Port, HTTPPath, AuthMech und Anmeldeinformationen) bleiben unverändert.

Schritt 3: Aktualisieren von DSN-Konfigurationen

Überspringen Sie diesen Schritt, wenn Sie DSN-weniger Verbindungszeichenfolgen verwenden.

Windows

1. Öffnen Sie den ODBC-Datenquellenadministrator.
2. Wählen Sie Ihren DSN aus, und klicken Sie auf "Konfigurieren".
3. Wählen Sie "Databricks ODBC-Treiber" aus der Treiberliste aus.
4. Klicke auf OK.

Linux/macOS

Aktualisieren Sie Ihre odbc.ini Datei so, dass sie auf die neue Treiberbibliothek verweist:

Before:

Driver=/opt/simba/spark/lib/64/libsparkodbc_sb64.so

After:

Driver=/opt/databricks/databricksodbc/lib/64/libdatabricksodbc_sb64.so

Schritt 4: Aktualisieren von Umgebungsvariablen (nur Linux/macOS)

Wenn Sie dies verwenden SIMBASPARKINI, ändern Sie sie in DATABRICKSODBCINI:

export DATABRICKSODBCINI=/path/to/databricks.odbc.ini

Schritt 5: Aktualisieren des Anwendungscodes

Aktualisieren von Treibernamenverweise in Ihrem Code:

Python

# Before
conn_str = "Driver={Simba Spark ODBC Driver};..."

# After
conn_str = "Driver={Databricks ODBC Driver};..."

Java

// Before
String connStr = "jdbc:odbc:Driver={Simba Spark ODBC Driver};...";

// After
String connStr = "jdbc:odbc:Driver={Databricks ODBC Driver};...";

C#

// Before
string connStr = "Driver={Simba Spark ODBC Driver};...";

// After
string connStr = "Driver={Databricks ODBC Driver};...";

Schritt 6: Überprüfen der Migration

Testen Sie Ihre Verbindung:

SELECT current_version();

Vergewissern Sie sich, dass der Treiber installiert ist:

Windows

Überprüfen Sie die Registerkarte "ODBC-Datenquellenadministratortreiber>" auf "ODBC-Treiber für Databricks".

Linux/macOS

Führen Sie den folgenden Befehl aus: Die Ausgabe enthält [Databricks ODBC Driver]:

odbcinst -q -d

Toolspezifische Migration

Führen Sie diese zusätzlichen Schritte für bestimmte Tools und Plattformen aus.

Tableau

Tableau erkennt den neuen Treiber in den meisten Fällen automatisch. Überprüfen Sie die Daten>[Ihre Verbindung]>Verbindung bearbeiten.

Excel

Aktualisieren Sie Ihren DSN im ODBC-Datenquellenadministrator. Wenn Sie Power Query-Formeln verwenden, aktualisieren Sie alle Verweise auf den Treibernamen.

SQL Server Management Studio

Aktualisieren Sie die mit SQL Server Management Studio (SSMS) verknüpften Serverkonfigurationen, die auf den alten Treibernamen verweisen und Ihre Abfragen erneut testen.

Problembehandlung

Wenn während der Migration Probleme auftreten, probieren Sie diese Lösungen aus.

Fehler "Treiber nicht gefunden"

Error: [IM002] Data source name not found and no default driver specified

Lösungen :

• Überprüfen Sie die Installation, indem Sie den ODBC-Datenquellenadministrator (Windows) überprüfen oder ausführen odbcinst -q -d (Linux/macOS).
• Überprüfen von Treiberpfaden in odbc.ini oder odbcinst.ini.
• Bestätigen Sie die richtige Architektur (32-Bit im Vergleich zu 64-Bit).

Fehler beim Laden von Bibliotheken (Linux)

Error loading shared libraries

Lösung: UnixODBC installieren:

# RPM-based
sudo yum install unixODBC

# Debian-based
sudo apt-get install unixodbc

Häufig gestellte Fragen

Im Folgenden finden Sie häufig gestellte Fragen zum Migrieren zum aktualisierten Treiber.

Muss ich neben dem Treibernamen Verbindungsparameter ändern?

Nein. Alle Parameter (Host, Port, HTTPPath, AuthMech und Anmeldeinformationen) bleiben gleich.

Funktionieren meine vorhandenen DSNs nicht mehr?

Nein, solange der Simba-Treiber installiert bleibt. Migrieren Sie jedoch für zukünftige Updates zum neuen Treiber.

Gibt es Funktionsänderungen?

Nein. Dies ist nur eine Umbenennung. Alle Features funktionieren identisch.

Kann ich beide Treiber gleichzeitig verwenden?

Ja. Installieren Sie beide Treiber, um inkrementell zu migrieren.

Um Hilfe zu erhalten, wenden Sie sich an den Databricks Support oder Ihr Kontoteam, um Unterstützung bei der Migration zu erhalten.