sp_posttracertoken (Transact-SQL)

  • Artikel

Gilt für:SQL Server

Mit dieser Prozedur wird ein Überwachungstoken in das Transaktionsprotokoll am Verleger platziert, und der Prozess der Nachverfolgung von Statistiken über Latenzzeiten wird gestartet. Informationen werden erfasst, wenn das Überwachungstoken in das Transaktionsprotokoll geschrieben wird, wenn es vom Protokolllese-Agent aufgenommen wird und vom Verteilungs-Agent angewendet wird. Diese gespeicherte Prozedur wird im Publisher in der Publikationsdatenbank ausgeführt. Weitere Informationen finden Sie unter Messen der Wartezeit und Überprüfen der Verbindungen bei Transaktionsreplikationen

Transact-SQL-Syntaxkonventionen

Syntax

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

Argumente

[ @publication = ] 'publication' Ist der Name der Publikation, für die die Latenz gemessen wird. Publikation ist sysname, ohne Standard.

[ @tracer_token_id = ] _tracer_token_id OUTPUT Ist die ID des eingefügten Ablaufverfolgungstokens. tracer_token_id ist int mit einem Standardwert von NULL, und es handelt sich um einen OUTPUT-Parameter. Dieser Wert kann verwendet werden, um sp_helptracertokenhistory (Transact-SQL) oder sp_deletetracertokenhistory (Transact-SQL) auszuführen, ohne zuerst sp_helptracertokens (Transact-SQL) auszuführen.

[ @publisher = ] 'publisher' Gibt einen Nicht-Microsoft SQL Server Publisher an. Publisher ist sysname, mit einem Standardwert von NULL und sollte für einen SQL Server-Herausgeber nicht angegeben werden.

Rückgabecodewerte

0 (Erfolg) oder 1 (Fehler)

Hinweise

sp_posttracertoken wird in der Transaktionsreplikation verwendet.

Beispiel

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

Berechtigungen

Nur Mitglieder der festen Serverrolle sysadmin oder die db_owner feste Datenbankrolle können sp_posttracertoken ausführen.

Weitere Informationen

Messen der Latenzzeit und Überprüfen der Verbindungen bei Transaktionsreplikationen