Files
oceanbase/docs/docs-cn/7.developer-guide-1/3.about-dml-statements-and-transactions/1.about-dml-statements/2.insert-statement.md
2022-02-10 14:51:49 +08:00

146 lines
4.8 KiB
Markdown

关于 INSERT 语句
=================================
INSERT 语句用来向表中插入行记录。
最简单的 INSERT 语句语法格式如下:
```javascript
INSERT INTO table_name (list_of_columns) VALUES (list_of_values);
```
其中,list_of_columns 指定表的 table_name 列,list_of_values 是 list_of_columns 提到的列的对应值,必须一一对应。因此,在向一个表插入记录之前,需要了解这个表所有的列信息,以及列类型和有效值、是否允许为空等。在 obclient 命令行环境下,可以直接用 DESC 命令查看列属性,如下所示:
```javascript
obclient> desc ordl;
+----------------+-------------+------+-----+---------+-------+
| FIELD | TYPE | NULL | KEY | DEFAULT | EXTRA |
+----------------+-------------+------+-----+---------+-------+
| OL_W_ID | NUMBER(38) | NO | PRI | NULL | NULL |
| OL_D_ID | NUMBER(38) | NO | PRI | NULL | NULL |
| OL_O_ID | NUMBER(38) | NO | PRI | NULL | NULL |
| OL_NUMBER | NUMBER(38) | NO | PRI | NULL | NULL |
| OL_DELIVERY_D | DATE | YES | NULL | NULL | NULL |
| OL_AMOUNT | NUMBER(6,2) | YES | NULL | NULL | NULL |
| OL_I_ID | NUMBER(38) | YES | NULL | NULL | NULL |
| OL_SUPPLY_W_ID | NUMBER(38) | YES | NULL | NULL | NULL |
| OL_QUANTITY | NUMBER(38) | YES | NULL | NULL | NULL |
| OL_DIST_INFO | CHAR(24) | YES | NULL | NULL | NULL |
+----------------+-------------+------+-----+---------+-------+
10 rows in set (0.01 sec)
```
在 INSERT 语句中,您不需要知道表的所有列的值,但需要知道所有列属性为
*NOT* *NULL 的列的值。如果列属性为 NOT NULL 有默认值时,您可以不指定该列的值;如果列为*
*NULL,您也可以不指定该列的值,OceanBase 会在该列上插入一个 NULL 值。*
当插入多条件记录时,可以分多条 INSERT 语句,也可以用一个 INSERT 多个 VALUES 语句。
示例:当所有列信息都知道时,使用INSERT语句
---------------------------------
如下示例创建有默认值列的表,SQL 插入两笔记录,所有字段信息都有值。
```javascript
obclient> CREATE TABLE t_insert(
id number NOT NULL PRIMARY KEY
, name varchar(10) NOT NULL, value number
, gmt_create DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP
);
Query OK, 0 rows affected (0.07 sec)
obclient> INSERT INTO t_insert(id, name, value, gmt_create)
values(1,'CN',10001, current_timestamp);
Query OK, 1 row affected (0.01 sec)
```
示例:当不是所有列信息都知道时,使用INSERT语句
-----------------------------------
下面 SQL 插入两笔记录,gmt_create 字段没有提供。两笔记录使用一个 INSERT 多个 VALUES 子句。
```javascript
obclient> INSERT INTO t_insert(id, name, value)
VALUES (2,'US', 10002) ,(3,'EN', 10003);
Query OK, 2 rows affected (0.00 sec)
Records: 2 Duplicates: 0 Warnings: 0
```
示例:使用INSERT语句违反唯一约束冲突
------------------------------
当表上有唯一性约束的时候,插入相同的记录,数据库会报错。
```javascript
obclient> INSERT INTO t_insert(id, name, value)
VALUES (3,'UK', 10003)
,(4, 'JP', 10004);
ERROR 1062 (23000): Duplicate entry '3' for key 'PRIMARY'
```
这个报错可以通过 INSERT IGNORE INTO、MERGE INTO、INSERT INTO ON DUPLICATE KEY UPDATE 避免。
#### 关于INSERT IGNORE INTO 语句
下面示例是 MySQL 租户下使用 INSERT IGNORE INTO 避免约束冲突,IGNORE 关键字可以忽略由于约束冲突导致的 INSERT 失败的影响。
```javascript
obclient> INSERT IGNORE INTO t_insert(id, name, value)
VALUES (3,'UK', 10003) ,(4, 'JP', 10004);
Query OK, 1 row affected (0.00 sec)
obclient> select * from t_insert;
+----+------+-------+---------------------+
| id | name | value | gmt_create |
+----+------+-------+---------------------+
| 1 | CN | 10001 | 2020-04-03 16:05:45 |
| 2 | US | 10002 | 2020-04-03 16:05:54 |
| 3 | EN | 10003 | 2020-04-03 16:05:54 |
| 4 | JP | 10004 | 2020-04-03 16:06:08 |
+----+------+-------+---------------------+
4 rows in set (0.00 sec)
```
示例:使用查询语句充当 INSERT 的 values 子句
---------------------------------------
当需要备份一个表的备份或者全部记录时,可以使用 `INSERT INTO ... SELECT ... FROM` 语句。
```javascript
obclient> create table ware_bak(
w_id int
, w_ytd decimal(12,2)
, w_tax decimal(4,4)
, w_name varchar(10)
, w_street_1 varchar(20)
, w_street_2 varchar(20)
, w_city varchar(20)
, w_state char(2)
, w_zip char(9)
, primary key(w_id)
);
Query OK, 0 rows affected (0.17 sec)
obclient> insert into ware_bak select * from ware;
Query OK, 2 rows affected (0.02 sec)
Records: 2 Duplicates: 0 Warnings: 0
```