• Artikel

sp_deletetracertokenhistory (Transact-SQL)

Entfernt Überwachungstoken-Datensätze aus den MStracer_tokens (Transact-SQL)- und MStracer_history (Transact-SQL)-Systemtabellen.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_deletetracertokenhistory [ @publication = ] 'publication' 
    [ , [ @tracer_id = ] tracer_id ]
    [ , [ @cutoff_date = ] cutoff_date ]
    [ , [ @publisher = ] 'publisher' ] 
    [ , [ @publisher_db = ] 'publisher_db' ]

Argumente

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

  • [ @tracer_id= ] tracer_id
    Die ID des zu löschenden Überwachungstokens. tracer_id ist vom int-Datentyp und hat den Standardwert NULL. Bei null werden alle Überwachungstoken gelöscht, die zur Veröffentlichung gehören.

  • [ @cutoff_date= ] cutoff_date
    Gibt den Stichtag für das Löschen von Überwachungstoken an. Alle Überwachungstoken, die vor dem angegebenen Datum in die Veröffentlichung eingefügt wurden, werden gelöscht. cutoff_date ist vom datetime-Datentyp und hat den Standardwert NULL.

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

    HinweisHinweis

    Dieser Parameter sollte nur für Nicht-Microsoft SQL Server-Anbieter angegeben werden.

  • [ @publisher_db= ] 'publisher_db'
    Der Name der Veröffentlichungsdatenbank. publisher_db ist vom sysname-Datentyp und hat den Standardwert NULL. Dieser Parameter wird ignoriert, wenn die gespeicherte Prozedur auf dem Verleger ausgeführt wird.

Rückgabecodewerte

0 (Erfolg) oder 1 (Fehler)

Hinweise

sp_deletetracertokenhistory wird in Transaktionsreplikationen verwendet.

Beim Ausführen von sp_deletetracertokenhistory können Sie nur tracer_id oder cutoff_date angeben. Wenn Sie beide Parameter angeben, wird eine Fehlermeldung angezeigt.

Wenn Sie sp_deletetracertokenhistory nicht ausführen, um Überwachungstoken-Metadaten zu entfernen, werden die Informationen während des regulär ausgeführten Verlaufscleanups entfernt.

Überwachungstoken-IDs können durch Ausführen von sp_helptracertokens (Transact-SQL) oder mit einer Abfrage an die MStracer_tokens (Transact-SQL)-Systemtabelle ermittelt werden.

Berechtigungen

Nur Mitglieder der festen Serverrolle sysadmin und der festen Datenbankrolle db_owner auf der Veröffentlichungsdatenbank oder der festen Datenbankrolle db_owner und der replmonitor-Rolle auf der Verteilungsdatenbank können sp_deletetracertokenhistory ausführen.