sp_check_for_sync_trigger (Transact-SQL)

  • [アーティクル]

ユーザー定義トリガまたはストアド プロシージャが、即時更新サブスクリプションに使われるレプリケーション トリガのコンテキストで呼び出されているかどうかを判別します。このストアド プロシージャは、パブリッシャ側でパブリケーション データベースについて、または、サブスクライバ側でサブスクリプション データベースについて実行されます。

トピック リンク アイコンTransact-SQL 構文表記規則

構文

sp_check_for_sync_trigger [ @tabid = ] 'tabid' 
    [ , [ @trigger_op = ] 'trigger_output_parameters' OUTPUT ]
    [ , [ @fonpublisher = ] fonpublisher ]

引数

  • [@tabid = ] 'tabid'
    即時更新トリガに対してチェックされるテーブルのオブジェクト ID です。tabid は int であり、既定値はありません。

  • [@trigger_op = ] 'trigger_output_parameters' OUTPUT
    出力パラメータが呼び出し元のトリガの種類を返すかどうかを指定します。trigger_output_parameters は char(10) であり、次のいずれかの値をとります。

    値 説明

    Ins

    INSERT トリガです。

    Upd

    UPDATE トリガです。

    Del

    DELETE トリガです。

    NULL (既定値)
  • [ @fonpublisher = ] fonpublisher
    ストアド プロシージャの実行場所を指定します。fonpublisher のデータ型は bit で、既定値は 0 です。0 の場合はサブスクライバ側、1 の場合はパブリッシャ側で実行します。

解説

sp_check_for_sync_trigger は、スナップショット レプリケーションおよびトランザクション レプリケーションで使用します。

sp_check_for_sync_trigger は、レプリケーション トリガとユーザー定義トリガ間を調整するのに使用します。このストアド プロシージャは、レプリケーション トリガのコンテキスト内で呼び出されているかどうかを判別します。たとえば、ユーザー定義トリガの内部でプロシージャ sp_check_for_sync_trigger を呼び出すことができます。sp_check_for_sync_trigger で 0 が返された場合、ユーザー定義トリガは処理を続行します。sp_check_for_sync_trigger で 1 が返された場合、ユーザー定義トリガは終了します。ユーザー定義トリガは、レプリケーション トリガがテーブルを更新するときには起動されません。

権限

sp_check_for_sync_trigger ストアド プロシージャは、sys.objects システム ビューで SELECT 権限を持っているどのユーザーでも実行できます。

戻り値

0 の場合、ストアド プロシージャが即時更新トリガのコンテキスト内で呼び出されていないことを示します。1 の場合、ストアド プロシージャが即時更新トリガのコンテキスト内で呼び出されており、@trigger_op で返される種類のトリガであることを示します。

使用例

次の例は、サブスクライバ テーブルのトリガで使用できるコードを示しています。

DECLARE @retcode int, @trigger_op char(10), @table_id int
SELECT @table_id = object_id('tablename')
EXEC @retcode = sp_check_for_sync_trigger @table_id, @trigger_op OUTPUT
IF @retcode = 1
RETURN

このコードは、パブリッシャのテーブルのトリガに追加することもできます。コードは似ていますが、sp_check_for_sync_trigger への呼び出しには追加のパラメータが含まれています。

DECLARE @retcode int, @trigger_op char(10), @table_id int, @fonpublisher int
SELECT @table_id = object_id('tablename')
SELECT @fonpublisher = 1
EXEC @retcode = sp_check_for_sync_trigger @table_id, @trigger_op OUTPUT, @fonpublisher
IF @retcode = 1
RETURN

参照

その他の技術情報

トランザクション レプリケーションの更新可能なサブスクリプション

ヘルプおよび情報

SQL Server 2005 の参考資料の入手