Миграция из драйвера ODBC Для Simba Spark в Databricks ODBC Driver

Databricks переименовал драйвер ODBC в феврале 2026 года. Это руководство поможет перенести существующие подключения из устаревшего драйвера ODBC Spark Simba Spark в драйвер ODBC Databricks.

Databricks больше не распространяет новые версии устаревшего драйвера Simba, но существующие версии остаются поддерживаемыми в течение двух лет. Databricks рекомендует перейти на новый драйвер, чтобы получить доступ к новейшим функциям и улучшениям. Оба драйвера могут сосуществовать во время миграции, поэтому при необходимости можно выполнять добавочную миграцию между приложениями, тестировать без нарушения рабочей среды и выполнять откат.

Что изменилось

Изменены только имена драйверов и пути установки. Все параметры подключения и функциональные возможности остаются одинаковыми.

Компонент Драйвер ODBC Для Simba Spark Драйвер ODBC Databricks
Путь установки 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

Шаги миграции

Выполните следующие действия, чтобы перейти из устаревшего драйвера ODBC Simba в Драйвер ODBC Databricks.

Шаг 1. Установка нового драйвера

Скачайте с страницы загрузки драйвера ODBC Databricks и запустите установщик для своей платформы.

Виндоус

.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=...

Все остальные параметры (Host, Port, HTTPPath, AuthMech и учетные данные) остаются неизменными.

Шаг 3. Обновление конфигураций DSN

Пропустите этот шаг, если вы используете строки подключения, не связанные с DSN.

Виндоус

  1. Откройте администратора источника данных ODBC.
  2. Выберите имя DSN и нажмите кнопку "Настроить".
  3. Выберите Databricks ODBC Driver из списка драйверов.
  4. Нажмите кнопку ОК.

Linux или macOS

Обновите odbc.ini файл, чтобы указать новую библиотеку драйверов:

Before:

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

After:

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

Имя файла общего объекта может отличаться версией драйвера. Чтобы подтвердить точное имя установленной версии, выполните rpm -ql databricksodbc (или find /opt/databricks/databricksodbc -name '*.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();

Убедитесь, что драйвер установлен:

Виндоус

Перейдите на вкладку"Драйверы администратора>источника данных ODBC ODBCДля Databricks".

Linux или macOS

Выполните следующую команду. Выходные данные включают [Databricks ODBC Driver]:

odbcinst -q -d

Миграция с определенным инструментом

Выполните следующие дополнительные действия для конкретных инструментов и платформ.

Tableau

Tableau автоматически обнаруживает новый драйвер в большинстве случаев. Проверьте, проверив данные>[ваше подключение]>Изменить подключение.

Excel

Обновите dsN в администраторе источника данных ODBC. При использовании формул 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

Часто задаваемые вопросы

Ниже приведены распространенные вопросы о миграции на обновленный драйвер.

Нужно ли изменять параметры подключения рядом с именем драйвера?

Нет. Все параметры (узел, порт, HTTPPath, AuthMech и учетные данные) остаются неизменными.

Перестанет ли работа существующих доменных сетей?

Нет, пока драйвер Simba остается установленным. Однако миграция на новый драйвер для будущих обновлений.

Есть ли какие-либо изменения в функциональности?

Нет. Это только переименование. Все функции работают одинаково.

Можно ли одновременно использовать оба драйвера?

Да. Установите оба драйвера для постепенной миграции.

Чтобы получить справку, обратитесь в службу поддержки Databricks или в службу поддержки учетной записи, чтобы получить помощь по миграции.

  • Last updated on