Partager via


sp_deletetracertokenhistory (Transact-SQL)

Supprime les enregistrements de jeton de suivi des tables système MStracer_tokens (Transact-SQL) et MStracer_history (Transact-SQL). 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.

Icône Lien de rubrique Conventions de la syntaxe de Transact-SQL

Syntaxe

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

Arguments

  • [ @publication= ] 'publication'
    Nom de la publication dans laquelle le jeton de suivi a été inséré. publication est de type sysname, sans valeur par défaut.

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

  • [ @cutoff_date= ] cutoff_date
    Spécifie une date de coupure de telle sorte que tous les jetons de suivi insérés dans la publication avant cette date soient supprimés. cutoff_date est de type datetime, avec NULL comme valeur par défaut.

  • [ @publisher= ] 'publisher'
    Nom du serveur de publication. publisher est de type sysname, avec NULL comme valeur par défaut.

    [!REMARQUE]

    Ce paramètre ne doit être spécifié que pour les serveurs de publication non Microsoft SQL Server.

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

Valeurs des codes de retour

0 (succès) ou 1 (échec)

Notes

sp_deletetracertokenhistory est utilisé dans la réplication transactionnelle.

Lorsque vous exécutez sp_deletetracertokenhistory, vous ne pouvez spécifier que tracer_id ou cutoff_date. Une erreur se produit si vous spécifiez les deux paramètres.

Si vous n'exécutez pas sp_deletetracertokenhistory pour supprimer les métadonnées des jetons de suivi, les informations sont supprimées lorsque le nettoyage d'historique périodique se produit.

Vous pouvez déterminer les ID de jeton de suivi en exécutant sp_helptracertokens (Transact-SQL) ou en interrogeant la table système MStracer_tokens (Transact-SQL).

Autorisations

Seuls les membres du rôle serveur fixe sysadmin, du rôle de base de données fixe db_owner dans la base de données de publication ou bien du rôle de base de données fixe db_owner ou du rôle replmonitor dans la base de données de distribution peuvent exécuter sp_deletetracertokenhistory.

Voir aussi

Référence

sp_helptracertokenhistory (Transact-SQL)

Concepts

Mesurer la latence et valider les connexions pour la réplication transactionnelle