🗂️ Categoria

TOTVS Tecnologia / Dbaccess

📝 Resumo

Este artigo apresenta as boas práticas recomendadas pela Mastersiga Consultoria para configuração do TOTVS DBAccess, com foco em estabilidade, performance e prevenção de erros intermitentes, como fechamentos inesperados do Protheus e mensagens de perda de conexão durante a navegação de dados.

As orientações aqui descritas são baseadas em atendimentos reais em ambientes produtivos com TOTVS Microsiga Protheus, TSS e banco de dados MSSQL.

🎯 Aplicabilidade

Este conteúdo se aplica a ambientes que utilizam:

• TOTVS Microsiga Protheus (Produção, Homologação e Testes)

• TOTVS TSS (SPED / NF-e / NFS-e)

• Banco de dados Microsoft SQL Server

• DBAccess em Windows ou Linux

Especialmente recomendado para ambientes que apresentam:

• Fechamento inesperado do Protheus

• Erros do tipo NO CONNECTION, FWBRWTABLE, SKIP

• Instabilidade intermitente sem erro funcional aparente

⚙️ Pré-requisitos

• Acesso ao arquivo dbaccess.ini

• Permissão para reinício do serviço TOTVS DBAccess

• Conhecimento básico da arquitetura Protheus (AppServer ↔ DBAccess ↔ Banco)

🧠 Conceito técnico essencial

O DBAccess é a camada responsável por intermediar a comunicação entre o AppServer Protheus e o banco de dados.
Qualquer instabilidade nessa camada pode impactar diretamente:

• Navegação em telas

• Execução de consultas

• Rotinas fiscais (SPED, NF-e, NFS-e)

• Sessões ativas de usuários

Por isso, uma configuração inadequada pode gerar sintomas que não são erros funcionais, mas sim incidentes de infraestrutura.

🛠️ Passo a passo — Configuração recomendada

1️⃣ Auditoria: manter desabilitada em produção

Em ambientes produtivos, não é recomendado manter auditoria ativa permanentemente, pois isso gera overhead e pode causar lentidão ou instabilidade.

Configuração recomendada:

AuditLog=0
AuditLevel=0
AuditAll=0
AuditSqlExec=0
AuditProcExec=0
AuditThreadComment=0
AuditERPUserName=0
AuditSingleThread=0

📌 A auditoria deve ser habilitada somente de forma temporária, para diagnóstico pontual.

2️⃣ MAXSTRINGSIZE: atenção ao valor configurado

O parâmetro MAXSTRINGSIZE define o tamanho máximo de strings trafegadas entre Protheus e banco.

Valores muito baixos podem causar:

• Limitação de retorno de consultas

• Comportamentos intermitentes em telas fiscais

• Falhas difíceis de reproduzir

Exemplo de configuração:

MAXSTRINGSIZE=500

📌 Em ambientes com uso intensivo de SPED, filtros complexos e SQL dinâmico, recomenda-se avaliar cuidadosamente esse valor, ajustando conforme a realidade do ambiente.

3️⃣ memoinquery: usar com critério

memoinquery=1

Vantagens:

• Melhora consultas que envolvem campos memo

• Reduz necessidade de leituras adicionais

Atenção:

• Pode aumentar consumo de memória

• Deve ser monitorado em horários de pico

📌 Recomendação Mastersiga: manter habilitado, desde que o ambiente esteja bem dimensionado.

4️⃣ Separação de ambientes no DBAccess

Evite concentrar Protheus Produção, TSS Produção e ambientes de teste na mesma instância de DBAccess quando houver alto volume de uso.

Configuração comum (funcional, porém arriscada sob carga):

environments=protheus_producao,protheus_teste,tss_producao,tss_teste

Boa prática recomendada:

• DBAccess exclusivo para Protheus Produção

• DBAccess exclusivo para TSS Produção

• Ambientes de teste/homologação separados

📌 Essa separação reduz concorrência, filas internas e erros intermitentes de conexão.

❌ Erros comuns

• Manter auditoria ativa continuamente em produção

• Utilizar DBAccess único para Protheus + TSS + Testes em ambientes críticos

• Ignorar erros intermitentes por não haver erro funcional visível

• Ajustar parâmetros sem reiniciar o serviço DBAccess

🧪 Diagnóstico em caso de instabilidade

Se ocorrer erro de fechamento ou perda de conexão:

1. Verificar logs do DBAccess no horário do evento

2. Verificar console.log do AppServer

3. Avaliar concorrência entre Protheus e TSS

4. Confirmar se houve reinício automático de serviços

5. Correlacionar com horários de pico de uso

📌 FAQ

Esse tipo de erro é bug do Protheus?
👉 Na maioria dos casos, não. Geralmente está relacionado à infraestrutura, concorrência ou configuração.

Preciso abrir chamado na TOTVS?
👉 Somente se, após ajustes de infraestrutura, o problema persistir de forma reproduzível.

Posso usar a mesma configuração para todos os ambientes?
👉 Não é recomendado. Produção exige critérios mais rígidos de estabilidade.

📚 Referências

• Documentação oficial TOTVS — DBAccess

• Central de Atendimento TOTVS

• Experiência prática da Mastersiga Consultoria em ambientes produtivos

👤 Autor

Fabrizio Augusto Ventavolo
Consultor Especialista TOTVS
Mastersiga Consultoria