Base de Conhecimento

Postgres no n8n: consulte e grave dados

  • postgres, postgresql, n8n, banco de dados, automação, workflow
  • Usuários acharam útil: 0

Deixe o PostgreSQL protegido, crie a credencial e teste a conexão. Veja cada operação do nó, use Query Parameters nas consultas e inicie fluxos com o Postgres Trigger.

Por Redação Eleven Host · @robson.direitodigital · 17 de novembro de 2026 · 9 min de leitura

Arte da Eleven Host: janela de terminal com o título: Postgres no n8n: consulte e grave dados

Capa da Redação Eleven Host para o tutorial: Postgres no n8n: consulte e grave dados Arte: Eleven Host

Usar postgres no n8n é ler e gravar dados num banco PostgreSQL seu a partir do fluxo: o nó Postgres consulta, insere, atualiza e apaga linhas, e o Postgres Trigger inicia um fluxo quando uma linha muda.

Valor que vem de fora entra na query pelos Query Parameters ($1, $2), e não por expressão colada no texto SQL. E o padrão da operação Delete é Truncate, que apaga os dados da tabela inteira.

Atualizado em 17/11/2026. Em 17/11/2026, a versão estável do n8n na página de lançamentos do projeto é a 2.48.4, publicada em 13/11/2026. Um nó Postgres novo usa a versão 2.8, e o Postgres Trigger, a versão 1.

O que o nó Postgres faz

Segundo a documentação do n8n, o nó Postgres serve para automatizar trabalho no Postgres e integrá-lo a outros aplicativos: o fluxo lê linhas de uma tabela, grava registros novos, atualiza e apaga.

Este nó trabalha dentro do fluxo, num banco PostgreSQL que é seu. O banco interno do próprio n8n, onde ele guarda fluxos e execuções, é outro assunto. Há um segundo nó, o Postgres Trigger, que começa um fluxo quando acontece um evento numa tabela. Os dois usam a credencial Postgres. Para MySQL há um nó próprio, o MySQL.

Para que serve num fluxo

Serve para gravar cada pedido que chega por formulário, conferir se um cliente já existe antes de cadastrá-lo ou avisar a equipe quando uma linha nova aparece. Se ainda falta o servidor onde o n8n e o banco vão conviver, veja o que é um servidor VPS. Quem está escolhendo o banco encontra uma comparação em Banco de dados para loja virtual: como escolher.

O plano de entrada e os demais ficam na loja de VPS. VPS a partir de R$ 29,90/mês no Plano Bronze; confira na loja o que cada plano inclui. Ver as VPS

Passo 1: deixar o banco acessível ao n8n e protegido

O PostgreSQL precisa estar alcançável pelo n8n. Recomendamos que os dois fiquem na mesma máquina ou na mesma rede Docker. Se o n8n rodar em Docker, localhost dentro do contêiner é o próprio contêiner: com o banco em outro contêiner, o Host da credencial é o nome do serviço.

Segundo a documentação do PostgreSQL, o valor padrão de listen_addresses é localhost, que aceita só conexões locais; com * o servidor escuta em todas as interfaces. No pg_hba.conf, a primeira regra que casa vale, e o método trust deixa entrar sem senha quem conseguir conectar.

Por isso, recomendamos não publicar a porta 5432 para a internet. Com o n8n e o banco na mesma VPS ou rede Docker, deixe o banco só na rede interna. Se ele ficar em outra máquina, recomendamos SSL Require ou o SSH Tunnel.

Passo 2: criar um usuário com permissão mínima

Recomendamos um usuário só para o n8n, e não o superusuário postgres. Segundo a documentação do PostgreSQL, CREATE USER equivale a CREATE ROLE com LOGIN. Um exemplo: confira a sintaxe no seu banco e troque a senha e os nomes.

CREATE USER n8n_app WITH PASSWORD '<senha forte>';

GRANT CONNECT ON DATABASE loja TO n8n_app;

GRANT USAGE ON SCHEMA public TO n8n_app;

GRANT SELECT, INSERT, UPDATE ON ALL TABLES IN SCHEMA public TO n8n_app;

Esse exemplo não permite apagar. Se um fluxo precisar de Delete, acrescente DELETE só nas tabelas necessárias. Se um INSERT falhar por permissão numa coluna de numeração automática, recomendamos conferir também a permissão da sequência dessa coluna no seu banco.

Passo 3: criar a credencial Postgres

No n8n, crie a credencial Postgres. Os campos são:

  • Host: o padrão é localhost;
  • Database: o padrão é postgres;
  • User e Password: o usuário do passo 2 e a senha dele;
  • Port: o padrão é 5432;
  • Maximum Number of Connections: o padrão é 100, e esse valor vezes o número de workers deve ficar abaixo do limite de conexões do PostgreSQL;
  • SSL: Allow, Disable ou Require, com Disable como padrão. Require só conecta com SSL e, havendo certificado da autoridade (CA), verifica o certificado;
  • CA Certificate, Client Private Key e Client Certificate: aparecem com SSL em Allow ou Require.

Há ainda Ignore SSL Issues (Insecure), desligado por padrão. Recomendamos deixá-lo desligado, salvo necessidade, porque a conexão fica menos segura.

O SSH Tunnel conecta ao banco por SSH, com SSH Host, SSH Port, SSH Postgres Port, SSH User e senha ou chave privada. Segundo a documentação do n8n, o servidor SSH precisa estar na mesma máquina do Postgres, e o nó Agent não suporta o túnel.

Passo 4: testar a conexão

Crie um workflow com gatilho manual e adicione o nó Postgres. Em Operation, escolha Execute Query, selecione a credencial, digite a query abaixo e execute o nó.

SELECT 1;

Se der erro de conexão, confira Host, Port, SSL e as regras do pg_hba.conf.

As seis operações do nó Postgres

  • Select: lê linhas, com Return All (desligado), Limit (padrão 50) e condições em Select Rows;
  • Insert: grava linhas novas. Skip on Conflict, desligado, pula as linhas que violam uma restrição única em vez de dar erro;
  • Insert or Update: insere ou, se a linha existir, atualiza. No editor o nome é este, e não "Upsert";
  • Update: atualiza linhas casando por uma coluna. Sem linha correspondente, o erro é "The row you are trying to update doesn't exist";
  • Delete: apaga dados, conforme o campo Command;
  • Execute Query: roda a query SQL que você escrever.

Todas, menos Execute Query, pedem Schema (padrão public) e Table. A operação padrão ao adicionar o nó é Insert.

Insert or Update e Query Batching

O Insert or Update casa pela coluna que você indicar, que não é alterada e precisa ser única. A documentação do PostgreSQL diz que, no ON CONFLICT DO UPDATE, é preciso informar o alvo do conflito, escolhido entre índices únicos. Na prática, a coluna de casamento precisa ser UNIQUE ou chave primária, senão o Postgres recusa a operação. Um exemplo: com email único, casar em email cadastra o cliente novo ou atualiza o existente.

Em Options, Query Batching tem três modos. Single Query, o padrão, envia uma query para todos os itens. Independent envia uma por item. Transaction junta tudo numa transação, e se uma falhar todas são desfeitas. Recomendamos Transaction quando o resultado só vale se tudo for gravado.

Delete: Truncate, Delete e Drop

O campo Command tem três opções, e o padrão é Truncate: ele remove os dados da tabela e preserva a estrutura. O comando Delete apaga as linhas que casam com as condições de Select Rows e, sem condição, apaga todas as linhas. O Drop apaga dados e estrutura, de forma permanente.

Recomendamos conferir o Command antes de executar e fazer uma cópia dos dados antes de testar uma exclusão.

Execute Query com Query Parameters

O editor sugere usar Query Parameters para evitar SQL injection: os valores vão nas opções e a query os chama por $1, $2 e assim por diante. Segundo a documentação do n8n, o n8n trata os dados passados em Query Parameters, o que previne SQL injection.

Esse cuidado vale só para os valores passados assim. Uma expressão {{ }} escrita direto no texto da query é substituída como texto puro, sem esse tratamento. Por isso, recomendamos que todo valor que vem de fora, como formulário, webhook ou resposta de IA, vá em Query Parameters.

Um exemplo: no campo Query, o texto abaixo, e em Options, Query Parameters com a expressão seguinte. Confira o resultado no seu banco.

SELECT id, nome FROM clientes WHERE email = $1;

{{ $json.email }}

Os valores são separados por vírgula e, a partir da versão 2.8 do nó, cada expressão vira um único valor, mesmo que o dado tenha vírgula. Recomendamos manter o n8n atualizado e deixar só gente de confiança editar fluxos.

Postgres Trigger: iniciar um fluxo por evento

Em Listen For, Table Row Change Events escuta inserção, atualização ou exclusão numa tabela, e Advanced escuta um canal que já existe. No primeiro modo, preencha Schema Name, Table Name e Event to listen for (Insert, Update ou Delete). Ele não é um webhook: o n8n mantém uma conexão aberta com o banco e escuta os avisos, então não precisa de URL pública, só alcançar o banco.

Atenção: o Trigger mexe no seu banco. Segundo a documentação do n8n, ele cria um trigger na tabela escolhida e um procedimento que avisa o n8n do evento, quando o fluxo é publicado (ou testado sem estar publicado), e remove ambos quando é despublicado.

O usuário da credencial precisa ser superusuário, dono da tabela ou ter o privilégio TRIGGER, além de CREATE no schema da função. O exemplo abaixo cobre só o TRIGGER; o CREATE no schema é concedido à parte. Um exemplo: troque os nomes e confira no seu banco.

GRANT TRIGGER ON TABLE pedidos TO n8n_app;

Duas ressalvas do NOTIFY, segundo a documentação do PostgreSQL: na configuração padrão o conteúdo precisa ter menos de 8000 bytes, então uma linha muito grande pode fazer o aviso falhar; e só recebe quem já estava escutando, então com o fluxo desligado o evento não chega.

Problemas comuns

  • Datas deslocadas: uma coluna DATE pode voltar como data e hora com o fuso aplicado. Segundo a documentação do n8n, a solução é TO_CHAR(date_col, 'YYYY-MM-DD');
  • Números grandes: em colunas NUMERIC e BIGINT com mais de 16 dígitos, mantenha Output Large-Format Numbers As em Text, o padrão.

Onde continuar

Com a conexão testada, monte o fluxo real começando por uma tabela de teste. Para outro banco de tabelas, veja Supabase no n8n: leia e grave dados nas tabelas.

Em reais por mês, o valor muda de um plano de VPS para outro. VPS a partir de R$ 29,90/mês no Plano Bronze; confira na loja o que cada plano inclui. Conhecer as VPS

Perguntas frequentes

O nó Postgres conecta em MySQL?

Para MySQL o n8n tem um nó próprio, o MySQL, com credencial própria.

Por que não colocar a expressão direto na query?

Porque o tratamento do n8n vale só para valores passados em Query Parameters. Uma expressão escrita dentro do texto da query vira texto puro.

Por que o Insert or Update deu erro?

Confira se a coluna de casamento é única na tabela. Sem UNIQUE ou chave primária, o Postgres recusa a operação.

Esta resposta lhe foi útil?

Artigos Relacionados