sp_deletetracertokenhistory (Transact-SQL)

Quita los registros del testigo de seguimiento de las tablas del sistema MStracer_tokens (Transact-SQL) y MStracer_history (Transact-SQL). 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 = ] 'publication' 
    [ , [ @tracer_id = ] tracer_id ]
    [ , [ @cutoff_date = ] cutoff_date ]
    [ , [ @publisher = ] 'publisher' ] 
    [ , [ @publisher_db = ] 'publisher_db' ]

Argumentos

• [ @publication= ] 'publication'
  Es el nombre de la publicación en la que se ha insertado el token de seguimiento. publication es de tipo sysname y no tiene ningún valor predeterminado.

• [ @tracer_id= ] tracer_id
  Es el identificador del token de seguimiento que se va a eliminar. tracer_id es de tipo int y su valor predeterminado es NULL. Si es null, se eliminan todos los testigos de seguimiento que pertenecen a la publicación.

• [ @cutoff_date= ] cutoff_date
  Especifica una fecha límite, de modo que se quitan todos los tokens de seguimiento insertados en la publicación antes de esa fecha. cutoff_date es de tipo datetime y su valor predeterminado es NULL.

• [ @publisher= ] 'publisher'
  El nombre del publicador. publisher es de tipo sysname y su valor predeterminado es NULL.

  Nota

  Este parámetro solo debe especificarse para aquellos publicadores que no son de Microsoft SQL Server.

• [ @publisher_db= ] 'publisher_db'
  Nombre de la base de datos de publicación. publisher_db es de tipo sysname y su valor predeterminado es NULL. Si el procedimiento almacenado se ejecuta en el publicador, se omite este parámetro.

Valores de código de retorno

0 (correcto) o 1 (error)

Comentarios

sp_deletetracertokenhistory se utiliza en la replicación transaccional.

Al ejecutar sp_deletetracertokenhistory, solo se puede especificar tracer_id o cutoff_date. Si se especifican ambos parámetros, se produce un error.

Si no se ejecuta sp_deletetracertokenhistory para quitar los metadatos del token de seguimiento, la información se quitará cuando tenga lugar la limpieza de historial programada regularmente.

Los Id. de los testigos de seguimiento se pueden determinar mediante la ejecución de sp_helptracertokens (Transact-SQL) o la consulta a la tabla del sistema MStracer_tokens (Transact-SQL).

Permisos

Solo los miembros del rol fijo de servidor sysadmin, el rol fijo de base de datos db_owner de la base de datos de publicaciones o los roles fijos de base de datos db_owner o replmonitor de la base de datos de distribución pueden ejecutar sp_deletetracertokenhistory.

Vea también

Referencia

sp_helptracertokenhistory (Transact-SQL)

Conceptos

Medir la latencia y validar las conexiones de la replicación transaccional