Saltar al contenido

Traducción automática — la versión en portugués es la referencia. Ver en portugués

Actualizado el 2026-09-08

Tutorial — conectar una base de datos PostgreSQL

Paso a paso para conectar un PostgreSQL como fuente, probar la conexión y listar las tablas disponibles para ingesta.

En esta página (13)

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#

  1. Host y puerto del PostgreSQL (puerto por defecto 5432).
  2. Database y, opcionalmente, el schema (por defecto public).
  3. Usuario y contraseña con permiso de SELECT en las tablas deseadas.
  4. 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.
  5. SSL definido (se recomienda require o superior).

Paso a paso#

  1. En la consola, ve a ETL/ELT → Conexiones y elige PostgreSQL (categoría Bases de datos).
  2. 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)
  3. En SSL mode, elige según tu política:
    • disable (sin SSL — evítalo), require, verify-ca o verify-full.
  4. En Cómo nos conectamos (red), elige IP pública + allowlist, Cloud SQL, VPN o Túnel SSH. Si es SSH, completa host/puerto/usuario del bastion y pega la Clave privada SSH.
  5. Haz clic en Probar conexión. Ingestia abre la conexión (y el túnel, si corresponde) y lista las tablas accesibles.
  6. Con la prueba OK, selecciona las tablas que quieres ingerir y guarda la fuente.

Ejemplo (sintético)#

código
Engine: PostgreSQL
Host: db.suaempresa.example
Porta: 5432
Database: producao
Schema: public
Usuário: ingestia_ro
SSL mode: require
Rede: IP público + allowlist

Usuario de lectura de ejemplo (ejecútalo en tu base de datos):

sql
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ía information_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): batchSize por defecto 5.000 (100–50.000); maxRows por 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íntomaCausa probableQué hacer
connection refused / timeoutfirewall/allowlist o ruta incorrectaHabilita la IP de salida o usa SSH/VPN; revisa host:puerto
password authentication failedusuario/contraseña incorrectosRevisa la credencial; prueba el login fuera de Ingestia
no pg_hba.conf entry / SSL exigidopolítica de SSL del servidorAjusta el SSL mode a require/verify-*
Lista de tablas vacíausuario sin SELECT o schema incorrectoConcede USAGE/SELECT; revisa el schema
Falla solo vía SSHclave/bastion incorrectosRevisa 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.

Enlaces relacionados