Insights データベースのメンテナンス

概要

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

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

2 億件のロボットログ
1 億件のキューアイテムイベント
1 億件のジョブイベント
2,000 万個のキューアイテム
2,000 万個のジョブ

次のデータベースメンテナンス 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 モジュールを無効化する必要があります。

Orchestrator がインストールされている仮想マシンにログインします。
次の項目を見つけます: C:\Program Files (x86)\UiPath\Orchestrator\UiPath.Orchestrator.dll.configInsights.ModuleEnabled。
メモ帳で、UiPath.Orchestrator.dll.config ファイルを開きます。
次の設定値を確認します。
```
"codes": [
    {
      "code": "<add key=\"Insights.ModuleEnabled\" value=\"true\" />",
      "language": "text",
      "name": "configuration value"
    }
  ]
}
  "codes": [
    {
      "code": "<add key=\"Insights.ModuleEnabled\" value=\"true\" />",
      "language": "text",
      "name": "configuration value"
    }
  ]
}
```
true を false に置き換えます。
ファイルを保存します。
Orchestrator がインストールされている仮想マシンに戻り、仮想マシンを再起動します。
メンテナンススクリプトを実行します。

注: メンテナンススクリプトの実行後は、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 ストアドプロシージャ パラメーター 説明

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` テーブルを切り捨てます。

Delete_Process_Logs_DBO