Migrowanie ze sterownika ODBC Simba Spark do sterownika ODBC usługi Databricks

W lutym 2026 r. usługa Databricks zmieniła nazwę sterownika ODBC. Ten przewodnik ułatwia migrowanie istniejących połączeń ze starszego sterownika Simba Spark ODBC do sterownika ODBC usługi Databricks.

Usługa Databricks nie dystrybuuje już nowych wersji starszego sterownika Simba, ale istniejące wersje pozostają obsługiwane przez dwa lata. Usługa Databricks zaleca migrację do nowego sterownika, aby uzyskać dostęp do najnowszych funkcji i ulepszeń. Oba sterowniki mogą współistnieć podczas migracji, dzięki czemu można migrować przyrostowo między aplikacjami, testować bez zakłócania produkcji i w razie potrzeby szybko wycofać się.

Co się zmieniło

Zmieniono tylko nazwę sterownika i ścieżki instalacji. Wszystkie parametry połączenia i funkcjonalność pozostają takie same.

Składnik	Sterownik Simba Spark ODBC	Sterownik ODBC Databricks
Ścieżka instalacji systemu Windows	C:\Program Files\Simba Spark ODBC Driver	C:\Program Files\Databricks ODBC Driver
Ścieżka instalacji systemu Linux	/opt/simba/spark	/opt/databricks/databricksodbc
Ścieżka instalacji systemu macOS	/Library/simba/spark	/Library/databricks/databricksodbc
Zmienna środowiskowa	SIMBASPARKINI	DATABRICKSODBCINI

Kroki migracji

Wykonaj następujące kroki, aby przeprowadzić migrację ze starszego sterownika Simba ODBC do sterownika ODBC usługi Databricks.

Krok 1. Instalowanie nowego sterownika

Pobierz ze strony pobierania sterownika ODBC usługi Databricks i uruchom instalatora dla swojej platformy.

Windows

.msi Uruchom instalatora i postępuj zgodnie z monitami.

Linux (RPM)

sudo rpm -i databricks-odbc-*.rpm

Linux (DEB)

sudo dpkg -i databricks-odbc_*.deb

MacOS

.dmg Otwórz plik i uruchom .pkg instalatora.

Krok 2. Aktualizowanie parametrów połączenia

Zmień nazwę sterownika w parametrach połączenia:

Before:

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

After:

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

Wszystkie inne parametry (Host, Port, HTTPPath, AuthMech i poświadczenia) pozostają niezmienione.

Krok 3. Aktualizowanie konfiguracji DSN

Pomiń ten krok, jeśli używasz parametrów połączenia bez nazwy DSN.

Windows

1. Otwórz administratora źródła danych ODBC.
2. Wybierz nazwę DSN i kliknij przycisk Konfiguruj.
3. Wybierz pozycję Sterownik ODBC usługi Databricks z listy sterowników.
4. Kliknij przycisk OK.

Linux/macOS

odbc.ini Zaktualizuj plik, aby wskazywał nową bibliotekę sterowników:

Before:

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

After:

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

Krok 4. Aktualizowanie zmiennych środowiskowych (tylko system Linux/macOS)

Jeśli używasz metody SIMBASPARKINI, zmień ją na DATABRICKSODBCINI:

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

Krok 5. Aktualizowanie kodu aplikacji

Zaktualizuj odwołania do nazwy sterownika w kodzie:

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};...";

Krok 6. Weryfikowanie migracji

Przetestuj połączenie:

SELECT current_version();

Upewnij się, że sterownik jest zainstalowany:

Windows

Sprawdź kartęSterownikiadministratora> źródła danych ODBC dla pozycji "Sterownik ODBC usługi Databricks".

Linux/macOS

Uruchom następujące polecenie. Dane wyjściowe obejmują [Databricks ODBC Driver]:

odbcinst -q -d

Migracja specyficzna dla narzędzi

Wykonaj następujące dodatkowe kroki dla określonych narzędzi i platform.

Tableau

Usługa Tableau automatycznie wykrywa nowy sterownik w większości przypadków. Sprawdź, sprawdzając pozycję Dane>[Połączenie]>Edytuj połączenie.

Excel

Zaktualizuj nazwę DSN w administratorze źródła danych ODBC. Jeśli używasz formuł Dodatku Power Query , zaktualizuj wszelkie odwołania do nazwy sterownika.

SQL Server Management Studio

Zaktualizuj konfiguracje serwera połączonego programu SQL Server Management Studio (SSMS), które odwołują się do starej nazwy sterownika i ponownie przetestuj zapytania.

Troubleshooting

Jeśli wystąpią problemy podczas migracji, wypróbuj te rozwiązania.

Błąd nie znaleziono sterownika

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

Rozwiązania:

• Zweryfikuj instalację, sprawdzając administratora źródła danych ODBC (Windows) lub uruchom polecenie odbcinst -q -d (Linux/macOS).
• Sprawdź ścieżki sterowników w elem odbc.ini lub odbcinst.ini.
• Potwierdź poprawną architekturę (32-bitową a 64-bitową).

Błędy ładowania biblioteki (Linux)

Error loading shared libraries

Rozwiązanie: Zainstaluj system unixODBC:

# RPM-based
sudo yum install unixODBC

# Debian-based
sudo apt-get install unixodbc

Często zadawane pytania

Poniżej przedstawiono typowe pytania dotyczące migracji do zaktualizowanego sterownika.

Czy muszę zmienić parametry połączenia oprócz nazwy sterownika?

Nie. Wszystkie parametry (Host, Port, HTTPPath, AuthMech i poświadczenia) pozostają takie same.

Czy moje istniejące sieci DSN przestaną działać?

Nie, o ile sterownik Simba pozostaje zainstalowany. Jednak przeprowadź migrację do nowego sterownika pod kątem przyszłych aktualizacji.

Czy istnieją jakieś zmiany funkcji?

Nie. Jest to tylko zmiana nazwy. Wszystkie funkcje działają identycznie.

Czy mogę używać obu sterowników jednocześnie?

Tak. Zainstaluj oba sterowniki, aby przeprowadzić migrację przyrostowo.

Aby uzyskać pomoc, skontaktuj się z pomocą techniczną usługi Databricks lub zespołem ds. obsługi migracji.