INSERT 语句用来向表中插入行记录。

最简单的 INSERT 语句语法格式如下:

  1. INSERT INTO table_name (list_of_columns) VALUES (list_of_values);

其中,list_of_columns 指定表的 table_name 列,list_of_values 是 list_of_columns 提到的列的对应值,必须一一对应。因此,在向一个表插入记录之前,需要了解这个表所有的列信息,以及列类型和有效值、是否允许为空等。在 obclient 命令行环境下,可以直接用 DESC 命令查看列属性,如下所示:

  1. obclient> desc ordl;
  2. +----------------+-------------+------+-----+---------+-------+
  3. | FIELD | TYPE | NULL | KEY | DEFAULT | EXTRA |
  4. +----------------+-------------+------+-----+---------+-------+
  5. | OL_W_ID | NUMBER(38) | NO | PRI | NULL | NULL |
  6. | OL_D_ID | NUMBER(38) | NO | PRI | NULL | NULL |
  7. | OL_O_ID | NUMBER(38) | NO | PRI | NULL | NULL |
  8. | OL_NUMBER | NUMBER(38) | NO | PRI | NULL | NULL |
  9. | OL_DELIVERY_D | DATE | YES | NULL | NULL | NULL |
  10. | OL_AMOUNT | NUMBER(6,2) | YES | NULL | NULL | NULL |
  11. | OL_I_ID | NUMBER(38) | YES | NULL | NULL | NULL |
  12. | OL_SUPPLY_W_ID | NUMBER(38) | YES | NULL | NULL | NULL |
  13. | OL_QUANTITY | NUMBER(38) | YES | NULL | NULL | NULL |
  14. | OL_DIST_INFO | CHAR(24) | YES | NULL | NULL | NULL |
  15. +----------------+-------------+------+-----+---------+-------+
  16. 10 rows in set (0.01 sec)

在 INSERT 语句中,您不需要知道表的所有列的值,但需要知道所有列属性为 NOT NULL 的列的值。如果列属性为NOT NULL 有默认值时,您可以不指定该列的值;如果列为 NULL,您也可以不指定该列的值,OceanBase 会在该列上插入一个 NULL 值。

当插入多条件记录时,可以分多条 INSERT 语句,也可以用一个 INSERT 多个 VALUES 语句。

示例:当所有列信息都知道时,使用INSERT语句

如下示例创建有默认值列的表,SQL 插入两笔记录,所有字段信息都有值。

  1. obclient> CREATE TABLE t_insert(
  2. id number NOT NULL PRIMARY KEY
  3. , name varchar(10) NOT NULL, value number
  4. , gmt_create date NOT NULL DEFAULT sysdate
  5. );
  6. Query OK, 0 rows affected (0.07 sec)
  7. obclient> INSERT INTO t_insert(id, name, value, gmt_create)
  8. values(1,'CN',10001, sysdate);
  9. Query OK, 1 row affected (0.01 sec)

示例:当不是所有列信息都知道时,使用INSERT语句

下面 SQL 插入两笔记录,gmt_create 字段没有提供。两笔记录使用一个 INSERT 多个 VALUES 子句。

  1. obclient> INSERT INTO t_insert(id, name, value)
  2. VALUES (2,'US', 10002) ,(3,'EN', 10003);
  3. Query OK, 2 rows affected (0.00 sec)
  4. Records: 2 Duplicates: 0 Warnings: 0

示例:使用INSERT语句违反唯一约束冲突

当表上有唯一性约束的时候,插入相同的记录,数据库会报错,提示 key ‘xxx’ violated。

  1. obclient> INSERT INTO t_insert(id, name, value)
  2. VALUES (3,'UK', 10003)
  3. ,(4, 'JP', 10004);
  4. ERROR-00001: unique constraint '3' for key 'PRIMARY' violated

这个报错可以通过 MERGE INTO 避免,详细用法请参考 “关于MERGE语句”。

示例:使用查询语句充当 INSERT 的 values 子句

当需要备份一个表的备份或者全部记录时,可以使用 INSERT INTO … SELECT … FROM 语句。

  1. obclient> create table ware_bak(
  2. w_id int
  3. , w_ytd decimal(12,2)
  4. , w_tax decimal(4,4)
  5. , w_name varchar(10)
  6. , w_street_1 varchar(20)
  7. , w_street_2 varchar(20)
  8. , w_city varchar(20)
  9. , w_state char(2)
  10. , w_zip char(9)
  11. , primary key(w_id)
  12. );
  13. Query OK, 0 rows affected (0.17 sec)
  14. obclient> insert into ware_bak select * from ware;
  15. Query OK, 2 rows affected (0.02 sec)
  16. Records: 2 Duplicates: 0 Warnings: 0