sp_posttracertoken (Transact-SQL)

Artikel
05/07/2013

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 auf dem Verleger für die Veröffentlichungsdatenbank ausgeführt. Weitere Informationen finden Sie unter Messen der Latenzzeit und Überprüfen der Verbindungen bei Transaktionsreplikationen.

Themenlink (Symbol) Transact-SQL-Syntaxkonventionen

Syntax

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

Argumente

[ @publication= ] 'publication'
Der Name der Veröffentlichung, für die die Latenzzeit ermittelt wird. publication ist vom Datentyp sysname und hat keinen Standardwert.
[ @tracer_token_id= ] tracer_token_idOUTPUT
Die ID des eingefügten Überwachungstokens. tracer_token_id ist vom Datentyp int, der Standardwert ist NULL, und es handelt sich um einen OUTPUT-Parameter. Dieser Wert kann für die Ausführung von sp_helptracertokenhistory (Transact-SQL) oder sp_deletetracertokenhistory (Transact-SQL) verwendet werden, ohne dass zuerst sp_helptracertokens (Transact-SQL) ausgeführt werden muss.
[ @publisher= ] 'publisher'
Gibt einen Nicht-Microsoft SQL Server-Verleger an. publisher ist vom Datentyp sysname. Der Standardwert ist NULL, und der Parameter sollte nicht für einen SQL Server-Verleger angegeben werden.

Rückgabecodewerte

0 (Erfolg) oder 1 (Fehler)

Hinweise

sp_posttracertoken wird für die Transaktionsreplikation verwendet.

Beispiel

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

Berechtigungen

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

Siehe auch

Konzepte

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

Freigeben über