Conexión Destino PostgreSQL

Requisitos previos

Antes de configurar la conexión a PostgreSQL en Crestone, asegúrese de cumplir con los siguientes requisitos:

Requisito principal: Una base de datos PostgreSQL activa y accesible, versión 9.x o superior, alojada localmente, de forma remota o mediante un proveedor en la nube (como Supabase, Amazon RDS, Azure Database for PostgreSQL o Google Cloud SQL). Se recomienda PostgreSQL 12 o superior para entornos de producción.

Información requerida:

Consejo: Si se conecta a una instancia de Supabase, utilice los siguientes valores:

• Server: db.<project-ref>.supabase.co
• Port: 5432 (conexión directa, recomendada para cargas masivas)
• Database: postgres
• Username: postgres
• Password: la contraseña configurada al crear el proyecto

Paso de verificación previa

Antes de configurar la conexión en Crestone, le recomendamos verificar sus credenciales utilizando cualquier cliente PostgreSQL de su preferencia (ej. pgAdmin, DBeaver, psql, TablePlus). Esto garantiza que las credenciales sean correctas y que el servidor sea accesible antes de continuar.

Pasos de configuración

Siga estos pasos para crear una nueva conexión de destino PostgreSQL en Crestone:

1. Diríjase a Connections en la barra de navegación superior.
2. Seleccione la pestaña Destination.
3. Haga clic en el botón + para crear una nueva conexión.
4. Complete el campo Connection Name con un nombre descriptivo (ej. Mi Base de Datos PostgreSQL).
5. En el menú desplegable Destination Type, seleccione PostgreSQL.

Cargando imagen...Select PostgreSQL from the destination type dropdown

6. Complete el formulario de credenciales con los campos requeridos:

   • Server — host o dirección IP de su instancia de PostgreSQL
   • Port — predeterminado 5432
   • Database — nombre de la base de datos destino
   • Username — usuario de base de datos
   • Password — contraseña del usuario

7. Haga clic en Test Connection para validar que Crestone pueda comunicarse con la base de datos exitosamente.

8. Una vez aprobada la prueba, haga clic en Create Destination para guardar la conexión.

Edición de una conexión existente

Para actualizar las credenciales de una conexión PostgreSQL existente:

1. Diríjase a Connections y localice su destino PostgreSQL.
2. Haga clic en Edit.
3. Modifique los campos deseados en el formulario de credenciales.
4. Haga clic en Test Connection para verificar las nuevas credenciales.
5. Haga clic en Confirm para guardar los cambios.

Cargando imagen...Edit Destination form for PostgreSQL

Uso de PostgreSQL como destino en un nodo de extracción

Una vez creada la conexión, puede utilizarla como destino en un nodo de extracción (Extraction Node):

1. Abra o cree un Extraction Node y diríjase a la pestaña Destination.
2. En Select Destinations, elija su conexión PostgreSQL.
3. En Select Database, elija la base de datos destino de la lista.
4. En Select Schema, elija un esquema existente o seleccione Create new schema para crearlo sobre la marcha.
5. En Select Table, elija una tabla existente o seleccione Create new table para que Crestone la cree automáticamente según la estructura de datos de origen.
6. Opcionalmente, habilite Prefers to delete existing data and then insert new data si desea vaciar la tabla antes de cada carga.
7. Continúe a la pestaña Settings y guarde el nodo.

Nota: Al seleccionar Create new table, Crestone infiere automáticamente los tipos de columna a partir de los datos de origen y crea la tabla en PostgreSQL antes de insertar registros. El mapeo de tipos aplicado es:

Tipo de origen	Tipo PostgreSQL
Int8 / Int16	SMALLINT
Int32	INTEGER
Int64	BIGINT
Float32	REAL
Float64	DOUBLE PRECISION
Boolean	BOOLEAN
String	TEXT
Date	DATE
Datetime	TIMESTAMP

Problemas comunes

Permisos requeridos

El usuario de base de datos configurado en Crestone requiere como mínimo los siguientes privilegios en la base de datos de destino:

-- Permitir conexión
GRANT CONNECT ON DATABASE my_database TO my_user;

-- Permitir creación de esquemas (si Crestone necesita crear nuevos esquemas)
GRANT CREATE ON DATABASE my_database TO my_user;

-- Permitir creación de tablas y operaciones de datos en un esquema específico
GRANT USAGE, CREATE ON SCHEMA my_schema TO my_user;
GRANT INSERT, SELECT, DELETE ON ALL TABLES IN SCHEMA my_schema TO my_user;

Consejo: Si utiliza el usuario postgres (predeterminado en Supabase), este ya posee privilegios de superusuario y no se requieren concesiones adicionales.