EVENTDATA (Transact-SQL)

更新日期： 2006 年 12 月 12 日

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

Transact-SQL 语法约定

语法

 EVENTDATA( )

备注

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

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

注意：
EVENTDATA 返回 XML 数据。该数据将以 Unicode 的形式（其中每个字符包含 2 个字节）发送到客户端。以下 Unicode 码位可以在 EVENTDATA 所返回的 XML 中使用： 0x0009 0x000A 0x000D >= 0x0020 && <= 0xD7FF >= 0xE000 && <= 0xFFFD 某些可以在 Transact-SQL 标识符和数据中使用的字符不能或不允许在 XML 中使用。其码位没有显示在前面列表中的字符或数据将映射为问号 (?)。

返回的架构

EVENTDATA 返回类型为 xml 的值。为每个事件返回的架构由 <EVENT_INSTANCE> 元素内嵌套的元素组成。若要获取为事件返回的架构，请使用索引或搜索在 SQL Server 联机丛书中查找该事件的主题。为事件列出的属性名称与架构中返回的元素相对应，但是下列情况例外：

• EVENTDATA 返回 <ServerName> 元素，而不是 <SQLInstance> 和 <ComputerName>。
• EVENTDATA 返回其他 <EventType> 元素。

例如，ALTER_TABLE 事件返回以下架构：

<EVENT_INSTANCE>
    <EventType>type</EventType>
    <PostTime>date-time</PostTime>
    <SPID>spid</SPID>
    <ServerName>name</ServerName>
    <LoginName>name</LoginName>
    <UserName>name</UserName>
    <DatabaseName>name</DatabaseName>
    <SchemaName>name</SchemaName>
    <ObjectName>name</ObjectName>
    <ObjectType>type</ObjectType>
    <TSQLCommand>command</TSQLCommand>
</EVENT_INSTANCE>

示例

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

以下示例创建 DDL 触发器，以防止在数据库中创建新表。通过对 EVENTDATA 生成的 XML 数据使用 XQuery，可以捕获激发触发器的 Transact-SQL 语句。有关详细信息，请参阅 针对 xml 数据类型的 XQuery。

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

USE AdventureWorks;
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 AdventureWorks;
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 触发器
设计事件通知

帮助和信息

获取 SQL Server 2005 帮助

更改历史记录

发布日期	历史记录
2006 年 12 月 12 日	新增内容： 添加了还可以在登录触发器正文的内部使用 EVENTDATA。SQL Server Service Pack 2 中引入了登录触发器。