libSQL

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

Hay dos componentes con el nombre libSQL. Este trabaja fila a fila con tus tablas. El otro libSQL guarda datos que luego se pueden buscar por significado.

Cuándo usarlo

• Tu aplicación guarda sus datos en Turso y quieres leerlos o actualizarlos desde un flujo.
• Dar a un agente acceso a consultar registros.
• Guardar en una tabla los resultados de un proceso.

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 libSQL / Turso con la dirección y el token de tu base. Consulta Credenciales.

Campo	Qué hace
Credential (obligatorio)	La credencial libSQL / Turso con los datos de conexión.
Operation (obligatorio)	Qué hace el componente. Por defecto, Insert.
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.
Mode	Con 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 Type	Con 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 String	Las condiciones que deben cumplir las filas. Los textos van entre comillas simples y los números sin comillas.
Field To Update	Con 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'.
Limit	Con Get, cuántas filas se devuelven como máximo. Por defecto, 10.

Opciones avanzadas

Campo	Qué hace
Return All	Con 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 app de reservas guarda las citas en Turso.

1. Añade libSQL con la credencial libSQL / Turso.
2. Elige Update, la tabla citas, la condición id = 120 en Filter String y 1 en Field To Update.
3. En el campo que aparece, escribe el nuevo estado: confirmada.

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

• libSQL: guarda datos en libSQL para buscarlos por significado.
• MySQL: lo mismo para MySQL.