Использование функции EVENTDATA

Статья
12/15/2008

Изменения: 5 декабря 2005 г.

Функция EVENTDATA позволяет получить сведения о событии, которое привело к срабатыванию триггера DDL. Эта функция возвращает значение типа xml. XML-схема содержит следующие сведения:

время формирования события;
идентификатор системного процесса (SPID), соответствующий соединению, во время которого был выполнен триггер;
тип события, которое привело к срабатыванию триггера.

В зависимости от типа события эта схема включает также дополнительные сведения о базе данных, в которой было сформировано событие, об объекте, в контексте которого оно было сформировано, и об инструкции Transact-SQL, вызвавшей это событие. Дополнительные сведения см. в разделе EVENTDATA (Transact-SQL).

Предположим, что в базе данных AdventureWorks создан следующий триггер DDL:

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
;

После этого выполняется следующая инструкция CREATE TABLE:

CREATE TABLE NewTable (Column1 int);

Инструкция EVENTDATA() в триггере DDL захватывает текст инструкции CREATE TABLE , что является недопустимым. Это достигается путем выполнения запроса XQuery к данным типа xml, порожденным функцией EVENTDATA, и получения элемента <CommandText>. Дополнительные сведения см. в разделе Запрос XQuery к типу данных xml.

Внимание!
Функция EVENTDATA захватывает данные событий CREATE_SCHEMA, а также элемента <schema_element> соответствующего определения CREATE SCHEMA, если таковые существуют. Кроме этого, функция EVENTDATA распознает определение <schema_element> как отдельное событие. Таким образом, триггер DDL, созданный для события CREATE_SCHEMA и для события, представленного данными <schema_element> определения CREATE SCHEMA, может дважды вернуть одни и те же сведения о событии (например, данные `TSQLCommand`). Допустим, для событий CREATE_SCHEMA и CREATE_TABLE создан триггер DDL и выполняется следующий пакет: `CREATE SCHEMA s` `CREATE TABLE t1 (col1 int)` Если приложение запрашивает данные `TSQLCommand` о событии CREATE_TABLE, следует учитывать, что эти данные могут появиться дважды: при возникновении события CREATE_SCHEMA и при возникновении события CREATE_TABLE. Следует избегать создания триггеров DDL одновременно для событий CREATE_SCHEMA и текста <schema_element> для любых соответствующих определений CREATE SCHEMA, или же в приложение необходимо добавить элемент логики, чтобы одно и то же событие не обрабатывалось дважды.

Внимание!

Функция EVENTDATA захватывает данные событий CREATE_SCHEMA, а также элемента <schema_element> соответствующего определения CREATE SCHEMA, если таковые существуют. Кроме этого, функция EVENTDATA распознает определение <schema_element> как отдельное событие. Таким образом, триггер DDL, созданный для события CREATE_SCHEMA и для события, представленного данными <schema_element> определения CREATE SCHEMA, может дважды вернуть одни и те же сведения о событии (например, данные TSQLCommand). Допустим, для событий CREATE_SCHEMA и CREATE_TABLE создан триггер DDL и выполняется следующий пакет: CREATE SCHEMA s CREATE TABLE t1 (col1 int) Если приложение запрашивает данные TSQLCommand о событии CREATE_TABLE, следует учитывать, что эти данные могут появиться дважды: при возникновении события CREATE_SCHEMA и при возникновении события CREATE_TABLE. Следует избегать создания триггеров DDL одновременно для событий CREATE_SCHEMA и текста <schema_element> для любых соответствующих определений CREATE SCHEMA, или же в приложение необходимо добавить элемент логики, чтобы одно и то же событие не обрабатывалось дважды.

Пример

Функция EVENTDATA может применяться для создания журнала событий. В следующем примере создается таблица для хранения информации о событиях. После этого для текущей базы данных создается триггер DDL, который при любом событии DDL уровня базы данных заполняет эту таблицу следующими данными:

время формирования события (функция GETDATE);
пользователь базы данных, инициировавший сеанс, во время которого произошло событие (функция CURRENT_USER);
тип события;
инструкция Transact-SQL, вызвавшая данное событие.

Сведения о двух последних элементах регистрируются путем выполнения запроса XQuery для xml-данных, сформированных функцией EVENTDATA.

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

Примечание.
Для получения сведения о событиях в запросе XQuery вместо метода query() рекомендуется использовать метод value(). Метод query() возвращает XML-данные и символы возврата каретки и переноса строки, заэкранированные амперсандом, тогда как в выводе метода value() эти символы не экранируются.

Для получения сведения о событиях в запросе XQuery вместо метода query() рекомендуется использовать метод value(). Метод query() возвращает XML-данные и символы возврата каретки и переноса строки, заэкранированные амперсандом, тогда как в выводе метода value() эти символы не экранируются.

Аналогичный пример триггера DDL предоставляется вместе с образцом базы данных AdventureWorks. Для его получения перейдите в среде SQL Server Management Studio в папку с триггерами базы данных, которая вложена в папку Программирование базы данных AdventureWorks. Щелкните правой кнопкой мыши элемент ddlDatabseTriggerLog и выберите команду Создать сценарий для триггера базы данных. По умолчанию DDL-триггер ddlDatabseTriggerLog заблокирован.

См. также

Основные понятия

Проектирование триггеров DDL

Справка и поддержка

Получение помощи по SQL Server 2005

Журнал изменений

Версия	Журнал
5 декабря 2005 г.	Новое содержимое Добавлено предупреждение о создании триггеров DDL одновременно для событий CREATE_SCHEMA и текстов <schema_element> для соответствующих определений CREATE SCHEMA.