Compartir vía

sp_helptracertokenhistory (Transact-SQL)

  • Artículo

Se aplica a:SQL ServerAzure SQL Managed Instance

Devuelve información detallada de latencia acerca de los testigos de seguimiento especificados. Se devuelve una fila por cada suscriptor. Este procedimiento almacenado se ejecuta en el publicador de la base de datos de publicación o en el distribuidor de la base de datos de distribución.

Convenciones de sintaxis de Transact-SQL

Sintaxis

sp_helptracertokenhistory
    [ @publication = ] N'publication'
    , [ @tracer_id = ] tracer_id
    [ , [ @publisher = ] N'publisher' ]
    [ , [ @publisher_db = ] N'publisher_db' ]
[ ; ]

Argumentos

[ @publication = ] N'publication'

Nombre de la publicación en la que se insertó el token del seguimiento. @publication es sysname, sin ningún valor predeterminado.

[ @tracer_id = ] tracer_id

Identificador del token de seguimiento de la tabla MStracer_tokens , para el que se devuelve información del historial. @tracer_id es int, sin ningún valor predeterminado.

[ @publisher = ] N'publisher'

El nombre del publicador. @publisher es sysname, con un valor predeterminado de NULL.

@publisher solo se debe especificar para publicadores que no son de SQL Server.

[ @publisher_db = ] N'publisher_db'

Nombre de la base de datos de publicación. @publisher_db es sysname, con un valor predeterminado de NULL. Si el procedimiento almacenado se ejecuta en el publicador, se omite este parámetro.

Conjunto de resultados

Nombre de la columna Tipo de datos Descripción
distributor_latency bigint Número de segundos entre la confirmación del registro del token de seguimiento en el publicador y la confirmación del registro en el distribuidor.
subscriber sysname Nombre del suscriptor que ha recibido el token de seguimiento.
subscriber_db sysname Nombre de la base de datos de suscripciones en la que se ha insertado el testigo de seguimiento.
subscriber_latency bigint Número de segundos entre la confirmación del registro del token de seguimiento en el distribuidor y la confirmación del registro en el suscriptor.
overall_latency bigint Número de segundos entre la confirmación del registro del token de seguimiento en el publicador y la confirmación del registro del token en el suscriptor.

Valores de código de retorno

0 (correcto) o 1 (erróneo).

Comentarios

sp_helptracertokenhistory se usa en la replicación transaccional.

Ejecute sp_helptracertokens para obtener una lista de tokens de seguimiento para la publicación.

Un valor de en el conjunto de NULL resultados significa que no se pueden calcular las estadísticas de latencia. Esto se debe a que el token de seguimiento no se ha recibido en el distribuidor o en uno de los suscriptores.

Ejemplos

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

USE [AdventureWorks2022]

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

Contenido relacionado