01. INTRODUÇÃO

Este documento apresenta os procedimentos para criação de uma fonte de dados (DSN) para uso com o Microsoft SQL Server, para ambientes com Sistema Operacional Windows e Linux, para uso com o .

02. REQUISITOS


Lembre-se de ter previamente instalado os drivers ODBC do Microsoft SQL Server condizente com a mesma arquitetura (32 bits ou 64 bits) do .

Driver ODBC para Windows: https://learn.microsoft.com/en-us/sql/connect/odbc/download-odbc-driver-for-sql-server?view=sql-server-ver15

Driver ODBC para Linux: https://docs.microsoft.com/en-us/sql/connect/odbc/linux-mac/installing-the-microsoft-odbc-driver-for-sql-server?view=sql-server-ver15

Compatibilidade da versões dos drivers com as versões dos SGBDs: https://docs.microsoft.com/en-us/sql/connect/odbc/windows/system-requirements-installation-and-driver-files?view=sql-server-ver15

Nessa página:

02. PROCEDIMENTOS - Windows


Para garantir que a fonte de dados seja visível a todos os usuários logados ao servidor em que está instalado o , crie a fonte de dados como System DSN (DSN de Sistema).



Inicie o ODBC Data Source Administrator condizente com a arquitetura .

  • 32 bits
    Execute %WinDir%\SysWoW64\odbcad32.exe



  • 64 bits
    Execute %WinDir%\System32\odbcad32.exe



Crie uma nova fonte de dados.


Utilize versão de driver em que o suporte a MARS esteja habilitado por padrão.

Recomendamos a última versão do ODBC Driver disponível no site da Microsoft que seja compatível com a versão do Microsoft SQL Server utilizado.

O driver SQL Server não tem suporte a MARS e portanto não deve ser utilizado.

Coloque o nome da fonte de dados e o endereço do servidor do Microsoft SQL Server (IP ou hostname).

  • Não confunda o endereço do Microsoft SQL Server com o do , que não necessariamente podem estar instalados na mesma máquina.
  • O nome da fonte de dados é o mesmo que será utilizado para criação de ambiente Microsoft SQL Server dentro do .



Em How should SQL Server verify the authenticity of the login ID?, selecione a opção With SQL Server authentication using a login ID and password entered by the user e coloque o nome de usuário e senha para conexão com o Microsoft SQL Server.



Marque as opções Use ANSI quoted identifiers e Use ANSI nulls, paddings and warnings.

Caso o database padrão seja diferente do database que será utilizado, marque a opção Change the default database to e escolha no combobox abaixo qual é o database que será utilizado.


O nome da fonte de dados e do database não precisam ser iguais.

Marque a opção Perform translation for character data.

As opções Use strong encryption for data e Trust server certificate devem ser ou não marcadas dependendo da instalação do Microsoft SQL Server. Consulte seu DBA para verificar sobre o uso dessas opções.


Finalize a configuração e faça o teste de conexão.


04. PROCEDIMENTOS - Linux


Recomendamos o uso da unixODBC por garantir o mesmo comportamento para diferentes drivers de SGBDs diferentes. As próximas informações tem como base a instalação da unixODBC.

Atualmente está disponível apenas a versão 64 bits do driver ODBC para Microsoft SQL Server.

Abra o arquivo odbc.ini e crie uma nova fonte de dados seguindo o modelo de seu driver.

Utilize o driver Microsoft ODBC Driver 17 for SQL Server ou superior.

Altere a nova fonte de dados de acordo com suas informações de acesso ao banco e configure as chaves:

  • Em AnsiNPW, informe Yes.
  • Em QuotedID, informe Yes.
  • Em AutoTranslate, informe No.


Lista de chaves utilizadas pelo Microsoft SQL Server: https://docs.microsoft.com/en-us/sql/connect/odbc/dsn-connection-string-attribute?view=sql-server-ver15

Como conectar com o Microsoft SQL Server no Linux: https://docs.microsoft.com/en-us/sql/connect/odbc/linux-mac/connection-string-keywords-and-data-source-names-dsns?view=sql-server-ver15

O  utiliza o protocolo TCP para conexão com o Microsoft SQL Server.

Após a edição, faça o teste de conexão da unixODBC com o utilitário isql.


isql -v DSN username password



05. DEMAIS INFORMAÇÕES

O procedimento para a criação de uma fonte de dados ODBC, por uma particularidade do sistema operacional, pode variar quanto aos passos, mas suas parametrizações (sessões e chaves) tendem a serem as mesmas independentemente do tipo de sistema.



06. ASSUNTOS RELACIONADOS


<script>
AJS.toInit(function () {
  // 55 px is collapsed state
  if (AJS.$("div.ia-fixed-sidebar").width() != 55) {
    AJS.$("a.expand-collapse-trigger").click();
  }
});
</script>