sp_helptracertokenhistory(Transact-SQL)
적용 대상:SQL ServerAzure SQL Managed Instance
각 구독자에 대해 하나의 행이 반환되는 지정된 추적 프로그램 토큰에 대한 자세한 대기 시간 정보를 반환합니다. 이 저장 프로시저는 게시 데이터베이스의 게시자 또는 배포 데이터베이스의 배포자에서 실행됩니다.
구문
sp_helptracertokenhistory [ @publication = ] 'publication'
, [ @tracer_id = ] tracer_id
[ , [ @publisher = ] 'publisher' ]
[ , [ @publisher_db = ] 'publisher_db' ]
인수
[ @publication = ] 'publication'
추적 프로그램 토큰이 삽입된 게시의 이름입니다. 게시는 sysname이며 기본값은 없습니다.
[ @tracer_id = ] tracer_id
기록 정보가 반환되는 MStracer_tokens(Transact-SQL) 테이블의 추적 프로그램 토큰 ID입니다. tracer_id 기본값이 없는 int입니다.
[ @publisher = ] 'publisher'
게시자의 이름입니다. 게시자는 sysname이며 기본값은 NULL입니다.
참고 항목
이 매개 변수는 Microsoft SQL Server 이외 게시자에 대해서만 지정해야 합니다.
[ @publisher_db = ] 'publisher_db'
게시 데이터베이스의 이름입니다. publisher_db sysname이며 기본값은 NULL입니다. 이 매개 변수는 저장 프로시저가 게시자에서 실행되는 경우 무시됩니다.
결과 집합
열 이름 | 데이터 형식 | 설명 |
---|---|---|
distributor_latency | bigint | 게시자에서 커밋되는 추적 프로그램 토큰 레코드와 배포자에서 커밋되는 레코드 사이의 시간(초)입니다. |
subscriber | sysname | 추적 프로그램 토큰을 받은 구독자의 이름입니다. |
subscriber_db | sysname | 추적 프로그램 토큰 레코드가 삽입된 구독 데이터베이스의 이름입니다. |
subscriber_latency | bigint | 배포자에서 커밋되는 추적 프로그램 토큰 레코드와 구독자에서 커밋되는 레코드 사이의 시간(초)입니다. |
overall_latency | bigint | 게시자에서 커밋되는 추적 프로그램 토큰 레코드와 구독자에서 커밋되는 토큰 레코드 사이의 시간(초)입니다. |
반환 코드 값
0 (성공) 또는 1 (실패)
설명
sp_helptracertokenhistory 트랜잭션 복제에 사용됩니다.
sp_helptracertokens(Transact-SQL)를 실행하여 게시에 대한 추적 프로그램 토큰 목록을 가져옵니다.
결과 집합의 NULL 값은 대기 시간 통계를 계산할 수 없음을 의미합니다. 이는 배포자 또는 구독자 중 하나에서 추적 프로그램 토큰이 수신되지 않았기 때문입니다.
예
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
사용 권한
sysadmin 고정 서버 역할의 멤버, 게시 데이터베이스의 db_owner 고정 데이터베이스 역할 또는 배포 데이터베이스의 db_owner 고정 데이터베이스 또는 replmonitor 역할만 sp_helptracertokenhistory 실행할 수 있습니다.
참고 항목
트랜잭션 복제에 대한 대기 시간 측정 및 연결 유효성 검사
sp_deletetracertokenhistory(Transact-SQL)
피드백
https://aka.ms/ContentUserFeedback
출시 예정: 2024년 내내 콘텐츠에 대한 피드백 메커니즘으로 GitHub 문제를 단계적으로 폐지하고 이를 새로운 피드백 시스템으로 바꿀 예정입니다. 자세한 내용은 다음을 참조하세요.다음에 대한 사용자 의견 제출 및 보기