UPDATE

功能描述

更新表中的数据。UPDATE修改满足条件的所有行中指定的字段值，WHERE子句声明条件，SET子句指定的字段会被修改，没有出现的字段则保持它们的原值。

注意事项

• 表的所有者、拥有表UPDATE权限的用户或拥有UPDATE ANY TABLE权限的用户，有权更新表中的数据，系统管理员默认拥有此权限。
• 对expression或condition条件里涉及到的任何表要有SELECT权限。
• 对于列存表，暂时不支持RETURNING子句。
• 列存表不支持结果不确定的更新(non-deterministic update)。试图对列存表用多行数据更新一行时会报错。
• 列存表的更新操作，旧记录空间不会回收，需要执行VACUUM FULL table_name进行清理。
• 对于列存复制表，暂不支持UPDATE操作。
• 生成列不能被直接写入。在UPDATE命令中不能为生成列指定值，但是可以指定关键字DEFAULT。
• 对于多表更新语法，仅在参数sql_compatibility=B时生效，暂时不支持对列存表、视图和含有RULE的表进行多表更新。

语法格式

单表更新：
[ WITH [ RECURSIVE ] with_query [, ...] ]
UPDATE [/*+ plan_hint */] [ ONLY ] table_name [ partition_clause ] [ * ] [ [ AS ] alias ]
SET {column_name = { expression | DEFAULT } 
    |( column_name [, ...] ) = {( { expression | DEFAULT } [, ...] ) |sub_query }}[, ...]
    [ FROM from_list] [ WHERE condition ]
    [ ORDER BY {expression [ [ ASC | DESC | USING operator ]
    [ LIMIT { count } ]
    [ RETURNING {* 
                | {output_expression [ [ AS ] output_name ]} [, ...] }];
多表更新：
[ WITH [ RECURSIVE ] with_query [, ...] ]
UPDATE [/*+ plan_hint */] table_list
SET {column_name = { expression | DEFAULT } 
    |( column_name [, ...] ) = {( { expression | DEFAULT } [, ...] ) |sub_query }}[, ...]
    [ FROM from_list] [ WHERE condition ];
where sub_query can be:
SELECT [ ALL | DISTINCT [ ON ( expression [, ...] ) ] ]
{ * | {expression [ [ AS ] output_name ]} [, ...] }
[ FROM from_item [, ...] ]
[ WHERE condition ]
[ GROUP BY grouping_element [, ...] ]
[ HAVING condition [, ...] ]
[ ORDER BY {expression [ [ ASC | DESC | USING operator ] | nlssort_expression_clause ] [ NULLS { FIRST | LAST } ]} [, ...] ]
[ LIMIT { [offset,] count | ALL } ]

参数说明

• plan_hint子句

  以/*+ */的形式在UPDATE关键字后，用于对UPDATE对应的语句块生成的计划进行hint调优，详细用法请参见章节使用Plan Hint进行调优。每条语句中只有第一个/*+ plan_hint */注释块会作为hint生效，里面可以写多条hint。

• table_name

  要更新的表名，可以使用模式修饰。

  取值范围：已存在的表名称。

• partition_clause

  指定分区更新操作

  PARTITION { ( partition_name ) | FOR ( partition_value [, …] ) } |

  SUBPARTITION { ( subpartition_name ) | FOR ( subpartition_value [, …] ) }

  关键字详见SELECT一节介绍

• alias

  目标表的别名。

  取值范围：字符串，符合标识符命名规范。

• table_list

  一个表的表达式列表，与from_list类似，但可以同时声明目标表和关联表，仅在参数sql_compatibility=B时生效。

• column_name

  要修改的字段名。

  支持使用目标表的别名加字段名来引用这个字段。例如：

  UPDATE foo AS f SET f.col_name = ‘namecol’;

  取值范围：已存在的字段名。

• expression

  赋给字段的值或表达式。

• DEFAULT

  用对应字段的缺省值填充该字段。

  如果没有缺省值，则为NULL。

• sub_query

  子查询。

  使用同一数据库里其他表的信息来更新一个表可以使用子查询的方法。其中SELECT子句具体介绍请参考SELECT。

  在update单列时，支持使用order by子句与limit子句；而在update多列时，则不支持使用order by子句与limit子句。

• from_list

  一个表的表达式列表，允许在WHERE条件里使用其他表的字段。与在一个SELECT语句的FROM子句里声明表列表类似。

  须知：

  目标表绝对不能出现在from_list里，除非在使用一个自连接（此时它必须以from_list的别名出现）。

• condition

  一个返回Boolean类型结果的表达式。只有这个表达式返回true的行才会被更新。不建议使用int等数值类型作为condition，因为int等数值类型可以隐式转换为bool值（非0值隐式转换为true，0转换为false），可能导致非预期的结果。

• ORDER BY子句

  关键字详见SELECT一节介绍。

• LIMIT子句

  关键字详见SELECT一节介绍。

• output_expression

  在所有需要更新的行都被更新之后，UPDATE命令用于计算返回值的表达式。

  取值范围：使用任何table以及FROM中列出的表的字段。*表示返回所有字段。

• output_name

  字段的返回名称。

示例

--创建表student1。
openGauss=# CREATE TABLE student1
(
   stuno     int,
   classno   int 
);
--插入数据。
openGauss=# INSERT INTO student1 VALUES(1,1);
openGauss=# INSERT INTO student1 VALUES(2,2);
openGauss=# INSERT INTO student1 VALUES(3,3);
--查看数据。
openGauss=# SELECT * FROM student1;
--直接更新所有记录的值。
openGauss=# UPDATE student1 SET classno = classno*2;
--查看数据。
openGauss=# SELECT * FROM student1;
--删除表。
openGauss=# DROP TABLE student1;