Skip to main content
Este guia cobre a configuração do conector PostgreSQL para desenvolvimento local. Para ativar o conector via Console strattum.ai, consulte o Quickstart de Data Pipelines.

Visão geral

O conector PostgreSQL ingere tabelas de bancos relacionais PostgreSQL na infraestrutura strattum.ai. Você pode configurar tabelas individuais ou sincronizar schemas completos, com suporte a dois modos de carga:

Pré-requisitos

PostgreSQL 12 ou superior

O conector é compatível com PostgreSQL 12+, seja em cloud (RDS, Cloud SQL, Supabase) ou on-premise.

Usuário com permissão de leitura

Recomendamos criar um usuário dedicado com permissão apenas de SELECT. Veja o passo a passo abaixo.

Variáveis de ambiente

Adicione a variável abaixo ao arquivo .env (veja o guia de configuração local):
Nunca comite o arquivo .env no repositório. Certifique-se que ele está listado no .gitignore.

Como criar um usuário read-only

Recomendamos usar um usuário dedicado com acesso apenas de leitura para minimizar a superfície de risco. Execute os comandos abaixo conectado ao banco com um usuário administrador:
1

Crie o usuário

Use uma senha forte e aleatória. Ferramentas como openssl rand -base64 32 geram senhas seguras diretamente no terminal.
2

Conceda acesso ao banco

3

Conceda acesso ao schema

Repita para outros schemas que deseja expor além do public.
4

Conceda permissão de leitura nas tabelas existentes

5

Garanta acesso a tabelas futuras

Este comando garante que novas tabelas criadas no schema também sejam acessíveis ao usuário.

Acesso de rede

O worker strattum.ai precisa conseguir alcançar o banco PostgreSQL na porta configurada (padrão 5432).

Cloud (RDS, Cloud SQL)

Adicione o IP do ambiente strattum.ai ou o CIDR da VPC ao Security Group / firewall do banco.

On-premise

Verifique se o banco aceita conexões externas no pg_hba.conf e se o firewall da rede permite o tráfego de entrada na porta 5432.
Para ambientes com requisitos de rede mais restritos, consulte o time strattum.ai para configurar uma conexão via túnel ou VPN privada.

Próximos passos

Guia de desenvolvimento local

Configure o ambiente local completo com Prefect, worker e Docker Compose.

Quickstart — Data Pipelines

Ative conectores via Console strattum.ai sem precisar de ambiente local.