Eseguire la migrazione da Simba Spark ODBC Driver a Databricks ODBC Driver

Databricks ha rinominato il driver ODBC nel mese di febbraio 2026. Questa guida consente di eseguire la migrazione di connessioni esistenti dal driver ODBC Di Simba Spark legacy al driver ODBC di Databricks.

Databricks non distribuisce più nuove versioni del driver Simba legacy, ma le versioni esistenti rimangono supportate per due anni. Databricks consiglia di eseguire la migrazione al nuovo driver per ottenere l'accesso alle funzionalità e ai miglioramenti più recenti. Entrambi i driver possono coesistere durante la migrazione, in modo da poter eseguire la migrazione incrementale tra applicazioni, testare senza interrompere la produzione e eseguire rapidamente il rollback, se necessario.

Cosa è cambiato

Sono stati modificati solo il nome del driver e i percorsi di installazione. Tutti i parametri e le funzionalità di connessione rimangono invariati.

Componente	Simba Spark ODBC Driver	Driver ODBC di Databricks
Percorso di installazione di Windows	C:\Program Files\Simba Spark ODBC Driver	C:\Program Files\Databricks ODBC Driver
Percorso di installazione di Linux	/opt/simba/spark	/opt/databricks/databricksodbc
Percorso di installazione di macOS	/Library/simba/spark	/Library/databricks/databricksodbc
Variabile di ambiente	SIMBASPARKINI	DATABRICKSODBCINI

Passaggi per la migrazione

Completare questi passaggi per eseguire la migrazione dal driver ODBC Simba legacy al driver ODBC di Databricks.

Passaggio 1: Installare il nuovo driver

Scaricare dalla pagina di download del driver ODBC di Databricks ed eseguire il programma di installazione per la piattaforma.

Windows

Eseguire il .msi programma di installazione e seguire le istruzioni.

Linux (RPM)

sudo rpm -i databricks-odbc-*.rpm

Linux (DEB)

sudo dpkg -i databricks-odbc_*.deb

MacOS

Aprire il .dmg file ed eseguire il .pkg programma di installazione.

Passaggio 2: Aggiornare le stringhe di connessione

Modificare il nome del driver nelle stringhe di connessione:

Before:

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

After:

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

Tutti gli altri parametri (Host, Porta, HTTPPath, AuthMech e credenziali) rimangono invariati.

Passaggio 3: Aggiornare le configurazioni DSN

Ignorare questo passaggio se si usano stringhe di connessione senza DSN.

Windows

1. Aprire l'amministratore origine dati ODBC.
2. Selezionare il DSN e fare clic su Configura.
3. Selezionare Databricks ODBC Driver dall'elenco dei driver.
4. Fare clic su OK.

Linux/macOS

Aggiornare il odbc.ini file in modo che punti alla nuova libreria driver:

Before:

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

After:

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

Passaggio 4: Aggiornare le variabili di ambiente (solo Linux/macOS)

Se si usa SIMBASPARKINI, modificarlo in DATABRICKSODBCINI:

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

Passaggio 5: Aggiornare il codice dell'applicazione

Aggiornare i riferimenti al nome del driver nel codice:

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

Passaggio 6: Verificare la migrazione

Testare la connessione:

SELECT current_version();

Verificare che il driver sia installato:

Windows

Controllare la schedaDriver amministratore >origine dati ODBCper "Driver ODBC di Databricks".

Linux/macOS

Esegui il comando seguente: L'output include [Databricks ODBC Driver]:

odbcinst -q -d

Migrazione specifica dello strumento

Seguire questi passaggi aggiuntivi per strumenti e piattaforme specifici.

Tableau

Tableau rileva automaticamente il nuovo driver nella maggior parte dei casi. Verificare controllando i dati>[Connessione]>Modifica connessione.

Excel

Aggiornare il DSN nell'amministratore dell'origine dati ODBC. Se si usano formule di Power Query , aggiornare i riferimenti al nome del driver.

SQL Server Management Studio

Aggiornare le configurazioni del server collegato di SQL Server Management Studio (SSMS) che fanno riferimento al nome del driver precedente e ripetere le query.

Risoluzione dei problemi

Se si verificano problemi durante la migrazione, provare queste soluzioni.

Errore del driver non trovato

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

Soluzioni:

• Verificare l'installazione controllando l'amministratore dell'origine dati ODBC (Windows) o eseguendo odbcinst -q -d (Linux/macOS).
• Verificare i percorsi dei driver in odbc.ini o odbcinst.ini.
• Confermare l'architettura corretta (a 32 bit rispetto a 64 bit).

Errori di caricamento della libreria (Linux)

Error loading shared libraries

Soluzione: Installare unixODBC:

# RPM-based
sudo yum install unixODBC

# Debian-based
sudo apt-get install unixodbc

Domande frequenti

Di seguito sono riportate domande comuni sulla migrazione al driver aggiornato.

È necessario modificare i parametri di connessione oltre al nome del driver?

No. Tutti i parametri (Host, Porta, HTTPPath, AuthMech e credenziali) rimangono invariati.

I DSN esistenti smetteranno di funzionare?

No, purché il driver Simba rimanga installato. Tuttavia, eseguire la migrazione al nuovo driver per gli aggiornamenti futuri.

C'è qualche modifica della funzionalità?

No. Si tratta solo di una ridenominazione. Tutte le funzionalità funzionano in modo identico.

È possibile usare entrambi i driver contemporaneamente?

Sì. Installare entrambi i driver per eseguire la migrazione incrementale.

Per ottenere assistenza, contattare il supporto tecnico di Databricks o il team dell'account per assistenza per la migrazione.