Databricks は、2026 年 2 月に ODBC ドライバーの名前を変更しました。 このガイドは、従来の Simba Spark ODBC ドライバーから Databricks ODBC ドライバーに既存の接続を移行するのに役立ちます。
Databricks は従来の Simba ドライバーの新しいバージョンを配布しなくなりましたが、既存のバージョンは 2 年間サポートされたままです。 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 |
| Windows レジストリ キー (64 ビット) | HKEY_LOCAL_MACHINE\SOFTWARE\Simba\Simba Spark ODBC Driver\Driver |
HKEY_LOCAL_MACHINE\SOFTWARE\Databricks\Databricks ODBC Driver\Driver |
| Windows レジストリ キー (32 ビット) | HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Simba\Simba Spark ODBC Driver\Driver |
HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Databricks\Databricks ODBC Driver\Driver |
移行の手順
従来の Simba ODBC ドライバーから Databricks ODBC ドライバーに移行するには、次の手順を実行します。
手順 1: 新しいドライバーをインストールする
Databricks ODBC ドライバーのダウンロード ページからダウンロードし、プラットフォームのインストーラーを実行します。
ウィンドウズ
.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 レス接続文字列を使用する場合は、この手順をスキップします。
ウィンドウズ
- ODBC データ ソース アドミニストレーターを開きます。
- DSN を選択し、[ 構成] をクリックします。
- ドライバーの一覧から Databricks ODBC ドライバー を選択します。
- OK をクリックします。
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};...";
C/C++
// Before
SQLCHAR connStr[] = "Driver={Simba Spark ODBC Driver};...";
// After
SQLCHAR connStr[] = "Driver={Databricks ODBC Driver};...";
手順 6: 移行を確認する
接続をテストします。
SELECT current_version();
ドライバーがインストールされていることを確認します。
ウィンドウズ
[Databricks ODBC Driver]\(Databricks ODBC ドライバー\) の [ODBC Data Source Administrator>Drivers ] タブを確認します。
Linux または macOS
次のコマンドを実行します。 出力には、次の [Databricks ODBC Driver]が含まれます。
odbcinst -q -d
ツール固有の移行
特定のツールとプラットフォームについては、次の追加の手順に従います。
Tableau
ほとんどの場合、Tableau は新しいドライバーを自動的に検出します。 [接続]>[接続の>]をオンにして確認します。
エクセル
ODBC データ ソース管理者で DSN を更新します。 Power Query の数式を使用する場合は、ドライバー名への参照を更新します。
SQL Server Management Studio
古いドライバー名を参照し、クエリを再テストする 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) を実行してインストールを確認します。 -
odbc.iniまたはodbcinst.iniのドライバー パスを確認します。 - 正しいアーキテクチャ (32 ビットと 64 ビット) を確認します。
ライブラリの読み込みエラー (Linux)
Error loading shared libraries
ソリューション: unixODBC をインストールします。
# RPM-based
sudo yum install unixODBC
# Debian-based
sudo apt-get install unixodbc
よく寄せられる質問
更新されたドライバーへの移行に関する一般的な質問を次に示します。
ドライバー名以外に接続パラメーターを変更する必要がありますか?
No. すべてのパラメーター (ホスト、ポート、HTTPPath、AuthMech、資格情報) は同じままです。
既存の DSN は機能しなくなりますか?
いいえ。Simba ドライバーがインストールされている限り。 ただし、今後の更新のために新しいドライバーに移行します。
機能の変更はありますか?
No. これは名前の変更のみです。 すべての機能は同じように動作します。
両方のドライバーを同時に使用できますか?
Yes. 両方のドライバーをインストールして段階的に移行します。
サポートを受ける場合は、 Databricks サポート またはアカウント チームにお問い合わせください。