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.

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 Datentyp sysname und hat keinen Standardwert.

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

• [ @cutoff_date= ] cutoff_date
  Gibt das Umstellungsdatum an, sodass alle vor diesem Datum in die Veröffentlichung eingefügten Überwachungstoken entfernt werden. cutoff_date ist vom Datentyp datetime und hat den Standardwert NULL.

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

  Hinweis
  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 Datentyp sysname 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.

Siehe auch

Verweis

sp_helptracertokenhistory (Transact-SQL)

Konzepte

Messen der Latenzzeit und Überprüfen der Verbindungen bei Transaktionsreplikationen