Dela via


Migrera från Simba Spark ODBC-drivrutin till Databricks ODBC-drivrutin

Databricks bytte namn på ODBC-drivrutinen i februari 2026. Den här guiden hjälper dig att migrera befintliga anslutningar från den äldre Simba Spark ODBC-drivrutinen till Databricks ODBC-drivrutinen.

Databricks distribuerar inte längre nya versioner av den äldre Simba-drivrutinen, men befintliga versioner stöds fortfarande i två år. Databricks rekommenderar att du migrerar till den nya drivrutinen för att få åtkomst till de senaste funktionerna och förbättringarna. Båda drivrutinerna kan samexistera under migreringen, så du kan migrera stegvis mellan program, testa utan att störa produktionen och återställa snabbt om det behövs.

Vad har ändrats

Endast drivrutinsnamnet och installationssökvägarna har ändrats. Alla anslutningsparametrar och funktioner förblir desamma.

Komponent Simba Spark ODBC-drivrutin Databricks ODBC-drivrutin
Windows-installationssökväg C:\Program Files\Simba Spark ODBC Driver C:\Program Files\Databricks ODBC Driver
Linux-installationssökväg /opt/simba/spark /opt/databricks/databricksodbc
installationssökväg för macOS /Library/simba/spark /Library/databricks/databricksodbc
Miljövariabel SIMBASPARKINI DATABRICKSODBCINI

Migreringssteg

Slutför de här stegen för att migrera från den äldre Simba ODBC-drivrutinen till Databricks ODBC-drivrutinen.

Steg 1: Installera den nya drivrutinen

Ladda ned från nedladdningssidan för Databricks ODBC-drivrutinen och kör installationsprogrammet för din plattform.

Windows

.msi Kör installationsprogrammet och följ anvisningarna.

Linux (RPM)

sudo rpm -i databricks-odbc-*.rpm

Linux (DEB)

sudo dpkg -i databricks-odbc_*.deb

MacOS

.dmg Öppna filen och kör .pkg installationsprogrammet.

Steg 2: Uppdatera anslutningssträngar

Ändra drivrutinsnamnet i anslutningssträngarna:

Before:

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

After:

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

Alla andra parametrar (värd, port, HTTPPath, AuthMech och autentiseringsuppgifter) förblir oförändrade.

Steg 3: Uppdatera DSN-konfigurationer

Hoppa över det här steget om du använder DSN-lösa anslutningssträngar.

Windows

  1. Öppna ODBC-datakälladministratören.
  2. Välj ditt DSN och klicka på Konfigurera.
  3. Välj Databricks ODBC-drivrutin i drivrutinslistan.
  4. Klicka på OK.

Linux/macOS

odbc.ini Uppdatera filen så att den pekar på det nya drivrutinsbiblioteket:

Before:

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

After:

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

Steg 4: Uppdatera miljövariabler (endast Linux/macOS)

Om du använder SIMBASPARKINIändrar du det till DATABRICKSODBCINI:

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

Steg 5: Uppdatera programkoden

Uppdatera referenser för drivrutinsnamn i koden:

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

Steg 6: Verifiera migreringen

Testa anslutningen:

SELECT current_version();

Bekräfta att drivrutinen är installerad:

Windows

Kontrollera flikenAdministratörsdrivrutiner> för ODBC-datakällaför "Databricks ODBC-drivrutin".

Linux/macOS

Kör följande kommando. Utdata innehåller [Databricks ODBC Driver]:

odbcinst -q -d

Verktygsspecifik migrering

Följ dessa ytterligare steg för specifika verktyg och plattformar.

Tableau

Tableau identifierar automatiskt den nya drivrutinen i de flesta fall. Kontrollera genom att kontrollera Data>[Din anslutning]>Redigera anslutning.

Excel

Uppdatera ditt DSN i ODBC-datakälladministratören. Om du använder Power Query-formler uppdaterar du eventuella referenser till drivrutinsnamnet.

SQL Server Management Studio

Uppdatera de länkade serverkonfigurationerna i SQL Server Management Studio (SSMS) som refererar till det gamla drivrutinsnamnet och testa dina frågor igen.

Felsökning

Om du stöter på problem under migreringen kan du prova de här lösningarna.

Det gick inte att hitta drivrutinen

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

Lösningar:

  • Kontrollera installationen genom att kontrollera ODBC-datakälladministratören (Windows) eller köra odbcinst -q -d (Linux/macOS).
  • Verifiera drivrutinssökvägar i odbc.ini eller odbcinst.ini.
  • Bekräfta rätt arkitektur (32-bitars jämfört med 64-bitars).

Inläsningsfel för bibliotek (Linux)

Error loading shared libraries

Lösning: Installera unixODBC:

# RPM-based
sudo yum install unixODBC

# Debian-based
sudo apt-get install unixodbc

Vanliga frågor och svar

Följande är vanliga frågor om att migrera till den uppdaterade drivrutinen.

Behöver jag ändra anslutningsparametrar förutom drivrutinsnamnet?

Nej. Alla parametrar (värd, port, HTTPPath, AuthMech och autentiseringsuppgifter) förblir desamma.

Kommer mina befintliga DSN:er att sluta fungera?

Nej, så länge Simba-drivrutinen är installerad. Migrera dock till den nya drivrutinen för framtida uppdateringar.

Finns det några funktionsändringar?

Nej. Det här är bara ett namnbyte. Alla funktioner fungerar identiskt.

Kan jag använda båda drivrutinerna samtidigt?

Ja. Installera båda drivrutinerna för att migrera stegvis.

Om du vill få hjälp kontaktar du Databricks Support eller ditt kontoteam för migreringshjälp.