For the complete documentation index, see llms.txt. This page is also available as Markdown.

Banco de dados

Funcionalidade em Beta

A página de Banco de Dados permite consultar as tabelas do Z-PRO diretamente pelo painel do Superadmin, sem precisar de uma ferramenta externa como o PGAdmin. Toda consulta fica registrada, com controle de acesso por senha e proteção automática de campos sensíveis.

Novidade (v4.0.5.6, 23/09/2026).

1. Acessando a página

No menu lateral, abra Sistema > Dados & Config > Banco de Dados.

O acesso concedido vale por 15 minutos sem uso e por no máximo 2 horas seguidas, depois disso, o sistema pede a senha de novo.

A tela tem três abas: Tabelas, Consulta e Histórico.


2. Aba Tabelas

Lista todas as tabelas do banco de dados, com nome, tamanho e contagem aproximada de registros. Use o campo Procurar tabela para localizar uma tabela específica.

Algumas tabelas exibem indicadores:

  • Campos protegidos — a tabela guarda algum dado sensível (ex: AiAgents, AiAgentKnowledgeSources), e esses campos aparecem mascarados na consulta.

  • Somente leitura — a tabela não aceita edição pela interface (ex: AiCreditAccounts, AiCreditTopups).

Ao abrir uma tabela, filtre por coluna:

  1. Clique em + Adicionar filtro.

  2. Escolha o campo, o operador (ex: "está vazio") e o valor, quando aplicável.

  3. Clique em Executar.

Use Limpar filtros para remover todos de uma vez, o seletor Por página para ajustar quantos registros aparecem por vez (até 50.000 registros), e Exportar CSV para baixar o resultado.

O subtítulo da própria página fala em "corrigir um registro por vez" — a tela de edição de um registro individual (abrindo uma linha da tabela) ainda não foi conferida em captura. A confirmar antes de documentar esse fluxo.


3. Aba Consulta

Editor de SQL para rodar consultas diretamente nas tabelas do sistema.

  1. Escreva a consulta (ex: SELECT * FROM "Contacts" LIMIT 50).

  2. Clique em Executar (ou Ctrl+Enter).

O resultado mostra o número de registros e a duração da consulta, com as colunas e os tipos de dado de cada uma (ex: integer, text, timestamp with time zone). Use Exportar CSV para baixar o resultado.


4. Aba Histórico

Registra tudo o que foi executado nesta tela: quem, quando, o quê e o resultado.

Filtre por Autor e Ação, e ajuste quantos registros aparecem por página em Por página. As colunas mostradas são: Quando, Autor, Ação, Resultado, Registros e Duração.


Documentação sobre como acessar o banco de dados via terminal

Atualizado

Isto foi útil?