扩展事件包

适用于： SQL Server Azure SQL 数据库 Azure SQL 托管实例

包是 SQL Server 数据库引擎中扩展事件对象的容器。 例如，任何支持扩展事件的数据库引擎中都存在以下包：

程序包	说明
package0（默认值）	扩展事件系统对象。
sqlserver	与数据库引擎相关的对象。
sqlos	SQL 操作系统 (SQLOS) 相关的对象。

注意

SecAudit 包供审核功能在内部使用。 此包中的所有对象均不能通过扩展事件数据定义语言 (DDL) 使用。

包是由名称、GUID 以及包含该包的二进制模块进行标识的。 模块可以是可执行文件或者是动态链接库。 有关详细信息，请参阅 sys.dm_xe_packages。

包可以包含以下任一对象或所有对象，稍后将在本文章中详细介绍这些对象：

• 事件
• 目标
• 操作
• 类型
• 谓词
• 地图

在一个事件会话中可混合不同包中的对象。 有关详细信息，请参阅扩展事件会话。

包的内容

下图显示了包中可以存在哪些对象。

事件

事件是程序（例如 SQL Server）的执行路径中的相关监视点。 事件触发时，其中包含已经到达相关点的事实，并具有自事件触发以来的状态信息。

事件可仅用于跟踪目的或用于触发操作。 这些操作可以是同步的，也可以是异步的。

注意

事件不知道在对事件触发做出响应时可能会触发的操作。

在向扩展事件注册包后，将不能更改该包中的事件集。

所有事件都有一个用于定义其内容的版本控制架构。 此架构由其类型已定义的事件列组成。 特定类型的事件在提供其数据时必须始终完全遵守在架构中指定的相同顺序。 但是，事件目标不必使用提供的所有数据。

事件分类

扩展事件使用与 Windows 事件跟踪 (ETW) 类似的事件分类模型。 两个事件属性将用于分类、通道和关键字。 使用这些属性可支持将扩展事件与 ETW 及其工具进行集成。

通道用于标识事件的用户。 下表对这些通道进行了说明。

术语	定义
管理员	管理员事件主要针对的是最终用户、管理员和支持人员。 管理员通道中包含的事件指示定义好的解决方案出现问题，管理员可以对该问题进行处理。 例如，应用程序无法连接就是一个管理员事件。 这些事件可能在文档中有详细描述，或者有与之关联的消息告诉读者如何纠正这一问题。
可运行	操作事件用于分析和诊断问题或匹配项。 它们可用于基于问题或匹配项来触发工具或任务。
分析	分析事件的发布量是很大的。 它们对程序操作进行说明并且通常用于性能调查。
调试	调试事件主要由开发人员用来诊断问题以进行调试。 调试渠道中的事件返回特定于实现的内部状态数据。 这些事件返回的架构和数据可能在数据库引擎的将来版本中更改、失效或删除，恕不另行通知。

关键字是特定于应用程序的，并且使得对相关事件的分组更加细化，这样您能更容易地指定和检索要在会话中使用的事件。 可以使用以下查询来获取关键字信息。

SELECT map_value AS Keyword
FROM sys.dm_xe_map_values
WHERE name = 'keyword_map';

目标

目标是指事件使用者。 目标在触发事件的线程中同步处理事件或在系统提供的线程中异步处理事件。 扩展事件提供了多个目标类型，您可以根据需要将其用于定向事件输出。 有关详细信息，请参阅扩展事件的目标。

使用 ADD TARGET 子句可以向事件会话添加目标。

操作

操作是对事件做出的一个编程方式的响应或一系列响应。 操作与事件绑定在一起，并且每个事件都可能具有自己的一组操作。

注意

用于特定事件的操作不能绑定到其他事件。

在触发事件的线程上将同步调用与该事件绑定的操作。 操作类型很多，并且它们都具有多种功能。 操作可以：

• 捕获进程转储
• 使用变量存储将状态信息存储在本地上下文中
• 聚合事件数据
• 将数据追加到事件数据

使用操作的常见示例包括：

• 收集线程触发事件所执行的查询的 SQL 文本
• 收集查询计划句柄、查询哈希和查询计划哈希
• 收集导致触发事件的会话的属性，包括客户端主机名、主体名称、连接 ID 等。
• 收集调用堆栈
• 当发生特定错误时捕获进程转储

使用 ACTION 子句可以向事件会话添加操作。

谓词

谓词是一组逻辑规则，用于在处理事件时计算这些事件。 谓词使扩展事件用户能够根据特定条件有选择地捕获事件数据。

谓词可在本地上下文中存储用于创建谓词的数据，这些谓词每 n 分钟或每当事件触发 n 次时返回一次 true。 还可以使用此本地上下文存储来动态更新谓词，如果事件包含类似数据，则会抑制未来的事件触发。

谓词能够检索上下文信息，如线程 ID 和特定于事件的数据。 谓词的计算结果为完整的布尔表达式，并且它支持在整个表达式为 false 的第一个点处执行短路。

注意

如果早期的谓词检查失败，则可能无法计算具有副作用的谓词。

使用 WHERE 子句可以向事件会话添加谓词。

类型

在包中，每个扩展事件对象都有一个类型。 以下是使用的类型：

• action
• event
• message
• pred_compare
• pred_source
• target
• type

有关详细信息，请参阅 sys.dm_xe_objects。

地图

映射表用于将内部值映射到字符串，这使用户可以知道该值代表什么。 用户可以获得关于内部值真正含义的说明，而不是只能够获取数值。 下面的查询显示了获取映射值的方式。

SELECT map_key,
       map_value
FROM sys.dm_xe_map_values
WHERE name = 'lock_mode';

前面的查询生成以下输出：

map_key	map_value
0	NL
1	SCH_S
2	SCH_M
3	S
4	U
5	X
6	IS
7	IU
8	IX
9	SIU
10	SIX
11	UIX
12	BU
13	RS_S
14	RS_U
15	RI_NL
16	RI_S
17	RI_U
18	RI_X
19	RX_S
20	RX_U
21	LAST_MODE

以此表为例，假定有一名为 lock_mode 的列，且其值为 5。 此表指示 5 映射到 X，即表示锁类型为排他。

相关内容

• 扩展事件会话
• 扩展事件引擎
• 扩展事件的目标