Conecte o PostgreSQL ao n8n
Antes de começar
Conectar o Node Postgres ao servidor e executar uma consulta parametrizada.
- Servidor PostgreSQL acessível pelo n8n.
- Login com permissões para as tabelas usadas no workflow.
O Node Postgres conecta o workflow a um servidor PostgreSQL para consultar, inserir e atualizar registros. Você pode selecionar tabelas pela interface ou escrever SQL com Execute Query. A credencial define o servidor e o login usados nessa conexão.
Configure a credencial
Preencha Host, Database, User, Password e Port conforme o servidor PostgreSQL. Configure SSL de acordo com a conexão exigida pelo servidor. A opção Ignore SSL Issues permite conectar mesmo quando a validação SSL falha, portanto não a use como substituto da configuração do certificado.
A credencial também oferece SSH Tunnel para o Node Postgres. A documentação exige um servidor SSH na mesma máquina do PostgreSQL e um login autorizado nesse servidor. Use esse caminho somente quando ele corresponder à forma de acesso da sua instalação.
Consulte uma tabela pela interface
Selecione Select em Operation. Escolha Schema e Table, depois configure Select Rows com a coluna, o operador e o valor procurado. Sem condições, o Node seleciona todas as linhas da tabela.
Para limitar a saída durante o teste, desative Return All e preencha Limit. Confira se as colunas retornadas pertencem à tabela esperada antes de acrescentar ações de escrita.
Use parâmetros no SQL
Para uma consulta personalizada, selecione Execute Query. A documentação mostra o uso de marcadores e parâmetros para separar o SQL dos valores recebidos. Este exemplo procura um email na tabela ilustrativa users:
SELECT * FROM $1:name WHERE email = $2;Em Options > Query Parameters, forneça os valores:
{{ [ 'users', $json.email ] }}Substitua a tabela e a coluna conforme sua estrutura. O n8n sanitiza os valores fornecidos pelos parâmetros. Evite concatenar diretamente campos externos ao texto da consulta.
Escrita e processamento de vários itens
As ações Insert, Update e Insert or Update permitem mapear campos para colunas. No mapeamento automático, os nomes recebidos precisam coincidir com os nomes das colunas.
Quando várias consultas precisam ocorrer juntas, Query Batching oferece Transaction. Nesse modo, uma falha desfaz as alterações da transação. Confira a quantidade de registros e os valores gravados com uma consulta posterior antes de publicar o workflow.
Confira o resultado
A consulta retorna os registros esperados e os valores externos chegam por Query Parameters.
Fontes e conferência
Conteúdo conferido na documentação oficial do n8n em 28 de outubro de 2026.
