CREATE RULE

Descrição

O comando CREATE RULE cria uma regra a ser aplicada à tabela ou visão especificada. O comando CREATE OR REPLACE RULE cria uma regra, ou substitui uma regra existente com o mesmo nome para a mesma tabela.

O sistema de regras do PostgreSQL permite definir uma ação alternativa a ser realizada nas inserções, atualizações ou exclusões em tabelas do banco de dados. Grosso modo, uma regra faz com que sejam executados comandos adicionais quando é executado um determinado comando em uma determinada tabela. Como alternativa, a regra INSTEAD pode substituir um determinado comando por outro, ou até mesmo fazer com que o comando não seja executado. [1] [2] [3] As regras também são utilizadas para implementar as visões das tabelas. É importante perceber que a regra é, na realidade, um mecanismo de transformação de comando, ou uma macro de comando. A transformação acontece antes do início da execução do comando. Se, na verdade, for desejada uma operação que dispare de forma independente para cada linha física, provavelmente o que se deseja é um gatilho, e não uma regra. Podem ser obtidas mais informações sobre o sistema de regras no Capítulo 35.

Atualmente as regras ON SELECT devem ser regras INSTEAD incondicionais, e devem possuir ações consistindo de um único comando SELECT. Portanto, uma regra ON SELECT na verdade transforma a tabela em uma visão, cujo conteúdo visível são as linhas retornadas pelo comando SELECT da regra, em vez do que está armazenado na tabela (se houver alguma coisa). É considerado um estilo melhor usar o comando CREATE VIEW, em vez de criar uma tabela real e definir uma regra ON SELECT para a mesma.

É possível criar a ilusão de uma visão atualizável definindo regras ON INSERT, ON UPDATE e ON DELETE, ou qualquer subconjunto destas que seja suficiente para as finalidades desejadas, para substituir as ações de atualização na visão por atualizações apropriadas em outras tabelas. Se for desejado dar suporte a INSERT RETURNING, e assim por diante, então deverá ser colocada uma cláusula RETURNING adequada em cada uma destas regras.

Existe algo a ser lembrado quando se tenta utilizar regras condicionais para atualização de visões: é obrigatório haver uma regra incondicional INSTEAD para cada ação que se deseja permitir na visão. Se a regra for condicional, ou não for INSTEAD, então o sistema continuará a rejeitar as tentativas de realizar a ação de atualização, porque acha que poderá acabar tentando realizar a ação sobre a tabela fictícia da visão em alguns casos. Caso se deseje tratar todos os casos úteis por meio de regras condicionais, deverá ser adicionada uma regra incondicional DO INSTEAD NOTHING para garantir que o sistema sabe que nunca será chamado para atualizar a tabela fictícia. Depois torne as regras condicionais não-INSTEAD; nos casos onde se aplicam, serão adicionadas à ação padrão INSTEAD NOTHING (Entretanto, no momento este método não dá suporte a comandos RETURNING).

Parâmetros

Dentro da condição e do comando podem ser utilizados os nomes especiais de tabela NEW e OLD, para fazer referência aos valores na tabela referenciada. NEW é válido nas regras ON INSERT e ON UPDATE, para fazer referência à nova linha sendo inserida ou atualizada. OLD é válido nas regras ON UPDATE e ON DELETE, para fazer referência à linha existente sendo atualizada ou excluída.

Observações

É necessário ser o dono da tabela para criar ou alterar regras para a mesma.

Em uma regra para INSERT, UPDATE ou DELETE em uma visão pode ser adicionada a cláusula RETURNING que emite as colunas da visão. Esta cláusula será utilizada para computar as saídas se a regra for disparada por um comando INSERT RETURNING, UPDATE RETURNING ou DELETE RETURNING, respectivamente. Quando a regra é disparada por um comando sem RETURNING, a cláusula RETURNING da regra é ignorada. A implementação corrente permite que apenas as regras incondicionais INSTEAD contenham RETURNING; além disso, pode haver no máximo uma cláusula RETURNING entre todas as regras para o mesmo evento (Isto garante que existe apenas uma cláusula RETURNING candidata a ser utilizada para computar os resultados). Os comandos RETURNING para a visão serão rejeitados se não houver nenhuma cláusula RETURNING em alguma regra disponível.

É muito importante tomar cuidado para evitar regras circulares. Por exemplo, embora as duas definições de regra abaixo sejam aceitas pelo PostgreSQL, o comando SELECT faz com que o PostgreSQL relate um erro, por causa da expansão recursiva da regra:

CREATE RULE "_RETURN" AS
    ON SELECT TO t1
    DO INSTEAD
        SELECT * FROM t2;

CREATE RULE "_RETURN" AS
    ON SELECT TO t2
    DO INSTEAD
        SELECT * FROM t1;

SELECT * FROM t1;

Atualmente se a ação da regra contiver um comando NOTIFY, este comando NOTIFY será executado incondicionalmente, ou seja, o NOTIFY será emitido mesmo não havendo nenhuma linha onde a regra se aplique. Por exemplo, em

CREATE RULE me_notifique AS ON UPDATE TO minha_tabela DO ALSO NOTIFY minha_tabela;

UPDATE minha_tabela SET nome = 'foo' WHERE id = 42;

será enviado um evento NOTIFY durante o UPDATE, haja ou não alguma linha que corresponda à condição id = 42. Esta é uma restrição da implementação que deverá estar corrigida em versões futuras.

Compatibilidade

O comando CREATE RULE é uma extensão do PostgreSQL à linguagem, assim como todo o sistema de reescrita de comandos.