sp_deletetracertokenhistory (Transact-SQL)

Quita los registros del testigo de traza 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.

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 testigo de traza. publication es de tipo sysname y no tiene valor predeterminado.

• [ @tracer_id= ] tracer_id
  Es el Id. del testigo de traza 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 traza que pertenecen a la publicación.

• [ @cutoff_date= ] cutoff_date
  Especifica una fecha límite, de modo que se quitan todos los testigos de traza 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.

Notas

sp_deletetracertokenhistory se utiliza en la réplica 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 traza, la información se quitará cuando tenga lugar la limpieza de historial programada regularmente.

Los Id. de los testigos de traza 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.

Valores de código de retorno

0 (correcto) o 1 (error)

Vea también

Referencia

sp_helptracertokenhistory (Transact-SQL)

Otros recursos

How to: Measure Latency and Validate Connections for Transactional Replication (Replication Transact-SQL Programming)
Medir la latencia y validar las conexiones en la réplica transaccional

Ayuda e información

Obtener ayuda sobre SQL Server 2005