DBAccess - Comportamentos relacionados ao nome da fonte de dados

O TOTVS | DBAccess estabelece uma conexão com os Bancos de Dados homologados através de um driver ODBC, para as plataformas Windows e Linux, sendo que para o ORACLE, normalmente é utilizada uma conexão através de uma biblioteca client chamada de OCI (Oracle Client Interface).

Independente do modo de conexão, para todos os casos, é necessário criar uma fonte de dados que precisa ser identificada por um nome distinto.

Este nome da fonte de dados, ou DSN (Data Source Name), preferencialmente, deve iniciar com uma letra e pode ter letras e/ou números.

Ao configurar o TOTVS | DBAccess para se conectar com um determinado Banco de Dados, informamos a ele qual o nome do DSN a ser utilizado, que deve ser exatamente o mesmo nome usado na ODBC.

É possível configurar, por exemplo, uma fonte de dados apontando para um database de homologação e outra fonte de dados para um database de testes.

A aplicação AdvPL acessa o TOTVS | DBAccess através do IP e Porta configurados em cada TOTVS | Application Server, e informa o Banco de Dados e o nome da fonte de dados a ser utilizada. 

Internamente, o TOTVS | DBAccess utiliza o nome da fonte de dados informado para controlar aspectos da emulação ISAM de acesso às tabelas, como o modo de abertura (exclusivo e/ou compartilhado, acesso completo ou somente leitura), bem como o mecanismo de bloqueios de arquivo e registro (bloqueio de registro linha a linha, ou do arquivo inteiro).

Estes controles fazem parte da compatibilidade exigida pelo AdvPL, e são feitos pelo TOTVS | DBAccess em listas mantidas em memória.

Sabendo dessa característica, sempre devemos criar apenas UMA fonte de dados nomeada (DSN/ODBC ) para UMA determinada instância de Banco de Dados.

Quando utilizamos o TOTVS | DBAccess em configuração distribuída, em mais de um equipamento, todas as fontes de dados criadas para um determinado database devem ter o mesmo nome em todas as máquinas, para que cada TOTVS | DBAccess secundário aponte para a fonte de dados de mesmo nome, que aponta para o mesmo Database.

Caso essas premissas não sejam respeitadas, a integridade dos dados de tabelas acessadas para alteração de dados em modo concorrente é seriamente prejudicada, pois dois programas AdvPL podem conseguir ao mesmo tempo um LOCK de registro para alteração, ou mesmo obter sucesso ao tentar abrir uma determinada tabela em modo EXCLUSIVO, nos cenários abaixo:

1. As instruções estão sendo executadas em programas conectando em dois  TOTVS | DBAccess stand-alone distintos, que apontam para o mesmo banco de dados.
2. Programas conectando com o mesmo TOTVS | DBAccess, usando duas fontes de dados de nomes distintos, que apontam para o mesmo banco de dados.