VastbaseG100

基于openGauss内核开发的企业级关系型数据库。

Menu

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的表进行多表更新。相关内容请参考UPDATE多表更新

语法格式

UPDATE [ ONLY ] table_name [ @dblink_name ] [ partition_clause ] [ * ] [ [ AS ] alias ]
    SET {column_name = { expression | DEFAULT } |
          ( column_name [, ...] ) = {( { expression | DEFAULT } [, ...] ) |sub_query }
          }[, ...]
    [ FROM from_list] [ WHERE condition | WHERE CURRENT OF cursor_name ]
    [ RETURNING {* | {output_expression [ [ AS ] output_name ]} [, ...] }];
  • 其中sub_query是可选项:

    SELECT [ ALL | DISTINCT [ ON ( expression [, ...] ) ] ]
    { * | {expression [ [ AS ] output_name ]} [, ...] }
    [ FROM from_item [, ...] ]
    [ WHERE condition ]
    [ GROUP BY grouping_element [, ...] ]
    [ HAVING condition [, ...] ]
    
  • 其中partition_clause是可选项:

    'partition_clause'选项仅在集中式模式下可用。

    PARTITION { ( partition_name ) | FOR ( partition_value [, ...] ) } |
    SUBPARTITION { ( subpartition_name ) | FOR ( subpartition_value [, ...] ) }
    

参数说明

  • table_name

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

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

  • partition_clause

    指定分区更新操作。

    PARTITION { ( partition_name ) | FOR ( partition_value [, ...] ) } |
    SUBPARTITION { ( subpartition_name ) | FOR ( subpartition_value [, ...] ) }
    

    关键字详见SELECT一节介绍。

    示例详见CREATE TABLE SUBPARTITION的示例

  • alias

    目标表的别名。

    取值范围:字符串,符合标识符命名规范。

  • 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),可能导致非预期的结果。

  • output_expression

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

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

  • output_name

    字段的返回名称。

示例

1、创建表student1。

CREATE TABLE student1
(
   stuno     int,
   classno   int 
);

2、插入数据。

INSERT INTO student1 VALUES(1,1);
INSERT INTO student1 VALUES(2,2);
INSERT INTO student1 VALUES(3,3);

3、查看数据。

SELECT * FROM student1;

查询结果显示为:

 stuno | classno
-------+---------
     1 |       1
     2 |       2
     3 |       3
(3 rows)

4、直接更新所有记录的值。

UPDATE student1 SET classno = classno*2;

5、查看数据。

SELECT * FROM student1;

查询结果显示为:

 stuno | classno
-------+---------
     1 |       2
     2 |       4
     3 |       6
(3 rows)

6、删除表。

DROP TABLE student1;