sp_trace_setstatus (Transact-SQL)

  • Статья

Область применения: SQL Server

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

Внимание

Эта функция будет удалена в будущей версии SQL Server. Избегайте использования этого компонента в новых разработках и запланируйте изменение существующих приложений, в которых он применяется. Вместо этого используйте расширенные события.

Соглашения о синтаксисе Transact-SQL

Синтаксис

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

Аргументы

[ @traceid = ] traceid

Идентификатор измененной трассировки. @traceid не используется без значения по умолчанию. Пользователь использует это значение @traceid для идентификации, изменения и управления трассировки. Сведения о получении @traceid см. в sys.fn_trace_getinfo.

[ @status = ] состояние

Указывает действие с трассировкой для реализации. @status не используется без значения по умолчанию.

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

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

Примечание.

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

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

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

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

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

Замечания

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

Пример использования хранимых процедур трассировки см. в разделе "Создание трассировки".

Разрешения

Требуется разрешение ALTER TRACE.

Связанный контент