DROP EVENT NOTIFICATION (Transact-SQL)

Remove um gatilho de notificação de eventos do banco de dados atual.

Ícone de vínculo de tópicoConvenções de sintaxe Transact-SQL

Sintaxe

DROP EVENT NOTIFICATION notification_name [ ,...n ]
ON { SERVER | DATABASE | QUEUE queue_name }
[ ; ]

Argumentos

  • notification_name
    É o nome da notificação de eventos a ser removida. Podem ser especificadas várias notificações de eventos. Para consultar uma lista de notificações de eventos atualmente criadas, use sys.event_notifications (Transact-SQL).

  • SERVER
    Indica que o escopo da notificação de eventos se aplica ao servidor atual. SERVER deverá ser especificado se ele foi especificado quando a notificação de eventos foi criada.

  • DATABASE
    Indica que o escopo da notificação de eventos se aplica ao banco de dados atual. DATABASE deverá ser especificado se ele foi especificado quando a notificação de eventos foi criada.

  • QUEUE queue_name
    Indica que o escopo da notificação de eventos se aplica à fila especificada por queue_name. QUEUE deverá ser especificado se ele foi especificado quando a notificação de eventos foi criada. queue_name é o nome da fila e também deve ser especificado.

Comentários

Se uma notificação de eventos for acionada em uma transação e for descartada na mesma transação, a instância da notificação de eventos será enviada e depois descartada.

Permissões

Para descartar uma notificação de eventos cujo escopo seja o nível do banco de dados, no mínimo, o usuário deverá ser o proprietário da notificação de eventos ou ter permissão ALTER ANY DATABASE EVENT NOTIFICATION no banco de dados atual.

Para descartar uma notificação de eventos cujo escopo seja o nível do servidor, no mínimo, o usuário deverá ser o proprietário da notificação de eventos ou ter permissão ALTER ANY DATABASE EVENT NOTIFICATION no servidor.

Para descartar uma notificação de eventos em uma fila específica, no mínimo, o usuário deverá ser o proprietário da notificação de eventos ou ter permissão ALTER na fila pai.

Exemplos

O exemplo a seguir cria uma notificação de eventos com escopo no banco de dados e depois a descarta:

USE AdventureWorks;
GO
CREATE EVENT NOTIFICATION NotifyALTER_T1
ON DATABASE
FOR ALTER_TABLE
TO SERVICE 'NotifyService',
    '8140a771-3c4b-4479-8ac0-81008ab17984';
GO
DROP EVENT NOTIFICATION NotifyALTER_T1
ON DATABASE;