# PostgreSQL

Consultar dados de um banco PostgreSQL. Confira os campos necessários, a obtenção das credenciais e o funcionamento na Zild.

Source: https://zild.ai/pt-BR/docs/apps/zild-admin/connector-postgresql

Consultar dados de um banco PostgreSQL.

## Onde configurar

Abra Zild Admin → Integrações → Conectores, localize o provedor e use Configurar ou Editar. Informe os dados deste guia, habilite o conector para o fluxo e salve.

## Campos necessários

Os requisitos abaixo são os dados necessários ao fluxo que utiliza o conector. O cadastro genérico pode aceitar campos vazios que serão exigidos somente ao executar uma operação. O botão Salvar não confirma que a credencial funciona no provedor.



<table class="api-params"><thead><tr><th>Campo</th><th>Requisito para o fluxo</th></tr></thead><tbody><tr><td><code>ConnectionString</code></td><td>Conexão com servidor, banco e autenticação fornecidos pelo administrador.</td></tr></tbody></table>

Exemplo de formato com valores fictícios:



```
Host=HOST;Port=5432;Database=DATABASE;Username=USER;Password=PASSWORD;SSL Mode=Require
```



## Como obter as credenciais

- Solicite ao administrador o host, a porta, o banco e um usuário com acesso às consultas necessárias.
- Monte a string no formato do driver e informe-a em ConnectionString. Não há chave de API para gerar.

## Como funciona na Zild

A API executa consultas pelo driver Npgsql e valida comandos antes da execução. O usuário precisa ter permissão no banco e o servidor da Zild precisa alcançar o host.

## Como conferir a configuração

Depois de salvar, use o fluxo correspondente (consulta, agente, chamada ou processamento) para verificar o acesso. Se houver erro, confira credencial, permissões e recurso escolhido no provedor. Para tipos limitados ou legados, confirme a disponibilidade com a administração antes de tentar usar.

Na edição, a Zild mostra credenciais protegidas como asteriscos. Preserve o valor mascarado para manter a credencial atual ou cole uma nova credencial para substituí-la.

## Documentação oficial

- [Npgsql: connection parameters](https://www.npgsql.org/doc/connection-string-parameters.html)

[Voltar a Conectores](/pt-BR/docs/apps/zild-admin/integration)