不完全なアクティビティインスタンスを削除する

[アーティクル]
07/21/2023

BAM 定義ファイルを展開すると、定義ファイルで定義された各アクティビティに対し、5 個のテーブルが BAM プライマリインポートデータベースに作成されます。作成されるテーブルは次のとおりです。

ActivityNamebam__Active
ActivityNamebam__Completed
ActivityNamebam__ActiveRelationships
ActivityNamebam__CompletedRelationships
ActivityNamebam__Continuations

は ActivityName 、ユーザーが定義したアクティビティの名前です。

通常の実行中、不完全なデータは bam_ActivityNameActive テーブルに残ります。データにリレーションと参照がある場合は、bam\ActivityName_ActiveRelationships テーブルにデータが存在します。

Continuation を使用したアクティビティの追跡時には、アクティビティが不完全な状態で BAM データベースに残される場合があります。このトピックの最後に示すストアドプロシージャ作成スクリプトを使用すると、不完全なレコードを削除するストアドプロシージャを作成できます。

ストアドプロシージャを作成するには、スクリプトをコピーしてから、SQL Server Management を使用して BAM プライマリインポートデータベースに対しスクリプトを実行します。このスクリプトでは、 RemoveDanglingInstances という名前のストアドプロシージャがデータベースに生成されます。

RemoveDanglingInstances ストアドプロシージャを作成する

SQL Server Management Studioを開き、SQL サーバーに接続します。
サーバー名を展開し、[ データベース] を展開して、BAM プライマリインポートデータベースを選択します。
[新しいクエリ] をクリックします。
ストアドプロシージャ作成スクリプトをコピーし、クエリウィンドウに貼り付けます。
スクリプトを実行します。結果のストアドプロシージャは、ストアドプロシージャの一覧で dbo として表示できます。RemoveDanglingInstances。

不完全なアクティビティインスタンスを削除する

SQL Server Management Studioを開き、SQL サーバーに接続します。
サーバー名を展開し、[ データベース] を展開して、BAM プライマリインポートデータベースを選択します。
[新しいクエリ] をクリックします。
クエリウィンドウで、実行する削除操作に適したパラメーターとを入力 exec RemoveDanglingInstances します。たとえば、発注書アクティビティの不完全なインスタンスをすべて削除するには、「」と入力します exec RemoveDanglingInstances @ActivityName = 'PurchaseOrder'。
スクリプトを実行します。

RemoveDanglingInstances の使用例

ストアドプロシージャは、次の 4 つのパラメーターを受け取ることができます。

パラメーター	説明
@ActivityName nvarchar(128)	削除する不完全なアクティビティインスタンスの名前を指定します。
@ActivityId nvarchar(128)	(省略可能) 指定したインスタンス識別子を持つ未解決のインスタンスだけをストアドプロシージャで削除するように指定します。
@DateThreshold datetime	(省略可能)指定した日付より古い (古い、古いだけ) アクティブなテーブル内のすべてのアクティブインスタンスを削除するように指定します。
@NewTableExtension nvarchar(30)	(省略可能) ストアドプロシージャで、指定された拡張子を既存のアクティビティテーブルに連結して新しいテーブルを 3 つ作成するように指定します。結果のテーブルは次のようになります。 <bam_ActivityName_Active_Extension> <bam_ActivityName_ActiveRelationships_Extension> <bam_ActivityName_Continuations_Extension> 不完全なインスタンスは、データベースから削除される代わりに、これらの新しいテーブルに移動されます。これらのテーブルが既に存在する場合は、再利用されます。存在しない場合は作成されます。大事な：テーブルが既に存在する場合、ストアドプロシージャは、スキーマが作成された場合に使用されるスキーマと一致することを前提としています。スキーマが一致しない場合は、ストアドプロシージャはレコードを挿入できず、削除操作が失敗します。

exec RemoveDanglingInstances @ActivityName = 'PurchaseOrder'

アクティブテーブル、アクティブリレーションシップテーブル、および Continuation テーブルにある PurchaseOrder アクティビティのアクティブなインスタンスをすべて削除します。

exec RemoveDanglingInstances @ActivityName = 'PurchaseOrder', @ActivityId = 'PO220567'

PurchaseOrder アクティビティのアクティブテーブル、アクティブリレーションシップテーブル、および Continuation テーブルから、アクティビティ ID が PO220567 であるアクティビティインスタンスだけを削除します。

exec RemoveDanglingInstances @ActivityName = 'PurchaseOrder', @DateThreshold='2005-02-02 19:27:03:533'

PurchaseOrder アクティビティのアクティブテーブル、アクティブリレーションシップテーブル、および Continuation テーブルから、LastModified の日時が 2005 年 2 月 2 日午後 7:27:03.533 よりも古いアクティビティインスタンスをすべて削除します。

exec RemoveDanglingInstances @ActivityName = 'PurchaseOrder', @ActivityId = 'PO220567', @DateThreshold='2005-02-02 19:27:03:533'

LastModified 列が 2005 年 2 月 2 日午後 7:27:03.533 よりも古い場合にのみ、アクティビティ ID が PO220567 であるアクティビティインスタンスを削除します。

exec RemoveDanglingInstances @ActivityName = 'PurchaseOrder', @DateThreshold='2005-02-02 19:27:03:533', @NewTableExtension=N'Dangling'

データベース内に次のテーブルを作成します。

bam_PurchaseOrder_Active_Dangling

bam_PurchaseOrder_ActiveRelationships_Dangling

bam_PurchaseOrder_Continuations_Dangling

ストアドプロシージャは、PurchaseOrder アクティビティのアクティブテーブル、アクティブリレーションシップテーブル、および Continuation テーブルから、2005 年 2 月 2 日午後 7:27:03.533 よりも古い不完全なアクティビティインスタンスをすべてコピーし、新しく作成されたテーブルに挿入します。次に、コピー済みのアクティビティインスタンスが、アクティブテーブル、アクティブリレーションシップテーブル、および Continuation テーブルから削除されます。

ストアドプロシージャ作成スクリプト

EXEC sp_stored_procedures @sp_name = 'RemoveDanglingInstances'  
IF @@ROWCOUNT > 0 DROP PROCEDURE RemoveDanglingInstances  
GO  
  
CREATE PROCEDURE RemoveDanglingInstances  
    @ActivityName nvarchar(128),  
    @ActivityId nvarchar(128) = NULL,  
    @DateThreshold datetime = NULL,  
    @NewTableExtension nvarchar(30) = NULL  
AS  
    DECLARE @QueryString nvarchar(4000)  
    DECLARE @ActiveTableName sysname  
    DECLARE @ActiveRelationshipsTableName sysname  
    DECLARE @ContinuationsTableName sysname  
    DECLARE @DanglingActiveTableName sysname  
    DECLARE @DanglingActiveRelationshipsTableName sysname  
    DECLARE @DanglingContinuationsTableName sysname  
  
    SET @ActiveTableName = 'bam_' + @ActivityName + '_Active'  
    SET @ActiveRelationshipsTableName = 'bam_' + @ActivityName + '_ActiveRelationships'  
    SET @ContinuationsTableName = 'bam_' + @ActivityName + '_Continuations'  
  
    SET TRANSACTION ISOLATION LEVEL READ COMMITTED  
    BEGIN TRAN  
  
    DECLARE @LockActivity nvarchar(128)  
    SELECT @LockActivity = ActivityName  
    FROM bam_Metadata_Activities WITH (XLOCK)  
    WHERE ActivityName = @ActivityName  
  
    EXEC sp_tables @table_name = #DanglingActivities  
    IF @@ROWCOUNT > 0 DROP TABLE #DanglingActivities  
  
    CREATE TABLE #DanglingActivities(ActivityID nvarchar(128) PRIMARY KEY)  
  
    SET @QueryString = N'INSERT INTO #DanglingActivities (ActivityID) SELECT ActivityID FROM [bam_' + @ActivityName + '_Active]'  
  
    IF (@DateThreshold is not NULL) OR (@ActivityId is not NULL)  
    BEGIN  
        SET @QueryString = @QueryString + ' WHERE'  
    END  
  
    IF (@DateThreshold is not NULL)  
    BEGIN  
        SET @QueryString = @QueryString + ' LastModified < N''' + CONVERT(nvarchar(50), @DateThreshold, 109) + ''''  
        IF (@ActivityId is not NULL)  
        BEGIN  
            SET @QueryString = @QueryString + ' AND'  
        END  
    END  
  
    IF (@ActivityId is not NULL)  
    BEGIN  
        SET @QueryString = @QueryString + ' ActivityID = N''' + @ActivityId + ''''  
    END  
  
    EXEC sp_executesql @QueryString  
    SELECT * FROM #DanglingActivities  
  
    SET @QueryString = N''  
  
    -- If the user gave a table extension, the dangling instances will be inserted  
    -- into that table.   
    IF (isnull(@NewTableExtension, '') <> '')  
    BEGIN  
        SET @DanglingActiveTableName = @ActiveTableName + '_' + @NewTableExtension  
        SET @DanglingActiveRelationshipsTableName = @ActiveRelationshipsTableName + '_' + @NewTableExtension  
        SET @DanglingContinuationsTableName = @ContinuationsTableName + '_' + @NewTableExtension  
  
        -- If the table for the dangling instances exists then insert into it  
        -- If the table does not exist, then create the dangling instances table  
        -- and then insert into it. SELECT INTO will do that.  
        EXEC sp_tables @table_name = @DanglingActiveTableName  
        IF @@ROWCOUNT > 0  
        BEGIN  
            SET @QueryString = N'INSERT INTO ' + '[' + @DanglingActiveTableName + '] SELECT active.* FROM [' + @ActiveTableName + '] active INNER JOIN #DanglingActivities dangling ON active.ActivityID = dangling.ActivityID'  
            EXEC sp_executesql @QueryString  
        END  
        ELSE  
        BEGIN  
            SET @QueryString = N'SELECT active.* INTO [' + @DanglingActiveTableName + '] FROM [' + @ActiveTableName + '] active INNER JOIN #DanglingActivities dangling ON active.ActivityID = dangling.ActivityID'  
            EXEC sp_executesql @QueryString  
        END  
  
        -- Now do what you did for the Active Instances table for the   
        -- ActiveRelationships table  
        EXEC sp_tables @table_name = @DanglingActiveRelationshipsTableName  
        IF @@ROWCOUNT > 0  
        BEGIN  
            SET @QueryString = N'INSERT INTO ' + '[' + @DanglingActiveRelationshipsTableName + '] SELECT active.* FROM [' + @ActiveRelationshipsTableName + '] active INNER JOIN #DanglingActivities dangling ON active.ActivityID = dangling.ActivityID'  
            EXEC sp_executesql @QueryString  
        END  
        ELSE  
        BEGIN  
            SET @QueryString = N'SELECT active.* INTO [' + @DanglingActiveRelationshipsTableName + '] FROM [' + @ActiveRelationshipsTableName + '] active INNER JOIN #DanglingActivities dangling ON active.ActivityID = dangling.ActivityID'  
            EXEC sp_executesql @QueryString  
        END  
  
        -- And finally for the continuations table  
        EXEC sp_tables @table_name = @DanglingContinuationsTableName  
        IF @@ROWCOUNT > 0  
        BEGIN  
            SET @QueryString = N'INSERT INTO ' + '[' + @DanglingContinuationsTableName + '] SELECT active.* FROM [' + @ContinuationsTableName + '] active INNER JOIN #DanglingActivities dangling ON active.ParentActivityID = dangling.ActivityID'  
            EXEC sp_executesql @QueryString  
        END  
        ELSE  
        BEGIN  
            SET @QueryString = N'SELECT active.* INTO [' + @DanglingContinuationsTableName + '] FROM [' + @ContinuationsTableName + '] active INNER JOIN #DanglingActivities dangling ON active.ParentActivityID = dangling.ActivityID'  
            EXEC sp_executesql @QueryString  
        END  
    END  
  
    -- Remove the dangling instances from the Active Instances Table  
    SET @QueryString = 'DELETE FROM [' + @ActiveTableName + '] FROM [' + @ActiveTableName + '] active INNER JOIN #DanglingActivities dangling ON active.ActivityID = dangling.ActivityID '  
    EXEC sp_executesql @QueryString  
  
    SET @QueryString = 'DELETE FROM [' + @ActiveRelationshipsTableName + '] FROM [' + @ActiveRelationshipsTableName + '] active INNER JOIN #DanglingActivities dangling ON active.ActivityID = dangling.ActivityID '  
    EXEC sp_executesql @QueryString  
  
    SET @QueryString = 'DELETE FROM [' + @ContinuationsTableName + '] FROM [' + @ContinuationsTableName + '] active INNER JOIN #DanglingActivities dangling ON active.ParentActivityID = dangling.ActivityID '  
    EXEC sp_executesql @QueryString  
  
    DROP TABLE #DanglingActivities  
  
    COMMIT TRAN      
GO

不完全なインスタンスを解決する別の方法

また、SQL クエリを使用して、BAMPrimaryImport データベースから不完全なアクティビティインスタンスを解決することもできます。「不完全なアクティビティインスタンスを解決する」を参照してください。

参照

BAM データベースの管理

次の方法で共有

不完全なアクティビティインスタンスを削除する

RemoveDanglingInstances ストアドプロシージャを作成する

不完全なアクティビティインスタンスを削除する

RemoveDanglingInstances の使用例

ストアドプロシージャ作成スクリプト

不完全なインスタンスを解決する別の方法

参照

フィードバック

その他のリソース

次の方法で共有

不完全なアクティビティ インスタンスを削除する

RemoveDanglingInstances ストアド プロシージャを作成する

不完全なアクティビティ インスタンスを削除する

RemoveDanglingInstances の使用例

ストアド プロシージャ作成スクリプト

不完全なインスタンスを解決する別の方法

参照

フィードバック

その他のリソース

不完全なアクティビティインスタンスを削除する

RemoveDanglingInstances ストアドプロシージャを作成する

不完全なアクティビティインスタンスを削除する

ストアドプロシージャ作成スクリプト