# CREATE RULE
#### 功能描述
定义一个重写规则。
#### 注意事项
- 仅表的拥有者可以在表上创建及修改规则。
- 如果在同一个表创建了多个相同类型的规则，则按规则的名称字母顺序排序进行规则触发。
- 在视图上用于INSERT、UPDATE、DELETE的规则中可以添加RETURNING子句基于视图的字段返回。如果规则被INSERT RETURNING、UPDATE RETURNING、DELETE RETURNING命令触发，这些子句将用来计算输出结果。如果规则被不带RETURNING的命令触发，那么规则的RETURNING子句将被忽略。目前仅允许无条件的INSTEAD规则包含RETURNING子句，而且在同一个事件内的所有规则中最多只能有一个RETURNING子句。这样就确保只有一个RETURNING子句可以用于计算结果。如果在任何有效规则中都不存在RETURNING子句，该视图上的RETURNING查询将被拒绝。
- ON SELECT规则必须是无条件的INSTEAD SELECT规则，并且必须有一个由一条单独SELECT查询组成的动作。ON SELECT规则后指定的规则名必须为"_RETURN"。
- 在规则的动作命令中如果使用FOR UPDATE或FOR SHARE等锁定子句时，不会对OLD和NEW特殊变量加锁（OLD和NEW的介绍请参见[CREATE TRIGGER](https://support.huaweicloud.com/centralized-ref-v10-gaussdb/gaussdb-38-0287.html)），具体行为如下：
  - 对于不指定表名的锁定子句（如SELECT ... FOR UPDATE）：自动跳过OLD和NEW特殊变量，仅对FROM子句中的实际表加锁，并提示已经跳过对OLD和NEW加锁的警告信息。
  
  - 对于显式指定OLD和NEW特殊变量名的锁定子句（如SELECT ... FOR UPDATE OF *OLD*）：会产生报错，提示"relation not found in FROM clause"。
   
 
#### 语法格式
```
CREATE [ OR REPLACE ] RULE name AS ON event
    TO table_name [ WHERE condition ]
    DO [ ALSO | INSTEAD ] { NOTHING | command | ( command [; command] [...] ) };
```
其中event包含以下几种：
```
SELECT
INSERT
DELETE
UPDATE
```
#### 参数说明
- **name**
  创建的规则名，同一个表上的所有规则名字需满足唯一约束。
  取值范围：字符串，要符合[标识符命名规范](https://support.huaweicloud.com/centralized-ref-v10-gaussdb/gaussdb-38-0003.html#ZH-CN_TOPIC_0000002793779057__section1257443811315)且最大长度不超过63个字符。
  
- **event**
  SELECT、INSERT、UPDATE、DELETE事件之一。
  
- **table_name**
  规则作用的表或者视图，可以使用模式进行具体指定。
  
- **condition**
  返回布尔值的SQL条件表达式，决定是否实际执行规则。
  表达式除了引用NEW和OLD之外不能引用任何表，并且不能含有聚集函数。不建议使用INT等数值类型作为condition，因为INT等数值类型可以隐式转换为布尔值（非0值隐式转换为true，0转换为false），可能导致非预期的结果。
  
- **INSTEAD**
  使用该命令替换初始事件。
  
- **ALSO**
  该命令应该在初始事件执行之后执行。如果既没有声明ALSO，也没有声明INSTEAD，默认为ALSO。
  
- **command**
  组成规则动作的命令。有效的命令包括：SELECT、INSERT、UPDATE以及DELETE语句。
  
 
#### 示例
```
--创建表tbl_rule1和tbl_rule2用于创建RULE。
gaussdb=# CREATE TABLE tbl_rule1(c1 int,c2 int,c3 int, c4 int);
gaussdb=# CREATE TABLE tbl_rule2(c1 int,c2 int);
--创建规则rule_test，ALSO指定命令在初始事件执行之后在执行。
gaussdb=# CREATE RULE rule_test AS 
    ON INSERT TO tbl_rule1 
    DO ALSO INSERT INTO tbl_rule2 VALUES (new.c1, new.c2);
--向tbl_rule1插入数据，并查看两张表的数据。
gaussdb=# INSERT INTO tbl_rule1 VALUES(1,11,111,1111), (2,22,222,2222);
gaussdb=# SELECT * FROM tbl_rule1;
 c1 | c2 | c3  |  c4  
----+----+-----+------
  1 | 11 | 111 | 1111
  2 | 22 | 222 | 2222
(2 rows)
gaussdb=# SELECT * FROM tbl_rule2;
 c1 | c2 
----+----
  1 | 11
  2 | 22
(2 rows)
--删除规则。
gaussdb=# DROP RULE rule_test ON tbl_rule1;
--删除表。
gaussdb=# DROP TABLE tbl_rule1;
gaussdb=# DROP TABLE tbl_rule2;
```
