Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
Se aplica a:
SQL ServerAzure SQL DatabaseInstancia administrada de Azure SQLBase de datos SQL en Microsoft Fabric
La información acerca de un evento que activa un desencadenador DDL se captura mediante la función EVENTDATA. Esta función devuelve un valor xml . El esquema XML incluye información acerca de lo siguiente:
La hora del evento.
Identificador de sesión (SPID) de la conexión cuando se ejecutó el desencadenador.
El tipo de evento que ha activado el desencadenador.
Según el tipo de evento, el esquema incluye información adicional, como la base de datos en la que se produjo el evento, el objeto en el que se produjo el evento y la instrucción Transact-SQL del evento. Para más información, consulte DDL Triggers.
Por ejemplo, el siguiente desencadenador DDL se crea en la base de datos de ejemplo AdventureWorks2025 :
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
;
Se ejecutará la siguiente instrucción CREATE TABLE :
CREATE TABLE NewTable (Column1 int);
La instrucción EVENTDATA() del desencadenador DDL captura el texto de la instrucción CREATE TABLE que no se admite. Esto se logra mediante el uso de una instrucción XQuery con los datos xml generados por EVENTDATA y recuperando el elemento <CommandText>. Para obtener más información, consulte Referencia del lenguaje XQuery (SQL Server).
Precaución
EVENTDATA captura los datos de CREATE_SCHEMA eventos así como la <schema_element> de la definición correspondiente CREATE SCHEMA , si es que existe alguna. Además, EVENTDATA reconoce la definición de <schema_element> como un evento independiente. Por lo tanto, un disparador DDL creado tanto en un evento CREATE_SCHEMA como en un evento representado por el <schema_element de la CREATE SCHEMA definición puede devolver los mismos datos de evento dos veces, como los TSQLCommand datos.> Por ejemplo, considere un desencadenador DDL creado en los eventos CREATE_SCHEMA y CREATE_TABLE, y que se ejecute el siguiente lote:
CREATE SCHEMA s
CREATE TABLE t1 (col1 int)
Si la aplicación recupera los datos de TSQLCommand del evento CREATE_TABLE, tenga en cuenta que estos datos pueden aparecer dos veces: una vez cuando tiene lugar el evento CREATE_SCHEMA, y otra cuando tiene lugar el evento CREATE_TABLE. Evita crear triggers DDL tanto en los eventos CREATE_SCHEMA como en los <textos schema_element> de definiciones correspondientes CREATE SCHEMA , o integra lógica en tu aplicación para que el mismo evento no se procese dos veces.
ALTER TABLE y ALTER DATABASE Eventos
Los datos de evento para los eventos ALTER_TABLE y ALTER_DATABASE también incluyen los nombres y los tipos de otros objetos afectados por la instrucción DDL y la acción realizada en estos objetos. Los datos de ALTER_TABLE evento incluyen los nombres de las columnas, restricciones o disparadores afectados por la ALTER TABLE sentencia y la acción (crear, alterar, eliminar, habilitar o desactivar) realizada sobre los objetos afectados. Los datos de ALTER_DATABASE evento incluyen los nombres de cualquier archivo o grupo de archivos afectado por la ALTER DATABASE instrucción y la acción (crear, modificar o eliminar) realizada sobre los objetos afectados.
Por ejemplo, cree el siguiente desencadenador DDL en la base de datos de ejemplo AdventureWorks:
CREATE TRIGGER ColumnChanges
ON DATABASE
FOR ALTER_TABLE
AS
-- Detect whether a column was created/altered/dropped.
SELECT EVENTDATA().value('(/EVENT_INSTANCE/TSQLCommand/CommandText)[1]', 'nvarchar(max)')
RAISERROR ('Table schema cannot be modified in this database.', 16, 1);
ROLLBACK;
Luego ejecuta la siguiente ALTER TABLE sentencia que viola una restricción:
ALTER TABLE Person.Address ALTER COLUMN ModifiedDate date;
La instrucción EVENTDATA() del desencadenador DDL captura el texto de la instrucción ALTER TABLE que no se permite.
Ejemplo
Puede utilizar la función EVENTDATA para crear un registro de eventos. En el siguiente ejemplo, una tabla se crea para almacenar la información del evento. A continuación, se crea un desencadenador DDL en la base de datos actual que rellena la tabla con la siguiente información siempre que tiene lugar un evento DDL en la base de datos:
La hora del evento (mediante la función GETDATE).
El usuario de la base de datos contra cuya sesión se ha producido el evento (mediante la función CURRENT_USER).
El tipo de evento.
La instrucción Transact-SQL que consta del evento.
Una vez más, los dos últimos elementos se capturan mediante XQuery con los datos xml generados por EVENTDATA.
USE AdventureWorks2022;
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
Nota:
Cuando quiera devolver datos de evento, se recomienda usar el método XQuery value() en vez del método query() . El método query() devuelve XML e instancias de retorno de carro y avance de línea (CRLF) con el carácter de escape Y comercial en el resultado, mientras que el método value() representa instancias de CRLF invisibles en el resultado.
Un ejemplo de desencadenador DDL parecido se proporciona con la base de datos de ejemplo AdventureWorks2025 . Para obtener el ejemplo, localice la carpeta Database Triggers mediante SQL Server Management Studio. Esta carpeta se encuentra bajo la carpeta de Programabilidad de la base de datos AdventureWorks2025. Haga clic con el botón derecho en ddlDatabaseTriggerLog y seleccione Script Database Trigger as (desencadenador de base de datos de script como). De forma predeterminada, el desencadenador DDL ddlDatabaseTriggerLog está deshabilitado.