扩展事件包

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

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

• package0 - 扩展事件系统对象。 这是默认包。
• sqlserver - 与数据库引擎相关的对象
• sqlos - 操作系统 (SQLOS) 相关对象。

包是由名称、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';

Targets

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

使用 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';

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

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

相关内容

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