Árvore de páginas


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 TOTVS | DBAccess.

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 TOTVS | DBAccess.

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 TOTVS | DBAccess, crie a fonte de dados como System DSN (DSN de Sistema).



Inicie o ODBC Data Source Administrator condizente com a arquitetura TOTVS | DBAccess.

  • 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.

Importante

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).

Observação

  • Não confunda o endereço do Microsoft SQL Server com o do TOTVS | DBAccess, 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 TOTVS | DBAccess.



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.

Observação

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.


Importante

O TOTVS | DBAccess 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