适用对象:yesSQL Server(从 2008 版开始)noAzure SQL 数据库noAzure SQL 数据仓库no并行数据仓库 管理应用程序通过发出 WMI 查询语言 (WQL) 语句来访问使用 WMI Provider for Server Events 的 SQL Server 事件。 WQL 是结构化查询语言 (SQL) 的简化子集,它还包含一些特定于 WMI 的扩展。 当使用 WQL 时,应用程序将针对特定的 SQL Server 实例、数据库或数据库对象(当前唯一支持的对象为队列)来检索事件类型。 WMI Provider for Server Events 会将查询转换为数据库范围或对象范围事件通知,或在目标数据库中创建的事件通知主服务器作用域的事件的数据库通知。
例如,请考虑下列 WQL 查询:
SELECT * FROM DDL_DATABASE_LEVEL_EVENTS WHERE DatabaseName = 'AdventureWorks'
在以下查询中,WMI 提供程序试图在目标服务器上生成此事件通知的等效项:
USE AdventureWorks ;
GO
CREATE EVENT NOTIFICATION SQLWEP_76CF38C1_18BB_42DD_A7DC_C8820155B0E9
ON DATABASE
WITH FAN_IN
FOR DDL_DATABASE_LEVEL_EVENTS
TO SERVICE
'SQL/Notifications/ProcessWMIEventProviderNotification/v1.0',
'A7E5521A-1CA6-4741-865D-826F804E5135';
GO
WQL 查询 (FROM) 的 DDL_DATABASE_LEVEL_EVENTS 子句中的参数可以为可对其创建事件通知的任何有效事件。 SELECT 和 WHERE 子句中的参数可以指定与某一事件或其父事件关联的任何事件属性。 有关有效事件和事件属性的列表,请参阅事件通知 (数据库引擎)。
WMI Provider for Server Events 显式支持以下 WQL 语法。 也可以指定附加 WQL 语法,但该语法并非特定于此提供程序,并且由 WMI 主机服务进行分析。 有关 WMI 查询语言的详细信息,请参阅 Microsoft Developer Network (MSDN) 上的 WQL 文档。
语法
SELECT { event_property [ ,...n ] | * }
FROM event_type
WHERE where_condition
参数
event_property
事件的属性。 示例包括PostTime, SPID,并LoginName。 查找中列出的每个事件WMI Provider for Server Events 类和属性以确定它所持有的属性。 例如,DDL_DATABASE_LEVEL_EVENTS 事件具有DatabaseName并用户名属性。 它还继承SQLInstance, LoginName, PostTime, SPID,并ComputerName从其父事件的属性。
, ...n
指示event_property可以进行多次查询,以逗号隔开。
*
指定对与事件关联的所有属性进行查询。
event_type
可针对其创建事件通知的任何事件。 有关可用事件的列表,请参阅WMI Provider for Server Events 类和属性。 请注意,事件类型名称对应于相同event_type | event_group ,可以手动创建事件通知时指定通过使用 CREATE EVENT NOTIFICATION。 示例事件类型包括 CREATE_TABLE、 LOCK_DEADLOCK、 DDL_USER_EVENTS 和 TRC_DATABASE。
Note:
执行 DDL 式操作的某些系统存储过程也可以激发事件通知。 测试您的事件通知以确定它们是否响应运行的系统存储过程。 例如,CREATE TYPE 语句和sp_addtype存储的过程都将激发针对 CREATE_TYPE 事件创建事件通知。 但是, sp_rename存储的过程不会激发任何事件通知。 有关详细信息,请参阅DDL 事件。
where_condition
是的组成的 WHERE 子句查询谓词event_property名称和逻辑运算符和比较运算符。 Where_condition确定在其中相应的事件通知注册目标数据库中的作用域。 此外可以用作筛选器,若要针对某个特定架构或对象从其查询event_type。 有关详细信息,请参阅本主题后面备注部分。
仅=操作数可连同DatabaseName, SchemaName,和ObjectName。 其他表达式不能与这些事件属性一起使用。
备注
Where_condition WMI Provider for Server Events 的语法确定以下:
-
提供程序尝试检索指定的作用域event_type: 服务器级、 数据库级别或对象级别 (目前支持的唯一对象为队列)。 最后,此范围用于确定在目标数据库中创建的事件通知的类型。 这个过程称为事件通知注册。
-
要在其上进行注册的数据库、架构和对象(视具体情况而定)。
WMI Provider for Server Events 使用从下到上的最先适应算法为基础 EVENT NOTIFICATION 生成尽可能小的范围。 该算法试图将服务器上的内部活动和 SQL Server 实例与 WMI 主机进程之间的网络通信流量降至最低。 提供程序检查event_type FROM 子句和 WHERE 子句中的条件中指定,并尝试尽可能小的范围注册基础 EVENT NOTIFICATION。 如果提供程序无法在最小的范围内注册,则它会依次尝试在更大的范围内注册,直到注册最终成功为止。 如果它达到服务器级别的最大范围且失败,则它将向使用者返回一个错误。
例如,如果 DatabaseName =' AdventureWorks ' 提供程序尝试注册事件通知在 WHERE 子句中指定AdventureWorks2012数据库。 如果 AdventureWorks2012 数据库存在且调用客户端拥有在 AdventureWorks2012 中创建事件通知所需的权限,则注册成功。 否则,将尝试在服务器级别注册事件通知。 如果 WMI 客户端拥有所需的权限,则注册成功。 但是,在这种情况下,在创建完 AdventureWorks2012 数据库之前不会将事件返回给客户端。
Where_condition也可用作筛选器,此外限制对特定数据库、 架构或对象的查询。 例如,请考虑下列 WQL 查询:
SELECT * FROM ALTER_TABLE
WHERE DatabaseName = 'AdventureWorks' AND SchemaName = 'Sales'
AND ObjectType='Table' AND ObjectName = 'SalesOrderDetail'
根据注册过程的结果的不同,可以在数据库级别或服务器级别注册此 WQL 查询。 但是,即使此查询的注册是在服务器级别进行的,提供程序最终还是会筛选不适用于 ALTER_TABLE 表的所有 AdventureWorks.Sales.SalesOrderDetail 事件。 也就是说,提供程序只会返回在此特定表上出现的 ALTER_TABLE 事件的属性。
如果指定复合表达式,例如 DatabaseName='AW1' OR DatabaseName='AW2',则会尝试在服务器范围注册单个事件通知,而不是两个独立的事件通知。 如果调用客户端拥有权限,则注册成功。
如果SchemaName='X' AND ObjectType='Y' AND ObjectName='Z'这些都是在中指定WHERE子句中,尝试注册直接在对象上的事件通知Z架构中X。 如果客户端拥有权限,则注册成功。 请注意,目前,对象级事件支持仅在队列上且仅针对 QUEUE_ACTIVATION event_type。
请注意,并非所有事件均可在任何特定的范围内进行查询。 例如,针对跟踪事件(例如 Lock_Deadlock)或跟踪事件组(例如 TRC_LOCKS)的 WQL 查询仅可在服务器级别进行注册。 与此类似,CREATE_ENDPOINT 事件和 DDL_ENDPOINT_EVENTS 事件组也只能在服务器级别进行注册。 用于注册事件的适当范围的详细信息,请参阅设计事件通知。 尝试注册 WQL 查询它的event_type仅可以注册在服务器级别建立时将始终在服务器级别。 如果 WMI 客户端拥有权限,则注册成功。 否则,将向客户端返回一个错误。 不过,在某些情况下,仍可根据与服务器级别事件对应的属性将 WHERE 子句用作服务器级别事件的筛选器。 例如,许多跟踪事件具有DatabaseName可以用作筛选器的 WHERE 子句中的属性。
在创建服务器范围事件通知主数据库,并且可以通过查询元数据sys.server_event_notifications目录视图。
数据库范围或对象范围事件通知在指定的数据库中创建并可通过查询元数据sys.event_notifications目录视图。 (您必须为目录视图加上对应的数据库名前缀。)
示例
A. 在服务器范围查询事件
以下 WQL 查询检索在 SERVER_MEMORY_CHANGE 实例上出现的任何 SQL Server 跟踪事件的所有事件属性。
SELECT * FROM SERVER_MEMORY_CHANGE
B. 在数据库范围查询事件
以下 WQL 查询检索在 AdventureWorks 数据库中出现且存在于 DDL_DATABASE_LEVEL_EVENTS 事件组下的任何事件的特定事件属性。
SELECT SPID, SQLInstance, DatabaseName FROM DDL_DATABASE_LEVEL_EVENTS
WHERE DatabaseName = 'AdventureWorks'
C. 在数据库范围查询事件,并按架构和对象进行筛选
以下查询检索在表 ALTER_TABLE 上出现的任何 AdventureWorks.Sales.SalesOrderDetail 事件的所有事件属性。
SELECT * FROM ALTER_TABLE
WHERE DatabaseName = 'AdventureWorks' AND SchemaName = 'Sales'
AND ObjectType='Table' AND ObjectName = 'SalesOrderDetail'
请参阅
WMI Provider for Server Events 的概念
事件通知 (数据库引擎)
历史资料。此文对应 2018-11-30 的中文文档快照,适用产品版本和命令行为以原文为准。
来源与署名:Microsoft 和文档贡献者(原始作者元数据 CarlRabeler)。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站展开固定版本仓库内的引用内容,将 Markdown 转为 HTML,规范化链接,移除外部媒体、发布器占位标签和导航标记。
