Migre do driver ODBC Simba Spark para o driver ODBC Databricks.

Em fevereiro de 2026, a Databricks renomeou o driver ODBC. Este guia ajuda você a migrar conexões existentes do driver ODBC legado do Simba Spark para o driver ODBC do Databricks.

A Databricks não está mais distribuindo novas versões do driver Simba legado, mas as versões existentes continuarão com suporte por dois anos. Databricks recomenda a migração para o novo driver para obter acesso aos recursos e melhorias mais recentes. Ambos os drivers podem coexistir durante a migração, permitindo migrar incrementalmente entre aplicações, testar sem interromper a produção e reverter rapidamente, se necessário.

O que mudou?

Apenas o nome do driver e os caminhos de instalação foram alterados. Todos os parâmetros de conexão e funcionalidades permanecem os mesmos.

Componente	Driver ODBC Simba Spark	Driver ODBC do Databricks
caminho de instalação do Windows	C:\Program Files\Simba Spark ODBC Driver	C:\Program Files\Databricks ODBC Driver
caminho de instalação do Linux	/opt/simba/spark	/opt/databricks/databricksodbc
caminho de instalação do macOS	/Library/simba/spark	/Library/databricks/databricksodbc
Variável de ambiente	SIMBASPARKINI	DATABRICKSODBCINI

Migração os passos

Siga estes passos para migrar do driver ODBC Simba legado para o driver ODBC Databricks .

Passo 1: Instale o novo driver

Faça o download do driver ODBC na página download Databricks e execute o instalador para sua plataforma.

Windows

execute o instalador .msi e siga as instruções.

Linux (RPM)

Bash

sudo rpm -i databricks-odbc-*.rpm

Linux (DEB)

Bash

sudo dpkg -i databricks-odbc_*.deb

MacOS

Abra o arquivo .dmg e execute o instalador .pkg .

o passo 2: Atualizar stringsde conexão

Altere o nome do driver nas suas strings de conexão:

Antes:

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

Depois:

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

Todos os outros parâmetros (Host, Porta, HTTPPath, AuthMech e credenciais) permanecem inalterados.

o passo 3: Atualizar configurações DSN

Ignore esta etapa se você usar strings de conexão sem DSN.

Windows

1. Abra o administrador da fonte de dadosODBC.
2. Selecione seu DSN e clique em Configurar .
3. Selecione o driver ODBC do Databricks na lista de drivers.
4. Clique em OK .

Linux/macOS

Atualize seu arquivo odbc.ini para apontar para a nova biblioteca de drivers:

Antes:

ini

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

Depois:

ini

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

o passo 4: Atualizar variável de ambiente (somente Linux/macOS)

Se você usar SIMBASPARKINI, altere para DATABRICKSODBCINI:

Bash

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

o passo 5: Atualizar código do aplicativo

Atualize as referências aos nomes dos drivers no seu código:

Python

Python

# Before
conn_str = "Driver={Simba Spark ODBC Driver};..."

# After
conn_str = "Driver={Databricks ODBC Driver};..."

Java

Java

// Before
String connStr = "jdbc:odbc:Driver={Simba Spark ODBC Driver};...";

// After
String connStr = "jdbc:odbc:Driver={Databricks ODBC Driver};...";

C#

Csharp

// Before
string connStr = "Driver={Simba Spark ODBC Driver};...";

// After
string connStr = "Driver={Databricks ODBC Driver};...";

o passo 6: Verificar a migração

Teste sua conexão:

SQL

SELECT current_version();

Confirme se o driver está instalado:

Windows

Verifique a fonte de dadosODBC Administrador > tab Drivers para "Databricks ODBC Driver".

Linux/macOS

execute o seguinte comando. A saída inclui [Databricks ODBC Driver]:

Bash

odbcinst -q -d

Migração específica da ferramenta

Siga estes passos adicionais para ferramentas e plataformas específicas.

Tableau

Na maioria dos casos, o Tableau detecta automaticamente o novo motorista. Verifique acessando Dados > [Sua conexão] > Editar conexão .

Excel

Atualize seu DSN no Administrador da fonte de dados ODBC . Se você usar fórmulas do Power Query , atualize todas as referências ao nome do driver.

SQL Server Management Studio

Atualize as configurações do servidor vinculado do SQL Server Management Studio (SSMS) que fazem referência ao nome do driver antigo e teste novamente suas consultas.

Solução de problemas

Se você encontrar problemas durante a migração, tente estas soluções.

Erro "Driver não encontrado"

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

par:

• Verifique a instalação verificando a fonte de dados ODBC Administrador (Windows) ou execução odbcinst -q -d (Linux/macOS).
• Verifique os caminhos do driver em odbc.ini ou odbcinst.ini.
• Confirme a arquitetura correta (32 bits ou 64 bits).

Erros de carregamento de biblioteca (Linux)

Error loading shared libraries

Comentário: Instale o unixODBC:

Bash

# RPM-based
sudo yum install unixODBC

# Debian-based
sudo apt-get install unixodbc

Perguntas frequentes

A seguir, apresentamos algumas perguntas frequentes sobre a migração para o driver atualizado.

Preciso alterar algum parâmetro de conexão além do nome do driver?

Não. Todos os parâmetros (Host, Porta, HTTPPath, AuthMech e credenciais) permanecem os mesmos.

Meus DSNs atuais deixarão de funcionar?

Não, desde que o driver Simba permaneça instalado. No entanto, migre para o novo driver para futuras atualizações.

Houve alguma alteração na funcionalidade?

Não. Trata-se apenas de uma mudança de nome. Todos os recursos funcionam da mesma forma.

Posso usar os dois drivers simultaneamente?

Sim. Instale ambos os drivers para migrar incrementalmente.

Para obter ajuda, entre em contato com o SuporteDatabricks ou com sua equipe account para obter assistência com a migração.