TRIGGER_NESTLEVEL (Transact-SQL)

Aplica-se a:SQL ServerBanco de Dados SQL do AzureInstância Gerenciada de SQL do Azure

Retorna o número de disparadores executados para a instrução que acionou o disparador. TRIGGER_NESTLEVEL é usado em disparadores DML e DDL para determinar o nível atual de aninhamento.

Convenções de sintaxe de Transact-SQL

Sintaxe

TRIGGER_NESTLEVEL ( [ object_id ] , [ 'trigger_type' ] , [ 'trigger_event_category' ] )  

Observação

Para exibir a sintaxe do Transact-SQL para o SQL Server 2014 (12.x) e versões anteriores, confira a Documentação das versões anteriores.

Argumentos

object_id
É o ID de objeto de um disparador. Se object_id for especificada, será retornado o número de vezes que o gatilho especificado foi executado para a instrução. Se object_id não for especificada, será retornado o número de vezes que todos os gatilhos foram executados para a instrução.

'trigger_type'
Especifica se deve ser aplicado TRIGGER_NESTLEVEL a disparadores AFTER ou disparadores INSTEAD OF. Especifique AFTER para gatilhos AFTER. Especifique IOT para gatilhos INSTEAD OF. Se trigger_type for especificado, trigger_event_category também deverá ser especificado.

'trigger_event_category'
Especifica se deve ser aplicado TRIGGER_NESTLEVEL a disparadores DML ou DDL. Especifique DML para gatilhos DML. Especifique DDL para gatilhos DDL. Se trigger_event_category for especificado, trigger_type também deverá ser especificado. Observe que apenas AFTER pode ser especificado com DDL, porque gatilhos DDL apenas podem ser gatilhos AFTER.

Comentários

Quando nenhum parâmetro for especificado, TRIGGER_NESTLEVEL retornará o número total de disparadores na pilha de chamada. Isto inclui ele próprio. Pode ocorrer omissão de parâmetros quando um disparador executar comandos que causem o acionamento de outro disparador ou criar uma sucessão de disparadores de acionamento.

Para retornar o número total de gatilhos na pilha de chamadas para um tipo de gatilho e uma categoria de evento específicos, especifique object_id = 0.

TRIGGER_NESTLEVEL retornará 0 se for executado fora de um disparador e quaisquer parâmetros não forem NULL.

Quando quaisquer parâmetros forem especificados explicitamente como NULL, um valor NULL será retornado independentemente do fato de TRIGGER_NESTLEVEL ser usado interna ou externamente a um disparador.

Exemplos

a. Testando o nível de aninhamento de um gatilho DML específico

IF ( (SELECT TRIGGER_NESTLEVEL( OBJECT_ID('xyz') , 'AFTER' , 'DML' ) ) > 5 )  
   RAISERROR('Trigger xyz nested more than 5 levels.',16,-1)  

B. Testando o nível de aninhamento de um gatilho DDL específico

IF ( ( SELECT TRIGGER_NESTLEVEL ( ( SELECT object_id FROM sys.triggers  
WHERE name = 'abc' ), 'AFTER' , 'DDL' ) ) > 5 )  
   RAISERROR ('Trigger abc nested more than 5 levels.',16,-1)  

C. Testando o nível de aninhamento de todos os gatilhos executados

IF ( (SELECT trigger_nestlevel() ) > 5 )  
   RAISERROR  
      ('This statement nested over 5 levels of triggers.',16,-1)  

Consulte Também

CREATE TRIGGER (Transact-SQL)