// Referência de erro do Oracle

ORA-04091: tabela está em mutação, o gatilho pode não enxergá-la

Um gatilho em nível de linha (ou uma função que ele chama) consultou ou alterou a tabela que a instrução de disparo está modificando, o que o Oracle proíbe.

Código de erro
ORA-04091
Categoria
PL/SQL
Mensagem de erro
table string.string is mutating, trigger/function may not see it

O que significa

Enquanto uma instrução está alterando uma tabela, suas linhas estão em fluxo, então o Oracle não permite que um gatilho em nível de linha nessa tabela a leia ou modifique. A mensagem completa do 19c é table string.string is mutating, trigger/function may not see it. Gatilhos em nível de instrução e gatilhos compostos não têm essa restrição para as partes em nível de instrução.

Causas comuns

  • A FOR EACH ROW gatilho que executa SELECT COUNT(*) ou UPDATE em sua própria tabela.
  • Uma função chamada pelo gatilho, ou pelo DML em si, que consulta a tabela.
  • Ações de chave estrangeira em cascata que atingem uma tabela com tal gatilho.

Como corrigir

  1. Use o :NEW e :OLD valores em vez de reconsultar a linha.

  2. Mova verificações que precisam da tabela inteira para um gatilho composto: colete ids na seção de linha e consulte a tabela em AFTER STATEMENT.

    CREATE OR REPLACE TRIGGER orders_limit
    FOR INSERT ON orders COMPOUND TRIGGER
      AFTER STATEMENT IS
        l_count NUMBER;
      BEGIN
        SELECT COUNT(*) INTO l_count FROM orders WHERE status = 'OPEN';
        IF l_count > 1000 THEN
          RAISE_APPLICATION_ERROR(-20001, 'Too many open orders');
        END IF;
      END AFTER STATEMENT;
    END;
  3. Ou aplique a regra com uma restrição ou na aplicação em vez de um gatilho.

Erros relacionados

Mais erros de PL/SQL

O código e o texto da mensagem são de Ajuda de erros do Oracle Database. Veja toda a Lista de erros do Oracle ou pesquise todos os erros do banco de dados.

// menos erros, correções mais rápidas

Trabalhe com Oracle no SQLly

Um cliente SQL nativo para macOS, Windows e Linux com IntelliSense que conhece o esquema, proteções para instruções arriscadas e mensagens de erro claras, para o Oracle e os outros bancos de dados que você usa.