Nó PostgreSQL

O nó PostgreSQL permite executar consultas e operações no banco de dados PostgreSQL. Oferece tanto um query builder visual quanto a opção de escrever SQL customizado.

Visão Geral

Conexão

Usando Credenciais Salvas (Recomendado)

Selecione uma credencial do tipo PostgreSQL no campo Credencial. A credencial contém todas as informações de conexão.

Configuração Manual

Connection String:

postgresql://usuario:senha@host:5432/banco?sslmode=require

Modos de Consulta (Presets)

Custom SQL

Escreva SQL livremente com suporte a parâmetros.

Exemplo:

SELECT * FROM users WHERE email = $1 AND active = $2

Parâmetros: ["joao@exemplo.com", true]

Segurança: Sempre use parâmetros ($1, $2) em vez de concatenar valores diretamente no SQL. Isso previne SQL injection.

SELECT (Visual Builder)

Construa consultas SELECT sem escrever SQL:

Condições WHERE:

EXISTS

Verifica se existe pelo menos um registro que corresponda aos critérios.

Retorna rowCount: 1 se existe, rowCount: 0 se não existe.

COUNT

Conta registros que correspondem aos critérios.

ASSERT

Verifica se um valor no banco corresponde ao esperado. Ideal para validações de dados.

INSERT

Insere novos registros.

Exemplo:

UPDATE

Atualiza registros existentes.

DELETE

Remove registros.

Outputs

Acessando os Outputs

// Todos os registros
{{ steps.query.outputs.rows }}

// Primeiro registro
{{ steps.query.outputs.rows[0] }}

// Campo específico do primeiro registro
{{ steps.query.outputs.rows[0].name }}  →  "João"
{{ steps.query.outputs.rows[0].email }}  →  "joao@exemplo.com"

// Contagem
{{ steps.query.outputs.rowCount }}  →  5

Exemplos Práticos

Validar dados após criação via API

[HTTP Request: POST /api/users → body: { "name": "João" }]
    │
    ▼
[PostgreSQL: SELECT * FROM users WHERE name = 'João']
    │
    ▼
[If: {{ steps.query.outputs.rowCount }} > 0]
    │ true → [Log: "Usuário criado com sucesso no banco"]
    │ false → [Stop and Fail]

Preparar dados para teste

[PostgreSQL: INSERT INTO test_data (key, value) VALUES ('token', 'abc123')]
    │
    ▼
[HTTP Request: GET /api/verify?token={{ steps.insert.outputs.rows[0].token }}]

Limpar dados após teste

[... testes ...]
    │
    ▼
[PostgreSQL: DELETE FROM test_data WHERE created_by = 'automated-test']

Dicas

• Use credenciais salvas para gerenciar conexões de forma centralizada
• Use parâmetros ($1, $2) em SQL customizado para prevenir SQL injection
• O query builder visual é ideal para operações simples e é menos propenso a erros de sintaxe
• Use expressões nos valores: {{ steps.api.outputs.json.id }} para usar dados de nós anteriores
• Teste a conexão antes de executar o fluxo usando o botão de teste na tela de credenciais