CREATE TRIGGER

Descrição

O comando CREATE TRIGGER cria um gatilho. O gatilho fica associado à tabela especificada e executa a função especificada nome_da_função quando ocorrem determinados eventos. [1] [2] [3]

O gatilho pode ser especificado para disparar antes de tentar realizar a operação na linha (antes das restrições serem verificadas e o comando INSERT, UPDATE ou DELETE ser tentado), ou após a operação estar completa (após as restrições serem verificadas e o comando INSERT, UPDATE ou DELETE ter completado). Se o gatilho for disparado antes do evento, o gatilho pode fazer com que a operação não seja realizada para a linha corrente, ou pode modificar a linha sendo inserida (para as operações de INSERT e UPDATE somente). Se o gatilho for disparado após o evento, todas as mudanças, incluindo a última inserção, atualização ou exclusão, estarão "visíveis" para o gatilho.

Um gatilho que está marcado FOR EACH ROW é chamado uma vez para cada linha que a operação modifica. Por exemplo, um comando DELETE afetando 10 linhas faz com que todos os gatilhos ON DELETE da relação de destino sejam chamados 10 vezes, uma vez para cada linha excluída. Diferentemente, um gatilho que está marcado FOR EACH STATEMENT somente executa uma vez para uma determinada operação, não importando quantas linhas sejam modificadas; em particular, uma operação que não modifica nenhuma linha ainda assim resulta na execução de todos os gatilhos FOR EACH STATEMENT aplicáveis.

Se existirem vários gatilhos do mesmo tipo definidos para o mesmo evento, estes serão disparados na ordem alfabética de seus nomes. [4] [5] [6]

O SELECT não modifica nenhuma linha e, portanto, não é possível criar gatilhos para SELECT. Neste caso as regras e visões são mais apropriadas.

Para obter mais informações sobre gatilhos deve ser consultado o Capítulo 32.

Parâmetros

Observações

Para poder criar um gatilho em uma tabela, o usuário deve possuir o privilégio TRIGGER na tabela.

Nas versões do PostgreSQL anteriores a 7.3 era necessário declarar as funções dos gatilhos como retornando o tipo guardador de lugar opaque, em vez de trigger. Para permitir a carga de cópias de segurança antigas (dump), o comando CREATE TRIGGER aceita funções declaradas como retornando opaque, mas mostra uma mensagem e muda o tipo de dado retornado declarado pela função para trigger.

Para remover um gatilho deve ser utilizado o comando DROP TRIGGER.

Exemplos

A Seção 32.4 contém um exemplo completo.

Compatibilidade

O comando CREATE TRIGGER do PostgreSQL implementa um subconjunto do padrão SQL:1999 (O padrão SQL-92 não trata de gatilhos). As seguintes funcionalidades estão faltando:

• O padrão SQL:1999 permite aos gatilhos disparar devido a atualização de colunas específicas (por exemplo, AFTER UPDATE OF col1, col2).

• O padrão SQL:1999 permite definir outros nomes (aliases) para as linhas e tabelas "OLD" e "NEW" a serem utilizados na definição da ação do gatilho (por exemplo, CREATE TRIGGER ... ON nome_da_tabela REFERENCING OLD ROW AS algum_nome NEW ROW AS outro_nome ...). Uma vez que o PostgreSQL permite que os procedimentos dos gatilhos sejam escritos em qualquer uma das linguagens definidas pelo usuário, o acesso aos dados é tratado na forma específica da linguagem.

• O PostgreSQL somente permite para a ação do gatilho a execução de uma função definida pelo usuário. O padrão SQL:1999 permite para a ação do gatilho a execução de vários outros comandos SQL, como CREATE TABLE. Esta limitação é fácil de ser superada: basta criar uma função definida pelo usuário para executar os comandos desejados.

O SQL:1999 especifica que gatilhos múltiplos devem ser disparados na ordem da data de criação. O PostgreSQL usa a ordem dos nomes, que foi julgada ser mais conveniente.

A capacidade de especificar várias ações para um único gatilho utilizando OR é uma extensão do PostgreSQL ao padrão SQL.

Consulte também