sp_helptracertokens (Transact-SQL)

Devuelve una fila para cada testigo de seguimiento que se ha insertado en una publicación para determinar la latencia. 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_helptracertokens [ @publication = ] 'publication' 
    [ , [ @publisher = ] 'publisher' ] 
    [ , [ @publisher_db = ] 'publisher_db' ]

Argumentos

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

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

  [!NOTA]

  Este parámetro solamente 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.

Conjunto de resultados

Nombre de columna	Tipo de datos	Descripción
tracer_id	int	Identifica un registro de un token de seguimiento.
publisher_commit	datetime	Fecha y hora a la que el registro de token se confirmó en el publicador de la base de datos de publicaciones.

Valores de código de retorno

0 (correcto) o 1 (error)

Comentarios

sp_helptracertokens se utiliza en la replicación transaccional.

sp_helptracertokens se utiliza para obtener los Id. de token de seguimiento cuando se ejecuta sp_helptracertokenhistory (Transact-SQL).

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, del rol fijo de base de datos db_owner de la base de datos de publicaciones o de los roles fijos de base de datos db_owner o replmonitor de la base de datos de distribución pueden ejecutar sp_helptracertokenhistory.

Vea también

Referencia

sp_deletetracertokenhistory (Transact-SQL)

Conceptos

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