sp_deletetracertokenhistory (Transact-SQL)

從 MStracer_tokens (Transact-SQL) 和 MStracer_history (Transact-SQL) 系統資料表中移除追蹤 Token 記錄。這個預存程序執行於發行集資料庫的發行者端，或散發資料庫的散發者端。

Transact-SQL 語法慣例

語法

sp_deletetracertokenhistory [ @publication = ] 'publication' 
    [ , [ @tracer_id = ] tracer_id ]
    [ , [ @cutoff_date = ] cutoff_date ]
    [ , [ @publisher = ] 'publisher' ] 
    [ , [ @publisher_db = ] 'publisher_db' ]

引數

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

• [ @tracer_id= ] tracer_id
  這是要刪除之追蹤 Token 的識別碼。tracer_id 是 int，預設值是 NULL。如果是 null，就會刪除屬於發行集的所有追蹤 Token。

• [ @cutoff_date= ] cutoff_date
  指定截止日期，以便移除在這個日期之前插入發行集的所有追蹤 Token。cutoff_date 是 datetime，預設值是 NULL。

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

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

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

傳回碼值

0 (成功) 或 1 (失敗)

備註

sp_deletetracertokenhistory 用於交易式複寫中。

當執行 sp_deletetracertokenhistory 時，您只能指定 tracer_id 或 cutoff_date。當您同時指定這兩個參數時，會發生錯誤。

如果您並未執行 sp_deletetracertokenhistory 來移除追蹤 Token 中繼資料，當進行定期排程的歷程記錄清除工作時，會移除這項資訊。

您可以執行 sp_helptracertokens (Transact-SQL) 或查詢 MStracer_tokens (Transact-SQL) 系統資料表，來判斷追蹤 Token 識別碼。

權限

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

請參閱

參考

sp_helptracertokenhistory (Transact-SQL)

其他資源

How to: Measure Latency and Validate Connections for Transactional Replication (Replication Transact-SQL Programming)
針對交易式複寫測量延遲並驗證連接

說明及資訊

取得 SQL Server 2005 協助