sys.fn_trace_gettable (Transact-SQL)

Статья
08/21/2023

Область применения: SQL Server

Возвращает содержимое одного или нескольких файлов трассировки в табличном формате.

Внимание

Эта функция будет удалена в будущей версии SQL Server. Избегайте использования этого компонента в новых разработках и запланируйте изменение существующих приложений, в которых он применяется. Вместо этого используйте расширенные события.

Соглашения о синтаксисе Transact-SQL

Синтаксис

  
fn_trace_gettable ( 'filename' , number_files )

Аргументы

"filename"
Указывает первый считываемый файл трассировки. имя файла — nvarchar(256), без значения по умолчанию.

number_files
Указывает число считываемых файлов продолжения. Это число включает исходный файл, указанный в имени файла. number_files является int.

Замечания

Если number_files указано по умолчанию, fn_trace_gettable считывает все файлы свертывания до конца трассировки. fn_trace_gettable возвращает таблицу со всеми столбцами, допустимыми для указанной трассировки. Дополнительные сведения см. в разделе sp_trace_setevent (Transact-SQL).

Помните, что функция fn_trace_gettable не будет загружать файлы отката (если этот параметр указан с помощью аргумента number_files ), где исходное имя файла трассировки заканчивается символом подчеркивания и числовым значением. (Это не относится к подчеркиваниям и числу, которые автоматически добавляются при перекате файла.) В качестве обходного решения можно переименовать файлы трассировки, чтобы удалить подчеркивания в исходном имени файла. Например, если исходный файл называется Trace_Oct_5.trc, а файл свертки называется Trace_Oct_5_1.trc, можно переименовать файлы в TraceOct5.trc и TraceOct5_1.trc.

Эта функция может считывать трассировку, которая еще активна на экземпляре, на котором она выполняется.

Разрешения

Необходимо разрешение ALTER TRACE на сервере.

Примеры

А. Применение функции fn_trace_gettable для импорта строк из файла трассировки

В следующем примере функция fn_trace_gettable вызывается в предложении FROM инструкции SELECT...INTO.

USE AdventureWorks2022;  
GO  
SELECT * INTO temp_trc  
FROM fn_trace_gettable('c:\temp\mytrace.trc', default);  
GO

B. Получение с помощью функции fn_trace_gettable таблицы со столбцом IDENTITY, которая может быть загружена в таблицу SQL Server

Следующий пример вызывает функцию из инструкции SELECT...INTO и возвращает таблицу со столбцом IDENTITY, которая может быть загружена в таблицу temp_trc.

USE AdventureWorks2022;  
GO  
SELECT IDENTITY(int, 1, 1) AS RowNumber, * INTO temp_trc  
FROM fn_trace_gettable('c:\temp\mytrace.trc', default);  
GO

См. также

sp_trace_generateevent (Transact-SQL)
sp_trace_setevent (Transact-SQL)
sp_trace_setfilter (Transact-SQL)
sp_trace_setstatus (Transact-SQL)

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