El mantenimiento de la base de datos es una tarea que todo administrador de Automic sabe que debería realizar con regularidad, pero que va posponiendo discretamente, hasta que los datos de ejecución, los informes antiguos y los mensajes del sistema han saturado la base de datos AE. Durante años, el mantenimiento de la base de datos de Automic implicaba recurrir a las utilidades locales de la base de datos AE o acceder directamente a la base de datos, lo cual es precisamente la razón por la que acababa relegado al final de la lista de tareas pendientes. En Automic V26, esa fricción ha desaparecido: puede archivar, reorganizar, eliminar y limpiar datos operativos directamente desde la perspectiva de administración de AWI y la API REST de AE. Este artículo forma parte de nuestra serie de capacitación sobre Automic V26 y se centra en la ruta de la API REST; el vídeo tutorial que aparece a continuación muestra las mismas operaciones de principio a fin.
¿Qué ha cambiado en el mantenimiento de la base de datos Automic en V26?
En versiones anteriores, el archivado, la reorganización y la descarga de la base de datos de AE se gestionaban mediante las utilidades independientes de AE DB o trabajando directamente con la base de datos. Automic V26 somete estas actividades a un control regulado y basado en API: las mismas tareas de mantenimiento están ahora disponibles a través de la API REST de AE y la perspectiva de administración de AWI, por lo que ya no se necesitan binarios de utilidades locales ni credenciales directas de la base de datos para ejecutarlas.
En general, los datos que se gestionan son lo que Automic denomina «datos operativos»: mensajes del sistema, datos de ejecución (antes denominados «estadísticas»), informes y comentarios. En conjunto, la API REST de AE abarca cinco operaciones: archivar datos operativos, crear informes de revisión, reorganizar datos operativos, eliminar datos operativos y vaciar la papelera de reciclaje.
La ventaja práctica es la gobernanza. Canalizar el mantenimiento a través de la API REST de AE significa que cada archivado, reorganización y eliminación es una llamada auditable y repetible, en lugar de una ejecución ad hoc de una utilidad en el ordenador de un usuario; además, se puede conceder mediante un único privilegio, en lugar de un acceso a nivel de base de datos. Para los entornos Automic regulados, esa trazabilidad es tan importante como el espacio liberado en la base de datos.
Privilegios y configuración que hay que preparar primero
Antes de ejecutar cualquier tarea de mantenimiento de la base de datos Automic a través de la API REST, es necesario cumplir dos requisitos: disponer de los privilegios de usuario adecuados y definir las variables que controlan cada operación.
- Privilegios. El privilegio
DB_MAINTENANCEinicia los procesos de archivado, reorganización y eliminación. Para descargar paquetes de archivo e informes de revisión, también necesitaACCESS_METRICS_ENDPOINT, y para leer o vaciar la Papelera de reciclaje necesitaRECYCLE_BIN. - Variables de configuración en el Cliente 0. Los parámetros de archivo se encuentran en
UC_UTILITY_ARCHIVE, los parámetros de reorganización enUC_UTILITY_REORG, y los parámetros de borrado enUC_UTILITY_DB_UNLOAD. Para los informes de revisión, debe activarse el registro de objetos (OBJECT_AUDIT) enUC_CLIENT_SETTINGS. - Ubicación de salida. El paquete de archivo o de informes se guarda automáticamente en el directorio que se defina en el archivo INI del Automation Engine para sistemas locales (on-premise), o en el archivo
values.yamlpara entornos AAKE (en contenedores). Desde allí, usted lo transfiere a donde lo necesite.
Con los privilegios concedidos y las variables configuradas una vez, cada ejecución posterior es una única llamada a la API. El recorrido a continuación muestra estas operaciones en AWI y a través de la API REST de AE; sígalo y luego utilice las llamadas de referencia en la segunda mitad de esta guía.
Las operaciones de mantenimiento a través de la API REST de AE
Cada operación se activa en el Cliente 0 y puede dirigirse a un único cliente (target_client=100) o a todos los clientes (target_client=ALL); no se puede seleccionar un subconjunto arbitrario. La mayoría de los procesos devuelven un run_id que se utiliza para recuperar el paquete resultante.
Archivar datos operativos
El archivado recopila mensajes del sistema, datos de ejecución, informes y comentarios en un archivo ZIP descargable. Usted lo activa con una solicitud POST y luego descarga el paquete con el ID de ejecución devuelto:
POST /ae/api/v1/0/system/clients/archive?target_client=100
→ { "run_id": 1007001 }
GET /ae/api/v1/0/system/clients/archive/1007001
→ (descarga el paquete de archivo)
Con un cliente REST como Postman, utilice la opción Send and Download; con cURL, añada -o para guardar el archivo en el disco. Si se llama al mismo punto final con el método «reset», se desactiva el indicador de archivo.
Creación de informes de revisión
Los informes de revisiones le proporcionan un registro cronológico y listo para auditorías de los cambios en un cliente —objetos creados, eliminaciones, transportes, inicios de sesión de usuarios y más—, lo que mantiene un entorno regulado en cumplimiento. Puede acotar un informe por rango de fechas y por tipo de cambio:
POST /ae/api/v1/0/system/clients/revisionreport?target_client=ALL
{
"from": "2026-01-01T00:00:00Z",
"to": "2026-03-31T00:00:00Z",
"types": ["CREATE", "DELETE", "OBJ_MOD", "USER", "TRNSPRT"]
}
Si types se omite, se incluyen todas las categorías de cambio. El informe se descarga con su run_id, exactamente igual que un paquete de archivo.
Reorganizar datos operativos
La reorganización de los datos operativos marca los registros antiguos para su eliminación, sin borrarlos todavía. La lógica de retención combina dos ajustes: un umbral de días para la reorganización y un recuento de registros que se conservan. Por ejemplo, si el umbral de reorganización se establece en 30 y el recuento de registros que se conservan en 5, el proceso conserva todo lo de los últimos 30 días más los cinco registros anteriores más recientes por objeto.
POST /ae/api/v1/0/system/clients/reorg?target_client=ALL
Eliminar datos operativos
Una vez que los registros están marcados, la eliminación de datos operativos los elimina permanentemente de la base de datos de AE. Es un único disparador por cliente o para todos los clientes:
POST /ae/api/v1/0/system/clients/deletedata?target_client=ALL
Vaciar la papelera de reciclaje
Los objetos eliminados se mueven a la Papelera de reciclaje en lugar de desaparecer inmediatamente. Desde el Cliente 0, puede enumerar los contenidos de la papelera de un cliente y luego vaciarla:
GET /ae/api/v1/0/recyclebin?target_client=100
DELETE /ae/api/v1/0/recyclebin?target_client=ALL
Los objetos que aún contienen datos operativos no archivados no se eliminan; se devuelven en la respuesta en failedObjects. La regla general es sencilla: primero archivar, luego vaciar.
Restablecer las marcas de archivado y reorganización
Si necesita volver a ejecutar un ciclo —por ejemplo, para archivar registros que ya estaban marcados—, los puntos finales de archivo y reorganización aceptan un método de reinicio que borra la marca correspondiente. Esto le permite corregir una ejecución mal programada sin tocar la base de datos, manteniendo todo el ciclo de mantenimiento dentro de la API REST de AE.
Convierta el mantenimiento de la base de datos Automic en una tarea programada, no en una carga
Dado que ahora cada operación es una simple llamada REST, el siguiente paso lógico es dejar de ejecutarlas manualmente. Incorpore la secuencia "archivar → reorganizar → eliminar" en un flujo de trabajo programado de Automic para que la base de datos de AE se mantenga con una periodicidad predecible, e incluya el Cliente 0, que acumula los registros del servidor y del agente y que es fácil pasar por alto. Si prefiere llamar a los puntos finales desde un script, la nueva integración de Automic V26 con Python le permite invocarlos desde un trabajo nativo de Python junto con su lógica de automatización existente. El mantenimiento fiable de la base de datos de Automic es una de las partes menos glamurosas, pero más importantes, para que V26 funcione correctamente.
Un patrón sensato es reorganizar con regularidad, archivar antes de eliminar y vaciar la Papelera de reciclaje una vez que el archivado haya confirmado que no queda nada sin archivar. Ajustar los umbrales de retención al volumen de sus datos es donde reside la mayor parte del valor: lo suficientemente agresivo como para mantener la base de datos reducida, lo suficientemente conservador como para cumplir su ventana de auditoría.
Esta guía forma parte de nuestra serie de formación sobre Automic V26. Si SAP es un elemento central de su entorno, el documento complementario sobre la compatibilidad de SAP Agent con múltiples sistemas aborda otro cambio de la versión V26 que conviene revisar antes de actualizar. Para consultar las especificaciones oficiales, véase la descripción general de la versión Automic V26 de Broadcom y la documentación de la API REST de AE 26.0 sobre el mantenimiento de la base de datos.
Preguntas frecuentes
¿Qué privilegios necesito para realizar tareas de mantenimiento de la base de datos Automic a través de la API REST?
Necesita el privilegio DB_MAINTENANCE para iniciar el archivado, la reorganización y la eliminación. Para descargar paquetes de archivo e informes de revisión, también necesita ACCESS_METRICS_ENDPOINT, y para leer o vaciar la Papelera de reciclaje, necesita el privilegio RECYCLE_BIN.
¿Funciona tanto en instalaciones locales (on-premise) como en entornos AAKE en contenedores?
Sí. Las operaciones son idénticas; solo difiere la ubicación de salida. En las instalaciones locales, establece el directorio del paquete en el archivo INI del Automation Engine, y en los entornos AAKE (contenedores) lo establece en el archivo values.yaml.
¿Qué se considera datos operativos en Automic?
Se consideran datos operativos los mensajes del sistema, los datos de ejecución (anteriormente llamados estadísticas), los informes y los comentarios. Estos son los registros que se acumulan durante la operación diaria y que el mantenimiento está diseñado para archivar, reorganizar y eliminar.
¿Puedo ejecutar el mantenimiento para todos los clientes a la vez?
Sí. Desde el Cliente 0 puede dirigirse a un solo cliente con target_client=100 o a todos los clientes con target_client=ALL. No puede seleccionar un subconjunto arbitrario de clientes en una sola llamada.
¿Cómo descargo un paquete de archivo o un informe de revisión?
Utilice en una solicitud GET posterior el run_id devuelto al activar el proceso. En Postman, utilice la opción Send and Download; con cURL, agregue el indicador -o para escribir el archivo en el disco.
¿Cuál es la diferencia entre reorganizar y eliminar?
Reorganizar marca los datos operativos que han caducado para su eliminación según su configuración de retención, pero los deja en la base de datos. Luego, la eliminación elimina permanentemente los registros marcados. Ejecutar primero reorganizar y luego eliminar le permite controlar lo que realmente sale de la base de datos.
¿Dónde se almacena el paquete de archivo o informe?
Cuando se activa el proceso, un trabajo en segundo plano recopila los datos en un archivo ZIP y lo escribe en el directorio definido en el archivo INI del Automation Engine (en las instalaciones) o en el archivo values.yaml (AAKE). Luego, lo descarga o transfiere desde allí.
Planifique la configuración de su mantenimiento V26
Trasladar el mantenimiento de la base de datos a la API REST supone un pequeño cambio con enormes beneficios en cuanto a la preparación para auditorías y el buen estado de la base de datos; sin embargo, vale la pena ajustar correctamente los privilegios, los umbrales de retención y la programación para su entorno específico. Si quiere que revisemos su configuración de V26, reserve una consulta gratuita con el equipo de Tricise Automic.

