Task Mining データベースをクリーンアップする

Automation Suite の Task Mining データベースのメンテナンス タスク (スキーマ構造やデータ ストレージのクリーンアップなど)。

このページでは、Task Mining データベースに必要なメンテナンス タスクについて説明します。

概要

既定の Task Mining データベースは [AutomationSuite_Task_Mining] という名前で、単一のスキーマ [tddiscovery] を使用してデータを保存します。Task Mining は主にデータをオブジェクト ストアに保存するので、データベースを頻繁にメンテナンスする必要性が減ります。必要に応じて、データベースのメンテナンス スクリプト Remove_Active_History.sql を使用し、次のデータベース テーブルを定期的にクリーンアップできます。

• [AutomationSuite_Task_Mining].[tddiscovery].[ActivityHistory]

重要:

スクリプトを実行する前に、必ず Task Mining データベース [AutomationSuite_Task_Mining] をバックアップしてください。

前提条件

次の前提条件が満たされている必要があります。

• [AutomationSuite_Task_Mining] データベースにアクセスでき、必要な権限を持っている。

Remove_Active_History.sql スクリプト

CREATE PROCEDURE [tddiscovery].[Delete_TaskMining_ActivityHistory] 
   @CutoffTimeStamp datetime2, 
   @BatchSize INT = 10000 
AS
BEGIN
  
   DECLARE @total_deleted_items BIGINT = 0; 
   
   SET NOCOUNT ON;
   
   -- delete ActivityHistoryItems 
   DECLARE @Deleted_Rows_ActivityHistoryItems INT = @BatchSize; 
   WHILE(@Deleted_Rows_ActivityHistoryItems = @BatchSize)
   BEGIN
     DELETE TOP(@BatchSize) FROM [tddiscovery].[ActivityHistory] WHERE At <= @CutoffTimeStamp; 
     SET @Deleted_Rows_ActivityHistoryItems = @@ROWCOUNT; 
     SET @total_deleted_items = @Deleted_Rows_ActivityHistoryItems + @total_deleted_items;
   END;

   PRINT('The script executed successfully!');
   PRINT('Total deleted rows from [tddiscovery].[ActivityHistory]: ' + CONVERT(NVARCHAR, @total_deleted_items));

END; 
GO

手順

1. Remove_Active_History.sql データベースのメンテナンス スクリプトを実行して、Delete_TaskMining_ActivityHistory ストアド プロシージャを作成します。

   注:

   常に最新バージョンのストアド プロシージャを使用してください。

   ストアド プロシージャの名前を変更して、以前に実行された SQL ストアド プロシージャをアーカイブすることを強くお勧めします。 これにより、特定のバージョンの SQL ストアド プロシージャ内の潜在的な問題や異常を検出して対処する機会が提供されます。 次のコードは、アーカイブの目的で SQL ストアド プロシージャの名前を変更する方法の例を示しています。

   EXEC sp_rename '[tddiscovery].[Delete_TaskMining_ActivityHistory]', '[Delete_TaskMining_ActivityHistory_2024-10-10_001]';
   

2. Delete_TaskMining_ActivityHistory ストアド プロシージャを実行します。これにより、カットオフタイムスタンプのアクティビティ履歴に関連するすべてのデータが [AutomationSuite_Task_Mining].[tddiscovery].[ActivityHistory] テーブルから削除されます。

SQL ストアド プロシージャ: アクティビティの履歴を削除する

注:

PROCEDURE [tddiscovery].[Delete_TaskMining_ActivityHistory]スクリプトを実行する前に、Task Mining の使用が中断されていることを確認してください。

注:

SQL ストアド プロシージャを使用したデータの削除に制限はありませんが、最近のアクティビティ レコードを保持するために、最低期間 (30 日間など) アクティビティ履歴をシステムに保持することをお勧めします。 これにより、SQL ストアド プロシージャが完全に削除される前に、SQL ストアド プロシージャ内の潜在的な問題や異常を検出して対処する機会も得られます。

次の表で、SQL ストアド プロシージャ Delete_TaskMining_ActivityHistory のパラメーターについて説明します。

パラメーター	説明	必須 Y/N
@CutoffTimeStamp	指定したタイムスタンプ (例: 2021-01-01 01:00:05) より前のデータをすべて削除します。 テーブルが空になるようなタイムスタンプを入力しないでください。	Y
@BatchSize INT = 10000	一度に削除する行数です。これにより、データをバッチ単位で削除できます。 The default is set to 10000 .	n

次のコードは、このストアド プロシージャの実行方法の例を示しています。

DECLARE @ProcessTime datetime2;
SET @ProcessTime = '2024-07-11 13:44:42.7856026';
EXEC [tddiscovery].[Delete_TaskMining_ActivityHistory] @CutoffTimeStamp = @ProcessTime;

詳細については、 ストアド プロシージャに関する Microsoft の公式ドキュメントをご覧ください。