sp_helptracertokens (Transact-SQL)

S’applique à :SQL ServerAzure SQL Managed Instance

Retourne une ligne pour chaque jeton de suivi inséré dans une publication pour déterminer la latence. 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_helptracertokens [ @publication = ] 'publication'   
    [ , [ @publisher = ] 'publisher' ]   
    [ , [ @publisher_db = ] 'publisher_db' ]  

Arguments

[ @publication = ] 'publication' Nom de la publication dans laquelle les jetons de suivi ont été insérés. publication est sysname, sans valeur par défaut.

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

[ @publisher_db = ] '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.

Jeu de résultats

Codet de retour

0 (réussite) ou 1 (échec)

Remarques

sp_helptracertokens est utilisé dans la réplication transactionnelle.

sp_helptracertokens est utilisé pour obtenir des ID de jeton de suivi lors de l’exécution de sp_helptracertokenhistory (Transact-SQL).

Exemple

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

USE [AdventureWorks2022]

-- 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

Autorisations

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

Voir aussi

Mesurer la latence et valider les connexions pour la réplication transactionnelle
sp_deletetracertokenhistory (Transact-SQL)