sp_helptracertokenhistory (Transact-SQL)
Devuelve información detallada de latencia acerca de los testigos de traza especificados. Se devuelve una fila por cada suscriptor. 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.
.gif "Icono de vínculo a temas")
Convenciones de sintaxis de Transact-SQL
Sintaxis
sp_helptracertokenhistory [ @publication = ] 'publication'
, [ @tracer_id = ] tracer_id
[ , [ @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 ningún valor predeterminado.
- [ @tracer_id= ] tracer_id
Es el Id. del testigo de traza de la tabla MStracer_tokens (Transact-SQL) cuya información de historial se devuelve. tracer_id es de tipo int 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 debe especificarse para aquellos publicadores que no son de Microsoft SQL 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. Si el procedimiento almacenado se ejecuta en el publicador, se omite este parámetro.
Notas
sp_helptracertokenhistory se utiliza en la réplica transaccional.
Ejecute sp_helptracertokens (Transact-SQL) para obtener una lista de los testigos de traza de la publicación.
Un valor NULL en el conjunto de resultados significa que no es posible calcular las estadísticas de latencia. Esto es debido a que no se ha recibido el testigo de traza en el distribuidor o en uno de los suscriptores.
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_helptracertokenhistory.
Conjunto de resultados
| Nombre de columna | Tipo de datos | Descripción |
|---|---|---|
distributor_latency |
bigint |
Número de segundos entre la confirmación del registro del testigo de traza en el publicador y la confirmación del registro en el distribuidor. |
subscriber |
sysname |
Nombre del suscriptor que ha recibido el testigo de traza. |
subscriber_db |
sysname |
Nombre de la base de datos de suscripciones en la que se ha insertado el testigo de traza. |
subscriber_latency |
bigint |
Número de segundos entre la confirmación del registro del testigo de traza 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 testigo de traza en el publicador y la confirmación del registro del testigo en el suscriptor. |
Valores de código de retorno
0 (correcto) o 1 (error)
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
Vea también
Referencia
sp_deletetracertokenhistory (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