Migrasi dari Simba Spark ODBC Driver ke Driver Databricks ODBC

Databricks mengganti nama driver ODBC pada Februari 2026. Panduan ini membantu Anda memigrasikan koneksi yang ada dari Driver ODBC Simba Spark warisan ke Driver ODBC Databricks.

Databricks tidak lagi mendistribusikan versi baru driver Simba warisan, tetapi versi yang ada tetap didukung selama dua tahun. Databricks merekomendasikan migrasi ke driver baru untuk mendapatkan akses ke fitur dan peningkatan terbaru. Kedua driver dapat hidup berdampingan selama migrasi, sehingga Anda dapat bermigrasi secara bertahap di seluruh aplikasi, menguji tanpa mengganggu produksi, dan mengembalikan dengan cepat jika diperlukan.

Apa yang berubah

Hanya nama driver dan jalur penginstalan yang berubah. Semua parameter dan fungsionalitas koneksi tetap sama.

Komponen	Simba Spark ODBC Driver	Databricks ODBC Driver
Jalur penginstalan Windows	C:\Program Files\Simba Spark ODBC Driver	C:\Program Files\Databricks ODBC Driver
Jalur penginstalan Linux	/opt/simba/spark	/opt/databricks/databricksodbc
Jalur penginstalan macOS	/Library/simba/spark	/Library/databricks/databricksodbc
Variabel lingkungan	SIMBASPARKINI	DATABRICKSODBCINI
Kunci registri Windows (64-bit)	HKEY_LOCAL_MACHINE\SOFTWARE\Simba\Simba Spark ODBC Driver\Driver	HKEY_LOCAL_MACHINE\SOFTWARE\Databricks\Databricks ODBC Driver\Driver
Kunci registri Windows (32-bit)	HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Simba\Simba Spark ODBC Driver\Driver	HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Databricks\Databricks ODBC Driver\Driver

Langkah-langkah migrasi

Selesaikan langkah-langkah ini untuk bermigrasi dari Driver ODBC Simba warisan ke Driver ODBC Databricks.

Langkah 1: Instal driver baru

Unduh dari halaman unduhan Driver ODBC Databricks dan jalankan alat penginstal untuk platform Anda.

Windows

Jalankan alat .msi penginstal dan ikuti perintah.

Linux (RPM)

sudo rpm -i databricks-odbc-*.rpm

Linux (DEB)

sudo dpkg -i databricks-odbc_*.deb

MacOS

.dmg Buka file dan jalankan alat penginstal.pkg.

Langkah 2: Memperbarui string koneksi

Ubah nama driver dalam string koneksi Anda:

Before:

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

After:

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

Semua parameter lainnya (Host, Port, HTTPPath, AuthMech, dan kredensial) tetap tidak berubah.

Langkah 3: Memperbarui konfigurasi DSN

Lewati langkah ini jika Anda menggunakan string koneksi tanpa DSN.

Windows

1. Buka Administrator Sumber Data ODBC.
2. Pilih DSN Anda dan klik Konfigurasikan.
3. Pilih Driver ODBC Databricks dari daftar driver.
4. Klik OK.

Linux/macOS

Perbarui file Anda odbc.ini untuk menunjuk ke pustaka driver baru:

Before:

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

After:

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

Langkah 4: Memperbarui variabel lingkungan (khusus Linux/macOS)

Jika Anda menggunakan SIMBASPARKINI, ubah menjadi DATABRICKSODBCINI:

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

Langkah 5: Memperbarui kode aplikasi

Perbarui referensi nama driver dalam kode Anda:

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};...";

Langkah 6: Verifikasi migrasi

Uji koneksi Anda:

SELECT current_version();

Konfirmasikan bahwa pengandar telah terinstal:

Windows

Periksa tabDriver> Sumber Data ODBC untuk "Driver ODBC Databricks".

Linux/macOS

Jalankan perintah berikut. Output meliputi [Databricks ODBC Driver]:

odbcinst -q -d

Migrasi khusus alat

Ikuti langkah-langkah tambahan ini untuk alat dan platform tertentu.

Tableau

Tableau secara otomatis mendeteksi driver baru dalam banyak kasus. Verifikasi dengan memeriksa Data>[Koneksi Anda]>Edit Koneksi.

Excel

Perbarui DSN Anda di Administrator Sumber Data ODBC. Jika Anda menggunakan rumus Power Query , perbarui referensi apa pun ke nama driver.

SQL Server Management Studio

Perbarui konfigurasi server tertaut SQL Server Management Studio (SSMS) yang mereferensikan nama driver lama dan mencoba kembali kueri Anda.

Troubleshooting

Jika Anda mengalami masalah selama migrasi, coba solusi ini.

Kesalahan driver tidak ditemukan

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

Solusi:

• Verifikasi penginstalan dengan memeriksa Administrator Sumber Data ODBC (Windows) atau jalankan odbcinst -q -d (Linux/macOS).
• Verifikasi jalur driver di odbc.ini atau odbcinst.ini.
• Konfirmasi arsitektur yang benar (32-bit versus 64-bit).

Kesalahan pemuatan pustaka (Linux)

Error loading shared libraries

Solusi: Instal unixODBC:

# RPM-based
sudo yum install unixODBC

# Debian-based
sudo apt-get install unixodbc

Tanya jawab umum

Berikut ini adalah pertanyaan umum tentang migrasi ke driver yang diperbarui.

Apakah saya perlu mengubah parameter koneksi selain nama driver?

Tidak. Semua parameter (Host, Port, HTTPPath, AuthMech, dan kredensial) tetap sama.

Apakah DSN saya yang ada akan berhenti berfungsi?

Tidak, selama driver Simba tetap terpasang. Namun, migrasikan ke driver baru untuk pembaruan di masa mendatang.

Apakah ada perubahan fungsionalitas?

Tidak. Ini hanya mengganti nama. Semua fitur berfungsi secara identik.

Dapatkah saya menggunakan kedua driver secara bersamaan?

Ya. Pasang kedua driver untuk bermigrasi secara bertahap.

Untuk mendapatkan bantuan, hubungi Dukungan Databricks atau tim akun Anda untuk bantuan migrasi.