Base de datos
Base de datos
El Runner mantiene una base de datos local para la cola de ejecuciones, los registros de programaciones y los mensajes de WhatsApp. La pestaña Base de datos es donde eliges qué base de datos usa y limpias lo que se ha ido acumulando.
Tipos de base de datos
Interna
El Runner usa una base de datos incorporada que gestiona él mismo. No hay nada más que configurar: es la opción más simple y la adecuada para la mayoría de los casos.
Externa
El Runner se conecta a una base de datos ya instalada en la máquina o en otro servidor. Úsala cuando:
- Tu organización ya tiene una infraestructura de bases de datos gestionada
- Necesitas más control sobre los datos (copias de seguridad, monitoreo, etc.)
- El entorno exige una base de datos compartida entre varios servicios
Bases de datos compatibles en modo externo:
| Base de datos | Puerto por defecto |
|---|---|
| MySQL | 3306 |
| MariaDB | 3306 |
| PostgreSQL | 5432 |
| SQL Server | 1433 |
Qué se almacena
Sea cual sea el tipo elegido, el Runner siempre usa una base de datos llamada roberty, con tres tablas:
runs — historial de ejecuciones
| Columna | Qué es |
|---|---|
id | El identificador de la ejecución |
robotKey | El robot que se ejecutó |
instanceId | La instancia/configuración del robot que se ejecutó |
status | No iniciada, En ejecución o Finalizada |
scheduled | Si la disparó una programación (true) o una persona (false) |
exitCode | El código de salida del proceso (0 = éxito) |
error | El mensaje de error, si la ejecución falló |
startedAt / finishedAt | Cuándo empezó y terminó la ejecución |
stdout / stderr | Salida estándar y de error durante la ejecución |
stdoutFilePath / stderrFilePath | Ruta del archivo con el log completo |
errorScreenshotPath | Captura de pantalla tomada en el momento del error |
argsFilePath | Ruta del archivo con los argumentos que usó la ejecución |
uploadStatus | Controla el envío de la ejecución a Roberty Studio: No enviada, Enviando o Enviada |
uploadError | El error ocurrido al enviar los datos al Studio |
createdAt / updatedAt | Cuándo se creó el registro y cuándo cambió por última vez |
schedules — reglas de programación
| Columna | Qué es |
|---|---|
id | El identificador de la regla |
robotKey | El robot al que pertenece la regla |
instanceId | La instancia a la que pertenece la regla |
rules | La lista de reglas: días (de la semana, del mes o fechas concretas) y horario (una franja, un intervalo fijo u horarios concretos) |
createdAt / updatedAt | Cuándo se creó y cuándo cambió por última vez |
whatsapp_messages — cola de mensajes de WhatsApp
| Columna | Qué es |
|---|---|
id | El identificador del mensaje |
to | El número de destino |
type | text o media |
content | El texto del mensaje (o el pie, si es multimedia) |
mediaPath | Ruta del archivo multimedia, cuando type es media |
instanceName | La instancia/conexión de WhatsApp que lo envió |
status | Pendiente, En cola o Procesado |
error | El error de envío, si lo hubo |
sentAt | Cuándo se envió |
createdAt / updatedAt | Cuándo se creó y cuándo cambió por última vez |
Los registros eliminados —a mano o por la limpieza de la base de datos— no se borran de verdad: quedan marcados como eliminados, pero siguen almacenados.
Configurar la base de datos
Base de datos interna
- En el panel administrativo, abre la pestaña Base de datos.
- En Tipo de base de datos, elige Interna.
- Haz clic en Guardar.
Base de datos externa
- En Tipo de base de datos, elige Externa.
- Selecciona la base de datos en el desplegable (MySQL, MariaDB, PostgreSQL o SQL Server).
- Completa los campos de conexión:
| Campo | Qué es |
|---|---|
| Puerto | El puerto de la base de datos |
| Usuario | Un usuario con acceso a la base de datos |
| Contraseña | La contraseña de ese usuario |
| Host | La dirección del servidor (p. ej. localhost o una IP) |
- Haz clic en Guardar.
Los cambios en la base de datos solo surten efecto tras reiniciar el Runner.
Conectarse directamente a la base de datos
Las tablas anteriores se pueden consultar directamente, desde cualquier cliente de base de datos (DBeaver, HeidiSQL, MySQL Workbench, SQL Server Management Studio, etc.) o incluso desde un robot de Roberty. Es útil para informes personalizados o para cruzar estos datos con otros sistemas, sin pasar por Roberty Studio.
Base de datos externa
Usa los mismos datos de conexión que configuraste en la pestaña Base de datos (host, puerto, usuario y contraseña) y el nombre de base de datos roberty.
Base de datos interna
Incluso en modo Interna, el Runner ejecuta un servidor MariaDB real en la propia máquina: no es una caja negra inaccesible. Los datos de conexión son:
| Campo | Valor |
|---|---|
| Host | localhost (solo accesible en la máquina donde está instalado el Runner) |
| Puerto | El puerto que se muestra en el campo Puerto de la pestaña Base de datos |
| Usuario | root |
| Contraseña | En blanco (sin contraseña) |
| Base de datos | roberty |
Leer directamente es seguro, pero evita editar o borrar registros desde las tablas. Los campos status y uploadStatus los gestiona internamente el Runner: cambiarlos a mano puede bloquear la cola de ejecuciones o impedir que los datos lleguen al Studio. Para eliminar datos antiguos, usa Limpiar la base de datos, más abajo.
Tamaño actual de la base de datos
El panel muestra el tamaño actual de la base de datos en tiempo real (B, KB, MB o GB). Úsalo para vigilar cómo crecen los datos con el tiempo.
Limpiar la base de datos
Si la base de datos crece mucho, o quieres eliminar datos que ya no necesitas, usa la limpieza.
- Haz clic en Limpiar la base de datos.
- En el modal de confirmación, elige qué limpiar:
- Cola de ejecuciones (registros finalizados) — elimina los registros de ejecuciones ya terminadas
- Cola de mensajes de WhatsApp — elimina los mensajes de WhatsApp ya procesados
- Haz clic en Sí, limpiar para confirmar.
Los datos que elimina la limpieza se borran permanentemente. Asegúrate de que ya no necesitas esos registros antes de confirmar. Considera exportarlos, o revisar antes el historial de ejecuciones en el Designer.
Siguientes pasos
- Proxy — enruta las conexiones de red del Runner por un proxy
- Cola de ejecuciones — monitorea las ejecuciones en curso