quarta-feira, 15 de dezembro de 2010

Trigger Oracle

Triggers são procedimentos que podem ser gravados em Java, PL/SQL ou C. São executados (ou disparados) implicitamente quando uma tabela é modificada, um objeto é criado ou ocorrem algumas ações de usuário ou de sistema de banco de dados.

As triggers são similares as stored procedures diferindo, apenas, na maneira como são chamadas. A trigger é executada implicitamente quando ocorre algum evento de trigger enquanto a stored procedure deve ser executado explicitamente.

Uma trigger é composta por quatro partes:

- Momento
- Evento
- Tipo
- Corpo

O momento define quando uma trigger irá ser acionada. Pode ser:

- BEFORE (tabela)
- AFTER (tabela)
- INSTEAD OF (view)

BEFORE indica que os comandos PL/SQL do corpo da trigger serão executados ANTES dos dados da tabela serem alterados. Normalmente usamos BEFORE nos casos em que precisamos incializar variáveis globais, validar regras de negócios, alterar o valor de flags ou para salvar o valor de uma coluna antes de alterarmos o valor delas. Exemplo:

CREATE OR REPLACE TRIGGER novo_func
	BEFORE...
.
.
.
END;
/

AFTER indica que os comando PL/SQL do corpo da trigger será executado APÓS os dados da tabela serem alterados. Normalmente usamos AFTER para completar os dados de outras tabelas e para completar a atividade de outra trigger de momento BEFORE. Exemplo:

CREATE OR REPLACE TRIGGER novo_func
	AFTER...
.
.
.
END;
/

INSTEAD OF indica que a trigger irá ser executada no lugar da instrução que disparou a trigger. Literalmente, a instrução é substituída pela trigger. Essa técnica permite que façamos, por exemplo, alterações em uma tabela através de uma view. É usado nos casos em que a view não pode alterar uma tabela por não referenciar uma coluna com a constraint not null. Nesse caso a trigger pode atualizar a coluna que a view não tem acesso.

Dois detalhes muito importantes sobre INSTEAD OF:

- Só funcionam com views e
- É sempre de linha. Será considerado assim, mesmo que "FOR EACH ROW" for omitido.

Exemplo:

CREATE OR REPLACE TRIGGER novo_func
	INSTEAD OF INSERT ON vemp
FOR EACH ROW
WHEN ...
.
.
.
END;
/

O evento define qual é a instrução DML que aciona a trigger. Informa qual instrução SQL irá disparar a trigger. Pode ser:

- INSERT
- UPDATE
- DELETE

Quando o evento for um UPDATE podemos informar quais colunas que, ao serem alteradas, irão disparar a trigger. O mesmo NÃO ocorre com INSERT e DELETE porque essas instruções sempre afetam a linha por inteiro. Exemplo:

CREATE OR REPLACE TRIGGER novo_func
	AFTER INSERT ON emp
.
.
.
END;
/

O evento pode conter uma, duas ou todas as três operações DML em uma única linha de comando. Exemplo:

CREATE OR REPLACE TRIGGER novo_func
	BEFORE INSERT OR UPDATE OR DELETE ON emp
.
.
.
END;
/

O tipo define quantas vezes uma trigger será executa. A trigger pode ser executada uma vez para a instrução que a disparou ou ser disparada para cada linha afetada pela instrução que disparou a trigger. Pode ser:

- Instrução (STATEMENT)
- Linha (ROW)

Quando a trigger for do tipo instrução ela será disparada uma vez para cada evento de trigger, mesmo que nenhuma linha tenha sido afetada. São úteis para aquelas trigger que eventualmente não alteram dados ou para situações onde o que queremos é uma resposta da trigger, por exemplo, em uma restrição complexa de negócio. Por DEFAULT toda trigger é deste tipo. Exemplo:

CREATE OR REPLACE TRIGGER novo_func
	BEFORE INSERT OR UPDATE OR DELETE ON emp
	FOR EACH STATEMENT
.
.
.
END;
/

Quando a trigger for do tipo linha, a trigger será executada toda vez que a tabela for afetada pelo evento da trigger. Se nenhuma linha for afetada a trigger não será executada. São muito úteis quando a ação da trigger depende dos dados afetados pelo evento da trigger. Exemplo:

CREATE OR REPLACE TRIGGER novo_func
	BEFORE INSERT OR UPDATE OR DELETE ON emp
	FOR EACH ROW
.
.
.
END;
/

O corpo define a ação que uma trigger irá executar quando acionada. O corpo de uma trigger é composto por um bloco PL/SQL, a chamada de uma PROCEDURE ou por um procedimento JAVA. Por definição, o tamanho de uma trigger não pode ultrapassar 32K.

Como, normalmente, precisamos trabalhar com os valores antes e depois da alteração dos dados, a trigger permite que façamos referencia aos valores antes da alteração (OLD) e após a alteração (NEW).

O nome de uma trigger deve ser único dentro de um mesmo esquema, e sua sintaxe básica é:

CREATE [OR REPLACE] TRIGGER [schema.] nome_da_trigger
       [BEFORE|AFTER]
       [DELETE|OR INSERT|OR UPDATE[OF coluna]]
       ON [schema.] nome_da_tabela_ou_da_view
       [REFERENCING [OLD [AS] OLD] [NEW [AS] NEW]
       [FOR EACH ROW]
       [WHEN [condição]]
BLOCO PL/SQL

Onde:

Nome_da_trigger é o nome da trigger;

Nome_da_tabela_ou_da_view indica a tabela ou view associada com a trigger;

Corpo_da_trigger é a ação que a trigger irá executar. Inicia por DECLARE ou BEGIN e termina por END. Também pode conter a chamada de um procedimento.

O uso do nome da coluna na cláusula UPDATE pode aumentar a performance porque a trigger só será disparada quando aquela coluna especificada na cláusula for alterada.

Agora que sabemos como criar uma trigger veremos um exemplo completo:

Primeiro vamos criar uma tabela para gravar um registro de todos os usuários que se conectaram ao banco:

CREATE TABLE vigia
   (marca VARCHAR2(100));
              
CREATE OR REPLACE TRIGGER marca_logon
   AFTER LOGON ON DATABASE
BEGIN
  INSERT INTO sys.vigia
    VALUES (USER || ' entrou no sistema em ' ||
            TO_CHAR(sysdate, 'DD-MM-YYYY HH24:MI:SS'));
  COMMIT;
END;
/

Pronto, temos nossa primeira trigger. Ela registra o nome do usuário e a que horas ele entrou. Esse exemplo foi retirado diretamente da documentação Oracle. No nosso exemplo fazemos referencia a um evento do sistema ao invés de referenciarmos uma tabela. Outros eventos do sistema são:

- AFTER SERVERERROR
- AFTER LOGON
- BEFORE LOGOFF
- AFTER STARTUP
- BEFORE SHUTDOWN

Você pode criar triggers usando os eventos acima para DATABASE e SCHEMA. As duas exceções são SHUTDOWN e STARTUP que só se aplicam a DATABASE. Exemplo:

CREATE OR REPLACE TRIGGER marca_logoff
   BEFORE LOGOFF ON SCHEMA
BEGIN
  INSERT INTO sys.vigia
    VALUES (USER || ' saiu do sistema em ' ||
            TO_CHAR(sysdate, 'DD-MM-YYYY HH24:MI:SS'));
  COMMIT;
END;
/

Eventualmente podemos ter algum tipo de erro em nossa trigger. Para verificar quais são os erros de compilação que temos na trigger basta usar o comando SHOW ERRORS TRIGGER nome_da_trigger. Caso você queira ver os erros de compilação da última trigger que você compilou pode escrever apenas SHOW ERRORS ou SHO ERR. Ao executarmos esse comando ele mostrará a linha onde está o erro. Atenção: caso a linha onde está o erro se estenda por mais de uma linha, este comando indicará o início da linha. Vamos criar uma trigger com erro para servir como exemplo:

CREATE OR REPLACE TRIGGER marca_logon
   AFTER LOGON ON DATABASE
BEGIN
  INSERT INTO sys.vigia
    VALUES (USER || ' entrou no sistema em ' ||
            TO_CHAR(sysdate, 'DD-MM-YYYY HH24:MI:SS));
  COMMIT;
END;
/

Gatilho criado com erro de compilação

Qual é o erro desse gatilho? É um erro bem banal, no caso deixamos de fechar a apóstrofe (ou aspas simples ou quote) no final da instrução TO_CHAR. Ao executarmos o SHOW ERROR ele irá mostrar que houve um erro na linha 4. Isso porque ele aponta onde a linha que contem o erro começou a ser escrita e não a linha onde efetivamente ocorreu o erro está.

Caso precise de mais informações sobre sua trigger, a view USER_TRIGGERS pode fornecer informações muito úteis. Exemplo:

SELECT trigger_name
  FROM user_triggers;

Com o nome da trigger que você deseja analisar execute o comando:

SELECT trigger_type, table_name, triggering_event
  FROM user_triggers
 WHERE trigger_name = 'nome_da_trigger';

Ou, se precisar obter o código usado para gerar a trigger:

SELECT trigger_name, trigger_type, triggering_event,
  table_name, referencing_names,
  status, trigger_body
  FROM user_triggers
 WHERE trigger_name = 'nome_da_trigger';

Caso descubra que não precisa mais da trigger existe duas formas de tratar a situação. Eliminar a trigger ou desabilitá-la.

Eliminando a trigger:

DROP TRIGGER nome_da_trigger;

Caso prefira apenas desabilitar a trigger use o comando:

ALTER TRIGGER nome_da_trigger DISABLE; 

Quando a trigger é criada pela primeira vez ela é habilitada automaticamente. Para habilitar a trigger novamente basta usar o comando:

ALTER TRIGGER nome_da_trigger ENABLE; 

Mas vamos continuar criando nossas triggers. O próximo caso vai nos ajudar a impedir que alguém cadastre um funcionário fora do horário de expediente:

CREATE TABLE nova_emp 
    AS SELECT * FROM SCOTT.EMP;

CREATE OR REPLACE TRIGGER hora_exp
 BEFORE INSERT ON nova_emp
 BEGIN
    IF (TO_CHAR(sysdate,'DY') IN ('SAB','DOM')) OR
       (TO_CHAR(sysdate,'HH24:MI')
               NOT BETWEEN '08:30' AND '17:30')
     THEN RAISE_APPLICATION_ERROR (-20500,'Você só pode
               atualizar os empregados no horário de 
               expediente');
    END IF;
END;
/

Essa trigger pode ser refinada para testar os predicados condicionais. Por exemplo:

CREATE OR REPLACE TRIGGER hora_exp
 BEFORE INSERT OR UPDATE OR DELETE ON nova_emp
 BEGIN
    IF (TO_CHAR(sysdate,'DY') IN ('SAB','DOM')) OR
       (TO_CHAR(sysdate,'HH24:MI')
               NOT BETWEEN '08:30' AND '17:30')
     THEN
        IF DELETING THEN
           RAISE_APPLICATION_ERROR (-20500,'Você só pode
               excluir empregados no horário de expediente');
        ELSIF INSERTING THEN
           RAISE_APPLICATION_ERROR (-20502,'Você só pode
               incluir empregados no horário de expediente');
        ELSIF UPDATING ('SAL') THEN
           RAISE_APPLICATION_ERROR (-20504,'Você só pode
               alterar salarios no horário de expediente');
        ELSE
           RAISE_APPLICATION_ERROR (-20506,'Você só pode
               Fazer alterações no horário de expediente');
        END IF;
    END IF;
END;
/ 

Vamos ver como usar valores OLD e NEW:

Primeiro vamos criar uma tabela para conter os dados do nosso histórico.

CREATE TABLE DDUR
(USUARIO 	VARCHAR2(15),
 HORARIO 	DATE,
 EMPNO	NUMBER(4),
 ENAME    VARCHAR2(10),
 JOB      VARCHAR2(9),
 MGR      NUMBER(4),
 HIREDATE DATE,
 SAL      NUMBER(7,2),
 COMM     NUMBER(7,2),
 DEPTNO   NUMBER(2))
/

Agora vamos criar nossa trigger. Ela deve registrar tudo o que fizermos em nossa tabela.

CREATE OR REPLACE TRIGGER hist_emp
 AFTER INSERT OR UPDATE OR DELETE ON nova_emp
 FOR EACH ROW
 BEGIN
   INSERT INTO ddur VALUES(
          user, sysdate, :OLD.empno, :OLD.ename, :OLD.job,
          :OLD.mgr, :OLD.hiredate, :OLD.sal, :OLD.comm, :OLD.deptno);
END;
/

A referência :OLD indica que estamos usando os valores antes da alteração. Caso quiséssemos usar o valor atualizado a referencia seria :NEW. Ambas podem ser usadas na mesma trigger. Por exemplo, nossa trigger poderia ter sido escrita assim:

CREATE OR REPLACE TRIGGER hist_emp
 AFTER INSERT OR UPDATE OR DELETE ON nova_emp
 FOR EACH ROW
 BEGIN
   INSERT INTO ddur VALUES(
          user, sysdate, :NEW.empno, :NEW.ename, :OLD.JOB,
          :NEW.MGR, :OLD.HIREDATE, :OLD.sal, :OLD.comm, :OLD.deptno);
END;
/

Você pode usar :OLD e :NEW em comparações dentro da sua trigger, montando estruturas PL/SQL cada vez mais complexas. Por exemplo:

CREATE OR REPLACE TRIGGER aumento
       BEFORE UPDATE OF sal ON emp
       FOR EACH ROW
BEGIN
     IF (:NEW.sal - :OLD.sal) < :OLD.sal * 0.025
     THEN
         RAISE_APPLICATION_ERROR (-20512, 'Favor corrigir indice');
      END IF;
END;

No caso acima, se o aumento de salário for inferior a 2,5% o sistema avisa que houve um erro na alteração salarial. Em um outro exemplo, mas agora com WHEN

CREATE OR REPLACE TRIGGER ver_sal
       BEFORE INSERT OR UPDATE OF sal, job
       ON empl
       FOR EACH ROW
       WHEN (NEW.job_id <> 'PRESIDENT')
DECLARE
       v_minsal emp.sal%TYPE;
       v_maxsal emp.sal%TYPE;
BEGIN
       SELECT MIN(sal), MAX(sal)
         INTO v_minsal, v_maxsal
         FROM emp
        WHERE job = :NEW.job;
       IF :NEW.sal < v_min OR
          :NEW.sal > v_maxsal THEN
          RAISE_APPLICATION_ERROR(-20515,'Salario inválido');
       END IF;
END;
/

UPDATE emp
   SET sal = 3400
 WHERE ename = 'BLAKE';

Neste caso estamos garantido que ninguém que for contratado com o cargo diferente de PRESIDENT irá receber um salário menor que o menor salário de seu cargo ou um salário maior que o maior salário de seu cargo.

Uma trigger pode ser bem mais simples do que os exemplos acima. Por exemplo, se quisermos implementar uma restrição onde o salário do funcionário nunca possa ser reduzido, basta aplicarmos a trigger:

CREATE OR REPLACE TRIGGER veri_sal
       BEFORE UPDATE OF sal ON emp
       FOR EACH ROW
       WHEN (NEW.sal < OLD.sal)
BEGIN
     RAISE_APPLICATION_ERROR (-20508,
'O salário não pode ser reduzido');
END;
/

Para que um usuário crie suas próprias triggers ele precisa ter o privilégio de sistema CREATE TRIGGER e ser o proprietário da tabela onde irá criar a trigger. Caso não seja proprietário ele deve ter o privilégio de sistema ALTER ou ALTER ANY TABLE. Caso precise criar triggers para eventos do banco de dados deve ter o privilégio de ADMINISTER DATABASE TRIGGER. Caso a trigger faça chamada de alguma procedure, quem estiver criando a trigger deve ter o privilégio de EXECUTE na procedure.

Como podemos notar as trigger podem ser usadas de forma bem flexível. Com elas podemos gerar mecanismos de segurança mais flexíveis, auditar dados de tabelas e implementar regras de negócios com mais facilidade.

Fonte: http://www.linhadecodigo.com.br/artigo/322/oracletrigger.aspx

Nenhum comentário :

Postar um comentário

Related Posts Plugin for WordPress, Blogger...