sp_helptracertokens (Transact-SQL)

Devuelve una fila para cada testigo de traza 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.

Icono de vínculo a temasConvenciones 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 insertaron testigos de traza. publication es de tipo sysname y no tiene ningún valor predeterminado.

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

    [!NOTA]

    Este parámetro sólo se puede especificar para publicadores que no sean de MicrosoftSQL Server.

  • [ @publisher_db= ] 'publisher_db'
    El nombre de la base de datos de publicaciones. publisher_db es de tipo sysname y su valor predeterminado es NULL. Este procedimiento se omite si el procedimiento almacenado se ejecuta en el publicador.

Conjunto de resultados

Nombre de columna

Tipo de datos

Descripción

tracer_id

int

Identifica un registro de testigo de traza.

publisher_commit

datetime

Fecha y hora a la que el registro de testigo se confirmó en el publicador de la base de datos de publicaciones.

Valores de código de retorno

0 (correcto) o 1 (error)

Notas

sp_helptracertokens se utiliza en la réplica transaccional.

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

Ejemplo

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

USE [AdventureWorks]

-- 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

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