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

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

  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_AMOUNT      | NUMBER(6,2) | YES  | NULL | NULL    | NULL  |
  10. | OL_I_ID        | NUMBER(38)  | YES  | NULL | NULL    | NULL  |
  12. | OL_QUANTITY    | NUMBER(38)  | YES  | NULL | NULL    | NULL  |
  13. | OL_DIST_INFO   | CHAR(24)    | YES  | NULL | NULL    | NULL  |
  14. +----------------+-------------+------+-----+---------+-------+
  15. 10 rows in set (0.01 sec)

在 INSERT 语句中，您不需要知道表的所有列的值，但需要知道所有列属性为

NULL，您也可以不指定该列的值，OceanBase 会在该列上插入一个 NULL 值。

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

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

  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 IGNORE INTO、MERGE INTO、INSERT INTO ON DUPLICATE KEY UPDATE 避免。

关于INSERT IGNORE INTO 语句

下面示例是 MySQL 租户下使用 INSERT IGNORE INTO 避免约束冲突，IGNORE 关键字可以忽略由于约束冲突导致的 INSERT 失败的影响。

  1. obclient> INSERT IGNORE INTO t_insert(id, name, value) 
  4. obclient> select * from t_insert;
  5. +----+------+-------+---------------------+
  6. | id | name | value | gmt_create          |
  7. +----+------+-------+---------------------+
  8. |  1 | CN   | 10001 | 2020-04-03 16:05:45 |
  9. |  2 | US   | 10002 | 2020-04-03 16:05:54 |
  10. |  3 | EN   | 10003 | 2020-04-03 16:05:54 |
  11. |  4 | JP   | 10004 | 2020-04-03 16:06:08 |
  12. +----+------+-------+---------------------+