读取扩展事件异步文件目标创建的文件。 每行返回一个 XML 格式的事件。
.gif "注意事项") 注意 |
|---|
SQL Server 2008 和 SQL Server 2008 R2 接受用 XEL 和 XEM 格式生成的跟踪结果。 SQL Server 2012 扩展事件仅支持 XEL 格式的跟踪结果。 我们推荐您使用 SQL Server Management Studio 来读取 XEL 格式的跟踪结果。 |
.gif "主题链接图标")
语法
sys.fn_xe_file_target_read_file ( path, mdpath, initial_file_name, initial_offset )
参数
path
要读取的文件的路径。 path 可以包含通配符并包括文件的名称。 path 的数据类型为 nvarchar(260)。 没有默认值。mdpath
对应于 path 参数指定的文件的元数据文件的路径。 mdpath 的数据类型为 nvarchar(260)。 没有默认值。.gif "注意")
注意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 权限。
示例
A.从文件目标检索数据
下面的示例从所有文件获取所有行。 在此示例中，文件目标和图元文件位于 C:\ 驱动器上的跟踪文件夹中。
SELECT * FROM sys.fn_xe_file_target_read_file('C:\traces\*.xel', 'C:\traces\metafile.xem', null, null);