EVENTDATA (Transact-SQL)
S’applique à : SQL Server
Azure SQL Database
Azure SQL Managed Instance
Cette fonction retourne des informations sur les événements de serveur et de base de données. Lorsqu’une notification d’événement est déclenchée et que le Service Broker spécifié reçoit les résultats, EVENTDATA
est appelé. Un déclencheur DDL ou d’ouverture de session prend également en charge l’utilisation interne de EVENTDATA
.
Conventions de la syntaxe Transact-SQL
Syntaxe
EVENTDATA( )
Remarque
Pour afficher la syntaxe Transact-SQL pour SQL Server 2014 (12.x) et versions antérieures, consultez la Documentation sur les versions antérieures.
Notes
EVENTDATA
ne retourne des données que si elles sont référencées directement au sein d’un déclencheur DDL ou d’ouverture de session. EVENTDATA
retourne la valeur Null si d’autres routines l’appellent, même si un déclencheur DDL ou d’ouverture de session appelle ces routines.
Les données retournées par EVENTDATA
ne sont pas valides après une transaction qui :
- a appelé
EVENTDATA
explicitement ; - a appelé
EVENTDATA
implicitement ; - est en validation ;
- est restaurée.
Attention
EVENTDATA
retourne des données XML qui sont envoyées au client au format Unicode, qui utilise 2 octets pour chaque caractère. Le code XML retourné par EVENTDATA
peut représenter ces points de code Unicode :
0x0009
0x000A
0x000D
>= 0x0020 && <= 0xD7FF
>= 0xE000 && <= 0xFFFD
XML ne peut ni exprimer ni autoriser certains caractères susceptibles d’apparaître dans les identificateurs et les données Transact-SQL. Les caractères ou données ayant des points de code non représentés dans la liste précédente sont mappés sur un point d'interrogation (?).
Les mots de passe ne s’affichent pas pendant l’exécution d’instructions CREATE LOGIN
ou ALTER LOGIN
de façon à préserver la sécurité de connexion.
Schémas retournés
EVENTDATA renvoie une valeur dont le type de données est xml. Par défaut, la définition de schéma de tous les événements s’installe dans ce répertoire : C:\Program Files\Microsoft SQL Server\nnn\Tools\Binn\schemas\sqlserver\2006\11\events\events.xsd.
La page web Schémas XML Microsoft SQL Server comporte également le schéma d’événement.
Pour extraire le schéma pour un événement particulier, recherchez dans le schéma le type complexe EVENT_INSTANCE_<event_type>
. Par exemple, pour extraire le schéma de l’événement EVENT_INSTANCE_DROP_TABLE
, recherchez DROP_TABLE
dans le schéma.
Exemples
R. Interrogation des données d'événement dans un déclencheur DDL
Cet exemple crée un déclencheur DDL qui empêche la création de nouvelles tables de base de données. La requête XQuery effectuée sur les données XML générées par EVENTDATA
capture l’instruction Transact-SQL qui active le déclencheur. Voir Informations de référence sur le langage XQuery (SQL Server) pour plus d’informations.
Notes
Lorsque vous utilisez Résultats dans des grilles dans SQL Server Management Studio pour interroger l’élément <TSQLCommand>
, les sauts de ligne n’apparaissent pas dans le texte de la commande. Utilisez plutôt l’option Résultats dans du texte.
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
Notes
Pour retourner des données d’événement, utilisez la méthode XQuery value() plutôt que la méthode query(). La méthode query() renvoie des instances XML et CR/LF (retour chariot/saut de ligne) à séquence d’échappement perluète dans la sortie, tandis que la méthode value() retourne des instances CR/LF invisibles dans la sortie.
B. Création d'une table de journal avec données d'événements dans un déclencheur DDL
Cet exemple crée une table pour stocker des informations sur tous les événements de niveau base de données, et la remplit avec un déclencheur DDL. La requête XQuery effectuée sur les données XML générées par EVENTDATA
capture le type d’événement et l’instruction Transact-SQL.
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
Voir aussi
Utiliser la fonction EVENTDATA
Déclencheurs DDL
Notifications d'événements
Déclencheurs de connexion