文档首页/ 云数据库 GaussDB/ 开发指南（分布式_V2.0-8.x）/ SQL参考/ SQL语法/ I/ INSERT ALL

更新时间：2025-01-20 GMT+08:00

INSERT ALL

功能描述

向多个表中插入一条或多条数据。

注意事项

只有拥有表INSERT权限的用户，才可以向表中插入数据。用户被授予INSERT ANY TABLE权限，即用户对除系统模式之外的任何模式具有USAGE权限，并且拥有这些模式下表的INSERT权限。
如果使用QUERY子句插入来自查询里的数据行，用户还需要拥有在查询里使用的表的SELECT权限。
生成列不能被直接写入。在INSERT命令中不能为生成列指定值，但可以指定关键字DEFAULT。
仅支持在ORA兼容模式下执行该语法。

语法格式

INSERT [/*+ plan_hint */] [ ALL | FIRST ]
    { [ WHEN condition THEN ]
    { INTO table_name
    [ { [alias_name] [ ( column_name [, ...] ) ] } | { [partition_clause] [ AS alias ] 
    [ ( column_name [, ...] ) ] } ]
    [ VALUES {( { expression | DEFAULT } [, ...] ) } ] }[, ...] }[, ...]
    { subquery };

参数说明

plan_hint子句
以/*+ */的形式在INSERT关键字后，目前仅适配了语法格式，并未实现具体功能。
ALL/FIRST
如果不带条件子句（WHEN condition THEN），此关键字不可省略，且只能为ALL。如果含有条件子句，此关键字可以省略，默认为ALL，此时ALL和FIRST的含义分别为：
- ALL：遍历所有匹配条件的分支，只要满足条件就会将数据插入对应的表。
- FIRST：查询到第一个满足条件的分支后，将数据插入该分支对应的表，不再继续检查剩余分支。
WHEN condition THEN
插入表时的条件判断，只有满足条件才会进行插入操作，condition中可以引用子查询（SUBQUERY）中的列。
table_name
要插入数据的目标表名。

取值范围：已存在的表名。
alias_name
INSERT语句不包含AS alias语法时的表别名。
1. INTO子句不包含AS alias语法时的表别名不能为关键字（如SELECT、VALUE）或者表达式，表别名要求符合标识符命名规范。
2. INTO子句不包含AS alias语法时的表别名不支持INTO table_name alias_name(alias_name.col1,...,alias_name.coln) VALUES(xxx);的语法格式。
3. INTO子句的分区表不包含AS alias语法时的表别名不支持指定分区插入操作。
partition_clause
指定分区插入操作。
```
PARTITION { ( partition_name ) | FOR ( partition_value [, ...] ) } |
SUBPARTITION { ( subpartition_name ) | FOR ( subpartition_value [, ...] ) }
```
关键字具体信息请参见SELECT。

如果VALUE子句的值和指定分区不一致，结果会提示异常。
column_name
目标表中的字段名称。
- 字段名可以由子字段名或者数组下标修饰。
- 没有在字段列表中出现的每个字段，将由系统默认值或者声明时的默认值进行填充，若无默认值或未声明时则使用NULL填充。例如，向一个复合类型中的某些字段插入数据，其他字段使用NULL进行填充。
- 目标字段（column_name）按顺序排列。如果没有列出任何字段，则默认全部字段，且顺序为表声明时的顺序。
- 如果VALUE子句和QUERY中只提供了N个字段，则目标字段为前N个字段。
- VALUE子句和QUERY提供的值在表中从左到右关联到对应列。
取值范围：已存在的字段名。
VALUES
不可跟多行。
expression
赋予对应column的一个有效表达式或值。
- 向表中字段插入单引号（'）时需要使用单引号对自身进行转义。
- 如果插入行的表达式不是正确的数据类型，系统将自动进行类型转换，若转换失败，则插入数据失败，系统返回错误信息。
- 不支持聚集函数。
- 不支持子查询。
DEFAULT
对应字段名的缺省值。如果没有缺省值，则为NULL。
subquery
一个查询语句（SELECT语句），将查询结果作为插入的数据，不可省略，如果没有子查询可以使用SELECT * FROM DUAL。

如果子查询带表别名，不可在CONDITION子句和INTO子句中引用该别名。

示例

不带条件的多表插入

示例：

--创建ORA兼容数据库。
gaussdb=# CREATE DATABASE insertall_test_db DBCOMPATIBILITY 'ORA';

--切换至ORA兼容数据库。
gaussdb=# \c insertall_test_db;

--建表。
insertall_test_db=# CREATE TABLE insert_all_test0(c1 INT, c2 VARCHAR2(20));
insertall_test_db=# CREATE TABLE insert_all_test1(c1 INT, c2 VARCHAR2(20));
insertall_test_db=# CREATE TABLE insert_all_test2(c1 INT, c2 VARCHAR2(20));
insertall_test_db=# CREATE TABLE insert_all_test3(c1 INT, c2 VARCHAR2(20));

--构造数据。
insertall_test_db=# INSERT INTO insert_all_test0 VALUES(1,'a'),(2,'b'),(3,'c'),(4,'d'),(5,'e');

--向表中插入数据。
insertall_test_db=# INSERT ALL
insertall_test_db-# INTO insert_all_test1
insertall_test_db-# INTO insert_all_test1 VALUES(1,'a')
insertall_test_db-# INTO insert_all_test1(c1,c2)
insertall_test_db-# INTO insert_all_test1(c1) VALUES(1)
insertall_test_db-# INTO insert_all_test1(c2) VALUES('aaa')
insertall_test_db-# INTO insert_all_test2(c2) VALUES(c2)
insertall_test_db-# INTO insert_all_test2(c2) VALUES(c2||'*')
insertall_test_db-# INTO insert_all_test3(c1,c2) VALUES(1,'a')
insertall_test_db-# INTO insert_all_test3(c1,c2) VALUES(1,c2)
insertall_test_db-# INTO insert_all_test3(c1,c2) VALUES(c1,c2)
insertall_test_db-# INTO insert_all_test3(c2,c1) VALUES('***',666)
insertall_test_db-# SELECT * FROM insert_all_test0;

--查询数据。
insertall_test_db=# SELECT * FROM insert_all_test1 ORDER BY c1,c2;
 c1 | c2  
----+-----
  1 | a
  1 | a
  1 | a
  1 | a
  1 | a
  1 | a
  1 | a
  1 | 
  1 | 
  1 | 
  1 | 
  1 | 
  2 | b
  2 | b
  3 | c
  3 | c
  4 | d
  4 | d
  5 | e
  5 | e
    | aaa
    | aaa
    | aaa
    | aaa
    | aaa
(25 rows)

insertall_test_db=# SELECT * FROM insert_all_test2 ORDER BY c1,c2;
 c1 | c2 
----+----
    | a
    | a*
    | b
    | b*
    | c
    | c*
    | d
    | d*
    | e
    | e*
(10 rows)

insertall_test_db=# SELECT * FROM insert_all_test3 ORDER BY c1,c2;
 c1  | c2  
-----+-----
   1 | a
   1 | a
   1 | a
   1 | a
   1 | a
   1 | a
   1 | a
   1 | b
   1 | c
   1 | d
   1 | e
   2 | b
   3 | c
   4 | d
   5 | e
 666 | ***
 666 | ***
 666 | ***
 666 | ***
 666 | ***
(20 rows)

--删除表。
insertall_test_db=# DROP TABLE insert_all_test0;
insertall_test_db=# DROP TABLE insert_all_test1;
insertall_test_db=# DROP TABLE insert_all_test2;
insertall_test_db=# DROP TABLE insert_all_test3;

insertall_test_db=# \c postgres;
gaussdb=# DROP DATABASE insertall_test_db;

带条件的多表插入

示例1：INSERT FIRST

--创建ORA兼容数据库。
gaussdb=# CREATE DATABASE insertall_test_db DBCOMPATIBILITY 'ORA';

--切换至ORA兼容数据库。
gaussdb=# \c insertall_test_db;

--建表。
insertall_test_db=# CREATE TABLE insert_all_test0(c1 int, c2 VARCHAR2(20));
insertall_test_db=# CREATE TABLE insert_all_test1(c1 int, c2 VARCHAR2(20));
insertall_test_db=# CREATE TABLE insert_all_test2(c1 int, c2 VARCHAR2(20));
insertall_test_db=# CREATE TABLE insert_all_test3(c1 int, c2 VARCHAR2(20));

--构造数据。
insertall_test_db=# INSERT INTO insert_all_test0 VALUES(1,'a'),(2,'b'),(3,'c'),(4,'d'),(5,'e');
--向表中插入数据。
insertall_test_db=# INSERT FIRST
insertall_test_db-# WHEN c1 < 4 THEN
insertall_test_db-# INTO insert_all_test1
insertall_test_db-# WHEN c1 < 3 THEN
insertall_test_db-# INTO insert_all_test2
insertall_test_db-# ELSE
insertall_test_db-# INTO insert_all_test3
insertall_test_db-# SELECT * FROM insert_all_test0;

--查询数据。
insertall_test_db=# SELECT * FROM insert_all_test1 ORDER BY c1,c2;
 c1 | c2 
----+----
  1 | a
  2 | b
  3 | c
(3 rows)

insertall_test_db=# SELECT * FROM insert_all_test2 ORDER BY c1,c2;
 c1 | c2 
----+----
(0 rows)

insertall_test_db=# SELECT * FROM insert_all_test3 ORDER BY c1,c2;
 c1 | c2 
----+----
  4 | d
  5 | e
(2 rows)

--删除表。
insertall_test_db=# DROP TABLE insert_all_test0;
insertall_test_db=# DROP TABLE insert_all_test1;
insertall_test_db=# DROP TABLE insert_all_test2;
insertall_test_db=# DROP TABLE insert_all_test3;

insertall_test_db=# \c postgres;
gaussdb=# DROP DATABASE insertall_test_db;

示例2：INSERT ALL

--创建ORA兼容数据库。
gaussdb=# CREATE DATABASE insertall_test_db DBCOMPATIBILITY 'ORA';

--切换至ORA兼容数据库。
gaussdb=# \c insertall_test_db;

--建表。
insertall_test_db=# CREATE TABLE insert_all_test0(c1 int, c2 VARCHAR2(20));
insertall_test_db=# CREATE TABLE insert_all_test1(c1 int, c2 VARCHAR2(20));
insertall_test_db=# CREATE TABLE insert_all_test2(c1 int, c2 VARCHAR2(20));
insertall_test_db=# CREATE TABLE insert_all_test3(c1 int, c2 VARCHAR2(20));

--构造数据。
insertall_test_db=# INSERT INTO insert_all_test0 VALUES(1,'a'),(2,'b'),(3,'c'),(4,'d'),(5,'e');

--向表中插入数据，带ALL。
insertall_test_db=# INSERT ALL
insertall_test_db-# WHEN c1 < 4 THEN
insertall_test_db-# INTO insert_all_test1
insertall_test_db-# WHEN c1 < 3 THEN
insertall_test_db-# INTO insert_all_test2
insertall_test_db-# ELSE
insertall_test_db-# INTO insert_all_test3
insertall_test_db-# SELECT * FROM insert_all_test0;

--查询数据。
insertall_test_db=# SELECT * FROM insert_all_test1 ORDER BY c1,c2;
 c1 | c2 
----+----
  1 | a
  2 | b
  3 | c
(3 rows)

insertall_test_db=# SELECT * FROM insert_all_test2 ORDER BY c1,c2;
 c1 | c2 
----+----
  1 | a
  2 | b
(2 rows)

insertall_test_db=# SELECT * FROM insert_all_test3 ORDER BY c1,c2;
 c1 | c2 
----+----
  4 | d
  5 | e
(2 rows)

--删除数据。
insertall_test_db=# TRUNCATE TABLE insert_all_test1;
insertall_test_db=# TRUNCATE TABLE insert_all_test2;
insertall_test_db=# TRUNCATE TABLE insert_all_test3;

--向表中插入数据，省略ALL。
insertall_test_db=# insert
insertall_test_db-# WHEN c1 < 4 THEN
insertall_test_db-# INTO insert_all_test1
insertall_test_db-# WHEN c1 < 3 THEN
insertall_test_db-# INTO insert_all_test2
insertall_test_db-# ELSE
insertall_test_db-# INTO insert_all_test3
insertall_test_db-# SELECT * FROM insert_all_test0;

--查询数据。
insertall_test_db=# SELECT * FROM insert_all_test1 ORDER BY c1,c2;
 c1 | c2 
----+----
  1 | a
  2 | b
  3 | c
(3 rows)

insertall_test_db=# SELECT * FROM insert_all_test2 ORDER BY c1,c2;
 c1 | c2 
----+----
  1 | a
  2 | b
(2 rows)

insertall_test_db=# SELECT * FROM insert_all_test3 ORDER BY c1,c2;
 c1 | c2 
----+----
  4 | d
  5 | e
(2 rows)

--删除表。
insertall_test_db=# DROP TABLE insert_all_test0;
insertall_test_db=# DROP TABLE insert_all_test1;
insertall_test_db=# DROP TABLE insert_all_test2;
insertall_test_db=# DROP TABLE insert_all_test3;

insertall_test_db=# \c postgres;
gaussdb=# DROP DATABASE insertall_test_db;

支持PLSQL中使用INSERT ALL

示例：

--创建ORA兼容数据库。
gaussdb=# CREATE DATABASE insertall_test_db DBCOMPATIBILITY 'ORA';

--切换至ORA兼容数据库。
gaussdb=# \c insertall_test_db;

--建表。
insertall_test_db=# CREATE TABLE insert_all_test0(c1 int, c2 VARCHAR2(20));
insertall_test_db=# CREATE TABLE insert_all_test1(c1 int, c2 VARCHAR2(20));
insertall_test_db=# CREATE TABLE insert_all_test2(c1 int, c2 VARCHAR2(20));
insertall_test_db=# CREATE TABLE insert_all_test3(c1 int, c2 VARCHAR2(20));

--构造数据。
insertall_test_db=# INSERT INTO insert_all_test0 VALUES(1,'a'),(2,'b'),(3,'c'),(4,'d'),(5,'e');

--PLSQL，向表中插入数据。
insertall_test_db=# DECLARE
insertall_test_db-# var1 INT := 666;
insertall_test_db-# var2 VARCHAR2(20) := '***';
insertall_test_db-# BEGIN
insertall_test_db$# INSERT ALL
insertall_test_db$# INTO insert_all_test1 VALUES(var1,var2)
insertall_test_db$# INTO insert_all_test1(c1) VALUES(var1)
insertall_test_db$# INTO insert_all_test2(c2) VALUES(var2||'???')
insertall_test_db$# INTO insert_all_test3(c1,c2) VALUES(c1,c2)
insertall_test_db$# SELECT * FROM insert_all_test0;
insertall_test_db$# END;
insertall_test_db$# /

--查询数据。
insertall_test_db=# SELECT * FROM insert_all_test1 ORDER BY c1,c2;
 c1  | c2  
-----+-----
 666 | ***
 666 | ***
 666 | ***
 666 | ***
 666 | ***
 666 | 
 666 | 
 666 | 
 666 | 
 666 | 
(10 rows)

insertall_test_db=# SELECT * FROM insert_all_test2 ORDER BY c1,c2;
 c1 |   c2   
----+--------
    | ***???
    | ***???
    | ***???
    | ***???
    | ***???
(5 rows)

insertall_test_db=# SELECT * FROM insert_all_test3 order by c1,c2;
 c1 | c2 
----+----
  1 | a
  2 | b
  3 | c
  4 | d
  5 | e
(5 rows)

--删除表。
insertall_test_db=# DROP TABLE insert_all_test0;
insertall_test_db=# DROP TABLE insert_all_test1;
insertall_test_db=# DROP TABLE insert_all_test2;
insertall_test_db=# DROP TABLE insert_all_test3;

insertall_test_db=# \c postgres;
gaussdb=# DROP DATABASE insertall_test_db;

异常情况

示例：

--创建ORA兼容数据库。
gaussdb=# CREATE DATABASE insertall_test_db DBCOMPATIBILITY 'ORA';

--切换至ORA兼容数据库。
gaussdb=# \c insertall_test_db;

--建表。
insertall_test_db=# CREATE TABLE insert_all_test0(c1 int, c2 VARCHAR2(20));
insertall_test_db=# CREATE TABLE insert_all_test1(c1 int, c2 VARCHAR2(20));
insertall_test_db=# CREATE TABLE insert_all_test2(c1 int, c2 VARCHAR2(20));
insertall_test_db=# CREATE TABLE insert_all_test3(c1 int, c2 VARCHAR2(20));

--构造数据。
insertall_test_db=# INSERT INTO insert_all_test0 VALUES(1,'a'),(2,'b'),(3,'c'),(4,'d'),(5,'e');

--VALUSES内不支持聚集函数。
insertall_test_db=# INSERT ALL INTO insert_all_test1 VALUES(max(c1), 'a') SELECT * FROM insert_all_test0;
ERROR:  cannot use aggregate function in VALUES 
LINE 2: INTO insert_all_test1 VALUES(max(c1), 'a')

--VALUES后不能添加多行。
insertall_test_db=# INSERT ALL INTO insert_all_test1 VALUES(1,'a'),(2,'b') SELECT * FROM insert_all_test0;
ERROR:  syntax error at or near ","
LINE 1: INSERT ALL INTO insert_all_test1 VALUES(1,'a'),(2,'b') selec...

--WHEN条件中的列在子查询中不存在。
insertall_test_db=# INSERT ALL WHEN c1>1 THEN INTO insert_all_test1 VALUES(1,'a') SELECT c2 FROM insert_all_test0;
ERROR:  column "c1" does not exist 
LINE 2: WHEN c1>1 THEN
            ^ 
HINT:  There is a column named "c1" in table "insert_all_test1", but it cannot be referenced FROM this part of the query.

--不支持为子查询表设置别名。
insertall_test_db=# INSERT ALL INTO insert_all_test1 VALUES(t1.c1, 'a') SELECT * FROM insert_all_test0 t1;
ERROR:  missing FROM-clause entry for table "t1" 
LINE 2: INTO insert_all_test1 VALUES(t1.c1, 'a')

--不支持插入数据到视图。
insertall_test_db=# CREATE VIEW v1 as SELECT * FROM insert_all_test1;
insertall_test_db=# INSERT ALL INTO v1 SELECT * FROM insert_all_test0;
ERROR:  Not allowed to insert into view.

--子查询不存在。
insertall_test_db=# INSERT ALL INTO insert_all_test1 VALUES(1, 'a');
ERROR:  syntax error at or near ";" 
LINE 2: INTO insert_all_test1 VALUES(1, 'a');

--删除表。
insertall_test_db=# DROP TABLE insert_all_test0;
insertall_test_db=# DROP TABLE insert_all_test1;
insertall_test_db=# DROP TABLE insert_all_test2;
insertall_test_db=# DROP TABLE insert_all_test3;

insertall_test_db=# \c postgres;
gaussdb=# DROP DATABASE insertall_test_db;

父主题： I

上一篇：INSERT

下一篇：L

意见反馈

文档内容是否对您有帮助？

有帮助没帮助

提供反馈

提交成功！非常感谢您的反馈，我们会继续努力做到更好！您可在我的云声建议查看反馈及问题处理状态。

系统繁忙，请稍后重试

在使用文档中是否遇到以下问题

内容与产品页面不一致

内容不易理解

缺失示例代码

步骤不可操作

搜不到想要的内容

缺少最佳实践

意见反馈（选填）

0/500

请至少选择一项反馈信息并填写问题反馈

字符长度不能超过500

直接提交取消

如您有其它疑问，您也可以通过华为云社区问答频道来与我们联系探讨

智能客服提问云社区提问

INSERT ALL

功能描述

注意事项

语法格式

参数说明

示例

相关文档

意见反馈

文档内容是否对您有帮助？

7*24

备案

专业服务

退订

建议反馈

售前咨询热线