Compartir a través de


sp_deletetracertokenhistory (Transact-SQL)

Se aplica a: SQL Server Azure SQL Managed Instance

Quita los registros de token del seguimiento de las tablas del sistema de MStracer_tokens y MStracer_history . Este procedimiento almacenado se ejecuta en el publicador de la base de datos de publicación o en el distribuidor de la base de datos de distribución.

Convenciones de sintaxis de Transact-SQL

Sintaxis

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

Argumentos

[ @publication = ] N'publication'

Nombre de la publicación en la que se insertó el token del seguimiento. @publication es sysname, sin ningún valor predeterminado. Este parámetro es obligatorio.

[ @tracer_id = ] tracer_id

Identificador del token de seguimiento que se va a eliminar. @tracer_id es int, con un valor predeterminado de NULL. Si NULLes , se eliminan todos los tokens de seguimiento que pertenecen a la publicación.

[ @cutoff_date = ] cutoff_date

Los tokens de seguimiento insertados en la publicación antes de esta fecha se eliminan. @cutoff_date es datetime, con un valor predeterminado de NULL.

[ @publisher = ] N'publisher'

El nombre del publicador. @publisher es sysname, con un valor predeterminado de NULL.

Nota:

Este parámetro solo debe especificarse para publicadores que no son de SQL Server o al ejecutar el procedimiento almacenado desde el distribuidor.

[ @publisher_db = ] N'publisher_db'

Nombre de la base de datos de publicación. @publisher_db es sysname, con un valor predeterminado de NULL. Si el procedimiento almacenado se ejecuta en el publicador, se omite este parámetro.

Nota:

Este parámetro debe especificarse al ejecutar el procedimiento almacenado desde el distribuidor.

Valores de código de retorno

0 (correcto) o 1 (erróneo).

Comentarios

sp_deletetracertokenhistory se usa en la replicación transaccional.

Se produce un error si especifica los parámetros @tracer_id y @cutoff_date.

Si no se ejecuta sp_deletetracertokenhistory para eliminar los metadatos del token de seguimiento, la información se elimina cuando se produce la limpieza del historial programada periódicamente.

Los identificadores de token de seguimiento se pueden determinar ejecutando sp_helptracertokens o consultando la tabla del sistema de MStracer_tokens .

Permisos

Solo el personal siguiente tiene la autoridad para ejecutar sp_deletetracertokenhistory:

  • Miembros de los roles replmonitor , en la base de datos de distribución.
  • Miembros del rol fijo de servidor sysadmin .
  • Miembros del rol fijo de base de datos db_owner en la base de datos de publicación.
  • El db_owner de la base de datos fija.