sp_posttracertoken (Transact-SQL)

Este procedimiento envía un testigo de seguimiento al registro de transacciones del publicador y empieza el proceso de seguimiento de las estadísticas de latencia. La información se registra cuando el token de seguimiento se escribe en el registro de transacciones, cuando lo recoge el Agente de registro del LOG y cuando lo aplica el Agente de distribución. Este procedimiento almacenado se ejecuta en el publicador de la base de datos de publicaciones. Para obtener más información, vea Medir la latencia y validar las conexiones de la replicación transaccional.

Convenciones de sintaxis de Transact-SQL

Sintaxis

sp_posttracertoken [ @publication = ] 'publication' 
    [ , [ @tracer_token_id = ] tracer_token_id OUTPUT
    [ , [ @publisher = ] 'publisher'

Argumentos

• [ @publication= ] 'publication'
  Es el nombre de la publicación para la que se va a medir la latencia. publication es de tipo sysname y no tiene ningún valor predeterminado.

• [ @tracer_token_id= ] tracer_token_idOUTPUT
  Es el identificador del token de seguimiento insertado. tracer_token_id es de tipo int, su valor predeterminado es NULL y es un parámetro OUTPUT. Este valor se puede utilizar para ejecutar sp_helptracertokenhistory (Transact-SQL) o sp_deletetracertokenhistory (Transact-SQL) sin ejecutar sp_helptracertokens (Transact-SQL) primero.

• [ @publisher= ] 'publisher'
  Especifica un publicador que no es de Microsoft SQL Server. publisher es de tipo sysname, su valor predeterminado es NULL y no se debe especificar para un publicador de SQL Server.

Valores de código de retorno

0 (correcto) o 1 (error)

Comentarios

sp_posttracertoken se utiliza en la replicación transaccional.

Ejemplo

DECLARE @publication AS sysname;
DECLARE @tokenID AS int;
SET @publication = N'AdvWorksProductTran'; 

USE [AdventureWorks2012]

-- Insert a new tracer token in the publication database.
EXEC sys.sp_posttracertoken 
  @publication = @publication,
  @tracer_token_id = @tokenID OUTPUT;
SELECT 'The ID of the new tracer token is ''' + 
    CONVERT(varchar,@tokenID) + '''.'
GO

-- Wait 10 seconds for the token to make it to the Subscriber.
WAITFOR DELAY '00:00:10';
GO

-- Get latency information for the last inserted token.
DECLARE @publication AS sysname;
DECLARE @tokenID AS int;
SET @publication = N'AdvWorksProductTran'; 

CREATE TABLE #tokens (tracer_id int, publisher_commit datetime)

-- Return tracer token information to a temp table.
INSERT #tokens (tracer_id, publisher_commit)
EXEC sys.sp_helptracertokens @publication = @publication;
SET @tokenID = (SELECT TOP 1 tracer_id FROM #tokens
ORDER BY publisher_commit DESC)
DROP TABLE #tokens

-- Get history for the tracer token.
EXEC sys.sp_helptracertokenhistory 
  @publication = @publication, 
  @tracer_id = @tokenID;
GO

Permisos

Solo los miembros del rol fijo de servidor sysadmin o del rol fijo de base de datos db_owner pueden ejecutar sp_posttracertoken.

Vea también

Conceptos

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