Partilhar via

Migrar do Driver Simba Spark ODBC para o Driver ODBC Databricks

A Databricks renomeou o driver ODBC em fevereiro de 2026. Este guia ajuda-o a migrar as ligações existentes do antigo Simba Spark ODBC Driver para o Databricks ODBC Driver.

A Databricks já não distribui novas versões do driver legado Simba, mas as versões existentes continuam suportadas durante dois anos. A Databricks recomenda migrar para o novo driver para aceder às funcionalidades e melhorias mais recentes. Ambos os drivers podem coexistir durante a migração, por isso podes migrar incrementalmente entre aplicações, testar sem interromper a produção e reverter rapidamente se necessário.

O que mudou

Só o nome do driver e os caminhos de instalação mudaram. Todos os parâmetros e funcionalidades da ligação mantêm-se iguais.

Componente Simba Spark ODBC Driver Controlador 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

Etapas de migração

Complete estes passos para migrar do Driver Simba ODBC antigo para o Databricks ODBC Driver.

Passo 1: Instalar o novo driver

Descarregue a partir da página de downloads do Databricks ODBC Driver e execute o instalador para a sua plataforma.

Windows

Executa o instalador .msi e segue as indicações.

Linux (RPM)

sudo rpm -i databricks-odbc-*.rpm

Linux (DEB)

sudo dpkg -i databricks-odbc_*.deb

MacOS

Abre o .dmg ficheiro e executa o .pkg instalador.

Passo 2: Atualizar as cadeias de ligação

Muda o nome do driver nas túas cadeias de ligação:

Before:

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

After:

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

Todos os outros parâmetros (Host, Porta, HTTPPath, AuthMech e credenciais) mantêm-se inalterados.

Passo 3: Atualizar as configurações do DSN

Ignora este passo se usares cadeias de ligação sem DSN.

Windows

  1. Abra o Administrador da Fonte de Dados ODBC.
  2. Selecione o seu DSN e clique em Configurar.
  3. Selecione o Driver Databricks ODBC da lista de drivers.
  4. Clique em OK.

Linux/macOS

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

Before:

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

After:

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

Passo 4: Atualizar variáveis de ambiente (apenas Linux/macOS)

Se usares SIMBASPARKINI, altera para DATABRICKSODBCINI:

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

Passo 5: Atualizar o código da aplicação

Atualize as referências dos nomes do driver no seu código:

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

Passo 6: Verificar a migração

Testa a tua ligação:

SELECT current_version();

Confirme que o driver está instalado:

Windows

Consulte o separador ODBC Data Source Administrator> Drivers para "Databricks ODBC Driver".

Linux/macOS

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

odbcinst -q -d

Migração específica de ferramentas

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

Tabela

O Tableau deteta automaticamente o novo driver na maioria dos casos. Verifique verificando Dados>[A Sua Ligação]>Editar Ligação.

Excel

Atualize o seu DSN no ODBC Data Source Administrator. Se usares fórmulas do Power Query , atualiza quaisquer referências ao nome do driver.

SQL Server Management Studio

Atualize as configurações de servidores ligados do SQL Server Management Studio (SSMS ) que referenciam o nome antigo do driver e volte a testar as suas consultas.

Troubleshooting

Se encontrar problemas durante a migração, experimente estas soluções.

Erro de driver não encontrado

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

Soluções:

  • Verifique a instalação verificando o ODBC Data Source Administrator (Windows) ou execute odbcinst -q -d (Linux/macOS).
  • Verifique os caminhos dos condutores em odbc.ini ou odbcinst.ini.
  • Confirme a arquitetura correta (32 bits versus 64 bits).

Erros de carregamento de bibliotecas (Linux)

Error loading shared libraries

Solução: Instalar unixODBC:

# RPM-based
sudo yum install unixODBC

# Debian-based
sudo apt-get install unixodbc

Perguntas frequentes

As seguintes são perguntas comuns sobre a migração para o driver atualizado.

Preciso de alterar parâmetros de ligação para além do nome do driver?

Não. Todos os parâmetros (Host, Porta, HTTPPath, AuthMech e credenciais) mantêm-se iguais.

Os meus DSNs atuais vão deixar 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. Isto é apenas uma mudança de nome. Todas as funcionalidades funcionam da mesma forma.

Posso usar ambos os drivers simultaneamente?

Yes. Instala ambos os drivers para migrar incrementalmente.

Para obter ajuda, contacte o Suporte da Databricks ou a equipa da sua conta para obter assistência na migração.

  • Last updated on