sp_helptracertokenhistory (Transact-SQL)

Artikel
05/07/2013

Gibt detaillierte Latenzzeitinformationen für die angegebenen Überwachungstoken zurück, wobei für jeden Abonnenten eine Zeile zurückgegeben wird. Diese gespeicherte Prozedur wird auf dem Verleger für die Veröffentlichungsdatenbank oder auf dem Verteiler für die Verteilungsdatenbank ausgeführt.

Themenlink (Symbol) Transact-SQL-Syntaxkonventionen

Syntax

sp_helptracertokenhistory [ @publication = ] 'publication'  
        , [ @tracer_id = ] tracer_id
    [ , [ @publisher = ] 'publisher' ]
    [ , [ @publisher_db = ] 'publisher_db' ]

Argumente

[ @publication= ] 'publication'
Der Name der Veröffentlichung, in die das Überwachungstoken eingefügt wurde. publication ist vom Datentyp sysname und hat keinen Standardwert.
[ @tracer_id= ] tracer_id
Die ID des Überwachungstokens in der Tabelle MStracer_tokens (Transact-SQL), für die Verlaufsinformationen zurückgegeben werden. tracer_id ist vom Datentyp int und hat keinen Standardwert.
[ @publisher= ] 'publisher'
Der Name des Verlegers. publisher ist vom Datentyp sysname und hat den Standardwert NULL.

Hinweis

Dieser Parameter sollte nur für Nicht-Microsoft SQL Server-Anbieter angegeben werden.
[ @publisher_db= ] 'publisher_db'
Der Name der Veröffentlichungsdatenbank. publisher_db ist vom Datentyp sysname und hat den Standardwert NULL. Dieser Parameter wird ignoriert, wenn die gespeicherte Prozedur auf dem Verleger ausgeführt wird.

Hinweis
Dieser Parameter sollte nur für Nicht-Microsoft SQL Server-Anbieter angegeben werden.

Resultset

Spaltenname	Datentyp	Beschreibung
distributor_latency	bigint	Anzahl der Sekunden zwischen dem Commit des Überwachungstokendatensatzes auf dem Verleger und dem Commit des Datensatzes auf dem Verteiler
subscriber	sysname	Name des Abonnenten, der das Überwachungstoken empfing
subscriber_db	sysname	Name der Abonnementdatenbank, in die der Überwachungstokendatensatz eingefügt wurde
subscriber_latency	bigint	Anzahl der Sekunden zwischen dem Commit des Überwachungstokendatensatzes auf dem Verteiler und dem Commit des Datensatzes auf dem Abonnenten
overall_latency	bigint	Anzahl der Sekunden zwischen dem Commit des Überwachungstokendatensatzes auf dem Verleger und dem Commit des Datensatzes auf dem Abonnenten

Rückgabecodewerte

0 (Erfolg) oder 1 (Fehler)

Hinweise

sp_helptracertokenhistory wird in Transaktionsreplikationen verwendet.

Führen Sie sp_helptracertokens (Transact-SQL) aus, um eine Liste von Überwachungstoken für die Veröffentlichung abzurufen.

Der Wert NULL im Resultset bedeutet, dass keine Latenzzeitstatistik berechnet werden kann. Dies liegt daran, dass das Überwachungstoken nicht auf dem Verteiler oder einem der Abonnenten empfangen wurde.

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 und der festen Datenbankrolle db_owner auf der Veröffentlichungsdatenbank oder der festen Datenbankrolle db_owner und der replmonitor-Rolle auf der Verteilungsdatenbank können sp_helptracertokenhistory ausführen.

Siehe auch

Verweis

sp_deletetracertokenhistory (Transact-SQL)

Konzepte

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

Freigeben über