sys.fn_xe_file_target_read_file (Transact-SQL)

Читает файлы, создаваемые асинхронным целевым файловым объектом расширенных событий. Возвращается одно событие в каждой строке в формате XML.

Внимание!
SQL Server 2008 и SQL Server 2008 R2 принимает результат трассировки, созданный в формате XEL и XEM. Расширенные события SQL Server 2012 поддерживают только результаты трассировки в формате XEL. Для чтения результатов трассировки в формате XEL рекомендуется использовать SQL Server Management Studio.

Синтаксические обозначения в Transact-SQL

Синтаксис

sys.fn_xe_file_target_read_file ( path, mdpath, initial_file_name, initial_offset )

Аргументы

• path
  Путь к файлам для чтения. path может содержать символы-шаблоны и включать имя файла. Аргумент path имеет тип nvarchar(260). Значение по умолчанию отсутствует.

• mdpath
  Путь к файлу метаданных, соответствующий файлу или файлам, которые указаны аргументом path. Аргумент mdpath имеет тип nvarchar(260). Значение по умолчанию отсутствует.

  Примечание
  SQL Server 2012 не требует параметра mdpath. Однако он используется для поддержки обратной совместимости фалов журналов, сформированных в предыдущих версиях SQL Server.

• initial_file_name
  Первый файл для чтения из path. Аргумент initial_file_name имеет тип nvarchar(260). Значение по умолчанию отсутствует. Если в качестве аргумента указывается значение null, выполняется чтение всех файлов, найденных в path.

  Примечание
  Аргументы initial_file_name и initial_offset являются связанными. При указании значения для любого из этих аргументов необходимо также указать значение для второго аргумента.

• initial_offset
  Используется для указания последнего считанного ранее смещения и пропуска всех событий до смещения (включительно). Перечисление событий начинается после указанного смещения. Аргумент initial_offset имеет тип bigint. Если в качестве аргумента указывается значение null, выполняется чтение всего файла.

Возвращаемая таблица

Имя столбца	Тип данных	Описание
module_guid	uniqueidentifier	Идентификатор GUID модуля событий. Не допускает значения NULL.
package_guid	uniqueidentifier	Идентификатор GUID пакета событий. Не допускает значения NULL.
object_name	nvarchar(256)	Имя события. Не допускает значения NULL.
event_data	nvarchar(max)	Содержимое события в формате XML. Не допускает значения NULL.
file_name	nvarchar(260)	Имя файла, содержащего событие. Не допускает значения NULL.
file_offset	bigint	Смещение блока в файле, содержащем событие. Не допускает значение NULL.

Разрешения

Требует разрешение VIEW SERVER STATE на сервере.

Примеры

А.Извлечение данных из целевых файлов

В следующем примере извлекаются все строки из всех файлов. В этом примере целевые файлы и метафайлы расположены в папке трассировки на диске «C:\».

SELECT * FROM sys.fn_xe_file_target_read_file('C:\traces\*.xel', 'C:\traces\metafile.xem', null, null);

См. также

Справочник

Динамические административные представления расширенных событий

Представления каталога расширенных событий (Transact-SQL)

Основные понятия

Расширенные события