Поделиться через

  • Статья

Функция fn_trace_getinfo (Transact-SQL)

Возвращает сведения об указанной трассировке или обо всех существующих трассировках.

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

Синтаксис

sys.fn_trace_getinfo ( { trace_id | NULL | 0 | DEFAULT } )

Аргументы

  • trace_id
    Идентификатор трассировки. Аргумент trace_id имеет тип int. Допустимыми входными значениями являются идентификатор трассировки, NULL, 0 или DEFAULT. В данном контексте значения NULL, 0 и DEFAULT эквивалентны. Укажите значение NULL, 0 или DEFAULT, чтобы вернуть сведения для всех трассировок в экземпляре SQL Server.

Возвращаемые таблицы

Имя столбца

Тип данных

Описание

traceid

int

Идентификатор трассировки.

property

int

Свойство трассировки:

1 — параметры трассировки. Дополнительные сведения см. в описании аргумента @options в разделе Хранимая процедура sp_trace_create (Transact-SQL).

2 — имя файла

3 — максимальный размер

4 — время остановки

5 — текущее состояние трассировки. 0 — остановлена. 1 — запущена.

value

sql_variant

Сведения о свойстве указанной трассировки.

Замечания

Функция fn_trace_getinfo принимает идентификатор конкретной трассировки и возвращает сведения об этой трассировке. Если передать недопустимый идентификатор, эта функция вернет пустой набор строк.

Функция fn_trace_getinfo добавляет расширение TRC к имени любого файла трассировки, включенного в ее результирующий набор. Дополнительные сведения об определении трассировки см. в разделе Хранимая процедура sp_trace_create (Transact-SQL). Аналогичные сведения о фильтрах трассировки см. в разделе fn_trace_getfilterinfo (Transact-SQL).

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

Разрешения

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

Примеры

В следующем примере возвращаются сведения обо всех активных трассировках.

SELECT * FROM sys.fn_trace_getinfo(0) ;
GO