EVENTDATA (Transact-SQL)

适用于:yesSQL Server(所有受支持的版本)YesAzure SQL 数据库YesAzure SQL 托管实例

此函数返回有关服务器或数据库事件的信息。 激发事件通知且指定的 Service Broker 收到结果时,将调用 EVENTDATA。 DDL 或登录触发器还支持在内部使用 EVENTDATA

Topic link iconTransact-SQL 语法约定

语法

EVENTDATA( )

注意

若要查看 SQL Server 2014 及更早版本的 Transact-SQL 语法,请参阅早期版本文档

备注

只有直接在 DDL 或登录触发器内部引用 EVENTDATA 时,它才会返回数据。 如果其他例程调用 EVENTDATA,则它返回 null,即使 DDL 或登录触发器调用这些例程时也是如此。

当执行以下事务时,由 EVENTDATA 返回的数据无效

  • 显式调用 EVENTDATA
  • 隐式调用 EVENTDATA
  • 提交
  • 已回滚

注意

EVENTDATA 返回 XML 数据,该数据将以 Unicode 的形式(其中每个字符包含 2 个字节)发送到客户端。 EVENTDATA 返回可表示这些 Unicode 码位的 XML:

0x0009

0x000A

0x000D

>= 0x0020 && <= 0xD7FF

>= 0xE000 && <= 0xFFFD

某些可以在 Transact-SQL 标识符和数据中显示的字符不能或不允许在 XML 中使用。 其码位没有显示在前面列表中的字符或数据将映射为问号 (?)。

密码在 CREATE LOGINALTER LOGIN 语句执行时不会显示。 这可以保护登录安全性。

返回的架构

EVENTDATA 返回数据类型为 xml 的值。 默认情况下,所有事件的架构定义都安装在此目录中:C:\Program Files\Microsoft SQL Server\nnn\Tools\Binn\schemas\sqlserver\2006\11\events\events.xsd。

Microsoft SQL Server XML 架构网页还具有事件架构。

若要提取任何特定事件的架构,请搜索复杂类型 EVENT_INSTANCE_<event_type> 的架构。 例如,若要提取 DROP_TABLE 事件的架构,请搜索 EVENT_INSTANCE_DROP_TABLE 的架构。

示例

A. 在 DDL 触发器中查询事件数据

此示例创建阻止创建新数据库表的 DDL 触发器。 对 EVENTDATA 生成的 XML 数据使用 XQuery 可捕获激发触发器的 Transact-SQL 语句。 请参阅 XQuery 语言参考 (SQL Server) 以了解详细信息。

注意

使用 SQL Server Management Studio 中的“以网格显示结果”来查询 <TSQLCommand> 元素时,命令文本中的分行符不会出现。 请改用“以文本格式显示结果”

USE AdventureWorks2012;  
GO  
CREATE TRIGGER safety   
ON DATABASE   
FOR CREATE_TABLE   
AS   
    PRINT 'CREATE TABLE Issued.'  
    SELECT EVENTDATA().value  
        ('(/EVENT_INSTANCE/TSQLCommand/CommandText)[1]','nvarchar(max)')  
   RAISERROR ('New tables cannot be created in this database.', 16, 1)   
   ROLLBACK  
;  
GO  
--Test the trigger.  
CREATE TABLE NewTable (Column1 INT);  
GO  
--Drop the trigger.  
DROP TRIGGER safety  
ON DATABASE;  
GO  

注意

如果需要返回事件数据,使用 XQuery value() 方法而不是 query() 方法。 query() 方法可在输出中返回 XML 和以“and”符转义的回车符和换行符 (CR/LF) 实例,而 value() 方法无法在输出中呈现 CR/LF 实例

B. 创建事件数据在 DDL 触发器中的日志表

此示例创建用于存储有关所有数据库级事件的信息的表,并在表中填充 DDL 触发器。 对 EVENTDATA 生成的 XML 数据使用 XQuery 可捕获事件类型和 Transact-SQL 语句。

USE AdventureWorks2012;  
GO  
CREATE TABLE ddl_log (PostTime DATETIME, DB_User NVARCHAR(100), Event NVARCHAR(100), TSQL NVARCHAR(2000));  
GO  
CREATE TRIGGER log   
ON DATABASE   
FOR DDL_DATABASE_LEVEL_EVENTS   
AS  
DECLARE @data XML  
SET @data = EVENTDATA()  
INSERT ddl_log   
   (PostTime, DB_User, Event, TSQL)   
   VALUES   
   (GETDATE(),   
   CONVERT(NVARCHAR(100), CURRENT_USER),   
   @data.value('(/EVENT_INSTANCE/EventType)[1]', 'NVARCHAR(100)'),   
   @data.value('(/EVENT_INSTANCE/TSQLCommand)[1]', 'NVARCHAR(2000)') ) ;  
GO  
--Test the trigger.  
CREATE TABLE TestTable (a INT);  
DROP TABLE TestTable ;  
GO  
SELECT * FROM ddl_log ;  
GO  
--Drop the trigger.  
DROP TRIGGER log  
ON DATABASE;  
GO  
--Drop table ddl_log.  
DROP TABLE ddl_log;  
GO  

另请参阅

使用 EVENTDATA 函数
DDL 触发器
事件通知
登录触发器