sp_deletetracertokenhistory (Transact-SQL)
從 MStracer_tokens (Transact-SQL) 和 MStracer_history (Transact-SQL) 系統資料表中移除追蹤 Token 記錄。 這個預存程序是在發行集資料庫的發行者端，或散發資料庫的散發者端執行。
.gif "主題連結圖示")
語法
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)