sp_helptracertokens (Transact-SQL)

  • Artikel

Gilt für: SQL Server Azure SQL Managed Instance

Gibt eine Zeile für jedes Ablaufverfolgungstoken zurück, das in eine Publikation eingefügt wurde, um die Latenz zu bestimmen. 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_helptracertokens
    [ @publication = ] N'publication'
    [ , [ @publisher = ] N'publisher' ]
    [ , [ @publisher_db = ] N'publisher_db' ]
[ ; ]

Argumente

[ @publication = ] N'Publikation'

Der Name der Publikation, in der Ablaufverfolgungstoken eingefügt wurden. @publication ist "sysname" 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. @publisher_db wird ignoriert, wenn die gespeicherte Prozedur bei Publisher ausgeführt wird.

Resultset

Spaltenname Datentyp BESCHREIBUNG
tracer_id int Identifiziert einen Überwachungstoken-Datensatz.
publisher_commit datetime Das Datum und die Uhrzeit für den Commit des Tokendatensatzes auf dem Verleger in der Veröffentlichungsdatenbank.

Rückgabecodewerte

0 (erfolgreich) oder 1 Fehler.

Hinweise

sp_helptracertokens wird in der Transaktionsreplikation verwendet.

sp_helptracertokens wird verwendet, um Ablaufverfolgungstoken-IDs beim Ausführen von sp_helptracertokenhistory abzurufen.

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.

Zugehöriger Inhalt