> For the complete documentation index, see [llms.txt](https://ajuda.zdg.com.br/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ajuda.zdg.com.br/configuracao-superadmin/sistema/sistema-dados-e-configuracao/banco-de-dados.md).

# Banco de dados

Funcionalidade em Beta

{% hint style="warning" %}
**Disponível para o perfil: Superadministrador**
{% endhint %}

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.

{% hint style="info" %}
**Novidade (v4.0.5.6, 23/09/2026).**
{% endhint %}

#### 1. Acessando a página

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

{% hint style="warning" %}
Ao entrar, o sistema pede a **senha novamente**, mesmo com você já logado como Superadmin — uma camada extra de segurança só para esta tela.
{% endhint %}

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

<figure><img src="https://3541975055-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FM5B652UsmGn3Q7h9Du1t%2Fuploads%2F0eWCLXcEpGK3R00HcMzF%2Fimage.png?alt=media&amp;token=1aa8a069-7ee7-4502-9022-0637c370ca1c" alt=""><figcaption></figcaption></figure>

***

#### 2. Aba Tabelas

<figure><img src="https://3541975055-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FM5B652UsmGn3Q7h9Du1t%2Fuploads%2Fs2FcVV7jEEWu911zAioQ%2Fimage.png?alt=media&amp;token=c157760d-3596-44b0-a77a-671606c29ce8" alt=""><figcaption></figcaption></figure>

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.

{% hint style="info" %}
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.
{% endhint %}

***

#### 3. Aba Consulta

<figure><img src="https://3541975055-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FM5B652UsmGn3Q7h9Du1t%2Fuploads%2Fw6PfNW8oyKvMNSgwRWr4%2Fimage.png?alt=media&amp;token=1a6a199f-68e3-4560-866b-a396d4267dd9" alt=""><figcaption></figcaption></figure>

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

{% hint style="warning" %}
**A consulta é sempre somente leitura** — nada é alterado por aqui. `EXPLAIN` e `SHOW` também funcionam. São exibidos no máximo **500 registros por consulta**.
{% endhint %}

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](/avancado-recursos-tecnicos/banco-de-dados-como-acessar.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://ajuda.zdg.com.br/configuracao-superadmin/sistema/sistema-dados-e-configuracao/banco-de-dados.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.