sys.fn_trace_getinfo (Transact-SQL)
Область применения: SQL Server
Возвращает сведения об указанной трассировке или всех существующих трассировках.
Внимание
Эта функция будет удалена в будущей версии SQL Server. Избегайте использования этого компонента в новых разработках и запланируйте изменение существующих приложений, в которых он применяется. Вместо этого используйте расширенные события.
Соглашения о синтаксисе 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.
Возвращаемые таблицы
Имя столбца | Тип данных | Description |
---|---|---|
traceid | int | Идентификатор трассировки. |
свойство | int | Свойство трассировки: 1 — параметры трассировки. Дополнительные сведения см. в sp_trace_create @options (Transact-SQL). 2 — имя файла 3 — максимальный размер 4 — время остановки 5 — текущее состояние трассировки. 0 — остановлена. 1 — запущена. |
значение | 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)
sys.fn_trace_geteventinfo (Transact-SQL)
sys.fn_trace_gettable (Transact-SQL)