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'
    トレーサ トークンが挿入されたパブリケーションの名前です。publicationsysname であり、既定値はありません。
  • [ @tracer_id= ] tracer_id
    削除するトレーサ トークンの ID です。tracer_idint であり、既定値は NULL です。null の場合、パブリケーションに属するすべてのトレーサ トークンが削除されます。
  • [ @cutoff_date= ] cutoff_date
    終了日を指定します。それ以前にパブリケーションに挿入されたすべてのトレーサ トークンが削除されます。cutoff_date は datetime であり、既定値は NULL です。
  • [ @publisher= ] 'publisher'
    パブリッシャの名前です。publishersysname であり、既定値は NULL です。

    ms187806.note(ja-jp,SQL.90).gifメモ :
    このパラメータを指定するのは、Microsoft SQL Server 以外のパブリッシャの場合だけです。
  • [ @publisher_db= ] 'publisher_db'
    パブリケーション データベースの名前です。publisher_dbsysname であり、既定値は 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 の参考資料の入手