• 發行項

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。