sp_trace_setstatus (Transact-SQL)
Изменяет текущее состояние указанной трассировки.
.gif "Значок ссылки на раздел")
Синтаксические обозначения в 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
Закрывает указанную трассировку и удаляет ее определение из сервера.
.gif "ms176034.note(ru-ru,SQL.90).gif")
Примечание.Перед закрытием трассировка должна быть остановлена. Перед просмотром трассировка должна быть остановлена и закрыта.
Значения кодов возврата
В следующей таблице описаны значения кодов, которые могут быть возвращены пользователю при завершении хранимой процедуры.
| Код возврата | Описание |
|---|---|
0 |
Ошибок нет. |
1 |
Неизвестная ошибка. |
8 |
Указано недопустимое состояние. |
9 |
Указан недопустимый дескриптор трассировки. |
13 |
Не хватает памяти. Возвращается, когда для выполнения указанного действия недостаточно памяти. |
Если трассировка уже находится в указанном состоянии, то SQL Server возвращает 0.
Замечания
Аргументы всех хранимых процедур трассировки SQL (sp_trace_xx) строго типизированы. Если эти параметры не вызываются вместе с правильными типами данных входных параметров, как указано в аргументе описания, то хранимая процедура возвращает ошибку.
Разрешения
Пользователь должен иметь разрешение ALTER TRACE.
См. также
Справочник
fn_trace_geteventinfo (Transact-SQL)
fn_trace_getfilterinfo (Transact-SQL)
sp_trace_generateevent (Transact-SQL)
sp_trace_setevent (Transact-SQL)
sp_trace_setfilter (Transact-SQL)