Databricks 于 2026 年 2 月重命名了 ODBC 驱动程序。 本指南可帮助你将现有连接从旧版 Simba Spark ODBC 驱动程序迁移到 Databricks ODBC 驱动程序。
Databricks 不再分发旧版 Simba 驱动程序的新版本，但现有版本仍受支持两年。 Databricks 建议迁移到新驱动程序，以获取对最新功能和改进的访问权限。 两个驱动程序都可以在迁移期间共存，因此可以在应用程序之间以增量方式迁移，无需中断生产即可进行测试，并在需要时快速回滚。
变更了什么
只有驱动程序名称和安装路径已更改。 所有连接参数和功能保持不变。
| 组件 | Simba Spark ODBC 驱动程序 | Databricks ODBC 驱动程序 |
|---|---|---|
| Windows 安装路径 | C:\Program Files\Simba Spark ODBC Driver |
C:\Program Files\Databricks ODBC Driver |
| Linux 安装路径 | /opt/simba/spark |
/opt/databricks/databricksodbc |
| macOS 安装路径 | /Library/simba/spark |
/Library/databricks/databricksodbc |
| 环境变量 | SIMBASPARKINI |
DATABRICKSODBCINI |
迁移步骤
完成这些步骤以从旧版 Simba ODBC 驱动程序迁移到 Databricks ODBC 驱动程序。
步骤 1：安装新驱动程序
从 Databricks ODBC 驱动程序下载页下载 并运行平台的安装程序。
Windows操作系统
.msi运行安装程序并按照提示进行操作。
Linux （RPM）
sudo rpm -i databricks-odbc-*.rpm
Linux （DEB）
sudo dpkg -i databricks-odbc_*.deb
MacOS
.dmg打开该文件并运行.pkg安装程序。
步骤 2：更新连接字符串
更改连接字符串中的驱动程序名称：
Before:
Driver={Simba Spark ODBC Driver};Host=...
After:
Driver={Databricks ODBC Driver};Host=...
所有其他参数（主机、端口、HTTPPath、AuthMech 和凭据）保持不变。
步骤 3：更新 DSN 配置
如果使用无 DSN 连接字符串，请跳过此步骤。
Windows操作系统
- 打开 ODBC 数据源管理员。
- 选择 DSN 并单击“ 配置”。
- 从 驱动程序列表中选择 Databricks ODBC 驱动程序 。
- 单击 “确定” 。
Linux/macOS
odbc.ini更新文件以指向新的驱动程序库：
Before:
Driver=/opt/simba/spark/lib/64/libsparkodbc_sb64.so
After:
Driver=/opt/databricks/databricksodbc/lib/64/libdatabricksodbc_sb64.so
步骤 4：仅更新环境变量（仅限 Linux/macOS）
如果使用 SIMBASPARKINI，请将其更改为 DATABRICKSODBCINI：
export DATABRICKSODBCINI=/path/to/databricks.odbc.ini
步骤 5：更新应用程序代码
更新代码中的驱动程序名称引用：
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};...";
步骤 6：验证迁移
测试连接：
SELECT current_version();
确认已安装驱动程序：
Windows操作系统
选中“Databricks ODBC 驱动程序”的 ODBC 数据源管理员>驱动程序 选项卡。
Linux/macOS
运行以下命令。 输出包括 [Databricks ODBC Driver]：
odbcinst -q -d
特定于工具的迁移
针对特定工具和平台，请按照以下附加步骤操作。
Tableau
在大多数情况下，Tableau 会自动检测新驱动程序。 通过检查 数据>[连接]>编辑连接进行验证。
Excel
在 ODBC 数据源管理员中更新 DSN。 如果使用 Power Query 公式，请更新对驱动程序名称的任何引用。
SQL Server Management Studio
更新引用旧驱动程序名称和重新测试查询的 SQL Server Management Studio（SSMS） 链接服务器配置。
故障排除
如果在迁移过程中遇到问题，请尝试这些解决方案。
找不到驱动程序错误
Error: [IM002] Data source name not found and no default driver specified
解决方案：
- 通过检查 ODBC 数据源管理员（Windows）或运行
odbcinst -q -d（Linux/macOS）来验证安装。 - 在或
odbcinst.ini. 中odbc.ini验证驱动程序路径。 - 确认正确的体系结构（32 位与 64 位）。
库加载错误 （Linux）
Error loading shared libraries
解决 方案： 安装 unixODBC：
# RPM-based
sudo yum install unixODBC
# Debian-based
sudo apt-get install unixodbc
常见问题解答
以下是有关迁移到更新的驱动程序的常见问题。
除了驱动程序名称之外，是否需要更改连接参数？
否。 所有参数（主机、端口、HTTPPath、AuthMech 和凭据）保持不变。
我的现有 DSN 是否会停止工作？
否，只要 Simba 驱动程序仍安装。 但是，迁移到新驱动程序以供将来更新。
是否有任何功能更改？
否。 这只是重命名。 所有功能的工作方式相同。
是否可以同时使用这两个驱动程序？
是的。 安装这两个驱动程序以增量方式迁移。
若要获取帮助，请联系 Databricks 支持 部门或帐户团队获取迁移帮助。