Databricks 於 2026 年 2 月將 ODBC 驅動程式更名為 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、認證機械和憑證）保持不變。
步驟 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
步驟五：更新申請碼
更新你程式碼中的驅動程式名稱參考：
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 作業系統
請查看 ODBC 資料來源管理員>驅動程式 標籤中的「Databricks ODBC 驅動程式」。
Linux/macOS
執行下列命令。 產出內容包括 [Databricks ODBC Driver]：
odbcinst -q -d
工具專屬遷移
針對特定工具和平台，請依照以下額外步驟操作。
Tableau
大多數情況下，Tableau 會自動偵測到新的驅動程式。 請透過檢查 資料>[你的連線]>編輯連線來驗證。
Excel
在 ODBC 資料來源管理員中更新你的 DSN。 如果你使用 Power Query 公式，請更新所有指向驅動程式名稱的參考。
SQL Server 管理工作室
更新 SQL Server Management Studio（SSMS） 連結伺服器設定，這些設定會參考舊的驅動程式名稱，並重新測試你的查詢。
Troubleshooting
如果你在遷移過程中遇到問題，可以試試這些解決方案。
找不到駕駛員錯誤
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、認證機械和憑證）都保持不變。
我現有的 DSN 會停止運作嗎？
只要 Simba 驅動程式還在安裝，就不會。 不過，未來更新時請遷移到新驅動程式。
功能上有變動嗎？
否。 這只是重新命名。 所有功能運作方式相同。
我可以同時使用兩個驅動程式嗎？
是的。 安裝兩個驅動程式，逐步遷移。
如需協助，請聯絡 Databricks 支援 或您的帳戶團隊尋求遷移協助。