sp_deletetracertokenhistory (Transact-SQL)

  • Article

S’applique à : SQL Server Azure SQL Managed Instance

Supprime les enregistrements de jetons de suivi des tables système MStracer_tokens et MStracer_history . Cette procédure stockée est exécutée sur la base de données de publication du serveur de publication ou sur la base de données de distribution du serveur de distribution.

Conventions de la syntaxe Transact-SQL

Syntaxe

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

Arguments

[ @publication = ] N’publication'

Nom de la composition dans laquelle le jeton de suivi a été inséré. @publication est sysname, sans valeur par défaut. Ce paramètre est obligatoire.

[ @tracer_id = ] tracer_id

ID du jeton de suivi à supprimer. @tracer_id est int, avec la valeur par défaut NULL. Si NULL, tous les jetons de suivi appartenant à la publication sont supprimés.

[ @cutoff_date = ] cutoff_date

Jetons de suivi insérés dans la publication avant cette date sont supprimés. @cutoff_date est datetime, avec la valeur par défaut NULL.

[ @publisher = ] N’publisher'

Nom du serveur de publication. @publisher est sysname, avec la valeur par défaut NULL.

Remarque

Ce paramètre ne doit être spécifié que pour les serveurs de publication non-SQL Server ou lors de l’exécution de la procédure stockée à partir du serveur de distribution.

[ @publisher_db = ] N’publisher_db'

Nom de la base de données de publication. @publisher_db est sysname, avec la valeur par défaut NULL. Ce paramètre est ignoré si la procédure stockée est exécutée sur le serveur de publication.

Remarque

Ce paramètre doit être spécifié lors de l’exécution de la procédure stockée à partir du serveur de distribution.

Valeurs des codes de retour

0 (réussite) or 1 (échec).

Notes

sp_deletetracertokenhistory est utilisé dans la réplication transactionnelle.

Une erreur se produit si vous spécifiez les deux paramètres @tracer_id et @cutoff_date.

Si vous n’exécutez sp_deletetracertokenhistory pas pour supprimer les métadonnées de jeton de suivi, les informations sont supprimées lorsque le nettoyage de l’historique planifié régulièrement se produit.

Les ID de jeton de suivi peuvent être déterminés en exécutant sp_helptracertokens ou en interrogeant la table système MStracer_tokens .

autorisations

Seuls les membres du personnel suivants ont l’autorité d’exécution sp_deletetracertokenhistory:

  • Membres des rôles replmonitor , dans la base de données de distribution.
  • Membres du rôle serveur fixe sysadmin .
  • Membres du rôle de base de données fixe db_owner , dans la base de données de publication.
  • Db_owner de la base de données fixe.

Contenu connexe