将 WQL 与 WMI Provider for Server Events 结合使用

语法

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 和 UserName 属性。事件还从其父事件继承 SQLInstance、LoginName、PostTime、SPID 和 ComputerName 属性。

• ,...n
  指示可以对 event_property 进行多次查询（以逗号分隔）。

• *
  指定对与事件关联的所有属性进行查询。

• event_type
  可针对其创建事件通知的任何事件。有关可用事件的列表，请参阅 WMI Provider for Server Events 类和属性。请注意，event type 的名称与可在使用 CREATE EVENT NOTIFICATION 手动创建事件通知时指定的相同 event_type | event_group 相对应。event type 的示例包括 CREATE_TABLE、LOCK_DEADLOCK、DDL_USER_EVENTS 和 TRC_DATABASE。

  注意
  执行 DDL 式操作的某些系统存储过程也可以激发事件通知。测试您的事件通知以确定它们是否响应运行的系统存储过程。例如，CREATE TYPE 语句和 sp_addtype 存储过程都将激发通过 CREATE_TYPE 事件创建的事件通知。但是，sp_rename 存储过程不会激发任何事件通知。有关详细信息，请参阅 DDL 事件。

• where_condition
  由 event_property 名称、逻辑运算符和比较运算符组成的 WHERE 子句查询谓词。where_condition 确定在目标数据库中注册相应事件通知的范围。该参数也可用作筛选器，用于确定从中查询 event_type 的特定架构或对象。有关详细信息，请参阅本主题后面的“备注”部分。

  只有 = 操作数可与 DatabaseName、SchemaName 和 ObjectName 一起使用。其他表达式不能与这些事件属性一起使用。

注释

WMI Provider for Server Events 语法的 where_condition 用于确定以下信息：

• 提供程序尝试检索指定 event_type 的范围：服务器级别、数据库级别或对象级别（当前唯一支持的对象为队列）。最后，此范围用于确定在目标数据库中创建的事件通知的类型。这个过程称为事件通知注册。

• 要在其上进行注册的数据库、架构和对象（视具体情况而定）。

WMI Provider for Server Events 使用从下到上的最先适应算法为基础 EVENT NOTIFICATION 生成尽可能小的范围。该算法试图将服务器上的内部活动和 SQL Server 实例与 WMI 主机进程之间的网络通信流量降至最低。提供程序会检查在 FROM 子句中指定的 event_type 和 WHERE 子句中的条件，并尝试用尽可能小的范围注册基础 EVENT NOTIFICATION。如果提供程序无法在最小的范围内注册，则它会依次尝试在更大的范围内注册，直到注册最终成功为止。如果它达到服务器级别的最大范围且失败，则它将向使用者返回一个错误。

例如，如果在 WHERE 子句中指定 DatabaseName='AdventureWorks'，则提供程序将尝试在 AdventureWorks 数据库中注册事件通知。如果 AdventureWorks 数据库存在且调用客户端拥有在 AdventureWorks 中创建事件通知所需的权限，则注册成功。否则，将尝试在服务器级别注册事件通知。如果 WMI 客户端拥有所需的权限，则注册成功。但是，在这种情况下，在创建完 AdventureWorks 数据库之前不会将事件返回给客户端。

where_condition 也可用作筛选器，以将查询额外限制在特定数据库、架构或对象内进行。例如，请考虑下列 WQL 查询：

SELECT * FROM ALTER_TABLE 
WHERE DatabaseName = 'AdventureWorks' AND SchemaName = 'Sales' 
    AND ObjectType='Table' AND ObjectName = 'SalesOrderDetail'

根据注册过程的结果的不同，可以在数据库级别或服务器级别注册此 WQL 查询。但是，即使此查询的注册是在服务器级别进行的，提供程序最终还是会筛选不适用于 AdventureWorks.Sales.SalesOrderDetail 表的所有 ALTER_TABLE 事件。也就是说，提供程序只会返回在此特定表上出现的 ALTER_TABLE 事件的属性。

如果指定复合表达式，例如 DatabaseName='AW1' OR DatabaseName='AW2'，则会尝试在服务器范围注册单个事件通知，而不是两个独立的事件通知。如果调用客户端拥有权限，则注册成功。

如果在 WHERE 子句中全部指定了 SchemaName='X' AND ObjectType='Y' AND ObjectName='Z'，则会尝试直接在架构 X 中的对象 Z 上注册事件通知。如果客户端拥有权限，则注册成功。请注意，当前只有队列支持对象级事件，且此类事件仅适用于 QUEUE_ACTIVATION event_type。

请注意，并非所有事件均可在任何特定的范围内进行查询。例如，针对跟踪事件（例如 Lock_Deadlock）或跟踪事件组（例如 TRC_LOCKS）的 WQL 查询仅可在服务器级别进行注册。与此类似，CREATE_ENDPOINT 事件和 DDL_ENDPOINT_EVENTS 事件组也只能在服务器级别进行注册。有关用于注册事件的适当范围的详细信息，请参阅设计事件通知。始终在服务器级别尝试对只能在服务器级别注册其 event_type 的 WQL 查询进行注册。如果 WMI 客户端拥有权限，则注册成功。否则，将向客户端返回一个错误。不过，在某些情况下，仍可根据与服务器级别事件对应的属性将 WHERE 子句用作服务器级别事件的筛选器。例如，许多跟踪事件具有可在 WHERE 子句中用作筛选器的 DatabaseName 属性。

服务器范围事件通知在 master 数据库中创建，并可通过使用 sys.server_event_notifications 目录视图查询其元数据。

数据库范围或对象范围事件通知在指定数据库中创建，并可通过使用 sys.event_notifications 目录视图查询其元数据。（您必须为目录视图加上对应的数据库名前缀。）

示例

A. 在服务器范围查询事件

SELECT * FROM SERVER_MEMORY_CHANGE

B. 在数据库范围查询事件

SELECT SPID, SQLInstance, DatabaseName FROM DDL_DATABASE_LEVEL_EVENTS 
WHERE DatabaseName = 'AdventureWorks' 

C. 在数据库范围查询事件，并按架构和对象进行筛选

SELECT * FROM ALTER_TABLE 
WHERE DatabaseName = 'AdventureWorks' AND SchemaName = 'Sales' 
    AND ObjectType='Table' AND ObjectName = 'SalesOrderDetail'

请参阅

概念

其他资源