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, то все трассировочные маркеры публикации удаляются.

• [ @cutoff_date= ] cutoff_date
  Задает конечную дату, так что все трассировочные маркеры, созданные ранее указанной даты, удаляются. Аргумент cutoff_date имеет тип datetime и не имеет значения по умолчанию.

• [ @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)

Другие ресурсы

How to: Measure Latency and Validate Connections for Transactional Replication (Replication Transact-SQL Programming)
Проверка соединений и измерение задержки для репликации транзакций

Справка и поддержка

Получение помощи по SQL Server 2005