次の方法で共有

  • [アーティクル]

sp_deletetracertokenhistory (Transact-SQL)

MStracer_tokens (Transact-SQL) システム テーブルおよび MStracer_history (Transact-SQL) システム テーブルからトレーサ トークン レコードを削除します。このストアド プロシージャは、パブリッシャ側でパブリケーション データベースについて実行されます。または、ディストリビュータ側でディストリビューション データベースについて実行されます。

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

構文

sp_deletetracertokenhistory [ @publication = ] 'publication' 
    [ , [ @tracer_id = ] tracer_id ]
    [ , [ @cutoff_date = ] cutoff_date ]
    [ , [ @publisher = ] 'publisher' ] 
    [ , [ @publisher_db = ] 'publisher_db' ]

引数

  • [ @publication= ] 'publication'
    トレーサ トークンが挿入されたパブリケーションの名前です。publication は sysname であり、既定値はありません。

  • [ @tracer_id= ] tracer_id
    削除するトレーサ トークンの ID です。tracer_id は int であり、既定値は NULL です。null の場合、パブリケーションに属するすべてのトレーサ トークンが削除されます。

  • [ @cutoff_date= ] cutoff_date
    終了日を指定します。それ以前にパブリケーションに挿入されたすべてのトレーサ トークンが削除されます。cutoff_date は datetime であり、既定値は NULL です。

  • [ @publisher= ] 'publisher'
    パブリッシャの名前です。publisher は sysname であり、既定値は NULL です。

    注意注

    このパラメータを指定するのは、Microsoft SQL Server 以外のパブリッシャの場合だけです。

  • [ @publisher_db= ] 'publisher_db'
    パブリケーション データベースの名前です。publisher_db は sysname であり、既定値は NULL です。ストアド プロシージャがパブリッシャで実行される場合、このパラメータは無視されます。

戻り値

成功した場合は 0 を、失敗した場合は 1 をそれぞれ返します。

説明

sp_deletetracertokenhistory は、トランザクション レプリケーションで使用します。

sp_deletetracertokenhistory を実行する場合、tracer_id または cutoff_date のどちらか 1 つのみを指定できます。パラメータを 2 つ指定するとエラーが発生します。

sp_deletetracertokenhistory を実行しないでトレーサ トークン メタデータを削除すると、定期的な履歴のクリーンアップ時に情報が削除されます。

トレーサ トークン ID を調べるには、sp_helptracertokens (Transact-SQL) を実行するか、MStracer_tokens (Transact-SQL) システム テーブルのクエリを実行します。

権限

sp_deletetracertokenhistory を実行できるのは、固定サーバー ロール sysadmin、パブリケーション データベースの固定データベース ロール db_owner、ディストリビューション データベースの固定データベース ロール db_owner、またはディストリビューション データベースの replmonitor ロールのメンバだけです。