Saltearse al contenido
Nappai Documentation

Postgres SQL

Postgres SQL trabaja con las tablas de tu base de datos PostgreSQL desde un flujo: lee filas, añade nuevas, cambia o borra las existentes y ejecuta consultas SQL.

Cuándo usarlo

  • Registrar en tu base de datos las solicitudes que llegan por correo o formulario.
  • Dar a un agente acceso a consultar clientes o facturas.
  • Marcar como procesados los registros que ya ha tratado un flujo.
  • Sacar datos para un informe con una consulta SQL propia.

Configuración

El campo Operation decide qué hace el componente y qué campos aparecen:

  • Insert (por defecto): añade filas a una tabla.
  • Get: lee filas de una tabla, con o sin condiciones.
  • Update: cambia valores de las filas que cumplen una condición.
  • Delete: borra las filas que cumplen una condición.
  • Custom Query: ejecuta la consulta SQL que escribas.
  • DatabaseInfo: describe las tablas y columnas de la base, útil para que un agente sepa qué hay.

Al elegir la credencial, Table Name se llena con las tablas de tu base.

Necesitas una credencial Postgres SQL con el servidor, el puerto, el usuario, la contraseña y la base de datos. Consulta Credenciales.

CampoQué hace
Credential (obligatorio)La credencial Postgres SQL con los datos de conexión.
Operation (obligatorio)Qué hace el componente. Por defecto, Insert.
Schema (obligatorio)El esquema de la base en el que está la tabla.
Table Name (obligatorio)La tabla sobre la que se trabaja. Con Insert en modo Custom puedes escribir un nombre nuevo y la tabla se crea si no existe.
ModeCon Insert. Dynamic (por defecto): aparece un campo por cada columna de la tabla para rellenar sus valores. Custom: aparece Ingest Data para insertar los datos que llegan de otro componente.
Select Filter TypeCon Get, Update y Delete, cómo escribes las condiciones. String (por defecto): en Filter String, como edad > 25 AND ciudad = 'Madrid'. Build Manually: indicas cuántas condiciones quieres y aparece un campo para cada una.
Filter StringLas condiciones que deben cumplir las filas. Los textos van entre comillas simples y los números sin comillas.
Field To UpdateCon Update. Cuántas columnas quieres cambiar; aparece un campo para el nuevo valor de cada una.
Custom Query (obligatorio)Con Custom Query. La consulta SQL que se ejecuta, por ejemplo SELECT * FROM clientes WHERE ciudad = 'Sevilla'.
LimitCon Get, cuántas filas se devuelven como máximo. Por defecto, 10.

Opciones avanzadas

CampoQué hace
Return AllCon Get, devuelve todas las filas sin tener en cuenta Limit. Desactivado por defecto.

Resultado

La salida Data trae el resultado: las filas leídas con Get o Custom Query, o la confirmación de lo insertado, cambiado o borrado. La salida Database Info trae la descripción de las tablas con DatabaseInfo.

En modo herramienta, un agente puede usar el componente para consultar o cambiar datos por sí mismo. Consulta Tool Mode.

Ejemplo

Una asesoría registra cada consulta que entra por su web.

  1. Añade Postgres SQL con la credencial Postgres SQL.
  2. Elige Insert, el esquema public y la tabla consultas.
  3. Con Mode en Dynamic, conecta el nombre, el correo y el mensaje del formulario a los campos de cada columna.

Buenas prácticas

  • Usa una credencial con permisos de solo lectura si el componente solo va a consultar.
  • Antes de dejar que un agente use Update o Delete, prueba las condiciones con Get para ver qué filas se verían afectadas.

Componentes relacionados