sp_posttracertoken (Transact-SQL)

  • Статья

Область применения: SQL Server

Эта процедура записывает трассировочный токен в журнал транзакций на издателе и начинает процесс трассировки статистики задержек.

Сведения записываются:

  • при записи маркера трассировки в журнал транзакций;
  • когда агент чтения журналов выбирает его; и
  • при применении агент распространения.

Эта хранимая процедура выполняется на издателе в базе данных публикации. Дополнительные сведения см. в статье Измерение задержки и проверка правильности соединений для репликации транзакций.

Соглашения о синтаксисе Transact-SQL

Синтаксис

sp_posttracertoken
    [ @publication = ] N'publication'
    [ , [ @tracer_token_id = ] tracer_token_id OUTPUT ]
    [ , [ @publisher = ] N'publisher' ]
[ ; ]

Аргументы

[ @publication = ] N'publication'

Имя публикации, для которой измеряется задержка. @publication — sysname без значения по умолчанию.

[ @tracer_token_id = ] tracer_token_id OUTPUT

Идентификатор вставленного маркера трассировки. @tracer_token_id — это параметр OUTPUT типа int. Это значение можно использовать для выполнения sp_helptracertokenhistory или sp_deletetracertokenhistory без первого выполнения sp_helptracertokens.

[ @publisher = ] N'publisher'

Указывает издатель, отличный от SQL Server. @publisher — sysname с значением по умолчаниюNULL. Этот параметр не должен быть указан для издателя SQL Server.

Значения кода возврата

0 (успешно) или 1 (сбой).

Замечания

sp_posttracertoken используется в репликации транзакций.

Примеры

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

Разрешения

Могут выполняться sp_posttracertokenтолько члены предопределенных ролей сервера sysadmin или db_owner предопределенных ролей базы данных.

Связанный контент