Migrer du Driver ODBC Simba Spark vers le Driver ODBC Databricks
Databricks a renommé le driver ODBC en février 2026. Ce guide vous aide à migrer les connexions existantes du driver ODBC Simba Spark hérité vers le driver ODBC Databricks.
Databricks ne distribue plus de nouvelles versions du driver Simba hérité, mais les versions existantes restent prises en charge pendant deux ans. Databricks recommande de migrer vers le nouveau Driver pour accéder aux dernières fonctionnalités et améliorations. Les deux drivers peuvent coexister pendant la migration, vous pouvez donc migrer de manière incrémentielle entre les applications, tester sans perturber la production et revenir rapidement en arrière si nécessaire.
Ce qui a changé
Seuls le nom du driver et les chemins d'installation ont changé. Tous les paramètres de connexion et toutes les fonctionnalités restent les mêmes.
Composant | Driver ODBC Simba Spark | Driver ODBC Databricks |
|---|---|---|
Chemin d'installation Windows |
|
|
Chemin d'installation Linux |
|
|
Chemin d'installation macOS |
|
|
Variable d'environnement |
|
|
Clé de registre Windows (64 bits) |
|
|
Clé de registre Windows (32 bits) |
|
|
Étapes de migration
Suivez ces étapes pour migrer du Driver ODBC Simba hérité vers le Driver ODBC Databricks.
Étape 1 : Installez le nouveau driver
Téléchargez from the page de download du Driver ODBC Databricks et exécutez le programme d'installation pour votre plateforme.
- Windows
- Linux (RPM)
- Linux (DEB)
- MacOS
Exécutez l'installateur .msi et suivez les invites.
sudo rpm -i databricks-odbc-*.rpm
sudo dpkg -i databricks-odbc_*.deb
Ouvrez le fichier .dmg et exécutez l'installateur .pkg.
Étape 2 : Mettre à jour les chaînes de connexion
Modifiez le nom du driver dans vos chaînes de connexion :
Avant :
Driver={Simba Spark ODBC Driver};Host=...
Après :
Driver={Databricks ODBC Driver};Host=...
Tous les autres paramètres (Host, Port, HTTPPath, AuthMech et les informations d’identification) restent inchangés.
Étape 3 : Mettre à jour les configurations DSN
Ignorez cette étape si vous utilisez des chaînes de connexion sans DSN.
- Windows
- Linux/macOS
- Ouvrez l'administrateur de source de données ODBC.
- Sélectionnez votre DSN et cliquez sur Configurer .
- Sélectionnez Databricks ODBC Driver dans la liste des pilotes.
- Cliquez sur **OK**.
Mettez à jour votre fichier odbc.ini pour pointer vers la nouvelle bibliothèque de drivers :
Avant :
Driver=/opt/simba/spark/lib/64/libsparkodbc_sb64.so
Après :
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 d'application
Mettre à jour les références de noms de Driver dans votre code :
- Python
- Java
- C#
- C/C++
# Before
conn_str = "Driver={Simba Spark ODBC Driver};..."
# After
conn_str = "Driver={Databricks ODBC Driver};..."
// Before
String connStr = "jdbc:odbc:Driver={Simba Spark ODBC Driver};...";
// After
String connStr = "jdbc:odbc:Driver={Databricks ODBC Driver};...";
// Before
string connStr = "Driver={Simba Spark ODBC Driver};...";
// After
string connStr = "Driver={Databricks ODBC Driver};...";
// Before
SQLCHAR connStr[] = "Driver={Simba Spark ODBC Driver};...";
// After
SQLCHAR connStr[] = "Driver={Databricks ODBC Driver};...";
Étape 6 : Vérifier la migration
Testez votre connexion :
SELECT current_version();
Confirmez que le Driver est installé :
- Windows
- Linux/macOS
Vérifiez ODBC Data Source Administrator > Drivers tab pour "Databricks ODBC Driver".
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 des plateformes spécifiques.
Tableau
Tableau détecte automatiquement le nouveau Driver dans la plupart des cas. Vérifiez en accédant à Données > [Votre connexion] > Modifier la connexion .
Excel
Mettez à jour votre DSN dans l'Administrateur de sources de données ODBC. Si vous utilisez des formules Power Query, mettez à jour toutes les références au nom du Driver.
SQL Server Management Studio
Mettez à jour les configurations du serveur lié SQL Server Management Studio (SSMS) qui font référence à l'ancien nom de Driver et retestez vos requêtes.
Dépannage
Si vous rencontrez des problèmes lors de la migration, essayez ces solutions.
Erreur Driver introuvable
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 exécutez
odbcinst -q -d(Linux/macOS). - Vérifiez les chemins du Driver dans
odbc.iniouodbcinst.ini. - Confirmez la bonne architecture (32 bits ou 64 bits).
Erreurs de chargement de bibliothèque (Linux)
Error loading shared libraries
Solution : Installer unixODBC :
# RPM-based
sudo yum install unixODBC
# Debian-based
sudo apt-get install unixodbc
Questions fréquemment posées
Voici les questions courantes concernant la migration vers le Driver mis à jour.
Devez-vous changer les paramètres de connexion outre le nom du driver ?
Non. Tous les paramètres (Hôte, Port, HTTPPath, AuthMech et identifiants) restent les mêmes.
Mes DSN existants cesseront-ils de fonctionner ?
Non, tant que le driver Simba reste installé. Cependant, migrez vers le nouveau driver pour les futures mises à jour.
Y a-t-il un changement de fonctionnalité ?
N°. Il s'agit uniquement d'un changement de nom. Toutes les fonctionnalités fonctionnent de manière identique.
Puis-je utiliser les deux drivers simultanément ?
Oui. Installez les deux Drivers pour migrer de manière incrémentielle.
Pour obtenir de l'aide, contactez l'assistance Databricks ou votre équipe de compte pour obtenir de l'aide à la migration.