Effectuer la maintenance de la base de données Insights

Gérer la base de données Insights avec des sauvegardes régulières et nettoyer les anciennes données sur OpenShift.

Vue d'ensemble (Overview)

La base de données Insights fonctionne à l'aide de deux tables : dbo et read. Les deux tables stockent les données des bases de données Orchestrator et transmettent les données entre elles. Au fil du temps, les tables stockent une grande quantité de données qui peuvent avoir un impact sur les performances de la base de données. Vous pouvez libérer de l'espace en supprimant les données non pertinentes ou obsolètes.

Le seuil estimé pour le stockage des données historiques est défini sur

• Jusqu'à 100 millions de tâches
• Jusqu’à 1 milliard d’événements de tâche
• Jusqu'à 100 millions d'éléments de file d'attente
• Jusqu'à 500 millions d'événements d'élément de file d'attente
• Jusqu'à 1 milliard de journaux de robots

Utilisez les scripts SQL de maintenance de base de données suivants pour créer des procédures enregistrées SQL (SQL Stored Procedures), puis exécutez ces procédures stockées SQL pour supprimer toutes les données des tables [dbo].Jobs, [dbo].JobEvents, [dbo].QueueItems, [dbo].QueueItemEvents, [dbo].RobotLogs ou uniquement les [dbo].RobotLogs.

Remarque :

Sauvegardez votre base de données avant d'exécuter les scripts. Avant d’exécuter les scripts PROCEDURE [read].[Delete_Insights_Data_Read] et PROCEDURE [read].[Delete_Process_Logs_Read] , le module Insights doit être désactivé.

Considérations

• Les scripts avec le suffixe _DBO sont utilisés pour supprimer des données des tables de schéma DBO,
• Les scripts avec le suffixe _Read sont utilisés pour supprimer des données des tables de schéma en lecture.
• Les lots de grande taille peuvent avoir un impact sur la vitesse d'exécution. Envisagez d'utiliser la taille de lot par défaut, qui est définie sur 100 000.

Prérequis

Avant d'exécuter les scripts PROCEDURE [read].[Delete_Insights_Data_Read] et PROCEDURE [read].[Delete_Process_Logs_Read] , le module Insights doit être désactivé.

1. Connectez-vous au cluster Automation Suite.

2. Supprimez les fichiers pouvant entrer en conflit avec les commandes :

   rm -f appsettings.json
   

3. Obtenir les paramètres actuels :

   uipathctl config orchestrator get-config --app-settings > appsettings.json || echo '{}' > appsettings.json
   

   Remarque :

   Ignorer le message suivant s'il s'affiche : Cannot print custom config: Orchestrator custom config is missing appsettings.. Ce message d’erreur implique seulement l’absence de paramètres personnalisés.

4. Ajoutez la clé Insights.ModuleEnabled et définissez-la sur False:

   jq '.["Insights.ModuleEnabled"] = "false"' appsettings.json > temp.json && mv -f temp.json appsettings.json
   

5. Mettez à jour la configuration :

   uipathctl config orchestrator update-config --app-settings appsettings.json
   

6. Validez la configuration :

   uipathctl config orchestrator get-config --app-settings
   

   Le résultat attendu est le suivant :

   {
       "Insights.ModuleEnabled": "false"
   }
   

   Le résultat peut contenir d’autres paramètres sans rapport avec Insights.

7. Exécutez les scripts de maintenance. Après avoir exécuté le script de maintenance, réactivez Insights en procédant comme suit.

8. Supprimez tous les fichiers en conflit :

   rm -f appsettings.json
   

9. Supprimez la clé Insights.ModuleEnabled :

   jq 'del(.["Insights.ModuleEnabled"])' appsettings.json > temp.json && mv -f temp.json appsettings.json
   

10. Mettez à jour la configuration :

    uipathctl config orchestrator update-config --app-settings appsettings.json
    

11. Confirmez la configuration :

    uipathctl config orchestrator get-config --app-settings
    

    Le résultat attendu est le suivant :

    {}
    

    Le résultat peut contenir d’autres paramètres sans rapport avec Insights.

Ressources

Emplacement de téléchargement des procédures stockées SQL

Procédure enregistrée SQL 1 : supprimez toutes les données en fonction de l’horodatage de coupure

Générez et enregistrez les procédures enregistrées SQL (SQL Stored Procedures) suivantes pour supprimer tous les types de données (Jobs, JobEvents, QueueItems, QueueItemEvents, RobotLogs) pour un horodatage de coupure.

Procédures enregistrées SQL (SQL Stored Procedures)	Paramètre	Description
Delete_Insights_Data_DBO	@CouperHorodatage DATETIME (Requis) Supprimez les cinq types de données avant un horodatage spécifié (par exemple, 2021-01-01 01:00:05). Ne fournissez pas d’horodatage qui supprime toutes les données d’une table vide. @TailleLot INT = 100,000 (Facultatif) Par défaut, il est défini sur 100,000. Data is deleted batch by batch. For example, if you have 1 million RobotLogs and leave the default value, the delete command runs ten times to remove all data.	Supprimez les données des tables [dbo].[Jobs], [dbo].[JobEvents], [dbo].[QueueItems], [dbo].[QueueItemEvents], [dbo].[RobotLogs] en fonction d'un horodatage de coupure.
Delete_Insights_Data_Read	S/O	Tronquez les tables [read].Jobs, [read].JobEvents, [read].QueueItems, [read].QueueItemEvents, [read].RobotLogs.

Remarque :

Les widgets du tableau de bord Insights (Insights Dashboard) sont à nouveau disponibles une fois que la procédure SQL enregistrée 1 (SQL Stored Procedure 1) est terminée et que les données ont été renvoyées. Gardez à l'esprit que le processus de renvoi peut prendre des heures étant donné que vous disposez d'une grande quantité de données.

Lorsque vous exécutez le Script SQL (SQL Script) Delete_Insights_Data_DBO pour la première fois, il crée un index non-cluster QueueItems.IX_CreationTime dans le but d'accélérer les futures exécutions.

Procédure enregistrée SQL 2 (SQL Stored Procedure) : supprimez les données JournauxRobot (RobotLogs) en fonction des NomProcessus (ProcessNames) et de l'ID de locataire (Tenant ID)

Générez et enregistrez cette procédure enregistrée SQL (SQL Stored Procedure) pour supprimer les JournauxRobot (RobotsLogs) en fonction des NomProcessus (ProcessNames) et de l'ID de locataire (Tenant ID).

Procédures enregistrées SQL (SQL Stored Procedures)	Paramètre	Description
Delete_Process_Logs_DBO	@NomProcessus (@ProcessName) NVARCHAR(128) (Requis) Nom du processus Orchestrator. @TenantId INT (obligatoire) L'ID de locataire (Tenant ID) est requis car deux locataires peuvent exécuter des processus avec des noms identiques. @TailleLot (@BatchSize) INT = 100,000 (Facultatif) Supprimez les données par lots de 100 000. Pour de plus amples informations, consultez la section Considérations.	Supprimez les données de la table [dbo].[RobotLogs] par NomProcessus (ProcessName) et ID de locataire (Tenant ID).
Delete_Process_Logs_Read	@NomProcessus (@ProcessName) NVARCHAR(128) (Requis) @TenantId INT (obligatoire)	Tronquez le tableau [read].RobotLogs.

Remarque :

Les widgets des tableaux de bord Insights (Insights Dashboard) associés aux JournauxRobot (RobotLogs) sont à nouveau disponibles une fois que la procédure enregistrée SQL 2 (SQL Stored Procedure 2) est terminée et que les données ont été renvoyées. Gardez à l'esprit que le processus de renvoi peut prendre des heures étant donné que vous disposez d'une grande quantité de données.

Articles associés

Procédures stockées (moteur de base de données)