fn_trace_gettable (Transact-SQL)
Возвращает содержимое одного или нескольких файлов трассировки в табличном формате.
Синтаксические обозначения в Transact-SQL
Синтаксис
fn_trace_gettable ( filename , number_files )
Аргументы
- filename
Указывает первый считываемый файл трассировки. Аргумент filename имеет тип nvarchar(256) и не имеет значения по умолчанию.
- number_files
Указывает число считываемых файлов продолжения. Это число включает и файл, указанный в параметре filename. Аргумент number_files имеет тип int.
Замечания
Если значение аргумента number_files равно default, функция fn_trace_gettable считывает файлы продолжения до тех пор, пока не достигнет конца трассировки. Функция fn_trace_gettable возвращает таблицу, содержащую все столбцы, допустимые для указанной трассировки. Дополнительные сведения см. в разделе sp_trace_setevent (Transact-SQL).
Эта функция может считывать трассировку, которая еще активна на экземпляре, на котором она выполняется.
Разрешения
Необходимо разрешение ALTER TRACE на сервере.
Примеры
А. Применение функции fn_trace_gettable для импорта строк из файла трассировки
Следующий пример вызывает функцию fn_trace_gettable внутри предложения FROM
инструкции SELECT...INTO
.
USE AdventureWorks;
GO
SELECT * INTO temp_trc
FROM fn_trace_gettable('c:\temp\my_trace.trc', default);
GO
Б. Получение с помощью функции fn_trace_gettable таблицы со столбцом IDENTITY для последующей загрузки в таблицу SQL Server
Следующий пример вызывает функцию из инструкции SELECT...INTO
и возвращает таблицу со столбцом IDENTITY
, которая может быть загружена в таблицу temp_trc
.
USE AdventureWorks;
GO
SELECT IDENTITY(int, 1, 1) AS RowNumber, * INTO temp_trc
FROM fn_trace_gettable('c:\temp\my_trace.trc', default);
GO
См. также
Справочник
sp_trace_generateevent (Transact-SQL)
sp_trace_setevent (Transact-SQL)
sp_trace_setfilter (Transact-SQL)
sp_trace_setstatus (Transact-SQL)