DB Manager — Guía del usuario | YoBench

Para qué sirve el módulo «DB Manager»

DB Manager es un banco de trabajo unificado para bases de datos relacionales y documentales directamente desde YoBench. En lugar de hacer malabares con varias herramientas (DBeaver, pgAdmin, mysql-cli, MongoDB Compass) te conectas desde una sola app, exploras el esquema, ejecutas consultas, generas SQL con IA, comparas esquemas, programas backups y vigilas el estado de las conexiones.

Lo que obtienes:

• Seis motores de bases de datos — MySQL, MariaDB, PostgreSQL, SQLite, MS SQL Server y MongoDB.
• Explorador de esquema — árbol completo de bases de datos / esquemas / tablas / vistas / procedimientos con su estructura, índices, claves foráneas y triggers.
• Editor SQL con historial de consultas, exportación de resultados a CSV / JSON / XLSX y un límite de seguridad de 10 000 filas.
• Generación SQL con IA — describe lo que necesitas en lenguaje natural y recibe una consulta preliminar atada al contexto de la base de datos actual.
• Diagrama ER con disposición automática Dagre, aristas de claves foráneas y zoom / pan.
• Comparación y sincronización de esquemas — diff de dos esquemas, generación del script ALTER y aplicación al destino.
• Backups — dump / restore manual, además de un planificador con cron, rotación de archivos e historial de ejecuciones.
• Monitoreo de conexiones — comprobaciones de salud, latencia y banner de versión del servidor.
• Secretos cifrados — contraseñas, claves SSL y claves SSH se guardan cifradas en la base local; el renderer solo ve flags has_password.

Motores soportados y opciones de conexión

Para los motores TCP puedes guardar credenciales de túnel SSH en el registro de la conexión (el campo está reservado para una futura exposición en la UI). Todos los campos sensibles — contraseña, clave SSL, contraseña SSH y clave privada SSH — se cifran en disco.

Workbench

Cada conexión abierta vive en su propia pestaña. Una sola ventana admite hasta 10 sesiones activas (a nivel de renderer). Las sesiones headless usadas por el planificador, los backups y las comprobaciones de salud corren en un pool aparte.

El Workbench incluye:

• Árbol de esquema a la izquierda — desciende desde la raíz de la conexión hasta una tabla o vista concreta.
• Inspector de objetos — columnas con tipos y nullabilidad, índices (incluida la unicidad), constraints, claves foráneas y triggers.
• Vista de datos — filas paginadas con filtros por columna. Las celdas tienen un tope de 64 KB; el resultado devuelve un flag truncated si las filas superan 10 000.
• Editor SQL — escribe o pega una consulta, ejecútala, mira los resultados en tabla y vuelve atrás por el historial.
• Vista DDL — script CREATE completo de la tabla seleccionada o de la base entera.
• Diagrama ER — lienzo interactivo de React Flow con auto-layout Dagre para tablas y aristas FK.

Editor SQL y generación con IA

El editor SQL acepta cualquier sentencia válida para el motor conectado. Los resultados aterrizan en una tabla ordenable con filtros por columna y tres formatos de exportación: CSV, JSON y XLSX. Cada consulta ejecutada se guarda en el Query History de la conexión, así puedes relanzarla o copiarla más tarde.

La generación SQL con IA está disponible cuando hay un proveedor de IA configurado en Ajustes → DB Manager:

1. Abre el campo de IA encima del editor.
2. Describe lo que quieres (por ejemplo, «top 10 clientes por ingresos en los últimos 30 días»).
3. La base / esquema actuales se envían como contexto, la IA devuelve una consulta preliminar, tú la revisas y la ejecutas.

Si no hay proveedor seleccionado el botón de IA queda deshabilitado — las consultas siguen funcionando, solo se desactiva el paso de generación.

Comparación y sincronización de esquemas

Elige dos esquemas (de la misma conexión o de dos distintas), lanza Schema Compare (comparación) y revisa el diff:

• Tablas: added, removed, altered, identical.
• Para tablas alteradas: cambios a nivel de columna (columnas añadidas / eliminadas, cambios de tipo, default / nullabilidad, cambios de índice).
• Sync script generado — una secuencia ejecutable de ALTER/CREATE/DROP que pone el destino a la altura de la fuente.
• Exportación opcional del script a disco antes de ejecutarlo.

Sirve para dos casos típicos: promover cambios de staging a producción y validar si dos réplicas se han desincronizado.

Backup y restore

Dump puntual. Clic derecho sobre la conexión → Backup. El dump se escribe en un archivo ZIP que incluye un manifiesto JSON y el contenido de la base. Puedes incluir o excluir:

• Filas de datos
• Vistas, procedimientos almacenados, funciones
• Grants

Restore. Abre la conexión destino (o crea una nueva sobre una base vacía) → Restore → elige el archivo de dump → confirma la política de sobreescritura.

Backups programados. Desde el panel Backup Schedules de una conexión:

• Elige una expresión cron o un preset (cada día, cada semana, cada N horas).
• Indica la carpeta destino.
• Configura la rotación: conservar las N copias más recientes.
• Botón opcional Run Now (ejecutar ahora) para validar la programación sin esperar.

El panel Backup History muestra cada ejecución con su estado, tamaño del archivo y duración. Las ejecuciones fallidas incluyen el mensaje de error.

Monitoreo de conexiones

Cada conexión tiene un flag opcional de monitoreo con su intervalo (5 minutos por defecto). Cuando está activo, el Workbench:

• Hace ping al servidor con la comprobación de actividad propia del motor.
• Registra la latencia en milisegundos.
• Guarda el último banner de versión del servidor.
• Muestra un indicador de estado en la fila de la conexión.

El historial se almacena localmente y alimenta el panel de monitoreo dentro de la pestaña del Workbench.

DB tasks embebidas

Cada conexión puede alojar sus propias DB tasks — scripts SQL periódicos (limpieza, refresco de vistas materializadas, estadísticas). Una task tiene:

• Un nombre y el cuerpo SQL.
• Una programación (estilo cron).
• Un toggle de habilitada / deshabilitada.
• Historial de ejecuciones con estado: success, error, timeout.

Las DB tasks son distintas del AI Task Scheduler: son SQL puro, una sola conexión, sin IA implicada.

Ajustes

En Ajustes → DB Manager:

• Proveedor de IA — qué proveedor responde al prompt SQL con IA. Vacío por defecto.

Los ajustes por conexión viven en el formulario de la propia conexión: nombre, motor, host, puerto, base, usuario, contraseña, modo SSL, ruta del fichero SQLite, intervalo de monitoreo y extras específicos del motor (por ejemplo, authSource de MongoDB).

Flujo de uso

1. Añade una conexión

1. Abre DB Manager desde el menú lateral.
2. Pestaña Conexiones → Nueva conexión.
3. Elige el motor — el formulario muestra solo los campos relevantes.
4. Rellena host / puerto / base / usuario / contraseña (o ruta del archivo si es SQLite).
5. Pulsa Test — ves la versión del servidor y la latencia round-trip.
6. Guarda.

2. Abre el workbench

1. Pulsa Open en la fila de la conexión → se abre una pestaña nueva.
2. Navega el árbol del esquema y haz doble clic en una tabla para inspeccionar datos y estructura.
3. Cambia a SQL Editor para ejecutar sentencias.

3. Programa los backups

1. En el menú de la conexión elige Backup Schedules.
2. New Schedule → carpeta, expresión cron, retención.
3. Run Now para verificar, o espera al tick del cron.
4. Inspecciona las ejecuciones en Backup History.

4. Compara esquemas

1. En el menú de la conexión elige Schema Compare.
2. Selecciona origen y destino (base + esquema).
3. Compare → revisa el diff.
4. Generate Sync Script → revisa el SQL → Execute o Save to file.

Siguientes pasos

• Configura un proveedor de IA para activar la generación SQL con IA.
• Usa el AI Task Scheduler cuando necesites que un LLM ejecute una consulta, resuma el resultado y lo publique en algún sitio según un cron.
• Para pruebas de carga y capacidad de la propia base de datos, el módulo de Pruebas de carga puede empujar los endpoints HTTP que están delante.

Ayuda y comentarios

¿Encontraste un bug o quieres soporte para un nuevo motor? Escríbenos a través del formulario de contacto.