sp_deletetracertokenhistory (Transact-SQL)

  • Article

S’applique à :SQL ServerAzure SQL Managed Instance

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.

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) ou 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 l’historique planifié régulièrement propre up se produit.

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

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