Requisitos do sistema, instalação e arquivos de driver
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 ServerODBC Driver 13 for SQL Server(para 13 e 13.1)ODBC Driver 17 for SQL ServerODBC 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.
Observação
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 oumsodbcsql17.dll oumsodbcsql13.dll oumsodbcsql11.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 oumsodbcdiag17.dll oumsodbcdiag13.dll oumsodbcdiag11.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 oumsodbcsqlr17.rll oumsodbcsqlr13.rll oumsodbcsqlr11.rll |
O arquivo de recursos que acompanha a biblioteca do driver. Esse arquivo é instalado em %SYSTEMROOT%\System32\1033. |
s13ch_msodbcsql.chm ous11ch_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\1033OBSERVAÇÃ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 oumsodbcsql17.lib oumsodbcsql13.lib oumsodbcsql11.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. |