MySQL

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

Cuándo usarlo

• Guardar en tu base de datos los pedidos o contactos que llegan por un formulario.
• Dar a un agente acceso a consultar el stock o el estado de los pedidos.
• Actualizar el estado de un registro cuando termina un proceso.
• Preparar 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 MySQL con el servidor, el puerto, el usuario, la contraseña y la base de datos. Consulta Credenciales.

Campo	Qué hace
Credential (obligatorio)	La credencial MySQL 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 tienda quiere que su asistente consulte el estado de un pedido.

1. Añade MySQL con la credencial MySQL de la tienda.
2. Elige Get en Operation y la tabla pedidos en Table Name.
3. Ponlo en modo herramienta para que el agente escriba en Filter String algo como numero = 'A-1043'.
4. Conéctalo al conector de herramientas del agente.

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

• Postgres SQL y SQL Server: lo mismo para otras bases de datos.