sp_helptracertokenhistory (Transact-SQL)

發行項
12/15/2008

傳回指定追蹤 Token 的詳細延遲資訊，每個訂閱者會傳回一個資料列。這個預存程序執行於發行集資料庫的發行者端，或散發資料庫的散發者端。

語法

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

引數

[ @publication= ] 'publication'
這是追蹤 Token 插入其中之發行集的名稱。publication 是 sysname，沒有預設值。

[ @tracer_id= ] tracer_id
這是傳回的歷程記錄資訊所屬的 MStracer_tokens (Transact-SQL) 資料表中之追蹤 Token 的識別碼。tracer_id 是 int，沒有預設值。

[ @publisher= ] 'publisher'
發行者的名稱。publisher 是 sysname，預設值是 NULL。

附註：

這個參數只應指定給非 Microsoft SQL Server 發行者。

附註：
這個參數只應指定給非 Microsoft SQL Server 發行者。

[ @publisher_db= ] 'publisher_db'
發行集資料庫的名稱。publisher_db 是 sysname，預設值是 NULL。如果預存程序執行於發行者端，則會忽略這個參數。

傳回碼值

0 (成功) 或 1 (失敗)

結果集

資料行名稱	資料類型	描述
distributor_latency	bigint	在發行者端認可的追蹤 Token 記錄和在散發者端認可的記錄之間的秒數。
subscriber	sysname	接收追蹤 Token 的訂閱者名稱。
subscriber_db	sysname	追蹤 Token 記錄插入其中的訂閱資料庫名稱。
subscriber_latency	bigint	在散發者端認可的追蹤 Token 記錄和在訂閱者端認可的記錄之間的秒數。
overall_latency	bigint	在發行者端認可的追蹤 Token 記錄和在訂閱者端認可的 Token 記錄之間的秒數。

備註

sp_helptracertokenhistory 用於交易式複寫中。

請執行 sp_helptracertokens (Transact-SQL) 來取得發行集的追蹤 Token 清單。

結果集中的 NULL 值表示無法計算延遲統計資料。這是因為散發者端或某個訂閱者端尚未收到追蹤 Token。

權限

只有系統管理員 (sysadmin) 固定伺服器角色、發行集資料庫中的 db_owner 固定資料庫角色，或者散發資料庫中的 db_owner 固定資料庫或 replmonitor 角色的成員，才能夠執行 sp_helptracertokenhistory。

範例

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

請參閱

sp_helptracertokenhistory (Transact-SQL)

語法

引數

傳回碼值

結果集

備註

權限

範例

請參閱

參考

其他資源

說明及資訊

其他資源