PostgresSQL

El componente PostgresSQL te permite trabajar directamente con bases de datos PostgreSQL desde el dashboard de Nappai. Con él puedes insertar nuevos registros, ejecutar consultas SQL personalizadas, crear un buscador de similitud basado en embeddings y obtener información sobre la estructura de tus tablas, todo sin salir de la interfaz gráfica.

¿Cómo funciona?

El componente se conecta a tu base de datos PostgreSQL mediante una credencial previamente configurada. Cuando lo añades a un flujo, seleccionas la operación que deseas realizar (Add, SQL, Retriever o DatabaseInfo). Dependiendo de la operación, el componente envía la consulta o la acción correspondiente al servidor PostgreSQL y devuelve los resultados en el formato adecuado (Data, Retriever o Database Info). Si eliges la operación Retriever, el componente construye un objeto que permite hacer búsquedas de similitud usando embeddings, lo que facilita la recuperación de registros relevantes según el contenido textual.

Operaciones

Este componente ofrece varias operaciones que puedes seleccionar según lo que necesites hacer. Solo puedes usar una operación a la vez:

• Add: Inserta datos en una tabla especificada. Puedes decidir si quieres eliminar la tabla antes de insertar.
• SQL: Ejecuta una consulta SQL personalizada y devuelve los resultados.
• Retriever: Crea un buscador de similitud que utiliza embeddings para encontrar registros similares a una consulta.
• DatabaseInfo: Obtiene información sobre la estructura de una tabla (columnas, tipos, etc.).

Para usar el componente, primero selecciona la operación que necesitas en el campo Operation (Operación).

Entradas

Los siguientes campos están disponibles para configurar este componente. Cada campo puede estar visible en diferentes operaciones:

• Embedding: Embedding para generar un vector a partir de texto o para usar en búsqueda de similitud.

  • Visible en: Add

• Ingest Data: Inserta datos en la tabla de la base de datos.

  • Visible en: Add

• Operation: Selecciona la operación que quieres ejecutar (Add, SQL, Retriever, DatabaseInfo).

  • Visible en: Add, SQL, Retriever, DatabaseInfo

• Number of Results: Número de resultados que deseas recibir.

  • Visible en: Add, SQL, Retriever, DatabaseInfo

• Search Query: Consulta SQL que se ejecutará.

  • Visible en: SQL

• Search Score Threshold: Si el valor es distinto a 0.0, se filtrarán los resultados con una distancia menor al umbral.

  • Visible en: Add, SQL, Retriever, DatabaseInfo

• Table Name: Nombre de la tabla en la base de datos.

  • Visible en: Add, DatabaseInfo

• Drop Table: Elimina la tabla si ya existe antes de insertar datos.

  • Visible en: Add, DatabaseInfo

Credencial
Este componente requiere una credencial de tipo Postgres SQL.

1. Configura primero la credencial en la sección de credenciales de Nappai.
2. Luego selecciona esa credencial en el campo Credential del componente.
   La credencial necesita la PostgresSQL Server Connection URL (contraseña incluida).

Salidas

• Data: Devuelve los datos obtenidos de la consulta o de la inserción.
• Retriever: Devuelve un objeto que permite realizar búsquedas de similitud.
• Database Info: Devuelve la información estructural de la tabla solicitada.

Ejemplo de Uso

Operación Add

1. Arrastra el componente PostgresSQL al flujo.
2. Selecciona Operation = Add.
3. En Table Name escribe clientes.
4. En Ingest Data pega un JSON con los registros a insertar.
5. Marca Drop Table si quieres reemplazar la tabla existente.
6. Conecta la salida Data a un componente de visualización para ver los registros insertados.

Operación SQL

1. Arrastra el componente PostgresSQL al flujo.
2. Selecciona Operation = SQL.
3. En Table Name escribe ventas.
4. En Search Query escribe:

   SELECT * FROM ventas WHERE monto > 1000 ORDER BY fecha DESC LIMIT 10;

5. Conecta la salida Data a un gráfico de barras para visualizar las ventas más altas.

Componentes Relacionados

• PostgresBaseComponent: Base que gestiona la conexión y configuración común a todos los componentes PostgreSQL.
• PostgresRetriever: Utiliza el objeto Retriever para buscar registros similares basados en embeddings.
• Data: Componente que permite manipular y visualizar datos tabulares dentro de Nappai.

Consejos y Mejores Prácticas

• Usa credenciales seguras: Nunca compartas la URL de conexión en el flujo; mantenla en la sección de credenciales.
• Limita el número de resultados: En operaciones de búsqueda, ajusta Number of Results para evitar sobrecargar la interfaz.
• Comprueba la tabla antes de insertar: Si no quieres sobrescribir datos, desmarca Drop Table y asegúrate de que la tabla exista.
• Utiliza embeddings: Cuando necesites búsquedas semánticas, combina la operación Retriever con un modelo de embeddings confiable.

Consideraciones de Seguridad

• La credencial Postgres SQL contiene la URL de conexión y la contraseña; protégela y no la expongas en flujos públicos.
• Evita ejecutar consultas SQL que puedan modificar datos críticos sin una copia de respaldo.
• Cuando uses la operación SQL, valida la entrada para prevenir inyecciones SQL.

Con esta guía podrás integrar fácilmente tu base de datos PostgreSQL en tus flujos de trabajo de Nappai, aprovechando tanto la inserción de datos como la consulta y búsqueda avanzada.