• Artikel

sp_helptracertokens (Transact-SQL)

Gibt eine Zeile für jedes Überwachungstoken zurück, das in eine Veröffentlichung eingefügt wurde, um Latenzzeiten zu bestimmen. 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_helptracertokens [ @publication = ] 'publication' 
    [ , [ @publisher = ] 'publisher' ] 
    [ , [ @publisher_db = ] 'publisher_db' ]

Argumente

  • [ @publication= ] 'publication'
    Der Name der Veröffentlichung, in die Überwachungstoken eingefügt wurden. publication ist vom Datentyp sysname und hat keinen Standardwert.

  • [ @publisher= ] 'publisher'
    Der Name des Verlegers. publisher ist vom Datentyp sysname und hat den Standardwert NULL.

    HinweisHinweis

    Dieser Parameter sollte nur für Nicht-MicrosoftSQL Server-Verleger 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.

Resultset

Spaltenname

Datentyp

Beschreibung

tracer_id

int

Identifiziert einen Datensatz des Überwachungstokens.

publisher_commit

datetime

Das Datum und die Uhrzeit für den Commit des Tokendatensatzes auf dem Verleger in der Veröffentlichungsdatenbank.

Rückgabecodewerte

0 (Erfolg) oder 1 (Fehler)

Hinweise

sp_helptracertokens wird für die Transaktionsreplikation verwendet.

Mit sp_helptracertokens werden Überwachungstoken-IDs abgerufen, wenn sp_helptracertokenhistory (Transact-SQL) ausgeführt wird.

Beispiel

DECLARE @publication AS sysname;
DECLARE @tokenID AS int;
SET @publication = N'AdvWorksProductTran'; 

USE [AdventureWorks]

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