sp_helptracertokenhistory (Transact-SQL)
Gilt für:SQL ServerAzure 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 = ] 'publication'
, [ @tracer_id = ] tracer_id
[ , [ @publisher = ] 'publisher' ]
[ , [ @publisher_db = ] 'publisher_db' ]
Argumente
[ @publication = ] 'publication'
Der Name der Publikation, in der das Ablaufverfolgungstoken eingefügt wurde. die Veröffentlichung ist sysname, ohne Standardwert.
[ @tracer_id = ] tracer_id
Die ID des Ablaufverfolgungstokens in der MStracer_tokens -Tabelle (Transact-SQL), für die Verlaufsinformationen zurückgegeben werden. tracer_id ist int, ohne Standardwert.
[ @publisher = ] 'publisher'
Der Name des Verlegers. publisher ist sysname, wobei der Standardwert NULL ist.
Hinweis
Dieser Parameter sollte nur für Nicht-Microsoft-SQL Server-Herausgeber angegeben werden.
[ @publisher_db = ] 'publisher_db'
Der Name der Veröffentlichungsdatenbank. publisher_db ist sysname mit dem Standardwert 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 (Erfolg) oder 1 (Fehler)
Bemerkungen
sp_helptracertokenhistory wird bei der Transaktionsreplikation verwendet.
Führen Sie sp_helptracertokens (Transact-SQL) aus, um eine Liste der Ablaufverfolgungstoken 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 [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 , der db_owner festen Datenbankrolle in der Veröffentlichungsdatenbank oder db_owner festen Datenbank- oder replmonitor-Rollen in der Verteilungsdatenbank können sp_helptracertokenhistory ausführen.
Weitere Informationen
Messen der Latenzzeit und Überprüfen der Verbindungen bei Transaktionsreplikationen
sp_deletetracertokenhistory (Transact-SQL)
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für