sp_deletetracertokenhistory (Transact-SQL)

Artikel
2025-01-02

Gilt für: SQL Server Azure SQL Managed Instance

Entfernt Ablaufverfolgungstokeneinträge aus den MStracer_tokens und MStracer_history Systemtabellen. 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_deletetracertokenhistory
    [ @publication = ] N'publication'
    [ , [ @tracer_id = ] tracer_id ]
    [ , [ @cutoff_date = ] cutoff_date ]
    [ , [ @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. Dieser Parameter ist erforderlich.

[ @tracer_id = ] tracer_id

Die ID des zu löschenden Ablaufverfolgungstokens. @tracer_id ist int, mit einem Standardwert von NULL. Wenn NULLalle Ablaufverfolgungstoken, die zur Publikation gehören, gelöscht werden.

[ @cutoff_date = ] cutoff_date

Ablaufverfolgungstoken, die vor diesem Datum in die Publikation eingefügt wurden, werden gelöscht. @cutoff_date ist datetime, mit einem Standardwert von NULL.

[ @publisher = ] N'publisher'

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

Hinweis

Dieser Parameter sollte nur für Nicht-SQL Server-Herausgeber oder beim Ausführen der gespeicherten Prozedur aus dem Verteiler 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.

Hinweis

Dieser Parameter sollte beim Ausführen der gespeicherten Prozedur vom Verteiler angegeben werden.

Rückgabecodewerte

0 (erfolgreich) oder 1 Fehler.

Hinweise

sp_deletetracertokenhistory wird in der Transaktionsreplikation verwendet.

Wenn Sie beide Parameter @tracer_id und @cutoff_date angeben, tritt ein Fehler auf.

Wenn Sie nicht zum Löschen von Ablaufverfolgungstokenmetadaten ausgeführt sp_deletetracertokenhistory werden, werden die Informationen gelöscht, wenn die regelmäßig geplante Verlaufsbereinigung erfolgt.

Ablaufverfolgungstoken-IDs können durch Ausführen sp_helptracertokens oder durch Abfragen der MStracer_tokens Systemtabelle bestimmt werden.

Berechtigungen

Nur das folgende Personal hat die Befugnis, folgendes auszuführen sp_deletetracertokenhistory:

Mitglieder der Replmonitor-Rollen in der Verteilungsdatenbank.
Elemente der festen Serverrolle "sysadmin ".
Elemente der db_owner festen Datenbankrolle in der Publikationsdatenbank.
Die db_owner der festen Datenbank.

Freigeben über