sys.sp_helptracertokens (Transact-SQL)

Van toepassing op:SQL ServerAzure SQL Managed Instance

Geeft één rij terug voor elke tracertoken die in een publicatie is ingevoegd om de latentie te bepalen. Deze opgeslagen procedure wordt uitgevoerd bij de Publisher in de publicatiedatabase of bij de Distributor in de distributiedatabase.

Transact-SQL syntaxis-conventies

Syntax

sys.sp_helptracertokens
    [ @publication = ] N'publication'
    [ , [ @publisher = ] N'publisher' ]
    [ , [ @publisher_db = ] N'publisher_db' ]
[ ; ]

Arguments

[ @publication = ] N'publicatie'

De naam van de publicatie waarin tracer-tokens werden ingevoegd. @publication is sysname, zonder standaard.

[ @publisher = ] N'uitgever'

De naam van de uitgever. @publisher is sysname, met als standaard NULL.

@publisher moet alleen worden gespecificeerd voor niet-SQL Server uitgevers.

[ @publisher_db = ] N'publisher_db'

De naam van de publicatiedatabase. @publisher_db is een systeemnaam, met als standaard NULL. @publisher_db wordt genegeerd als de opgeslagen procedure wordt uitgevoerd op de Publisher.

Resultaatset

Kolomnaam Gegevenstype Description
tracer_id int Identificeert een tracer-tokenrecord.
publisher_commit datetime De datum en tijd waarop het tokenrecord werd vastgelegd bij de Publisher in de publicatiedatabase.

Codewaarden retourneren

0 (geslaagd) of 1 (mislukt).

Remarks

sp_helptracertokens wordt gebruikt bij transactionele replicatie.

sp_helptracertokens wordt gebruikt om tracer-token-ID's te verkrijgen bij het uitvoeren van sp_helptracertokenhistory.

Examples

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

Permissions

Alleen leden van de sysadmin-vaste serverrol, de db_owner vaste databaserol in de publicatiedatabase, of db_owner vaste database- of replmonitor-rollen in de distributiedatabase kunnen uitvoeren sp_helptracertokenhistory.