sp_deletetracertokenhistory (Transact-SQL)sp_deletetracertokenhistory (Transact-SQL)

S’APPLIQUE À : ouiSQL Server ouiAzure SQL Database (Managed Instance uniquement) nonAzure Synapse Analytics (SQL DW) nonParallel Data Warehouse APPLIES TO: yesSQL Server yesAzure SQL Database (Managed Instance only) noAzure Synapse Analytics (SQL DW) noParallel Data Warehouse

Supprime les enregistrements de jeton de suivi des tables système Transact -SQL () et (MStracer_history) Transact-SQL MStracer_tokens.Removes tracer token records from the MStracer_tokens (Transact-SQL) and MStracer_history (Transact-SQL) system tables. 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.This stored procedure is executed at the Publisher on the publication database or at the Distributor on the distribution database.

Icône de lien de rubrique Conventions de la syntaxe Transact-SQLTopic link icon Transact-SQL Syntax Conventions

SyntaxeSyntax

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

ArgumentsArguments

@publication= 'publication'
Nom de la publication dans laquelle le jeton de suivi a été inséré.Is the name of the publication in which the tracer token was inserted. Le type de données est sysname.The data type is sysname. Ce paramètre est obligatoire.This parameter is required.

[ @tracer_id= ] tracer_id
ID du jeton de suivi à supprimer.Is the ID of the tracer token to delete. Le type de données est int. La valeur par défaut est null.The data type is int. The default value is null. Si la valeur est null, tous les jetons de suivi appartenant à la publication sont supprimés.If null, all tracer tokens belonging to the publication are deleted.

[ @cutoff_date= ] cutoff_date
Les jetons de suivi insérés dans la publication avant cette date sont supprimés.Tracer tokens inserted into the publication before this date are deleted. Le type de données est DateTime.The data type is datetime. La valeur par défaut est null.The default value is null.

[ @publisher= ] 'publisher'
Nom du serveur de publication.Is the name of the Publisher. Le type de données est sysname.The data type is sysname. La valeur par défaut est null.The default value is null.

Notes

Ce paramètre doit être spécifié uniquement pour les serveurs MicrosoftMicrosoft de publication non- SQL ServerSQL Server ou lors de l’exécution de la procédure stockée à partir du serveur de distribution.This parameter should only be specified for non- MicrosoftMicrosoftSQL ServerSQL Server Publishers or when executing the stored procedure from distributor.

[ @publisher_db= ] 'publisher_db'
Nom de la base de données de publication.Is the name of the publication database. Le type de données est sysname.The data type is sysname. La valeur par défaut est NULL.The default value is NULL. Ce paramètre est ignoré si la procédure stockée est exécutée sur le serveur de publication.This parameter is ignored if the stored procedure is executed at the Publisher.

Notes

Ce paramètre doit être spécifié lors de l’exécution de la procédure stockée à partir du serveur de distribution.This parameter should be specified when executing the stored procedure from distributor.

Valeurs des codes de retourReturn Code Values

0 (succès) ou 1 (échec)0 (success) or 1 (failure)

NotesRemarks

sp_deletetracertokenhistory est utilisé dans la réplication transactionnelle.sp_deletetracertokenhistory is used in transactional replication.

Une erreur se produit si vous spécifiez les paramètres tracer_id et cutoff_date.An error occurs if you specify both parameters tracer_id and cutoff_date.

Si vous n’exécutez pas sp_deletetracertokenhistory pour supprimer les métadonnées de jeton de suivi, les informations sont supprimées lors du nettoyage régulier de l’historique.If you do not execute sp_deletetracertokenhistory to delete tracer token metadata, the information will be deleted when the regularly scheduled history cleanup occurs.

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 Transact- (SQL) MStracer_tokens .Tracer token IDs can be determined by executing sp_helptracertokens (Transact-SQL) or by querying the MStracer_tokens (Transact-SQL) system table.

AutorisationsPermissions

Seul le personnel suivant est habilité à exécuter sp_deletetracertokenhistory:Only the following personnel have the authority to execute sp_deletetracertokenhistory:

  • Membres des rôles replmonitor , dans la base de données de distributionMembers of the replmonitor roles, in the distribution database
  • Membres du rôle serveur fixe sysadmin .Members of the sysadmin fixed server role.
  • Membres du rôle de base de données fixe db_owner dans la base de données de publication.Members of the db_owner fixed database role, in the publication database.
  • Db_owner de la base de données fixe.The db_owner of the fixed database.

Voir aussiSee Also

Mesurer la latence et valider les connexions pour la réplication transactionnelleMeasure Latency and Validate Connections for Transactional Replication

sp_helptracertokenhistory (Transact-SQL)sp_helptracertokenhistory (Transact-SQL)