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