sp_helptracertokenhistory (Transact-SQL)sp_helptracertokenhistory (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

Retourne des informations de latence détaillées pour des jetons de suivi donnés, avec une ligne retournée par abonné.Returns detailed latency information for specified tracer tokens, with one row being returned for each Subscriber. 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_helptracertokenhistory [ @publication = ] 'publication'   
        , [ @tracer_id = ] tracer_id  
    [ , [ @publisher = ] 'publisher' ]  
    [ , [ @publisher_db = ] 'publisher_db' ]  

ArgumentsArguments

[ @publication = ] 'publication'Nom de la publication dans laquelle le jeton de suivi a été inséré.[ @publication = ] 'publication' Is the name of the publication in which the tracer token was inserted. publication est de type sysname, sans valeur par défaut.publication is sysname, with no default.

[ @tracer_id = ] tracer_idID du jeton de suivi dans la table Transact- (SQL) MStracer_tokens pour laquelle les informations d’historique sont retournées.[ @tracer_id = ] tracer_id Is the ID of the tracer token in the MStracer_tokens (Transact-SQL) table for which history information is returned. tracer_id est de type int, sans valeur par défaut.tracer_id is int, with no default.

[ @publisher = ] 'publisher'Nom du serveur de publication.[ @publisher = ] 'publisher' The name of the Publisher. Publisher est de type sysname, avec NULL comme valeur par défaut.publisher is sysname, with a default of NULL.

Notes

Ce paramètre ne doit être spécifié que pour les MicrosoftMicrosoft serveurs de publication non- SQL ServerSQL Server .This parameter should only be specified for non- MicrosoftMicrosoftSQL ServerSQL Server Publishers.

[ @publisher_db = ] 'publisher_db'Nom de la base de données de publication.[ @publisher_db = ] 'publisher_db' The name of the publication database. publisher_db est de type sysname, avec NULL comme valeur par défaut.publisher_db is sysname, with a default value of 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.

Jeu de résultatsResult Set

Nom de la colonneColumn name Type de donnéesData type DescriptionDescription
distributor_latencydistributor_latency bigintbigint Nombre de secondes s'écoulant entre la validation de l'enregistrement du jeton de suivi sur le serveur de publication et la validation de l'enregistrement sur le serveur de distribution.Number of seconds between the tracer token record being committed at the Publisher and the record being committed at the Distributor.
subscriber (Abonné)subscriber sysnamesysname Nom de l'Abonné qui a reçu le jeton de suivi.Name of the Subscriber that received the tracer token.
subscriber_dbsubscriber_db sysnamesysname Nom de la base de données d'abonnement dans laquelle l'enregistrement du jeton de suivi a été inséré.Name of the subscription database into which the tracer token record was inserted.
subscriber_latencysubscriber_latency bigintbigint Nombre de secondes s'écoulant entre la validation de l'enregistrement du jeton de suivi sur le serveur de distribution et la validation de l'enregistrement sur l'Abonné.Number of seconds between the tracer token record being committed at the Distributor and the record being committed at the Subscriber.
overall_latencyoverall_latency bigintbigint Nombre de secondes s'écoulant entre la validation de l'enregistrement du jeton de suivi sur le serveur de publication et la validation de l'enregistrement du jeton sur l'Abonné.Number of seconds between the tracer token record being committed at the Publisher and token record being committed at the Subscriber.

Valeurs des codes de retourReturn Code Values

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

NotesRemarks

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

Exécutez sp_helptracertokens (Transact-SQL) pour obtenir la liste des jetons de suivi pour la publication.Execute sp_helptracertokens (Transact-SQL) to obtain a list of tracer tokens for the publication.

Si le jeu de résultats contient la valeur NULL, les statistiques de latence ne peuvent pas être calculées.A value of NULL in the result set means that latency statistics cannot be calculated. Cela est dû au fait que le jeton de suivi n'a pas été reçu sur le serveur de distribution ou sur l'un des Abonnés.This is because the tracer token has not been received at the Distributor or one of the Subscribers.

ExempleExample

DECLARE @publication AS sysname;
DECLARE @tokenID AS int;
SET @publication = N'AdvWorksProductTran'; 

USE [AdventureWorks2012]

-- Insert a new tracer token in the publication database.
EXEC sys.sp_posttracertoken 
  @publication = @publication,
  @tracer_token_id = @tokenID OUTPUT;
SELECT 'The ID of the new tracer token is ''' + 
    CONVERT(varchar,@tokenID) + '''.'
GO

-- Wait 10 seconds for the token to make it to the Subscriber.
WAITFOR DELAY '00:00:10';
GO

-- Get latency information for the last inserted token.
DECLARE @publication AS sysname;
DECLARE @tokenID AS int;
SET @publication = N'AdvWorksProductTran'; 

CREATE TABLE #tokens (tracer_id int, publisher_commit datetime)

-- Return tracer token information to a temp table.
INSERT #tokens (tracer_id, publisher_commit)
EXEC sys.sp_helptracertokens @publication = @publication;
SET @tokenID = (SELECT TOP 1 tracer_id FROM #tokens
ORDER BY publisher_commit DESC)
DROP TABLE #tokens

-- Get history for the tracer token.
EXEC sys.sp_helptracertokenhistory 
  @publication = @publication, 
  @tracer_id = @tokenID;
GO

AutorisationsPermissions

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 des rôles de base de données fixe db_owner ou replmonitor dans la base de données de distribution peuvent exécuter SP _ helptracertokenhistory.Only members of the sysadmin fixed server role, the db_owner fixed database role in the publication database, or db_owner fixed database or replmonitor roles in the distribution database can execute sp_helptracertokenhistory.

Voir aussiSee Also

Mesurer la latence et valider les connexions pour la réplication transactionnelle Measure Latency and Validate Connections for Transactional Replication
sp_deletetracertokenhistory (Transact-SQL)sp_deletetracertokenhistory (Transact-SQL)