MySQL

El componente MySQL permite a los usuarios leer, escribir y obtener información de bases de datos MySQL directamente desde el panel de Nappai. Con él puedes insertar datos en tablas, ejecutar consultas SQL personalizadas o simplemente consultar la estructura y metadatos de tu base de datos.

¿Cómo funciona?

El componente se conecta a la base de datos MySQL usando una credencial previamente configurada en Nappai. Cuando el usuario selecciona una operación, el componente construye la consulta SQL correspondiente y la envía al servidor MySQL. Los resultados se devuelven como un objeto Data que puede ser usado en otros componentes del flujo, o como Database Info cuando se solicita información de la base de datos.

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 los datos proporcionados en la tabla especificada. Si la tabla ya existe y se marca la opción Drop Table, la tabla se elimina antes de la inserción.
• SQL: Ejecuta una consulta SQL completa que el usuario escribe en el campo Search Query. Los resultados se devuelven como datos.
• DatabaseInfo: Devuelve información sobre la base de datos, como tablas, columnas y tipos de datos.

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

Entradas

Campos de Entrada

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

• Ingest Data: Datos que se insertarán en la tabla.
  • Visible en: Add
• Operation: Selecciona la operación que deseas ejecutar.
  • Visible en: Add, SQL, DatabaseInfo
• Search Query: Consulta SQL que se ejecutará.
  • Visible en: SQL
• Table Name: Nombre de la tabla en la base de datos.
  • Visible en: Add
• Drop Table: Si se marca, la tabla se eliminará antes de insertar datos.
  • Visible en: Add, DatabaseInfo

Nota: El componente necesita una credencial de tipo MySQL. Primero configura la credencial en la sección de credenciales de Nappai, luego selecciónala en el campo Credential del componente.

Salidas

• Data: Resultado de la operación Add o SQL. Se devuelve como un objeto de tipo Data que puede ser conectado a otros componentes.
• Database Info: Información de la base de datos devuelta por la operación DatabaseInfo. Se devuelve como un objeto de tipo DatabaseInfo.

Ejemplo de Uso

Operación Add

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

Operación SQL

1. Selecciona SQL en el campo Operation.
2. En Search Query escribe:

   SELECT * FROM clientes WHERE edad > 30;

3. Conecta la salida Data a un gráfico de barras para visualizar la edad de los clientes mayores de 30 años.

Componentes Relacionados

• Database Connector – Conecta a diferentes tipos de bases de datos (PostgreSQL, SQLite, etc.).
• SQL Query Builder – Genera consultas SQL de forma visual sin escribir código.
• Data Exporter – Exporta los resultados de una consulta a CSV o Excel.

Consejos y Mejores Prácticas

• Usa credenciales seguras: Nunca compartas la credencial MySQL en el flujo; mantenla en la sección de credenciales de Nappai.
• Evita consultas largas: Si la tabla es grande, limita los resultados con LIMIT o filtra con WHERE para evitar tiempos de espera.
• Prueba en modo de desarrollo: Antes de ejecutar una operación Add en producción, prueba con una tabla de prueba para asegurarte de que los datos se insertan correctamente.

Consideraciones de Seguridad

• La credencial MySQL almacena la contraseña encriptada; solo el componente puede acceder a ella.
• Cuando uses la operación SQL, revisa la consulta para evitar inyecciones SQL.
• Si la tabla contiene datos sensibles, considera aplicar cifrado a nivel de columna o usar conexiones TLS al servidor MySQL.