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 publicaciones o en el distribuidor de la base de datos de distribución.

Icono de vínculo a temasConvenciones 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 testigo de seguimiento. publication es de tipo sysname y no tiene valor predeterminado.

  • [ @tracer_id= ] tracer_id
    Es el Id. del testigo 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 testigos 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'
    Es el nombre del publicador. publisher es de tipo sysname y su valor predeterminado es NULL.

    Nota

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

  • [ @publisher_db= ] 'publisher_db'
    Es el nombre de la base de datos de publicaciones. 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, sólo 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 testigo 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

Sólo los miembros de la función fija de servidor sysadmin, la función fija de base de datos db_owner de la base de datos de publicaciones o las funciones fijas de base de datos db_owner o replmonitor de la base de datos de distribución pueden ejecutar sp_deletetracertokenhistory.