sp_helptracertokens (Transact-SQL)
Se aplica a:SQL ServerAzure SQL Managed Instance
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 publicación 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 insertaron los tokens de seguimiento. publication es sysname, sin ningún valor predeterminado.
[ @publisher = ] 'publisher'
Nombre del publicador. publisher es sysname, con un valor predeterminado de NULL.
Nota
Este parámetro solo se debe especificar para publicadores que no son de Microsoft SQL Server.
[ @publisher_db = ] '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.
Tipo de cursor
Nombre de la 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 usa en la replicación transaccional.
sp_helptracertokens se usa para obtener identificadores de token de seguimiento al ejecutar sp_helptracertokenhistory (Transact-SQL).
Ejemplo
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.
Consulte también
Medir la latencia y validar las conexiones de la replicación transaccional
sp_deletetracertokenhistory (Transact-SQL)
Comentarios
https://aka.ms/ContentUserFeedback.
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea:Enviar y ver comentarios de