• Статья

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 базы данных распространителя.