sp_deletetracertokenhistory (Transact-SQL)

  • [アーティクル]

適用対象: SQL ServerAzure SQL Managed Instance

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

Transact-SQL 構文表記規則

構文

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

引数

[ @publication = ] N'publication'

トレーサー トークンが挿入されたパブリケーションの名前。 @publicationは sysname で、既定値はありません。 このパラメーターは必須です。

[ @tracer_id = ] tracer_id

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

[ @cutoff_date = ] cutoff_date

この日付より前にパブリケーションに挿入されたトレーサー トークンは削除されます。 @cutoff_dateは datetime で、既定値は NULL.

[ @publisher = ] N'publisher'

パブリッシャーの名前。 @publisherは sysname で、既定値は NULL.

Note

このパラメーターは、SQL Server 以外のパブリッシャーまたはディストリビューターからストアド プロシージャを実行する場合にのみ指定する必要があります。

[ @publisher_db = ] N'publisher_db'

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

Note

このパラメーターは、ディストリビューターからストアド プロシージャを実行するときに指定する必要があります。

リターン コードの値

0 (成功) または 1 (失敗)。

解説

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

パラメーター@tracer_idと@cutoff_dateの両方を指定すると、エラーが発生します。

トレーサー トークンメタデータを削除するために実行sp_deletetracertokenhistoryしない場合、定期的にスケジュールされた履歴クリーンアップが発生すると、情報が削除されます。

トレーサー トークン ID は、sp_helptracertokens (Transact-SQL) を実行するか、MStracer_tokens (Transact-SQL) システム テーブルに対してクエリを実行することによって決定できます。

アクセス許可

実行する権限 sp_deletetracertokenhistoryを持つのは、次の担当者だけです。

  • ディストリビューション データベース内の replmonitor ロールのメンバー。
  • sysadmin 固定サーバー ロールのメンバー。
  • パブリケーション データベースdb_owner固定データベース ロールのメンバー。
  • 固定データベースのdb_owner。

関連するコンテンツ