Effectuer la maintenance de la base de données Insights

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 values.json && rm -f appsettings.json
   

3. Obtenir les paramètres actuels :

   kubectl -n uipath get cm orchestrator-customconfig -o jsonpath='{.data.values\.json}' | jq '.' > values.json
   

4. Formatez les paramètres :

   jq '.AppSettings' values.json > appsettings.json
   

5. Définissez la clé Insights.ModuleEnabled sur False:

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

6. Mettez à jour la configuration :

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

7. Validez la configuration :

   kubectl -n uipath get cm orchestrator-customconfig -o jsonpath='{.data.values\.json}' | jq
   

   Le résultat attendu est le suivant :

   {
     "AppSettings": {
       "Insights.ModuleEnabled": "false"
     }
   }
   

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

8. Exécutez les scripts de maintenance.

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

9. Supprimez tous les fichiers en conflit :

   rm -f values.json && rm -f appsettings.json
   

10. Récupérer les paramètres actuels :

    kubectl -n uipath get cm orchestrator-customconfig -o jsonpath='{.data.values\.json}' | jq '.' > values.json
    

11. Formatez les paramètres :

    jq '.AppSettings' values.json > appsettings.json
    

12. Supprimez la clé Insights.ModuleEnabled :

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

13. Mettez à jour la configuration :

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

14. Confirmez la configuration :

    kubectl -n uipath get cm orchestrator-customconfig -o jsonpath='{.data.values\.json}' | jq
    

    Le résultat attendu est le suivant :

    {
      "AppSettings": {}
    }
    

    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 (@CutoffTimeStamp) 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 (@BatchSize) INT = 100000 (Facultatif) La valeur par défaut est 100000. 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.	Supprimer les données de [dbo].[Jobs], Les tables [dbo].[JobEvents], [dbo].[QueueItems], [dbo].[QueueItemEvents], [dbo].[RobotLogs] basées sur 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 = 100000 (Facultatif) Delete data in batches of 100000. See Considerations.	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)