Experimente nossa plataforma
Como conectar o Supabase como destino no Kondado

O que você vai aprender

Este tutorial mostra como configurar o Supabase como destino de dados no Kondado. O Supabase é um serviço PostgreSQL gerenciado que requer algumas configurações específicas de conectividade.

💡 Recomendação: Para integrações externas, recomendamos usar o Session Pooler do Supabase (porta 5432). Ele é gratuito em todos os planos, suporta prepared statements e é a recomendação oficial do Supabase para conexões persistentes de aplicações externas (veja a documentação oficial).

Pré-requisitos

  • Conta no Supabase com um projeto criado
  • Acesso de administrador ao projeto Supabase
  • Conta Kondado ativa

Passo 1 — Escolher o modo de conexão

O Supabase oferece duas formas de conexão para integrações externas. Recomendamos a Opção A (Session Pooler): é gratuita, estável e suportada nativamente pelo Supabase.

Opção A: Session Pooler (Recomendada — Gratuita)

Esta é a forma mais simples e gratuita de habilitar conectividade IPv4 (incluída em todos os planos do Supabase):

  1. Acesse o dashboard do Supabase
  2. Selecione seu projeto
  3. Clique em Connect no topo da página (ou vá em Project Settings → Database)
  4. Na seção Connection string, selecione Session pooler
  5. Anote os valores de host, porta e usuário exibidos
💡 Dica: O Session Pooler usa o host aws-0-<region>.pooler.supabase.com (exemplo: aws-1-sa-east-1.pooler.supabase.com) com porta 5432.

Opção B: IPv4 Add-on (Pago)

Se preferir usar o host direto do Supabase, é possível contratar o IPv4 dedicado como add-on pago:

  1. No Supabase, vá em Project Settings → Add-ons
  2. Habilite o add-on IPv4 Address
  3. Use o host db.<project-ref>.supabase.co com porta 5432
ℹ️ Nota: Não recomendamos o uso do Transaction Pooler (porta 6543) com a Kondado. Esse modo é otimizado para funções serverless e não suporta prepared statements — operações de ETL contínuas podem apresentar comportamento inesperado.

Passo 2 — Obter credenciais de conexão

No painel do Supabase, vá em Project Settings → Database e localize a seção Connection string:

Campo Kondado Valor no Supabase Exemplo
Host (Endereço) Session Pooler host (recomendado) ou IPv4 host aws-1-sa-east-1.pooler.supabase.com
Porta 5432 (Session Pooler ou Direct) 5432
Usuário postgres.<project-ref> (com ponto) ⚠️ NÃO é seu email! postgres.abcdefghijklmnop
Senha Senha do banco (definida em Database Settings → Database password) ••••••••
Banco de dados Nome do banco postgres
❌ Erro comum: Não use seu email de login do Supabase no campo Usuário. O usuário do PostgreSQL sempre segue o formato postgres.<project-ref>. O <project-ref> é a referência única do seu projeto (visível na URL do dashboard ou em Project Settings → General).
🔑 Sobre a senha: A senha do banco de dados é diferente da senha de login do dashboard Supabase, e também é diferente das chaves anon e service_role. Se você esqueceu ou nunca a definiu, é possível redefini-la em Project Settings → Database → Database password.

Passo 3 — Configurar no Kondado

  1. Acesse app.kondado.com.br
  2. Clique em CRIAR + → DESTINOS
  3. Selecione PostgreSQL
  4. Preencha os campos com os valores obtidos no Passo 2
  5. Clique em TESTAR CONEXÃO
  6. Se a conexão for bem-sucedida, clique em SALVAR

Passo 4 (Opcional) — Liberar IPs do Kondado

Se o seu projeto Supabase tiver Network Restrictions ativado, você precisa liberar os IPs do Kondado:

  1. No Supabase, vá em Project Settings → Database → Network Restrictions
  2. Adicione os IPs públicos da Kondado listados em IPs Kondado
✓ Nota: Se você não ativou Network Restrictions manualmente, esta etapa não é necessária. Por padrão, o Supabase permite conexões de qualquer IP (desde que a autenticação esteja correta).

Troubleshooting — Erros comuns

Erro Causa Solução
Connection refused / timeout O modo de conexão direta do Supabase exige o IPv4 add-on em ambientes IPv4-only Use o Session Pooler ou contrate o IPv4 add-on
password authentication failed for user "<email>" Email usado no campo Usuário Use postgres.<project-ref> (veja em Database Settings)
password authentication failed (usuário correto) Senha incorreta Redefina a senha em Database Settings → Database password (não confunda com a senha do dashboard)
Conexão funciona no teste, mas pipelines falham Network Restrictions ativo bloqueando alguns IPs Libere todos os IPs da Kondado (veja Passo 4)

Alternativa: Via Kondado

Se você não consegue ou prefere não configurar o Supabase, a Kondado oferece o destino Via Kondado — conexão direta com dashboards e IA, com unidade gratuita inclusa em todas as contas.

Para usar, basta selecionar Via Kondado ao criar um destino. Saiba mais em: Via Kondado.

Próximos passos

Conectar Supabase como destino no Kondado

Configure um banco PostgreSQL Supabase como destino de dados na Kondado usando o Session Pooler.

1
Selecionar o Session Pooler no Supabase

No dashboard do Supabase, vá em Project Settings → Database e selecione "Session pooler" na seção Connection string. Anote host, porta, usuário e senha.

2
Identificar host e usuário corretos

Use host aws-0-<region>.pooler.supabase.com com porta 5432, usuário postgres.<project-ref> (com ponto, NÃO é o email) e database postgres.

3
Obter a senha do banco

A senha está em Project Settings → Database → Database password. Não confunda com a senha do dashboard nem com as chaves anon/service_role. Redefina se necessário.

4
Cadastrar o destino na Kondado

Acesse app.kondado.com.br, clique em CRIAR + → DESTINOS, selecione PostgreSQL e preencha os campos com os valores anotados.

5
Testar e salvar a conexão

Clique em TESTAR CONEXÃO. Se passar, clique em SALVAR. Se falhar, consulte a tabela de troubleshooting do artigo.

6
Liberar IPs (se necessário)

Se o Supabase tiver Network Restrictions ativado, libere os IPs da Kondado em Project Settings → Database → Network Restrictions. Lista em kondado.com.br/wiki/a/ips-kondado.

Perguntas frequentes

Preciso pagar pelo IPv4 add-on no Supabase para usar a Kondado?▼
Não. A forma recomendada é usar o Session Pooler do Supabase (porta 5432), que é gratuito e está incluído em todos os planos. O IPv4 add-on é uma alternativa paga apenas para quem precisa especificamente de uma conexão direta ao banco.
Por que recebo "password authentication failed" mesmo informando a senha correta?▼
Verifique o formato do usuário. Ao usar o Session Pooler, o usuário NÃO é seu email — é postgres.<project-ref> (com ponto). O <project-ref> é a referência única do seu projeto Supabase, visível na URL do dashboard ou em Project Settings → General.
Qual a diferença entre Session Pooler (porta 5432) e Transaction Pooler (porta 6543)?▼
O Session Pooler mantém uma conexão dedicada por sessão e é o modo recomendado para a Kondado. O Transaction Pooler libera a conexão a cada transação e não suporta prepared statements — pode causar comportamento inesperado em operações de ETL contínuas.
Onde encontro a senha do banco de dados no Supabase?▼
A senha do banco é diferente da senha de login do dashboard Supabase e também é diferente das chaves anon e service_role. Acesse Project Settings → Database → Database password. Se esqueceu, é possível redefini-la nessa mesma página.
A Kondado oferece alguma alternativa caso eu não queira configurar o Supabase?▼
Sim — o Via Kondado é um destino PostgreSQL gerenciado pela Kondado, com unidade gratuita inclusa em todas as contas. Veja kondado.com.br/wiki/a/via-kondado.
Preciso liberar IPs da Kondado no firewall do Supabase?▼
Apenas se você tiver ativado Network Restrictions no projeto Supabase. Por padrão, o Supabase aceita conexões de qualquer IP. Caso esteja restringindo, libere todos os IPs públicos da Kondado listados em kondado.com.br/wiki/a/ips-kondado.
Escrito por·Publicado em 2026-04-29