共用方式為


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 插入其中之發行集的名稱。publicationsysname,沒有預設值。

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

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

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

    [!附註]

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

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

傳回碼值

0 (成功) 或 1 (失敗)

備註

sp_deletetracertokenhistory 用於交易式複寫中。

當執行 sp_deletetracertokenhistory 時,您只能指定 tracer_idcutoff_date。當您同時指定這兩個參數時,會發生錯誤。

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

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

權限

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