title: INSERT summary: TiDB 数据库中 INSERT 的使用概况。

INSERT

使用 INSERT 语句在表中插入新行。

语法图

InsertIntoStmt ::=
    'INSERT' TableOptimizerHints PriorityOpt IgnoreOptional IntoOpt TableName PartitionNameListOpt InsertValues OnDuplicateKeyUpdate
TableOptimizerHints ::=
    hintComment?
PriorityOpt ::=
    ( 'LOW_PRIORITY' | 'HIGH_PRIORITY' | 'DELAYED' )?
IgnoreOptional ::=
    'IGNORE'?
IntoOpt  ::= 'INTO'?
TableName ::=
    Identifier ( '.' Identifier )?
PartitionNameListOpt ::=
    ( 'PARTITION' '(' Identifier ( ',' Identifier )* ')' )?
InsertValues ::=
    '(' ( ColumnNameListOpt ')' ( ValueSym ValuesList | SelectStmt | '(' SelectStmt ')' | UnionStmt ) | SelectStmt ')' )
|   ValueSym ValuesList
|   SelectStmt
|   UnionStmt
|   'SET' ColumnSetValue? ( ',' ColumnSetValue )*
OnDuplicateKeyUpdate ::=
    ( 'ON' 'DUPLICATE' 'KEY' 'UPDATE' AssignmentList )?

示例

CREATE TABLE t1 (a INT);

Query OK, 0 rows affected (0.11 sec)

CREATE TABLE t2 LIKE t1;

Query OK, 0 rows affected (0.11 sec)

INSERT INTO t1 VALUES (1);

Query OK, 1 row affected (0.02 sec)

INSERT INTO t1 (a) VALUES (1);

Query OK, 1 row affected (0.01 sec)

INSERT INTO t2 SELECT * FROM t1;

Query OK, 2 rows affected (0.01 sec)
Records: 2  Duplicates: 0  Warnings: 0

SELECT * FROM t1;

+------+
| a    |
+------+
|    1 |
|    1 |
+------+
2 rows in set (0.00 sec)

SELECT * FROM t2;

+------+
| a    |
+------+
|    1 |
|    1 |
+------+
2 rows in set (0.00 sec)

INSERT INTO t2 VALUES (2),(3),(4);

Query OK, 3 rows affected (0.02 sec)
Records: 3  Duplicates: 0  Warnings: 0

SELECT * FROM t2;

+------+
| a    |
+------+
|    1 |
|    1 |
|    2 |
|    3 |
|    4 |
+------+
5 rows in set (0.00 sec)

MySQL 兼容性

INSERT 语句与 MySQL 完全兼容。如发现任何兼容性差异，请在 GitHub 上提交 issue。

另请参阅

• DELETE
• SELECT
• UPDATE
• REPLACE