Migrace z ovladače ODBC Simba Spark na ovladač ODBC Databricks

Databricks přejmenoval ovladač ODBC v únoru 2026. Tato příručka vám pomůže migrovat existující připojení ze starší verze ovladače SIMba Spark ODBC na ovladač ODBC Databricks.

Databricks už ne distribuuje nové verze starší verze ovladače Simba, ale stávající verze zůstávají podporované po dobu dvou let. Databricks doporučuje migrovat na nový ovladač, aby získal přístup k nejnovějším funkcím a vylepšením. Oba ovladače můžou během migrace existovat společně, takže můžete migrovat postupně napříč aplikacemi, testovat bez přerušení produkce a v případě potřeby se rychle vrátit zpět.

Co se změnilo

Změnily se pouze názvy ovladačů a instalační cesty. Všechny parametry a funkce připojení zůstávají stejné.

Součást	Ovladač Simba Spark ODBC	Ovladač ODBC Databricks
Cesta instalace systému Windows	C:\Program Files\Simba Spark ODBC Driver	C:\Program Files\Databricks ODBC Driver
Cesta instalace Linuxu	/opt/simba/spark	/opt/databricks/databricksodbc
Instalační cesta pro macOS	/Library/simba/spark	/Library/databricks/databricksodbc
Proměnná prostředí	SIMBASPARKINI	DATABRICKSODBCINI
Klíč registru Windows (64bitová verze)	HKEY_LOCAL_MACHINE\SOFTWARE\Simba\Simba Spark ODBC Driver\Driver	HKEY_LOCAL_MACHINE\SOFTWARE\Databricks\Databricks ODBC Driver\Driver
Klíč registru Windows (32bitová verze)	HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Simba\Simba Spark ODBC Driver\Driver	HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Databricks\Databricks ODBC Driver\Driver

Kroky migrace

Provedením těchto kroků proveďte migraci ze starší verze ovladače Simba ODBC na ovladač ODBC Databricks.

Krok 1: Instalace nového ovladače

Stáhněte si ze stránky pro stažení ovladače ODBC Databricks a spusťte instalační program pro vaši platformu.

Windows

.msi Spusťte instalační program a postupujte podle pokynů.

Linux (RPM)

sudo rpm -i databricks-odbc-*.rpm

Linux (DEB)

sudo dpkg -i databricks-odbc_*.deb

MacOS

.dmg Otevřete soubor a spusťte .pkg instalační program.

Krok 2: Aktualizace připojovacích řetězců

Změňte název ovladače v připojovacích řetězcích:

Before:

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

After:

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

Všechny ostatní parametry (Hostitel, Port, HTTPPath, AuthMech a přihlašovací údaje) zůstanou beze změny.

Krok 3: Aktualizace konfigurací DSN

Tento krok přeskočte, pokud používáte připojovací řetězce bez DSN.

Windows

1. Otevřete správce zdroje dat ODBC.
2. Vyberte svůj DSN a klikněte na Konfigurovat.
3. V seznamu ovladačů vyberte ovladač ODBC Databricks .
4. Klikněte na OK.

Linux/macOS

Aktualizujte odbc.ini soubor tak, aby odkazovat na novou knihovnu ovladačů:

Before:

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

After:

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

Krok 4: Aktualizace proměnných prostředí (jenom Linux/macOS)

Pokud používáte SIMBASPARKINI, změňte ho na DATABRICKSODBCINI:

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

Krok 5: Aktualizace kódu aplikace

Aktualizujte odkazy na názvy ovladačů v kódu:

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

jazyk C#

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

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

C/C++

// Before
SQLCHAR connStr[] = "Driver={Simba Spark ODBC Driver};...";

// After
SQLCHAR connStr[] = "Driver={Databricks ODBC Driver};...";

Krok 6: Ověření migrace

Otestujte připojení:

SELECT current_version();

Ověřte, že je ovladač nainstalovaný:

Windows

Zkontrolujte kartuOvladače správce >zdrojů dat ODBCpro Databricks.

Linux/macOS

Spusťte následující příkaz. Výstup zahrnuje [Databricks ODBC Driver]:

odbcinst -q -d

Migrace specifická pro konkrétní nástroje

Postupujte podle těchto dalších kroků pro konkrétní nástroje a platformy.

Tableau

Tableau ve většině případů automaticky rozpozná nový ovladač. Ověřte to tak, že zkontrolujete data>[vaše připojení]>Upravit připojení.

Excel

Aktualizujte svůj název DSN ve správci zdroje dat ODBC. Pokud používáte vzorce Power Query , aktualizujte všechny odkazy na název ovladače.

SQL Server Management Studio

Aktualizujte konfigurace odkazovaného serveru aplikace SQL Server Management Studio (SSMS), které odkazují na starý název ovladače a znovu otestují vaše dotazy.

Troubleshooting

Pokud během migrace narazíte na problémy, vyzkoušejte tato řešení.

Chyba ovladače nebyla nalezena.

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

Řešení:

• Ověřte instalaci tak, že zkontrolujete správce zdroje dat ODBC (Windows) nebo spustíte odbcinst -q -d (Linux/macOS).
• Ověřte cesty ovladače v odbc.ini nebo odbcinst.ini.
• Ověřte správnou architekturu (32bitová a 64bitová verze).

Chyby načítání knihovny (Linux)

Error loading shared libraries

Řešení: Nainstalujte unixODBC:

# RPM-based
sudo yum install unixODBC

# Debian-based
sudo apt-get install unixodbc

Nejčastější dotazy

Níže jsou uvedené běžné otázky týkající se migrace na aktualizovaný ovladač.

Musím změnit parametry připojení kromě názvu ovladače?

Ne. Všechny parametry (Hostitel, Port, HTTPPath, AuthMech a přihlašovací údaje) zůstanou stejné.

Přestanou fungovat stávající sítě DSN?

Ne, pokud zůstane nainstalovaný ovladač Simba. Migrujte však na nový ovladač pro budoucí aktualizace.

Mění se nějaká funkce?

Ne. Jedná se pouze o přejmenování. Všechny funkce fungují stejně.

Můžu používat oba ovladače současně?

Ano. Nainstalujte oba ovladače pro přírůstkovou migraci.

Pokud chcete získat pomoc, obraťte se na podporu Databricks nebo na tým vašeho účtu a požádejte o pomoc s migrací.