sp_trace_setstatus (Transact-SQL)
Изменяет текущее состояние указанной трассировки.
.gif "Важное примечание") Важно! |
|---|
В будущей версии Microsoft SQL Server этот компонент будет удален. Избегайте использования этого компонента в новых разработках и запланируйте изменение существующих приложений, в которых он применяется. Вместо этого используйте расширенные события. |
Применимо для следующих объектов: SQL Server (начиная с SQL Server 2008 до текущей версии). |
.gif "Значок ссылки на раздел")
Cинтаксические обозначения в Transact-SQL
Синтаксис
sp_trace_setstatus [ @traceid = ] trace_id , [ @status = ] status
Аргументы
[ @traceid= ] trace_id
Идентификатор изменяемой трассировки. Аргумент trace_id имеет тип int и не имеет значения по умолчанию. Пользователь применяет это значение аргумента trace_id, для идентификации, изменения и управления трассировкой. Дополнительные сведения о получении идентификатора trace_id см. в разделе sys.fn_trace_getinfo (Transact-SQL).[ @status= ] status
Указывает действие с трассировкой для реализации. Аргумент status имеет тип int и не имеет значения по умолчанию.В следующей таблице приведены состояния, которые могут быть заданы.
Состояние
Описание
0
Останавливает указанную трассировку.
1
Начинает указанную трассировку.
2
Закрывает указанную трассировку и удаляет ее определение из сервера.
Примечание
Перед закрытием трассировка должна быть остановлена.Перед просмотром трассировка должна быть остановлена и закрыта.
Значения кода возврата
В следующей таблице описаны значения кодов, которые могут быть возвращены пользователю при завершении хранимой процедуры.
Код возврата |
Описание |
|---|---|
0 |
Ошибок нет. |
1 |
Неизвестная ошибка. |
8 |
Указано недопустимое состояние. |
9 |
Указан недопустимый дескриптор трассировки. |
13 |
Не хватает памяти. Возвращается, когда для выполнения указанного действия недостаточно памяти. |
Если трассировка уже находится в указанном состоянии, то SQL Server возвращает 0.
Замечания
Аргументы всех хранимых процедур трассировки SQL (sp_trace_xx) строго типизированы. Если эти параметры не вызываются вместе с правильными типами данных входных параметров, как указано в описании аргумента, хранимая процедура возвращает ошибку.
Пример использования хранимых процедур трассировки см. в разделе создать трассировку (Transact-SQL).
Разрешения
Пользователь должен иметь разрешение ALTER TRACE.
См. также
Справочник
sys.fn_trace_geteventinfo (Transact-SQL)
sys.fn_trace_getfilterinfo (Transact-SQL)
sp_trace_generateevent (Transact-SQL)
Хранимая процедура sp_trace_setevent (Transact-SQL)
sp_trace_setfilter (Transact-SQL)