INSERT

This statement inserts new rows into a table.

Synopsis

InsertIntoStmt

INSERT - 图1

TableOptimizerHints

INSERT - 图2

PriorityOpt

INSERT - 图3

IgnoreOptional

INSERT - 图4

IntoOpt

INSERT - 图5

TableName

INSERT - 图6

PartitionNameListOpt

INSERT - 图7

InsertValues

INSERT - 图8

OnDuplicateKeyUpdate

INSERT - 图9

  1. InsertIntoStmt ::=
  2.     'INSERT' TableOptimizerHints PriorityOpt IgnoreOptional IntoOpt TableName PartitionNameListOpt InsertValues OnDuplicateKeyUpdate
  4. TableOptimizerHints ::=
  5.     hintComment?
  7. PriorityOpt ::=
  8.     ( 'LOW_PRIORITY' | 'HIGH_PRIORITY' | 'DELAYED' )?
  10. IgnoreOptional ::=
  11.     'IGNORE'?
  13. IntoOpt  ::= 'INTO'?
  15. TableName ::=
  16.     Identifier ( '.' Identifier )?
  18. PartitionNameListOpt ::=
  19.     ( 'PARTITION' '(' Identifier ( ',' Identifier )* ')' )?
  21. InsertValues ::=
  22.     '(' ( ColumnNameListOpt ')' ( ValueSym ValuesList | SelectStmt | '(' SelectStmt ')' | UnionStmt ) | SelectStmt ')' )
  23. |   ValueSym ValuesList
  24. |   SelectStmt
  25. |   UnionStmt
  26. |   'SET' ColumnSetValue? ( ',' ColumnSetValue )*
  28. OnDuplicateKeyUpdate ::=
  29.     ( 'ON' 'DUPLICATE' 'KEY' 'UPDATE' AssignmentList )?

Examples

  1. mysql> CREATE TABLE t1 (a INT);
  2. Query OK, 0 rows affected (0.11 sec)
  4. mysql> CREATE TABLE t2 LIKE t1;
  5. Query OK, 0 rows affected (0.11 sec)
  7. mysql> INSERT INTO t1 VALUES (1);
  8. Query OK, 1 row affected (0.02 sec)
  10. mysql> INSERT INTO t1 (a) VALUES (1);
  11. Query OK, 1 row affected (0.01 sec)
  13. mysql> INSERT INTO t2 SELECT * FROM t1;
  14. Query OK, 2 rows affected (0.01 sec)
  15. Records: 2  Duplicates: 0  Warnings: 0
  17. mysql> SELECT * FROM t1;
  18. +------+
  19. | a    |
  20. +------+
  21. |    1 |
  22. |    1 |
  23. +------+
  24. 2 rows in set (0.00 sec)
  26. mysql> SELECT * FROM t2;
  27. +------+
  28. | a    |
  29. +------+
  30. |    1 |
  31. |    1 |
  32. +------+
  33. 2 rows in set (0.00 sec)
  35. mysql> INSERT INTO t2 VALUES (2),(3),(4);
  36. Query OK, 3 rows affected (0.02 sec)
  37. Records: 3  Duplicates: 0  Warnings: 0
  39. mysql> SELECT * FROM t2;
  40. +------+
  41. | a    |
  42. +------+
  43. |    1 |
  44. |    1 |
  45. |    2 |
  46. |    3 |
  47. |    4 |
  48. +------+
  49. 5 rows in set (0.00 sec)

MySQL compatibility

The INSERT statement in TiDB is fully compatible with MySQL. If you find any compatibility differences, report a bug.

See also