sp_deletetracertokenhistory (Transact-SQL)

Удаляет записи о трассировочных токенах из системных таблиц MStracer_tokens (Transact-SQL) и MStracer_history (Transact-SQL). Эта хранимая процедура выполняется на издателе в базе данных публикации или на распространителе в базе данных распространителя.

Синтаксические обозначения в Transact-SQL

Синтаксис

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

Аргументы

• [ @publication= ] 'publication'
  Имя публикации, в которую была вставлена запись трассировочного токена. Аргумент publication имеет тип sysname и не имеет значения по умолчанию.

• [ @tracer_id= ] tracer_id
  Идентификатор трассировочного токена, который требуется удалить. Аргумент tracer_id имеет тип int и значение по умолчанию NULL. Если используется значение NULL, то все трассировочные токены публикации удаляются.

• [ @cutoff_date= ] cutoff_date
  Задает конечную дату так, что все трассировочные токены, созданные ранее указанной даты, удаляются. Аргумент 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 для очистки метаданных по трассировочным токенам не выполняется вручную пользователем, то указанная информация удаляется при выполнении плановой очистки журнала.

Идентификаторы трассировочных токенов могут быть заданы путем выполнения процедуры sp_helptracertokens (Transact-SQL) или направления запроса к системной таблице MStracer_tokens (Transact-SQL).

Разрешения

Процедуру sp_helptracertokenhistory могут выполнять только члены предопределенной роли сервера sysadmin, члены предопределенной роли db_owner базы данных публикации или члены предопределенных ролей db_owner и replmonitor базы данных распространителя.

См. также

Справочник

sp_helptracertokenhistory (Transact-SQL)

Основные понятия

Измерение задержки и проверка правильности соединений для репликации транзакций