Requisitos do sistema, instalação e arquivos de driver

Baixar driver ODBC

Este artigo aborda os drivers ODBC que se conectam ao SQL Server.

Compatibilidade com versões do SQL

A compatibilidade indica que um driver foi testado quanto à compatibilidade em relação às versões existentes do SQL no momento da versão do driver. As versões do SQL Server geralmente tentam manter a compatibilidade com versões anteriores dos drivers de cliente existentes. Porém, novos recursos em versões do SQL Server podem não estar disponíveis com drivers de cliente mais antigos.

Versão do banco de dados →
↓ Versão do Driver
Banco de Dados SQL do Azure Azure Synapse Analytics Instância Gerenciada do Azure SQL SQL Server 2022 SQL Server 2019 SQL Server 2017 SQL Server 2016 SQL Server 2014 SQL Server 2012 SQL Server 2008 R2 SQL Server 2008 SQL Server 2005
18.4 Sim Sim Sim Sim Sim Sim Sim Sim
18.3 Sim Sim Sim Sim Sim Sim Sim Sim
18.2 Sim Sim Sim Sim Sim Sim Sim Sim
18.1 Sim Sim Sim Sim Sim Sim Sim Sim
18.0 Sim Sim Sim Sim Sim Sim Sim Sim Sim
17.10 Sim Sim Sim Sim Sim Sim Sim Sim Sim
17.9 Sim Sim Sim Sim Sim Sim Sim Sim
17.8 Sim Sim Sim Sim Sim Sim Sim Sim
17,7 Sim Sim Sim Sim Sim Sim Sim Sim
17.6 Sim Sim Sim Sim Sim Sim Sim Sim
17.5 Sim Sim Sim Sim Sim Sim Sim Sim
17.4 Sim Sim Sim Sim Sim Sim Sim Sim
17.3 Sim Sim Sim Sim Sim Sim Sim Sim Sim Sim
17.2 Sim Sim Sim Sim Sim Sim Sim Sim Sim
17.1 Sim Sim Sim Sim Sim Sim Sim Sim Sim
17,0 Sim Sim Sim Sim Sim Sim Sim Sim Sim
13.1 Sim Sim Sim Sim Sim Sim
13 Sim Sim Sim Sim Sim
11 Sim Sim Sim Sim Sim

Detalhes da cadeia de conexão

O nome do driver especificado em uma cadeia de conexão será um dos seguintes valores:

  • ODBC Driver 11 for SQL Server
  • ODBC Driver 13 for SQL Server (para 13 e 13.1)
  • ODBC Driver 17 for SQL Server
  • ODBC Driver 18 for SQL Server

Sistemas operacionais compatíveis

A seguinte matriz indica suporte à versão do driver para versões do sistema operacional Windows:

Sistema operacional →
↓ Versão do driver
Windows Server 2022 Windows Server 2019 Windows Server 2016 Windows Server 2012 R2 Windows Server 2012 Windows Server 2008 R2 Windows 11 Windows 10 Windows 8.1 Windows 7 Windows Vista SP2
18.4 Sim Sim Sim Sim Sim
18.3 Sim Sim Sim Sim Sim Sim
18.2 Sim Sim Sim Sim Sim Sim
18.1 Sim Sim Sim Sim Sim Sim Sim Sim
18.0 Sim Sim Sim Sim Sim Sim Sim Sim
17.10 Sim Sim Sim Sim Sim Sim Sim Sim
17.9 Sim Sim Sim Sim Sim Sim Sim Sim
17.8 Sim Sim Sim Sim Sim Sim
17,7 Sim Sim Sim Sim Sim Sim
17.6 Sim Sim Sim Sim Sim Sim
17.5 Sim Sim Sim Sim Sim Sim
17.4 Sim Sim Sim Sim Sim Sim Sim Sim
17.3 Sim Sim Sim Sim Sim Sim Sim Sim
17.2 Sim Sim Sim Sim Sim Sim Sim
17.1 Sim Sim Sim Sim Sim Sim Sim
17,0 Sim Sim Sim Sim Sim Sim Sim
13.1 Sim Sim Sim Sim Sim Sim Sim
13 Sim Sim Sim Sim
11 Sim Sim Sim Sim

Instalando o Microsoft ODBC Driver for SQL Server

O driver é instalado quando você executa msodbcsql.msi de um dos Downloads do Windows.

Nota

Para aqueles que têm o driver 17.1.0.1 ou anterior instalado, é recomendável que ele seja desinstalado manualmente antes de instalar a versão mais recente do driver.

Lado a lado com o Native Client

O driver pode ser instalado lado a lado com o SQL Server Native Client. As versões principais do driver (11, 13, 17, 18) também podem ser instaladas lado a lado entre si.

Quando você invoca msodbcsql.msi, só os componentes cliente são instalados por padrão. Os componentes cliente são arquivos que dão suporte à execução de um aplicativo que foi desenvolvido usando o driver. Para instalar os componentes do SDK, especifique ADDLOCAL=ALL na linha de comando. Veja um exemplo.

msiexec /i msodbcsql.msi ADDLOCAL=ALL

Licença de usuário final

Especifique IACCEPTMSODBCSQLLICENSETERMS=YES para aceitar os termos da licença do usuário final se você usar a opção de instalação /passive, /qn, /qb ou /qr. Essa opção deve ser especificada com todas as letras maiúsculas. Veja um exemplo.

msiexec /quiet /passive /qn /i msodbcsql.msi IACCEPTMSODBCSQLLICENSETERMS=YES ADDLOCAL=ALL

Desinstalação silenciosa

O exemplo a seguir mostra como realizar uma desinstalação silenciosa.

msiexec /quiet /passive /qn /uninstall msodbcsql.msi

Indicar dependência

Quando um aplicativo usa o driver, ele deve indicar que depende do driver por meio da opção de instalação APPGUID. Essa indicação permite que o instalador do driver relate aplicativos dependentes antes da desinstalação. Para especificar uma dependência no driver, defina o parâmetro de linha de comando APPGUID com o código de produto na instalação silenciosa do driver. É preciso criar um código de produto ao usar o Microsoft Installer para agrupar o programa de instalação do aplicativo. Veja um exemplo.

msiexec /i msodbcsql.msi APPGUID={ <Your dependent application's APPGUID> }

Ferramentas de linha de comando: sqlcmd.exe e bcp.exe

As ferramentas bcp.exe e sqlcmd.exe para uso com o driver podem ser baixadas em Utilitários de Linha de Comando 11 da Microsoft para SQL Server, Utilitários de Linha de Comando 13 da Microsoft para SQL Server ou Utilitários de Linha de Comando 13.1 da Microsoft para SQL Server. O driver é um pré-requisito para instalar sqlcmd.exe e bcp.exe.

bcp.exe e sqlcmd.exe são instalados na subpasta 110\Tools do %PROGRAMFILES%\Microsoft SQL Server\Client SDK\ODBC para a versão 11 e 130\Tools para a 13 e a 13,1.

Um aplicativo que usa funções do BCP precisa especificar o driver da mesma versão que a fornecida com o arquivo de cabeçalho e a biblioteca usados para compilar o aplicativo.

Por exemplo, quando você compilar um aplicativo ODBC com msodbcsql11.lib e msodbcsql.h, use DRIVER={ODBC Driver 11 for SQL Server} na cadeia de conexão.

Componentes do Microsoft ODBC Driver para SQL Server no Windows

O driver ODBC no Windows contém os seguintes componentes:

Componente Descrição
msodbcsql18.dll ou
msodbcsql17.dll ou
msodbcsql13.dll ou
msodbcsql11.dll
O arquivo de biblioteca de vínculo dinâmico (DLL) que contém toda a funcionalidade do driver. Esse arquivo é instalado em %SYSTEMROOT%\System32.
msodbcdiag18.dll ou
msodbcdiag17.dll ou
msodbcdiag13.dll ou
msodbcdiag11.dll
O arquivo DLL (biblioteca de vínculo dinâmico) que contém a interface de diagnóstico (rastreamento) do driver. Esse arquivo é instalado em %SYSTEMROOT%\System32.
msodbcsqlr18.rll ou
msodbcsqlr17.rll ou
msodbcsqlr13.rll ou
msodbcsqlr11.rll
O arquivo de recursos que acompanha a biblioteca do driver. Esse arquivo é instalado em %SYSTEMROOT%\System32\1033.
s13ch_msodbcsql.chm ou
s11ch_msodbcsql.chm
O arquivo de ajuda do Assistente para Fontes de Dados que documenta como criar uma fonte de dados do driver. Esse arquivo é instalado em %SYSTEMROOT%\System32\1033

OBSERVAÇÃO: não há nenhum arquivo chm para o Driver ODBC 17 e posterior.
msodbcsql.h O arquivo de cabeçalho que contém todas as novas definições necessárias para usar o driver.

Observação: você não pode referenciar msodbcsql.h e odbcss.h no mesmo programa.
msodbcsql.h para o Driver ODBC 18 está instalado no %PROGRAMFILES%\Microsoft SQL Server\Client SDK\ODBC\180\SDK.
msodbcsql.h para o Driver ODBC 17 está instalado no %PROGRAMFILES%\Microsoft SQL Server\Client SDK\ODBC\170\SDK.
msodbcsql.h para o Driver ODBC 13 está instalado no %PROGRAMFILES%\Microsoft SQL Server\Client SDK\ODBC\130\SDK.
msodbcsql.h para o Driver ODBC 11 está instalado no %PROGRAMFILES%\Microsoft SQL Server\Client SDK\ODBC\110\SDK.
msodbcsql18.lib ou
msodbcsql17.lib ou
msodbcsql13.lib ou
msodbcsql11.lib
O arquivo de biblioteca necessário para chamar as funções do utilitário bcp que fazem parte do driver.

Observação: se você referenciar esse arquivo de biblioteca no programa, verifique se ele está no caminho do sistema e no caminho do sistema dos usuários que usam o aplicativo.
msodbcsql18.lib está instalado em %PROGRAMFILES%\Microsoft SQL Server\Client SDK\ODBC\180\SDK.
msodbcsql17.lib está instalado em %PROGRAMFILES%\Microsoft SQL Server\Client SDK\ODBC\170\SDK.
msodbcsql13.lib está instalado em %PROGRAMFILES%\Microsoft SQL Server\Client SDK\ODBC\130\SDK.
msodbcsql11.lib está instalado em %PROGRAMFILES%\Microsoft SQL Server\Client SDK\ODBC\110\SDK.