CREATE RULE

説明

The semantics of a rule is that at the time an individual instance is accessed, updated, inserted or deleted, there is a current instance (for retrieves, updates and deletes) and a new instance (for updates and appends). If the event specified in the ON clause and the condition specified in the WHERE clause are true for the current instance, the action part of the rule is executed. First, however, values from fields in the current instance and/or the new instance are substituted for current.attribute-name and new.attribute-name.

ルールの語義は個別のインスタンスがアクセスされ、更新され 挿入され、または削除される場合、(抽出、更新そして削除の対象となる) 指定したインスタンスと、(更新と追加の対象となる)新しいインスタンスが 存在すると言うことです。ON 句で指定された event と WHERE 句で指定された condition がともに指定したインスタンスに対して真の場合、 ルールの action 部 が実行されます。しかしながら、第一点として、指定したインスタンス とそして/または新しいインスタンスのフィールドの値が current.attribute-name と new.attribute-name で入れ換えられます。

The action part of the rule executes with the same command and transaction identifier as the user command that caused activation.

ルールの action 部は 駆動のもととなったユーザコマンドと同じコマンドとトランザクション 識別子により実行されます。

ON UPDATE TO emp.salary WHERE emp.name = "Joe"
    DO UPDATE emp ( ... ) WHERE ...
    

ON UPDATE TO emp-1.salary WHERE emp-2.name = "Joe"
    DO UPDATE emp-3 ( ... ) WHERE ...
    

CREATE RULE bad_rule_combination_1 AS
    ON SELECT TO emp
    DO INSTEAD SELECT TO toyemp;
     

CREATE RULE bad_rule_combination_2 AS
    ON SELECT TO toyemp
    DO INSTEAD SELECT TO emp;
     

SELECT * FROM emp;
      

使用法

Make Sam get the same salary adjustment as Joe:

Sam が Joe と同じ給与調整を受けるとします：

CREATE RULE example_1 AS
    ON UPDATE emp.salary WHERE current.name = "Joe"
    DO UPDATE emp (salary = new.salary)
    WHERE emp.name = "Sam";
   

Make Bill get Joe's salary when it is accessed:

アクセスした時 Bill が Joe の給与を見れるようにします：

CREATE RULE example_2 AS
    ON SELECT TO EMP.salary
    WHERE current.name = "Bill"
    DO INSTEAD
    SELECT (emp.salary) from emp
        WHERE emp.name = "Joe";
   

Deny Joe access to the salary of employees in the shoe department (current_user returns the name of the current user):

靴部門の従業員の給与に Joe がアクセスできないようにします： (current_user は指定したユーザの名前を 返します。)

  
CREATE RULE example_3 AS
    ON SELECT TO emp.salary
    WHERE current.dept = "shoe" AND current_user = "Joe"
    DO INSTEAD NOTHING;
   

Create a view of the employees working in the toy department.

玩具部門で働いている従業員のビューを作成します：

CREATE toyemp(name = char16, salary = int4);

CREATE RULE example_4 AS
    ON SELECT TO toyemp
    DO INSTEAD
    SELECT (emp.name, emp.salary) FROM emp
        WHERE emp.dept = "toy";
   

All new employees must make 5,000 or less

全ての新規従業員の給与は 5,000 またはそれ以下とします：

CREATE RULE example_5 AS
    ON INERT TO emp WHERE new.salary > 5000
    DO UPDATE NEWSET salary = 5000;
   

バグ情報

The object in a SQL rule cannot be an array reference and cannot have parameters.

SQL ルールにおけるオブジェクトは配列参照 ではなくパラメータを持つことが出来ません。

Aside from the "oid" field, system attributes cannot be referenced anywhere in a rule. Among other things, this means that functions of instances (e.g., "foo(emp)" where "emp" is a class) cannot be called anywhere in a rule.

"oid" フィールドは別として、システム属性はルール中 どこにも参照されてはなりません。ほかの項目の中で、これは インスタンスの関数(例えば、 "emp" が クラスの場合の "foo(emp)")がルールの 中でどこにも呼ばれては行けないことを意味しています。

The rule system stores the rule text and query plans as text attributes. This implies that creation of rules may fail if the rule plus its various internal representations exceed some value that is on the order of one page (8KB).

ルールシステムはルール原文と問合せプランを text 型の属性 として記憶します。このことは、ルールの作成はそのルールと その各種の内部表現形式が一ページ分 (8KB) に類似したあたり のある値を越えると失敗する可能性があること暗示しています。

互換性

CREATE RULE statement is a Postgres language extension.

CREATE RULE 文は Postgres 拡張言語です。