TRIGGER_NESTLEVEL (Transact-SQL)
Aplica-se a: 
SQL Server Banco de Dados SQL do Azure Instâ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' ] )
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)