Este artigo é uma tradução e adaptação do guia oficial da Microsoft sobre a instalação do Microsoft ODBC Driver para SQL Server no Linux, com foco específico no Ubuntu 24.04. O objetivo é fornecer um passo a passo claro e atualizado para profissionais de TI que desejam configurar o driver ODBC no Ubuntu 24.04, facilitando a conexão com o SQL Server.
Introdução
Muitos ambientes corporativos trabalham com soluções híbridas, onde aplicações Linux precisam acessar bancos de dados Microsoft SQL Server instalados em servidores Windows. Para que essa comunicação funcione corretamente, é necessário o uso de um driver ODBC (Open Database Connectivity) compatível com o sistema.
A Microsoft mantém seu próprio driver ODBC para Linux, compatível com diversas distribuições. Neste artigo, você aprenderá como instalar o Microsoft ODBC Driver no Ubuntu 24.04, de forma segura e com base na documentação oficial, adaptada para essa versão mais recente do Ubuntu.
A instalação correta deste driver é essencial para aplicações que dependem de consultas a bases SQL Server, como sistemas em Python, PHP, Java, ferramentas de BI, scripts automáticos ou aplicações corporativas em geral.
Este artigo é uma tradução e adaptação do conteúdo oficial da Microsoft, disponível em docs.microsoft.com.
O que é ODBC e por que usá-lo?
ODBC é uma interface padronizada que permite que aplicações se conectem a diferentes sistemas de banco de dados, como SQL Server, PostgreSQL e MySQL, de forma independente do sistema operacional ou linguagem de programação usada.
Ao optar pelo Microsoft ODBC Driver oficial, você garante:
- Melhor compatibilidade com o SQL Server, inclusive versões mais recentes.
- Melhor desempenho em conexões seguras e uso de funcionalidades nativas.
- Atualizações e correções de bugs diretamente da Microsoft.
- Suporte à autenticação moderna, TLS e criptografia.
Para ambientes que exigem estabilidade e suporte técnico, o uso do driver oficial é a melhor opção.
1. Verificando a versão do Ubuntu
Antes de iniciar a instalação, é fundamental verificar a versão do Ubuntu instalada:
lsb_release -aCertifique-se de que a saída indique o Ubuntu 24.04.
2. Importando a Chave GPG da Microsoft
Para garantir a autenticidade dos pacotes, importe a chave GPG da Microsoft:
curl https://packages.microsoft.com/keys/microsoft.asc | sudo gpg --dearmor -o /usr/share/keyrings/microsoft-prod.gpg3. Adicionando o Repositório da Microsoft
Adicione o repositório da Microsoft à lista de fontes do APT:
curl https://packages.microsoft.com/config/ubuntu/24.04/prod.list | sudo tee /etc/apt/sources.list.d/mssql-release.list4. Atualizando os pacotes do APT
Atualize a lista de pacotes do APT para reconhecer os novos pacotes disponíveis:
sudo apt-get update5. Instalando o Microsoft ODBC Driver 18
Instale o driver ODBC da Microsoft:
sudo ACCEPT_EULA=Y apt-get install -y msodbcsql18Este comando aceita automaticamente os termos de licença e instala o driver.
6. Instalando Ferramentas de Linha de Comando (Opcional)
Se desejar utilizar ferramentas como sqlcmd e bcp, instale o pacote mssql-tools18:
sudo ACCEPT_EULA=Y apt-get install -y mssql-tools18Adicione as ferramentas ao PATH para facilitar o uso:
echo 'export PATH="$PATH:/opt/mssql-tools18/bin"' >> ~/.bashrc
source ~/.bashrc7. Instalando Headers de Desenvolvimento (Opcional)
Para desenvolvimento com unixODBC, instale os headers necessários:
sudo apt-get install -y unixodbc-dev8. Verificando a Instalação do ODBC
Para confirmar que o driver foi instalado corretamente, utilize o seguinte comando:
odbcinst -jA saída deve indicar que o driver msodbcsql18 está disponível.
9. Exemplo de conexão via sqlcmd
Você pode testar a conexão com um servidor SQL usando o seguinte comando:
sqlcmd -S <IP ou HOSTNAME>,1433 -U SA -P 'SuaSenhaSegura'Se a conexão for bem-sucedida, você verá um prompt 1> onde poderá digitar consultas SQL.
10. Resolução de problemas comuns
Erro: EULA not accepted
→ Certifique-se de usar ACCEPT_EULA=Y antes dos comandos de instalação.
Erro: odbcinst: command not found
→ Verifique se o pacote unixodbc está instalado:
sudo apt install unixodbcProblemas com PATH após login
→ Confirme se você adicionou o diretório do mssql-tools18 corretamente ao .bashrc e reiniciou o shell.
Conexão recusada
→ Verifique se o SQL Server está escutando na porta 1433 e se não há firewall bloqueando.
Conclusão
A instalação do Microsoft ODBC Driver no Ubuntu 24.04 permite que seu ambiente Linux interaja diretamente com bancos SQL Server de forma segura, estável e compatível com padrões de mercado.
Além da instalação do driver, recomendamos manter o sistema sempre atualizado e consultar a documentação oficial sempre que houver lançamento de novas versões ou alterações de suporte.
Se você trabalha com desenvolvimento de integrações, automações ou administração de banco de dados, essa instalação é essencial para criar uma ponte eficiente entre o mundo Microsoft e o Linux.
Referências
Caso tenha alguma dúvida a respeito deste tópico sinta-se à vontade para entrar em contato.