Condividi tramite


sp_deletetracertokenhistory (Transact-SQL)

Rimuove i record dei token di traccia dalle tabelle di sistema MStracer_tokens (Transact-SQL) e MStracer_history (Transact-SQL). Questa stored procedure viene eseguita nel database di pubblicazione del server di pubblicazione o nel database di distribuzione del server di distribuzione.

Icona di collegamento a un argomentoConvenzioni della sintassi Transact-SQL

Sintassi

sp_deletetracertokenhistory [ @publication = ] 'publication' 
    [ , [ @tracer_id = ] tracer_id ]
    [ , [ @cutoff_date = ] cutoff_date ]
    [ , [ @publisher = ] 'publisher' ] 
    [ , [ @publisher_db = ] 'publisher_db' ]

Argomenti

  • [ @publication= ] 'publication'
    Nome della pubblicazione in cui è stato inserito il token di traccia. publication è di tipo sysname e non prevede alcun valore predefinito.

  • [ @tracer_id= ] tracer_id
    ID del token di traccia da eliminare. tracer_id è di tipo int e il valore predefinito è NULL. Se null, verranno eliminati tutti i token di traccia appartenenti alla pubblicazione.

  • [ @cutoff_date= ] cutoff_date
    Specifica un valore di cambio data in modo che tutti i token di traccia inseriti nella pubblicazione prima di tale data vengano rimossi. cutoff_date è di tipo datetime e il valore predefinito è NULL.

  • [ @publisher= ] 'publisher'
    Nome del server di pubblicazione. publisher è di tipo sysname e il valore predefinito è NULL.

    Nota

    Questo parametro deve essere specificato solo per i server di pubblicazione non Microsoft SQL Server.

  • [ @publisher_db= ] 'publisher_db'
    Nome del database di pubblicazione. publisher_db è di tipo sysname e il valore predefinito è NULL. Questo parametro viene ignorato se la stored procedure viene eseguita nel server di pubblicazione.

Valori restituiti

0 (esito positivo) o 1 (esito negativo)

Osservazioni

La stored procedure sp_deletetracertokenhistory viene utilizzata nella replica transazionale.

Quando si esegue sp_deletetracertokenhistory, è possibile specificare il parametro tracer_id o il parametro cutoff_date, ma non entrambi. Se si specificano entrambi i parametri, viene generato un errore.

Se non si esegue sp_deletetracertokenhistory per rimuovere i metadati dei token di traccia, le informazioni verranno rimosse in occasione delle operazioni di eliminazione del contenuto della cronologia regolarmente pianificate.

Per determinare gli ID dei token di traccia è possibile eseguire la stored procedure sp_helptracertokens (Transact-SQL) o eseguire query nella tabella di sistema MStracer_tokens (Transact-SQL).

Autorizzazioni

Solo i membri del ruolo predefinito del server sysadmin, del ruolo predefinito del database db_owner nel database di pubblicazione o dei ruoli predefiniti del database db_owner o replmonitor nel database di distribuzione possono eseguire la stored procedure sp_deletetracertokenhistory.