sp_deletetracertokenhistory (Transact-SQL)

  • [アーティクル]

適用対象: SQL Server Azure SQL Managed Instance

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

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 を実行するか、 MStracer_tokens システム テーブルに対してクエリを実行することによって決定できます。

アクセス許可

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

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

関連するコンテンツ