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 です。ストアド プロシージャがパブリッシャで実行される場合、このパラメータは無視されます。

解説

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 ロールのメンバだけです。

戻り値

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

参照

関連項目

sp_helptracertokenhistory (Transact-SQL)

その他の技術情報

トランザクション レプリケーションの待機時間を計測して接続を検証する方法 (レプリケーション Transact-SQL プログラミング)
トランザクション レプリケーションの待機時間の計測と接続の検証

ヘルプおよび情報

SQL Server 2005 の参考資料の入手