Статья
04/01/2012

sp_trace_setstatus (Transact-SQL)

Изменяет текущее состояние указанной трассировки.

Значок ссылки на раздел Синтаксические обозначения в Transact-SQL

Синтаксис

        sp_trace_setstatus [ @traceid = ] trace_id , [ @status = ] status

Аргументы

[ @traceid= ] trace_id
Идентификатор трассировки, подлежащей изменению. Аргумент trace_id имеет тип int без значения по умолчанию. Пользователь применяет это значение аргумента trace_id, для идентификации, изменения и управления трассировкой. Дополнительные сведения о получении идентификатора trace_id см. в разделе Функция fn_trace_getinfo (Transact-SQL).

[ @traceid= ] status
Указывает действие с трассировкой для реализации. Аргумент status имеет тип int без значения по умолчанию.

В следующей таблице приведены состояния, которые могут быть заданы.

Состояние	Описание
0	Останавливает указанную трассировку.
1	Начинает указанную трассировку.
2	Закрывает указанную трассировку и удаляет ее определение из сервера.

Примечание
Перед закрытием трассировка должна быть остановлена. Перед просмотром трассировка должна быть остановлена и закрыта.

Значения кодов возврата

В следующей таблице описаны значения кодов, которые могут быть возвращены пользователю при завершении хранимой процедуры.

Код возврата	Описание
0	Ошибок нет.
1	Неизвестная ошибка.
8	Указано недопустимое состояние.
9	Указан недопустимый дескриптор трассировки.
13	Не хватает памяти. Возвращается, когда для выполнения указанного действия недостаточно памяти.

Если трассировка уже находится в указанном состоянии, то SQL Server возвращает 0.

Замечания

Аргументы всех хранимых процедур SQL Trace (sp_trace_xx) строго типизированы. Если эти параметры не вызываются вместе с правильными типами данных входных параметров, как указано в аргументе описания, то хранимая процедура возвращает ошибку.

Пример использования хранимых процедур трассировки см. в разделе Как создать трассировку (Transact-SQL).