Pular para o conteúdo principal
Última atualização em

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

key de registro Windows (64 bits)

HKEY_LOCAL_MACHINE\SOFTWARE\Simba\Simba Spark ODBC Driver\Driver

HKEY_LOCAL_MACHINE\SOFTWARE\Databricks\Databricks ODBC Driver\Driver

key de registro Windows (32 bits)

HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Simba\Simba Spark ODBC Driver\Driver

HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Databricks\Databricks ODBC Driver\Driver

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

key de registro Windows (64 bits)

HKEY_LOCAL_MACHINE\SOFTWARE\Simba\Simba Spark ODBC Driver\Driver

HKEY_LOCAL_MACHINE\SOFTWARE\Databricks\Databricks ODBC Driver\Driver

key de registro Windows (32 bits)

HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Simba\Simba Spark ODBC Driver\Driver

HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Databricks\Databricks ODBC Driver\Driver

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.

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

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.

  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 .

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
# Before
conn_str = "Driver={Simba Spark ODBC Driver};..."

# After
conn_str = "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:

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

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.

Nesta página