Compartilhar via


DISABLE TRIGGER (Transact-SQL)

Desabilita um gatilho.

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

Sintaxe

DISABLE TRIGGER { [ schema_name . ] trigger_name [ ,...n ] | ALL }
ON { object_name | DATABASE | ALL SERVER } [ ; ]

Argumentos

  • schema_name
    É o nome do esquema ao qual o gatilho pertence. schema_name não pode ser especificado para gatilhos DDL ou de logon.

  • trigger_name
    É o nome do gatilho a ser desabilitado.

  • ALL
    Indica que todos os gatilhos definidos no escopo da cláusula ON estão desabilitados.

    Observação sobre cuidadosCuidado

    O SQL Server cria gatilhos em bancos de dados que são publicados para replicação de mesclagem. Ao especificar ALL em bancos de dados publicados, esses gatilhos são desabilitados, interrompendo a replicação. Verifique se o banco de dados atual não foi publicado para replicação de mesclagem antes de especificar ALL.

  • object_name
    É o nome da tabela ou exibição na qual o gatilho DML trigger_name foi criado para executar.

  • DATABASE
    Para um gatilho DDL, indica que trigger_name foi criado ou modificado para ser executado com o escopo do banco de dados.

  • ALL SERVER
    Para um gatilho DDL, indica que trigger_name foi criado ou modificado para ser executado com escopo de servidor. ALL SERVER também é aplicado a gatilhos de logon.

Comentários

Os gatilhos são habilitados por padrão ao serem criados. Ao desabilitar um gatilho, você não o descarta. O gatilho ainda existe como um objeto no banco de dados atual. Porém, o gatilho não é acionado quando qualquer instrução Transact-SQL em que ele tenha sido programado é executada. Os gatilhos podem ser reabilitados usando ENABLE TRIGGER. Os gatilhos DML definidos em tabelas também podem ser desabilitados ou habilitados usando ALTER TABLE.

Permissões

Para desabilitar um gatilho DML, no mínimo, um usuário deve ter a permissão ALTER na tabela ou exibição na qual o gatilho foi criado.

Para desabilitar um gatilho DDL definido com escopo de servidor (ON ALL SERVER) ou um gatilho de logon, um usuário deve ter a permissão CONTROL SERVER no servidor. Para desabilitar um gatilho DDL definido com escopo de banco de dados (ON DATABASE), no mínimo, um usuário deve ter a permissão ALTER ANY DATABASE DDL TRIGGER no banco de dados atual.

Exemplos

A. Desabilitando um gatilho DML em uma tabela

O exemplo a seguir desabilita o gatilho uAddress que foi criado na tabela Address.

USE AdventureWorks;
GO
DISABLE TRIGGER Person.uAddress ON Person.Address;
GO

B. Desabilitando um gatilho DDL

O exemplo a seguir cria um gatilho DDL safety com escopo definido no banco de dados e depois desabilita o mesmo.

IF EXISTS (SELECT * FROM sys.triggers
    WHERE parent_class = 0 AND name = 'safety')
DROP TRIGGER safety ON DATABASE;
GO
CREATE TRIGGER safety 
ON DATABASE 
FOR DROP_TABLE, ALTER_TABLE 
AS 
   PRINT 'You must disable Trigger "safety" to drop or alter tables!' 
   ROLLBACK;
GO
DISABLE TRIGGER safety ON DATABASE;
GO

C. Desabilitando todos os gatilhos que foram definidos com o mesmo escopo

O exemplo a seguir desabilita todos os gatilhos DDL que foram criados no escopo do servidor.

USE AdventureWorks;
GO
DISABLE Trigger ALL ON ALL SERVER;
GO