华为云首页用户手册

云数据库 GAUSSDB-INSERT:参数说明

时间：2024-11-02 18:50:36

云数据库 GAUSSDB

参数说明

WITH [ RECURSIVE ] with_query [, ...]
用于声明一个或多个可以在主查询中通过名称引用的子查询，相当于临时表。

如果声明了RECURSIVE，那么允许SELECT子查询通过名称引用它自己。

其中with_query的详细格式为：
```
with_query_name [ ( column_name [, ...] ) ] AS [ [ NOT ] MATERIALIZED ]
( {SELECT | VALUES | INSERT | UPDATE | DELETE} )
```
– with_query_name指定子查询生成的结果集名称，在查询中可使用该名称访问子查询的结果集。

– column_name指定子查询结果集中显示的列名。

– 每个子查询可以是SELECT，VALUES，INSERT，UPDATE或DELETE语句。
– 用户可以使用MATERIALIZED / NOT MATERIALIZED对CTE进行修饰。
- 如果声明为MATERIALIZED，WITH查询将被物化，生成一个子查询结果集的拷贝，在引用处直接查询该拷贝，因此WITH子查询无法和主干SELECT语句进行联合优化（如谓词下推、等价类传递等），对于此类场景可以使用NOT MATERIALIZED进行修饰，如果WITH查询语义上可以作为子查询内联执行，则可以进行上述优化。
- 如果用户没有显示声明物化属性则遵守以下规则：如果CTE只在所属主干语句中被引用一次，且语义上支持内联执行，则会被改写为子查询内联执行，否则以CTE Scan的方式物化执行。
- INSERT ON DUPLICATE KEY UPDATE不支持WITH及WITH RECURSIVE子句。
- INSERT语句的输出，只会显示最外层query block插入的tuple数量。比如：
```
with cte as (insert into t1 values(1) retunring * ) insert into t1 select * from cte;
```
  只会显示插入一条tuple，但实际上插入了两条。
plan_hint子句
以/*+ */的形式在INSERT关键字后，用于对INSERT对应的语句块生成的计划进行hint调优，详细用法请参见章节使用Plan Hint进行调优。每条语句中只有第一个/*+ plan_hint */注释块会作为hint生效，里面可以写多条hint。
table_name
要插入数据的目标表名。

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

支持使用DATABASE LINK方式对远端表进行操作，使用方式详情请见DATABASE LINK。
partition_clause
指定分区插入操作
```
PARTITION { ( partition_name ) | FOR ( partition_value [, ...] ) } |
SUBPARTITION { ( subpartition_name ) | FOR ( subpartition_value [, ...] ) }
```
关键字详见SELECT一节介绍

如果value子句的值和指定分区不一致，会抛出异常。

示例详见CREATE TABLE SUBPARTITION
column_name
目标表中的字段名：
- 字段名可以使用子字段名或者数组下标修饰。
- 没有在字段列表中出现的每个字段，将由系统默认值，或者声明时的默认值填充，若都没有则用NULL填充。例如，向一个复合类型中的某些字段插入数据的话，其他字段将是NULL。
- 目标字段（column_name）可以按顺序排列。如果没有列出任何字段，则默认全部字段，且顺序为表声明时的顺序。
- 如果value子句和query中只提供了N个字段，则目标字段为前N个字段。
- value子句和query提供的值在表中从左到右关联到对应列。
取值范围：已存在的字段名。
expression
赋予对应column的一个有效表达式或值：
- 如果是INSERT ON DUPLICATE KEY UPDATE语句下，expression可以为VALUES(column_name)或EXCLUDED.column_name用来表示引用冲突行对应的column_name字段的值。需注意，其中VALUES(column_name)不支持嵌套在表达式中（例如VALUES(column_name)+1），但EXCLUDED不受此限制。
- 向表中字段插入单引号 " ' "时需要使用单引号自身进行转义。
- 如果插入行的表达式不是正确的数据类型，系统试图进行类型转换，若转换不成功，则插入数据失败，系统返回错误信息。
DEFAULT
对应字段名的缺省值。如果没有缺省值，则为NULL。
query
一个查询语句（SELECT语句），将查询结果作为插入的数据。
RETURNING
返回实际插入的行，RETURNING列表的语法与SELECT的输出列表一致。注意：INSERT ON DUPLICATE KEY UPDATE不支持RETURNING子句。
output_expression
INSERT命令在每一行都被插入之后用于计算输出结果的表达式。

取值范围：该表达式可以使用table的任意字段。可以使用*返回被插入行的所有字段。
output_name
字段的输出名称。

取值范围：字符串，符合标识符命名规范。
ON DUPLICATE KEY UPDATE
对于带有唯一约束（UNIQUE INDEX或PRIMARY KEY）的表，如果插入数据违反唯一约束，则对冲突行执行UPDATE子句完成更新，对于不带唯一约束的表，则仅执行插入。UPDATE时，若指定NOTHING则忽略此条插入，可通过"EXCLUDE." 或者 "VALUES()" 来选择源数据相应的列。
- 支持触发器，触发器执行顺序由实际执行流程决定：
  - 执行insert：触发 before insert、 after insert触发器。
  - 执行update：触发before insert、before update、after update触发器。
  - 执行update nothing：触发before insert触发器。
- 不支持延迟生效（DEFERRABLE）的唯一约束或主键。
- 如果表中存在多个唯一约束，如果所插入数据违反多个唯一约束，对于检测到冲突的第一行进行更新，其他冲突行不更新（检查顺序与索引维护具有强相关性，一般先创建的索引先进行冲突检查）。
- 如果插入多行，这些行均与表中同一行数据存在唯一约束冲突，则按照顺序，第一条执行插入或更新，之后依次执行更新。
- 主键、唯一索引列不允许UPDATE。
- 不支持外表。
- expression不支持使用子查询表达式。