| PostgreSQL 8.3.3문서 | ||||
|---|---|---|---|---|
| Prev | Fast Backward | Fast Forward | Next | |
CREATE [ OR REPLACE ] RULE
name
AS ON
event
TO
table
[ WHERE
condition
]
DO [ ALSO | INSTEAD ] { NOTHING |
command
| (
command
;
command
... ) }
CREATE RULE에 의해, 지정한 테이블 또는 뷰에 적용하는 룰을 새롭게 정의할 수 있습니다. CREATE OR REPLACE RULE를 사용하면, 새로운 룰의 작성, 또는, 동일 테이블의 동일 이름의 기존 룰을 대체할 수 있습니다.
PostgreSQL의 룰 시스템을 사용하면, 데이터베이스 테이블에 대한 삽입, 갱신, 삭제 시에 대체로서 실행하는 액션을 정의할 수 있습니다. 간단하게 말하면, 지정된 테이블에 대해서 지정된 커멘드가 실행되었을 때, 룰에 의해 추가의 커멘드가 실행된다고 하는 것입니다. 그 외에도,INSTEAD룰에 의해 지정된 커멘드를 다른 커멘드로 대체 하거나, 전혀 커멘드를 실행하지 않게 하는 일도 가능합니다. 또, 룰은 테이브르뷰를 실장하기 위해서도 사용됩니다. 중요한 것은, 룰은 실제로 커멘드를 변환하는 매커니즘, 바꾸어 말하면, 커멘드의 매크로인 것입니다. 룰에 의한 변환은 커멘드의 실행전에 발생합니다. 각 물리행을 개별적으로 조작하고 싶은 경우, 룰은 아니고 방아쇠를 사용하는 편이 좋을 것입니다. 룰 시스템에 대한 자세한 것은,Chapter 35에 기재되어 있습니다.
현시점에서는,ON SELECT룰은, 조건을 가지지 않는INSTEAD룰이어야 합니다. 그리고,ON SELECT룰이 가지는 액션은, 단독의SELECT커멘드만으로 구성될 필요가 있습니다. 따라서,ON SELECT룰을 사용하면, 효율적으로 테이블을 뷰로 변환 할 수 있습니다. 이 뷰에서는, 테이블의 내용은 아니고, 룰에 포함되는SELECT커멘드가 반환하는 행이, 뷰의 내용으로서 제시됩니다. 다만, 테이블 작성하여, 거기에 ON SELECT룰을 정의하는 것보다는,CREATE VIEW커멘드를 생성하는 것을 추천합니다.
ON INSERT,ON UPDATE,ON DELETE룰(목적을 충족시키는 것)을 필요에 따라서 정의해, 뷰에 대한 갱신 조작을 다른 테이블에 대한 적절한 갱신 조작에 치환하는 것으로, 갱신 가능한 실재하지 않는 뷰를 작성할 수가 있습니다. INSERT RETURNING등을 지원하고 싶으면, 이러한 룰에 적절한RETURNING구를 확실히 적어 주세요.
뷰의 갱신에 조건부 룰을 사용하려고 하는 경우, 함정이 있습니다. 그 뷰에 허가하는 각각의 조작에, 조건을 가지지 않는INSTEAD룰을 준비할 필요가 있는 일입니다. 룰이 조건부이거나INSTEAD가 아닌 경우, 시스템은 갱신 조작을 거부합니다. 그 경우, 시스템이, 경우에 따라서는, 뷰의 더미 테이블에 대한 조작이 될 가능성이 있다는 것을 간주하기 때문입니다. 사용하는 모든 케이스에 대해 조건부 룰을 작성하는 경우는, 조건을 가지지 않는DO INSTEAD NOTHING룰을 추가해, 더미 테이블에 대한 갱신은 호출되지 않는 것을 시스템에 명시합니다. 게다가 조건부 룰에는,INSTEAD를 지정하지 않게 합니다. 이러한 조건이 충족 되었을 경우, 디폴트의INSTEAD NOTHING액션에 룰에 포함되는 액션이 추가됩니다. (그러나 현재, 이 방법에서는RETURNING쿼리를 지원하는 것이 잘 동작하지 않습니다. )
생성하는 룰의 이름입니다. 이 이름은, 같은 테이블의 다른 룰과는 다른 이름으로 지정해야 합니다. 동일 테이블에 이벤트의 종류가 같은 룰이 다수 있을 경우, 알파벳 이름 순으로 적용됩니다.
이벤트는,SELECT,INSERT,UPDATE,DELETE 중의 하나가 됩니다.
룰을 적용하는 테이블 또는 뷰의 이름(검증을 거친 스키마)입니다.
임의의SQL조건식입니다(boolean형을 반환합니다). 조건식에서는,NEW및OLD이외의 테이블은 참조할 수 없습니다. 또, 집계 함수를 포함할 수 없습니다.
INSTEAD는, 원래의 커멘드의 대신에 이 커멘드가 실행되는 것을 나타냅니다.
ALSO는 원래의 커멘드에 in addition to 추가적인 커멘드가 실행되는 것을 나타냅니다.
ALSO도INSTEAD도 지정되지 않은 경우,ALSO가 디폴트입니다.
룰의 액션을 구성하는 단일 또는 복수의 커멘드입니다. 유효한 커멘드는,SELECT,INSERT,UPDATE,DELETE, 또는 NOTIFY입니다.
condition 와 command 의 내부에서는, 대상으로 하는 테이블의 값을 참조하기 위해서, 특별한 테이블명NEW와OLD를 사용할 수 있습니다. NEW는,ON INSERT와ON UPDATE룰에 유효합니다. 삽입 또는 갱신되는 새로운 행을 참조합니다. OLD는,ON UPDATE와ON DELETE룰에 유효합니다. 갱신 또는 삭제되는 기존의 행을 참조합니다.
룰을 생성 또는 변경하기 위해서는, 테이블의 소유자여야 합니다.
뷰상의INSERT,UPDATE,DELETE룰에서는,RETURNING구를 추가해, 뷰의 열을 돌려줄 수가 있습니다. 룰이 각각의 INSERT RETURNING,UPDATE RETURNING,DELETE RETURNING커멘드에 의해 트리거 됐을 경우, 이 구는 출력을 계산하는 것에 사용됩니다. RETURNING없이 룰이 트리거 되었을 경우, 룰의RETURNING구는 무시됩니다. 현재의 실행에서는, 무조건의INSTEAD룰만이RETURNING를 포함할 수가 있습니다. 게다가 동일 이벤트용의 모든 룰 중 에서 많아야 1개의RETURNING구를 가질 수가 있습니다. (이것에 의해 확실히, 결과를 계산하기 위해서 사용되는RETURNING구의 후보가 1개에만 됩니다. ) 뷰상의RETURNING쿼리는, 이용 가능한 모든 룰에서 RETURNING가 존재하지 않는 경우, 거절됩니다.
순환적인 룰은 피하도록 주의해 주세요. 예를 들면, 아래와 같은 2개의 룰 정의 각각이PostgreSQL에 받아들여졌을 경우, 룰이 재귀적으로 전개되기 때문에,SELECT커멘드가,PostgreSQL에 에러를 표시시킵니다.
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;
현재, 룰의 액션에NOTIFY커멘드가 포함되는 경우,NOTIFY커멘드는 무조건 실행됩니다. 즉, 룰을 적용해야 할 행이 존재하지 않아도,NOTIFY가 발행됩니다. 예를 들면,
CREATE RULE notify_me AS ON UPDATE TO mytable DO ALSO NOTIFY mytable; UPDATE mytable SET name = 'foo' WHERE id = 42;
id = 42라고 하는 조건에 일치하는 행의 유무에 관계없이,UPDATE가 행해지는 동안, 1개의NOTIFY이벤트가 송신됩니다. 이것은 실행상의 제한이며, 장래의 릴리스에서는 수정될지도 모릅니다.