CREATE EVENT NOTIFICATION (Transact-SQL)

Artículo
05/15/2023

Se aplica a: SQL Server Azure SQL Managed Instance

Crea un objeto que envía información sobre un evento de servidor o base de datos para un servicio de Service Broker. Las notificaciones de eventos solo se pueden crear mediante instrucciones Transact-SQL.

Convenciones de sintaxis de Transact-SQL

Sintaxis

CREATE EVENT NOTIFICATION event_notification_name   
ON { SERVER | DATABASE | QUEUE queue_name }   
[ WITH FAN_IN ]  
FOR { event_type | event_group } [ ,...n ]  
TO SERVICE 'broker_service' , { 'broker_instance_specifier' | 'current database' }  
[ ; ]

Argumentos

event_notification_name
Es el nombre de la notificación de eventos. El nombre de una notificación de eventos debe cumplir las reglas para identificadores y debe ser único dentro del ámbito en el que se creó: SERVER, DATABASE u object_name.

SERVER
Aplica el ámbito de la notificación de eventos a la instancia actual de SQL Server. Si se especifica, la notificación se activa cada vez que el evento especificado en la cláusula FOR se produce en cualquier lugar de la instancia de SQL Server.

Nota

Esta opción no está disponible en las bases de datos independientes.

DATABASE
Aplica el ámbito de la notificación de eventos a la base de datos actual. Si se especifica, la notificación se activa cada vez que el evento especificado en la cláusula FOR se produce en la base de datos actual.

QUEUE
Aplica el ámbito de la notificación a la cola especificada en la base de datos actual. Se puede especificar QUEUE solo si también se especifica FOR QUEUE_ACTIVATION o FOR BROKER_QUEUE_DISABLED.

queue_name
Es el nombre de la cola a la que se aplica la notificación de eventos. Solo se puede especificar queue_name si se ha establecido QUEUE.

WITH FAN_IN
Indica a SQL Server que solo envíe un mensaje por evento a un servicio especificado para todas las notificaciones de eventos que:

Se crean en el mismo evento.
Son creadas por la misma entidad de seguridad (identificada por el mismo SID).
Especifica el mismo servicio y broker_instance_specifier.
Especifique WITH FAN_IN.

Por ejemplo, se crean tres notificaciones de evento. Todas las notificaciones de evento especifican FOR ALTER_TABLE, WITH FAN_IN, la misma cláusula TO SERVICE y se crean con el mismo SID. Cuando se ejecuta una instrucción ALTER TABLE, los mensajes que crean estas tres notificaciones de evento se mezclan en uno solo. Por tanto, el servicio de destino recibe un solo mensaje del evento.

event_type
Es el nombre del tipo de evento que ejecuta la notificación de eventos. event_type puede ser un tipo de evento DDL de Transact-SQL, un tipo de evento de Seguimiento de SQL o un tipo de evento de Service Broker. Para obtener una lista de tipos de eventos DDL de Transact-SQL posibles, vea Eventos DDL. Los tipos de evento de Service Broker son QUEUE_ACTIVATION y BROKER_QUEUE_DISABLED. Para más información, consulte Event Notifications.

event_group
Es el nombre de un grupo predefinido de tipos de evento de Transact-SQL o de Seguimiento de SQL. Se puede activar una notificación de eventos tras la ejecución de cualquier evento que pertenece a un grupo de eventos. Para obtener una lista de grupos de eventos DDL, los eventos de Transact-SQL que cubren y el ámbito en el que se pueden definir, vea Grupos de eventos DDL.

event_group también actúa como una macro, cuando finaliza la instrucción CREATE EVENT NOTIFICATION, al agregar los tipos de evento que cubre a la vista de catálogo sys.events.

' broker_service '
Especifica el servicio de destino que recibe los datos de instancia de evento. SQL Server abre una o más conversaciones al servicio de destino para la notificación de eventos. Este servicio debe respetar el mismo contrato y tipo de mensaje de eventos de SQL Server que se utilizan en el envío del mensaje.

Las conversaciones permanecen abiertas hasta que se quita la notificación de eventos. Algunos errores pueden hacer que las conversaciones se cierren antes. Es posible que la finalización de algunas o todas las conversaciones explícitamente evite que el servicio de destino reciba más mensajes.

{ 'broker_instance_specifier' | 'current database' }
Especifica una instancia de Service Broker en la que se resuelve broker_service. Se puede adquirir el valor de un Service Broker específico al realizar una consulta en la columna service_broker_guid de la vista de catálogo sys.databases. Utilice 'current database' para especificar la instancia de Service Broker en la base de datos actual. 'current database' es un literal de cadena que no distingue mayúsculas de minúsculas.

Nota

Esta opción no está disponible en las bases de datos independientes.

Observaciones

Service Broker incluye un tipo de mensaje y un contrato específicos para notificaciones de evento. Por lo tanto, no se debe crear un servicio de inicio de Service Broker debido a que ya existe uno que especifica el nombre de contrato siguiente: https://schemas.microsoft.com/SQL/Notifications/PostEventNotification.

El servicio de destino que recibe notificaciones de eventos debe respetar este contrato preexistente.

Importante

Service Broker se debe configurar para las notificaciones de eventos que envíen mensajes a un Service Broker en un servidor remoto. La seguridad del diálogo debe configurarse manualmente según el modelo de seguridad completa. Para obtener más información, consulte Configurar la seguridad de diálogo para notificaciones de eventos.

Si se revierte una transacción de evento que activa una notificación, también se revierte el envío de la notificación de eventos. Las notificaciones de eventos no son activadas por una acción definida en un desencadenador cuando se confirma o revierte la transacción en el desencadenador. Dado que los eventos de seguimiento no están enlazados mediante transacciones, se envían las notificaciones de eventos basadas en los eventos de seguimiento, independientemente de si se revierte la transacción que los activa.

Si se interrumpe la conversación entre el servidor y el servicio de destino tras la activación de una notificación de eventos, se informa un error y se quita la notificación de eventos.

Tanto si se envía la notificación de eventos como si no, la notificación de eventos que originalmente inició la notificación no se ve afectada.

Se guarda un registro de cualquier error en el envío de una notificación de eventos.

Permisos

Para crear una notificación de eventos en el ámbito de la base de datos (ON DATABASE), se requiere el permiso CREATE DATABASE DDL EVENT NOTIFICATION en la base de datos actual.

Para crear una notificación de eventos en una instrucción DDL incluida en el ámbito del servidor (ON SERVER), se requiere el permiso CREATE DDL EVENT NOTIFICATION en el servidor.

Para crear una notificación de eventos en un evento de seguimiento, se requiere el permiso CREATE TRACE EVENT NOTIFICATION en el servidor.

Para crear una notificación de eventos en el ámbito de una cola, se requiere el permiso ALTER en la cola.

Ejemplos

Nota:

En los ejemplos A y B siguientes, el GUID de la cláusula TO SERVICE 'NotifyService' (8140a771-3c4b-4479-8ac0-81008ab17984') es específico para el equipo en el que se configuró el ejemplo. Para esa instancia, ese era el GUID para la base de datos AdventureWorks2022.

Para copiar y ejecutar estos ejemplos, necesita reemplazar este GUID por uno de su equipo y su instancia de SQL Server. Tal como se ha explicado en la sección Argumentos anterior, puede adquirir el 'broker_instance_specifier' consultando la columna de service_broker_guid de la vista de catálogo sys.databases.

A. Crear una notificación de eventos en el ámbito de un servidor

En el ejemplo siguiente se crean los objetos necesarios para configurar un servicio de destino utilizando Service Broker. El servicio de destino hace referencia al contrato y tipo de mensaje del servicio de inicio específicamente para notificaciones de eventos. Después, se crea una notificación de eventos en el servicio de destino que envía una notificación cada vez que tiene lugar un evento de seguimiento Object_Created en la instancia de SQL Server.

--Create a queue to receive messages.  
CREATE QUEUE NotifyQueue ;  
GO  

--Create a service on the queue that references  
--the event notifications contract.  
CREATE SERVICE NotifyService  
ON QUEUE NotifyQueue  
([https://schemas.microsoft.com/SQL/Notifications/PostEventNotification]);  
GO  

--Create a route on the service to define the address   
--to which Service Broker sends messages for the service.  
CREATE ROUTE NotifyRoute  
WITH SERVICE_NAME = 'NotifyService',  
ADDRESS = 'LOCAL';  
GO 

--Create the event notification.  
CREATE EVENT NOTIFICATION log_ddl1   
ON SERVER   
FOR Object_Created   
TO SERVICE 'NotifyService',  
    '8140a771-3c4b-4479-8ac0-81008ab17984' ;

B. Crear una notificación de eventos en el ámbito de una base de datos

El ejemplo siguiente crea una notificación de eventos en el mismo servicio de destino que el ejemplo anterior. La notificación de eventos se activa después de un evento ALTER_TABLE en la base de datos de ejemplo AdventureWorks2022.

CREATE EVENT NOTIFICATION Notify_ALTER_T1  
ON DATABASE  
FOR ALTER_TABLE  
TO SERVICE 'NotifyService',  
    '8140a771-3c4b-4479-8ac0-81008ab17984';

C. Obtener información sobre una notificación de eventos en el ámbito de un servidor

El ejemplo siguiente realiza una consulta en la vista de catálogo sys.server_event_notifications respecto de metadatos sobre la notificación de eventos log_ddl1 creada en el ámbito de un servidor.

SELECT * FROM sys.server_event_notifications  
WHERE name = 'log_ddl1';

D. Obtener información sobre una notificación de eventos en el ámbito de una base de datos

El ejemplo siguiente realiza una consulta en la vista de catálogo sys.event_notifications respecto de metadatos sobre la notificación de eventos Notify_ALTER_T1 creada en el ámbito de una base de datos.

SELECT * FROM sys.event_notifications  
WHERE name = 'Notify_ALTER_T1';

Consulte también

Notificaciones de eventos
DROP EVENT NOTIFICATION (Transact-SQL)
EVENTDATA (Transact-SQL)
sys.event_notifications (Transact-SQL)
sys.server_event_notifications (Transact-SQL)
sys.events (Transact-SQL)
sys.server_events (Transact-SQL)

Compartir a través de