EVENTDATA (Transact-SQL)

项目
03/07/2014

返回有关服务器或数据库事件的信息。激发事件通知时将调用 EVENTDATA，并且结果返回到指定的 Service Broker。还可以在 DDL 或登录触发器正文的内部使用 EVENTDATA。

适用范围：SQL Server（SQL Server 2008 至当前版本），Windows Azure SQL Database（初始版本至当前版本）。

语法

EVENTDATA( )

注释

只有直接在 DDL 或登录触发器内部引用 EVENTDATA 时，EVENTDATA 才会返回数据。如果 EVENTDATA 由其他例程调用（即使这些例程由 DDL 或登录触发器进行调用），将返回 NULL。

在隐式或显式调用 EVENTDATA 的事务提交或回滚之后，EVENTDATA 所返回的数据将无效。

备注

EVENTDATA 返回 XML 数据。该数据将以 Unicode 的形式（其中每个字符包含 2 个字节）发送到客户端。以下 Unicode 码位可以在 EVENTDATA 所返回的 XML 中使用：

0x0009

0x000A

0x000D

>= 0x0020 && <= 0xD7FF

>= 0xE000 && <= 0xFFFD

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

为了保护登录名的安全性，当执行 CREATE LOGIN 或 ALTER LOGIN 语句时，将不显示密码。

返回的架构

EVENTDATA 返回类型为 xml 的值。默认情况下，所有事件的架构定义都安装在以下目录中：C:\Program Files\Microsoft SQL Server\120\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