El conector PostgreSQL se puede registrar y usar hoy, sin liberación caso a caso. La extracción depende de la credencial de su origen y de que el entorno en la nube del workspace esté configurado — sin él la ejecución falla con un mensaje, en vez de fingir éxito. Ejemplos sintéticos.
Lee antes: Cómo fluyen los datos · Catálogo de conectores.
Qué es#
Conectar una base de datos PostgreSQL como fuente (modo pull, "Nosotros buscamos"): Ingestia se conecta a tu base con un usuario de lectura y extrae tablas a la capa Bronze de tu workspace. Vale para PostgreSQL, y el mismo flujo cubre MySQL, SQL Server y Oracle (solo cambian el puerto y algunos campos).
Para qué sirve#
Traer datos operativos (pedidos, clientes, inventario) de tu base de producción al datalake, sin exportar hojas de cálculo a mano, y mantenerlos actualizados con una programación.
Cuándo usar / cuándo no usar#
- Úsalo cuando: los datos viven en una base relacional accesible por red (IP pública con allowlist, Cloud SQL, VPN o mediante túnel SSH/bastion).
- No lo uses cuando: solo tienes archivos sueltos (usa importar archivo) o los datos están en un SaaS con conector propio (Omie, Bling, Meta Ads, etc.).
Plan y permisos#
- Núcleo del producto · verificación de acceso (workspace activo).
- La acción de carga pasa por el interruptor de apagado de la capacidad ejecución de ingesta.
- Recomendado: un usuario de base de datos solo lectura dedicado a Ingestia.
Requisitos previos#
- Host y puerto del PostgreSQL (puerto por defecto 5432).
- Database y, opcionalmente, el schema (por defecto
public). - Usuario y contraseña con permiso de
SELECTen las tablas deseadas. - Ruta de red — una de las opciones:
- IP pública + allowlist: habilitar la IP de salida de Ingestia en tu firewall.
- Cloud SQL (IP/Proxy).
- VPN (IP privada).
- Túnel SSH (bastion): host/puerto/usuario del bastion + clave privada SSH.
- SSL definido (se recomienda
requireo superior).
Paso a paso#
- En la consola, ve a ETL/ELT → Conexiones y elige PostgreSQL (categoría Bases de datos).
- Completa los campos de conexión:
- Host — ej.:
db.suaempresa.example - Puerto —
5432 - Database — ej.:
producao - Schema — ej.:
public(opcional) - Usuario — ej.:
ingestia_ro - Contraseña — la contraseña del usuario de lectura (se cifra; nunca se vuelve a mostrar)
- Host — ej.:
- En SSL mode, elige según tu política:
disable(sin SSL — evítalo),require,verify-caoverify-full.
- En Cómo nos conectamos (red), elige
IP pública + allowlist,Cloud SQL,VPNoTúnel SSH. Si es SSH, completa host/puerto/usuario del bastion y pega la Clave privada SSH. - Haz clic en Probar conexión. Ingestia abre la conexión (y el túnel, si corresponde) y lista las tablas accesibles.
- Con la prueba OK, selecciona las tablas que quieres ingerir y guarda la fuente.
Ejemplo (sintético)#
Engine: PostgreSQL
Host: db.suaempresa.example
Porta: 5432
Database: producao
Schema: public
Usuário: ingestia_ro
SSL mode: require
Rede: IP público + allowlistUsuario de lectura de ejemplo (ejecútalo en tu base de datos):
CREATE USER ingestia_ro WITH PASSWORD 'troque-esta-senha';
GRANT CONNECT ON DATABASE producao TO ingestia_ro;
GRANT USAGE ON SCHEMA public TO ingestia_ro;
GRANT SELECT ON ALL TABLES IN SCHEMA public TO ingestia_ro;
ALTER DEFAULT PRIVILEGES IN SCHEMA public GRANT SELECT ON TABLES TO ingestia_ro;Resultado esperado#
- Probar conexión devuelve OK y aparece la lista de tablas (
schema.tabela) para seleccionar. Ingestia lee el catálogo víainformation_schema.tables, excluyendo los schemas del sistema, con un tope de 2.000 tablas listadas. - Después de una carga, las filas seleccionadas aparecen en la capa Bronze de tu workspace, listas para el pipeline.
Límites y costos#
- Extracción fragmentada (paginada):
batchSizepor defecto 5.000 (100–50.000);maxRowspor defecto 200.000 (hasta 5.000.000). - Tope duro de paginación anti-bucle.
- La plataforma no cobra la llamada a tu base de datos; la carga Bronze consume procesamiento de carga en el datalake (cobrable).
Seguridad#
- Los nombres de schema/tabla/columna se sanean (solo
[A-Za-z0-9_$]) antes de entrar en el SQL — protección anti-inyección. - La contraseña (y la clave SSH) se cifra (AES-256-GCM) y se redacta en cualquier error/log.
- Prefiere un usuario solo lectura; Ingestia solo ejecuta
SELECT. - Alcance por workspace: las filas van al Bronze de tu workspace, nunca de otro.
Errores comunes#
| Síntoma | Causa probable | Qué hacer |
|---|---|---|
connection refused / timeout | firewall/allowlist o ruta incorrecta | Habilita la IP de salida o usa SSH/VPN; revisa host:puerto |
password authentication failed | usuario/contraseña incorrectos | Revisa la credencial; prueba el login fuera de Ingestia |
no pg_hba.conf entry / SSL exigido | política de SSL del servidor | Ajusta el SSL mode a require/verify-* |
| Lista de tablas vacía | usuario sin SELECT o schema incorrecto | Concede USAGE/SELECT; revisa el schema |
| Falla solo vía SSH | clave/bastion incorrectos | Revisa host/usuario del bastion y la clave privada |
Solución de problemas#
- Usa Probar conexión para aislar el problema (red vs. credencial vs. permiso) — nunca lanza una excepción; devuelve OK + tablas, o un mensaje de error ya redactado.
- Un administrador puede revisar la salud profunda del entorno en
GET /api/health?deep=1.
Relacionados#
Última revisión: 2026-09-08.