sp_helptracertokenhistory (Transact-SQL)

Gilt für: SQL Server Azure SQL Managed Instance

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.

Transact-SQL-Syntaxkonventionen

Syntax

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

Argumente

[ @publication = ] N'Publikation'

Der Name der Publikation, in die das Ablaufverfolgungstoken eingefügt wurde. @publication ist "sysname" ohne Standard.

[ @tracer_id = ] tracer_id

Die ID des Ablaufverfolgungstokens in der MStracer_tokens Tabelle, für die Verlaufsinformationen zurückgegeben werden. @tracer_id ist int, ohne Standard.

[ @publisher = ] N'publisher'

Der Name des Herausgebers. @publisher ist "sysname" mit der Standardeinstellung "NULL.

@publisher sollte nur für Nicht-SQL Server-Herausgeber angegeben werden.

[ @publisher_db = ] N'publisher_db'

Der Name der Publikationsdatenbank. @publisher_db ist "sysname" mit der Standardeinstellung "NULL. Dieser Parameter wird ignoriert, wenn die gespeicherte Prozedur auf dem Verleger ausgeführt wird.

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 (erfolgreich) oder 1 Fehler.

Hinweise

sp_helptracertokenhistory wird in der Transaktionsreplikation verwendet.

Führen Sie sp_helptracertokens aus, um eine Liste von Ablaufverfolgungstoken für die Publikation abzurufen.

Ein Wert im NULL Resultset bedeutet, dass Latenzstatistiken nicht berechnet werden können. Dies liegt daran, dass das Ablaufverfolgungstoken beim Distributor oder einem der Abonnenten nicht empfangen wurde.

Beispiele

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 , die db_owner feste Datenbankrolle in der Publikationsdatenbank oder db_owner festen Datenbank- oder Neuplmonitorrollen in der Verteilungsdatenbank können ausgeführt werden sp_helptracertokenhistory.