Migrer du pilote ODBC Simba Spark vers databricks ODBC Driver

Databricks a renommé le pilote ODBC en février 2026. Ce guide vous aide à migrer des connexions existantes du pilote ODBC Simba Spark hérité vers le pilote ODBC Databricks.

Databricks ne distribue plus de nouvelles versions du pilote Simba hérité, mais les versions existantes restent prises en charge pendant deux ans. Databricks recommande de migrer vers le nouveau pilote pour accéder aux dernières fonctionnalités et améliorations. Les deux pilotes peuvent coexister pendant la migration. Vous pouvez donc migrer de manière incrémentielle entre les applications, tester sans interrompre la production et restaurer rapidement si nécessaire.

Ce qui a changé

Seul le nom du pilote et les chemins d’installation ont changé. Tous les paramètres et fonctionnalités de connexion restent les mêmes.

Composant	Pilote ODBC Simba Spark	Pilote ODBC Databricks
Chemin d’installation de Windows	C:\Program Files\Simba Spark ODBC Driver	C:\Program Files\Databricks ODBC Driver
Chemin d’installation linux	/opt/simba/spark	/opt/databricks/databricksodbc
chemin d’installation macOS	/Library/simba/spark	/Library/databricks/databricksodbc
Variable d'environnement	SIMBASPARKINI	DATABRICKSODBCINI

Étapes de la migration

Effectuez ces étapes pour migrer du pilote ODBC Simba hérité vers le pilote ODBC Databricks.

Étape 1 : Installer le nouveau pilote

Téléchargez à partir de la page de téléchargement du pilote ODBC Databricks et exécutez le programme d’installation de votre plateforme.

Fenêtres

Exécutez le programme d’installation .msi et suivez les invites.

Linux (RPM)

sudo rpm -i databricks-odbc-*.rpm

Linux (DEB)

sudo dpkg -i databricks-odbc_*.deb

MacOS

Ouvrez le fichier et exécutez le programme d’installation .dmg.pkg .

Étape 2 : Mettre à jour les chaînes de connexion

Modifiez le nom du pilote dans vos chaînes de connexion :

Before:

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

After:

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

Tous les autres paramètres (Host, Port, HTTPPath, AuthMech et credentials) restent inchangés.

Étape 3 : Mettre à jour les configurations DSN

Ignorez cette étape si vous utilisez des chaînes de connexion sans DSN.

Fenêtres

1. Ouvrez l’administrateur de source de données ODBC.
2. Sélectionnez votre DSN, puis cliquez sur Configurer.
3. Sélectionnez Databricks ODBC Driver dans la liste des pilotes.
4. Cliquez sur OK.

Linux/macOS

Mettez à jour votre odbc.ini fichier pour qu’il pointe vers la nouvelle bibliothèque de pilotes :

Before:

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

After:

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

Étape 4 : Mettre à jour les variables d’environnement (Linux/macOS uniquement)

Si vous utilisez SIMBASPARKINI, remplacez-le par DATABRICKSODBCINI:

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

Étape 5 : Mettre à jour le code de l’application

Mettez à jour les références de nom de pilote dans votre 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};...";

Étape 6 : Vérifier la migration

Testez votre connexion :

SELECT current_version();

Vérifiez que le pilote est installé :

Fenêtres

Consultez l’ongletPilotesd’administrateur> de source de données ODBC pour « Pilote ODBC Databricks ».

Linux/macOS

Exécutez la commande suivante : La sortie inclut [Databricks ODBC Driver]:

odbcinst -q -d

Migration spécifique à l’outil

Suivez ces étapes supplémentaires pour des outils et plateformes spécifiques.

Tableau

Tableau détecte automatiquement le nouveau pilote dans la plupart des cas. Vérifiez en vérifiant les données>[Votre connexion]>Modifier la connexion.

Excel

Mettez à jour votre DSN dans l’administrateur de source de données ODBC. Si vous utilisez des formules Power Query , mettez à jour les références au nom du pilote.

SQL Server Management Studio

Mettez à jour les configurations de serveur lié SQL Server Management Studio (SSMS) qui référencent l’ancien nom du pilote et testent à nouveau vos requêtes.

Résolution des problèmes

Si vous rencontrez des problèmes lors de la migration, essayez ces solutions.

Erreur introuvable dans le pilote

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

Solutions :

• Vérifiez l’installation en vérifiant l’administrateur de source de données ODBC (Windows) ou en exécutant odbcinst -q -d (Linux/macOS).
• Vérifiez les chemins d’accès des pilotes dans odbc.ini ou odbcinst.ini.
• Confirmez l’architecture correcte (32 bits par rapport à 64 bits).

Erreurs de chargement de bibliothèque (Linux)

Error loading shared libraries

Solution: Installez unixODBC :

# RPM-based
sudo yum install unixODBC

# Debian-based
sudo apt-get install unixodbc

Questions fréquemment posées

Voici des questions courantes sur la migration vers le pilote mis à jour.

Dois-je modifier les paramètres de connexion en plus du nom du pilote ?

Non. Tous les paramètres (Host, Port, HTTPPath, AuthMech et credentials) restent identiques.

Mes DSN existants cesseront-ils de fonctionner ?

Non, tant que le pilote Simba reste installé. Toutefois, migrez vers le nouveau pilote pour les futures mises à jour.

Existe-t-il des modifications de fonctionnalité ?

Non. Il s’agit d’un renommage uniquement. Toutes les fonctionnalités fonctionnent de façon identique.

Puis-je utiliser les deux pilotes simultanément ?

Yes. Installez les deux pilotes pour migrer de façon incrémentielle.

Pour obtenir de l’aide, contactez le support Technique Databricks ou votre équipe de compte pour obtenir de l’aide sur la migration.