EVENTDATA (Transact-SQL)

van toepassing op:SQL ServerAzure SQL DatabaseAzure SQL Managed Instance

Deze functie retourneert informatie over server- of database-gebeurtenissen. Wanneer een gebeurtenismelding wordt geactiveerd en de opgegeven servicebroker de resultaten ontvangt, EVENTDATA wordt aangeroepen. Een DDL- of aanmeldingstrigger ondersteunt ook intern gebruik van EVENTDATA.

Transact-SQL syntaxis-conventies

Syntaxis

EVENTDATA( )

Opmerkingen

EVENTDATA retourneert alleen gegevens wanneer er rechtstreeks naar een DDL- of aanmeldingstrigger wordt verwezen. EVENTDATA retourneert null als andere routines deze aanroepen, zelfs als een DDL- of aanmeldingstrigger deze routines aanroept.

Gegevens die worden geretourneerd door EVENTDATA , zijn ongeldig na een transactie die

• expliciet aangeroepen EVENTDATA
• impliciet aangeroepen EVENTDATA
• doorvoeringen
• wordt teruggedraaid

Wachtwoorden worden niet weergegeven wanneer CREATE LOGIN of ALTER LOGIN instructies worden uitgevoerd. Dit beschermt de aanmeldingsbeveiliging.

Geretourneerde schema's

EVENTDATA retourneert een waarde van het gegevenstype XML. Standaard wordt de schemadefinitie voor alle gebeurtenissen geïnstalleerd in deze map: <station>:\Program Files\Microsoft SQL Server\nnn\Tools\Binn\schemas\sqlserver\2006\11\events\events.xsd.

De webpagina XML-schema's van Microsoft SQL Server bevat ook het gebeurtenisschema.

Als u het schema voor een bepaalde gebeurtenis wilt extraheren, zoekt u in het schema naar het complexe type EVENT_INSTANCE_<event_type>. Als u bijvoorbeeld het schema voor de DROP_TABLE gebeurtenis wilt extraheren, zoekt u in het schema naar EVENT_INSTANCE_DROP_TABLE.

Voorbeelden

Eén. Query's uitvoeren op gebeurtenisgegevens in een DDL-trigger

In dit voorbeeld wordt een DDL-trigger gemaakt die het maken van nieuwe databasetabellen voorkomt. Gebruik van XQuery op basis van de XML-gegevens die worden gegenereerd door EVENTDATA het vastleggen van de Transact-SQL instructie waarmee de trigger wordt geactiveerd. Zie XQuery Language Reference (SQL Server) voor meer informatie.

USE AdventureWorks2022;  
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  

B. Een logboektabel maken met gebeurtenisgegevens in een DDL-trigger

In dit voorbeeld wordt een tabel gemaakt voor informatieopslag over alle gebeurtenissen op databaseniveau en wordt die tabel gevuld met een DDL-trigger. Het gebruik van XQuery op basis van de XML-gegevens die worden gegenereerd door EVENTDATA het gebeurtenistype en de Transact-SQL-instructie vast te leggen.

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  
--Drop the trigger.  
DROP TRIGGER log  
ON DATABASE;  
GO  
--Drop table ddl_log.  
DROP TABLE ddl_log;  
GO  

Zie ook

De functie EVENTDATA gebruiken
DDL-triggers
Gebeurtenismeldingen
Aanmeldingstriggers