sys.fn_trace_getinfo (Transact-SQL)
Возвращает сведения об указанной трассировке или всех существующих трассировках.
.gif "Важное примечание") Важно! |
|---|
В будущей версии Microsoft SQL Server этот компонент будет удален. Избегайте использования этого компонента в новых разработках и запланируйте изменение существующих приложений, в которых он применяется. Вместо этого используйте расширенные события. |
.gif "Значок ссылки на раздел")
Соглашения о синтаксисе 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). Аналогичные сведения о фильтрах трассировки см. в разделе sys.fn_trace_getfilterinfo (Transact-SQL).
Подробный пример использования хранимых процедур трассировки см. в разделе создать трассировку (Transact-SQL).
Разрешения
Необходимо разрешение ALTER TRACE на сервере.
Примеры
В следующем примере возвращаются сведения обо всех активных трассировках.
SELECT * FROM sys.fn_trace_getinfo(0) ;
GO
См. также
Задания
создать трассировку (Transact-SQL)
Справочник
Хранимая процедура sp_trace_create (Transact-SQL)
sp_trace_generateevent (Transact-SQL)
Хранимая процедура sp_trace_setevent (Transact-SQL)
sp_trace_setfilter (Transact-SQL)
sp_trace_setstatus (Transact-SQL)
sys.fn_trace_getfilterinfo (Transact-SQL)