Insights データベースのメンテナンスを実行する

概要

Insights データベースは、dbo と read の 2 つのテーブルを使用して動作します。両方のテーブルに Orchestrator データベースのデータが格納され、相互にデータが渡されます。時間の経過とともにテーブルに大量のデータが格納され、データベースのパフォーマンスに影響を与える可能性があります。関係のないデータや古いデータを削除することで、領域を解放できます。

履歴データを保存するための推定しきい値は、以下のように設定されます。

• 最大1億人の雇用
• 最大 10 億件のジョブ イベント
• 最大 1 億個のキュー アイテム
• 最大 5 億件のキュー アイテム イベント
• 最大 10 億件のロボット ログ

次のデータベース メンテナンス SQL スクリプトを使用して SQL ストアド プロシージャを作成します。次に、それらの SQL ストアド プロシージャを実行して、[dbo].Jobs、[dbo].JobEvents、[dbo].QueueItems、[dbo].QueueItemEvents、および [dbo].RobotLogs テーブルから、または [dbo].RobotLogs のみから、すべてのデータを削除します。

注:

スクリプトを実行する前にデータベースをバックアップしてください。 PROCEDURE [read].[Delete_Insights_Data_Read] および PROCEDURE [read].[Delete_Process_Logs_Read] スクリプトを実行する前に、Insights モジュールを無効化する必要があります。

考慮事項

• DBO スキーマ テーブルからデータを削除するには、_DBO サフィックスが追加されたスクリプトを使用します。
• _Read サフィックスが追加されたスクリプトは、Read スキーマのテーブルからデータを削除するために使用します。
• サイズの大きいバッチは、実行速度に影響を与える可能性があります。既定のバッチ サイズ (100000 に設定) の使用を検討してください。

前提条件

PROCEDURE [read].[Delete_Insights_Data_Read] および PROCEDURE [read].[Delete_Process_Logs_Read] スクリプトを実行する前に、Insights モジュールを無効化する必要があります。

1. Automation Suite クラスターにログインします。

2. コマンドと競合する可能性のあるファイルを削除します。

   rm -f appsettings.json
   

3. 現在の設定を取得します。

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

   注:

   「 Cannot print custom config: Orchestrator custom config is missing appsettings.」というメッセージが表示された場合は、無視してください。このエラー メッセージは、カスタム設定がないことを意味するだけです。

4. Insights.ModuleEnabled キーを追加し、 に設定しますFalse

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

5. 構成を更新します。

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

6. 設定を検証します。

   ./bin/uipathctl config orchestrator get-config --app-settings
   

   期待される結果は次のとおりです。

   {
       "Insights.ModuleEnabled": "false"
   }
   

   結果には、Insights に関係のない他の設定が含まれる場合があります。

7. メンテナンス スクリプトを実行します。メンテナンス スクリプトの実行後、以下の手順に従い Insights を再度有効化します。

8. 競合するファイルをすべて削除します。

   rm -f appsettings.json
   

9. Insights.ModuleEnabled キーを削除します。

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

10. 構成を更新します。

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

11. 設定を確認します。

    ./bin/uipathctl config orchestrator get-config --app-settings
    

    期待される結果は次のとおりです。

     {}
    

    結果には、Insights に関係のない他の設定が含まれる場合があります。

リソース

SQL ストアド プロシージャのダウンロード場所

SQL ストアドプロシージャ 1: カットオフ タイムスタンプに基づいてすべてのデータを削除する

次の SQL ストアド プロシージャを生成して保存し、カットオフ タイムスタンプまでのすべての種類のデータ (Jobs、JobEvents、QueueItems、QueueItemEvents、RobotLogs) を削除します。

SQL ストアド プロシージャ	パラメーター	説明
Delete_Insights_Data_DBO	@CutoffTimeStamp DATETIME (必須) 指定したタイムスタンプ (例: 2021-01-01 01:00:05 ) より前の 5 種類のデータをすべて削除します。 すべてのデータが削除されて空のテーブルになるようなタイムスタンプを入力しないでください。 @BatchSize INT = 100000 (任意) 既定では、 100000 に設定されています。 データはバッチ単位で削除されます。たとえば、100 万件のロボット ログがあり、既定値をそのまま使用した場合は、削除コマンドが 10 回実行され、すべてのデータが削除されます。	カットオフ タイムスタンプに基づいて、 [dbo].[Jobs] 、 [dbo].[JobEvents] 、 [dbo].[QueueItems] 、 [dbo].[QueueItemEvents] 、 [dbo].[RobotLogs] のテーブルからデータを削除します。
Delete_Insights_Data_Read	N/A	[read].Jobs、[read].JobEvents、[read].QueueItems、[read].QueueItemEvents、および [read].RobotLogs テーブルを切り捨てます。

注:

SQL ストアド プロシージャ 1 が完了し、データがバックフィルされた後、Insights のダッシュボード ウィジェットが再び利用できるようになります。大量のデータがある場合、バックフィル プロセスが完了するのに時間がかかる可能性があることにご留意ください。

Delete_Insights_Data_DBO SQL スクリプトを初めて実行すると、将来の実行を高速化することを目的として、QueueItems.IX_CreationTime 非クラスター化インデックスが作成されます。

SQL ストアド プロシージャ 2: プロセス名とテナント ID に基づいてロボット ログのデータを削除する

次の SQL ストアド プロシージャを生成して保存し、プロセス名とテナント ID に基づいてロボット ログを削除します。

SQL ストアド プロシージャ	パラメーター	説明
Delete_Process_Logs_DBO	@ProcessName NVARCHAR(128) (必須) Orchestrator のプロセス名です。 @TenantId INT (必須) 2 つのテナントが同じ名前のプロセスを実行する可能性があるため、テナント ID は必須です。 @BatchSize INT = 100000 (任意) 100000 件のバッチ単位でデータを削除します。「考慮事項」をご覧ください。	プロセス名とテナント ID に基づいて [dbo].[RobotLogs] テーブルからデータを削除します。
Delete_Process_Logs_Read	@ProcessName NVARCHAR(128) (必須) @TenantId INT (必須)	[read].RobotLogs テーブルを切り捨てます。

注:

SQL ストアド プロシージャ 2 が完了し、データがバックフィルされた後、ロボット ログに関連する Insights ダッシュボード ウィジェットを再び利用できるようになりました。大量のデータがある場合、バックフィル プロセスが完了するのに時間がかかる可能性があることにご留意ください。

関連記事

ストアド プロシージャ (データベース エンジン)