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)