sp_posttracertoken (Transact-SQL)sp_posttracertoken (Transact-SQL)

S’APPLIQUE À : ouiSQL Server nonAzure SQL Database nonAzure Synapse Analytics (SQL DW) nonParallel Data Warehouse APPLIES TO: yesSQL Server noAzure SQL Database noAzure Synapse Analytics (SQL DW) noParallel Data Warehouse

Cette procédure publie un jeton de suivi dans le journal des transactions sur le serveur de publication et commence le processus de suivi des statistiques de latence.This procedure posts a tracer token into the transaction log at the Publisher and begins the process of tracking latency statistics. Les informations sont enregistrées lorsque le jeton de suivi est écrit dans le journal des transactions, lorsqu'il est repris par l'Agent de lecture du journal et lorsqu'il est appliqué par l'Agent de distribution.Information is recorded when the tracer token is written to the transaction log, when it is picked up by the Log Reader Agent, and when it is applied by the Distribution Agent. Cette procédure stockée est exécutée sur le serveur de publication dans la base de données de publication.This stored procedure is executed at the Publisher on the publication database. Pour plus d’informations, voir Mesurer la latence et valider les connexions pour la réplication transactionnelle.For more information, see Measure Latency and Validate Connections for Transactional Replication.

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

SyntaxeSyntax

  
sp_posttracertoken [ @publication = ] 'publication'   
    [ , [ @tracer_token_id = ] tracer_token_id OUTPUT  
    [ , [ @publisher = ] 'publisher'   

ArgumentsArguments

[ @publication = ] 'publication' est le nom de la publication pour laquelle la latence est mesurée.[ @publication = ] 'publication' Is the name of the publication for which latency is being measured. publication est de type sysname, sans valeur par défaut.publication is sysname, with no default.

[ @tracer_token_id = ] _tracer_token_id OUTPUT est l’ID du jeton de suivi inséré.[ @tracer_token_id = ] _tracer_token_id OUTPUT Is the ID of the tracer token inserted. tracer_token_id est de type int avec NULL comme valeur par défaut et il s’agit d’un paramètre OUTPUT.tracer_token_id is int with a default of NULL, and it is an OUTPUT parameter. Cette valeur peut être utilisée pour exécuter sp_helptracertokenhistory (Transact-SQL) ou sp_deletetracertokenhistory (Transact) -SQL sans d’abord exécuter sp_helptracertokens (Transact-SQL ).This value can be used to execute sp_helptracertokenhistory (Transact-SQL) or sp_deletetracertokenhistory (Transact-SQL) without first executing sp_helptracertokens (Transact-SQL).

[ @publisher = ] 'publisher' spécifie un serveur de publication non-MicrosoftMicrosoft SQL ServerSQL Server.[ @publisher = ] 'publisher' Specifies a non- MicrosoftMicrosoft SQL ServerSQL Server Publisher. Publisher est de type sysname, avec NULL comme valeur par défaut et ne doit pas être spécifié pour un serveur de publication SQL ServerSQL Server.publisher is sysname, with a default of NULL and should not be specified for a SQL ServerSQL Server Publisher.

Valeurs des codes de retourReturn Code Values

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

NotesRemarks

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

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 ou du rôle de base de données fixe db_owner peuvent exécuter sp_posttracertoken.Only members of the sysadmin fixed server role or the db_owner fixed database role can execute sp_posttracertoken.

Voir aussiSee Also

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