sp_deletetracertokenhistory (Transact-SQL)

Si applica a:SQL Server Istanza gestita di SQL di Azure

Rimuove i record del 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.

Convenzioni di sintassi Transact-SQL

Sintassi

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

Argomenti

[ @publication = ] N'publication'

Nome della pubblicazione in cui è stato inserito il token di traccia. @publication è sysname, senza impostazione predefinita. Questo parametro è obbligatorio.

[ @tracer_id = ] tracer_id

ID del token di traccia da eliminare. @tracer_id è int, con il valore predefinito NULL. Se NULL, tutti i token di traccia appartenenti alla pubblicazione vengono eliminati.

[ @cutoff_date = ] cutoff_date

Token di traccia inseriti nella pubblicazione prima dell'eliminazione di questa data. @cutoff_date è datetime, con il valore predefinito NULL.

[ @publisher = ] N'publisher'

Nome del server di pubblicazione. @publisher è sysname, con un valore predefinito .NULL

Nota

Questo parametro deve essere specificato solo per server di pubblicazione non SQL Server o quando si esegue la stored procedure dal server di distribuzione.

[ @publisher_db = ] N'publisher_db'

Nome del database di pubblicazione. @publisher_db è sysname, con il valore predefinito NULL. Questo parametro viene ignorato se la stored procedure viene eseguita nel server di pubblicazione.

Nota

Questo parametro deve essere specificato durante l'esecuzione della stored procedure dal server di distribuzione.

Valori del codice restituito

0 (esito positivo) o 1 (errore).

Osservazioni:

sp_deletetracertokenhistory viene usato nella replica transazionale.

Se si specificano entrambi i parametri @tracer_id e @cutoff_date, si verifica un errore.

Se non si esegue sp_deletetracertokenhistory per eliminare i metadati del token di traccia, le informazioni vengono eliminate quando viene eseguita regolarmente la pulizia della cronologia pianificata.

Gli ID dei token di traccia possono essere determinati eseguendo sp_helptracertokens (Transact-SQL) o eseguendo query sulla tabella di sistema MStracer_tokens (Transact-SQL).

Autorizzazioni

Solo il personale seguente ha l'autorità di eseguire sp_deletetracertokenhistory:

  • Membri dei ruoli replmonitor nel database di distribuzione.
  • Membri del ruolo predefinito del server sysadmin .
  • Membri del ruolo predefinito del database db_owner nel database di pubblicazione.
  • Db_owner del database fisso.