MySQL :: MySQL 8.3 Reference Manual :: 15.2.19 VALUES Statement

version 8.3

8.0 current

8.0 Japanese

MySQL 8.3 Reference Manual / ... / VALUES Statement

15.2.19 VALUES 语句

VALUES 是 MySQL 8.0.19 中引入的一条 DML 语句，它返回一个或多个行的表格。换言之，它是一个表值构造函数，也可以作为独立的 SQL 语句。

VALUES row_constructor_list [ORDER BY column_designator] [LIMIT number]

row_constructor_list:
    ROW(value_list)[, ROW(value_list)][, ...]

value_list:
    value[, value][, ...]

column_designator:
    column_index

该 VALUES 语句由 VALUES 关键字和一个或多个行构造函数组成，中间用逗号分隔。一个行构造函数由 ROW() 行构造函数子句和一个或多个标量值列表组成，括号中括起来。一个值可以是任何 MySQL 数据类型的文字，也可以是一个标量值的表达式。

ROW() 不能是空的（但每个提供的标量值可以是 NULL）。同一个 VALUES 语句中的每个 ROW() 都必须具有相同数量的值列表。

该 DEFAULT 关键字不支持 VALUES，并且会引发语法错误，除非它用于在 INSERT 语句中提供值。

该 VALUES 的输出是一个表格：

mysql> VALUES ROW(1,-2,3), ROW(5,7,9), ROW(4,6,8);
+----------+----------+----------+
| column_0 | column_1 | column_2 |
+----------+----------+----------+
|        1 |       -2 |        3 |
|        5 |        7 |        9 |
|        4 |        6 |        8 |
+----------+----------+----------+
3 rows in set (0.00 sec)

该表格的列名是隐式命名的，例如 column_0、column_1、column_2 等，从 0 开始。这可以用于使用可选的 ORDER BY 子句对行进行排序，类似于 SELECT 语句。

mysql> VALUES ROW(1,-2,3), ROW(5,7,9), ROW(4,6,8) ORDER BY column_1;
+----------+----------+----------+
| column_0 | column_1 | column_2 |
+----------+----------+----------+
|        1 |       -2 |        3 |
|        4 |        6 |        8 |
|        5 |        7 |        9 |
+----------+----------+----------+
3 rows in set (0.00 sec)

该 VALUES 语句还支持 LIMIT 子句，以限制输出的行数。

该 VALUES 语句对列值的数据类型非常宽松；您可以在同一列中混合不同的数据类型，如下所示：

mysql> VALUES ROW("q", 42, '2019-12-18'),
    ->     ROW(23, "abc", 98.6),
    ->     ROW(27.0002, "Mary Smith", '{"a": 10, "b": 25}');
+----------+------------+--------------------+
| column_0 | column_1   | column_2           |
+----------+------------+--------------------+
| q        | 42         | 2019-12-18         |
| 23       | abc        | 98.6               |
| 27.0002  | Mary Smith | {"a": 10, "b": 25} |
+----------+------------+--------------------+
3 rows in set (0.00 sec)

Important

VALUES 语句可以用作表值构造函数；虽然它可以在 INSERT 或 REPLACE 语句中提供值，但不要将其与用于相同目的的 VALUES 关键字混淆。您也不应该将其与 VALUES() 函数混淆，该函数用于 INSERT ... ON DUPLICATE KEY UPDATE 中引用列值。

您还应该注意 ROW() 是一个行值构造函数（见第 15.2.15.5 节，“行子查询”），而 VALUES ROW() 是一个表值构造函数；这两个不能互换使用。

您可以在许多情况下使用 VALUES，包括以下情况：

使用 UNION，如下所示：

mysql> SELECT 1,2 UNION SELECT 10,15;
+----+----+
| 1  | 2  |
+----+----+
|  1 |  2 |
| 10 | 15 |
+----+----+
2 rows in set (0.00 sec)

mysql> VALUES ROW(1,2) UNION VALUES ROW(10,15);
+----------+----------+
| column_0 | column_1 |
+----------+----------+
|        1 |        2 |
|       10 |       15 |
+----------+----------+
2 rows in set (0.00 sec)

您可以 union 多个构造表，每个表都有多行，如下所示：

mysql> VALUES ROW(1,2), ROW(3,4), ROW(5,6)
     >     UNION VALUES ROW(10,15),ROW(20,25);
+----------+----------+
| column_0 | column_1 |
+----------+----------+
|        1 |        2 |
|        3 |        4 |
|        5 |        6 |
|       10 |       15 |
|       20 |       25 |
+----------+----------+
5 rows in set (0.00 sec)

您也可以（通常是首选的）省略 UNION，并使用单个 VALUES 语句，如下所示：

mysql> VALUES ROW(1,2), ROW(3,4), ROW(5,6), ROW(10,15), ROW(20,25);
+----------+----------+
| column_0 | column_1 |
+----------+----------+
|        1 |        2 |
|        3 |        4 |
|        5 |        6 |
|       10 |       15 |
|       20 |       25 |
+----------+----------+

VALUES 还可以与 SELECT 语句、TABLE 语句或两者结合使用。

在 UNION 中构造的表必须包含相同数量的列，就像使用 SELECT 一样。请参阅第 15.2.18 节，“UNION 子句”，以获取更多示例。

您可以使用 EXCEPT 和 INTERSECT 与 VALUES 结合使用，方式与 UNION 相似，如下所示：

mysql> VALUES ROW(1,2), ROW(3,4), ROW(5,6)
    ->   INTERSECT 
    -> VALUES ROW(10,15), ROW(20,25), ROW(3,4);
+----------+----------+
| column_0 | column_1 |
+----------+----------+
|        3 |        4 |
+----------+----------+
1 row in set (0.00 sec)
 
mysql> VALUES ROW(1,2), ROW(3,4), ROW(5,6)
    ->   EXCEPT 
    -> VALUES ROW(10,15), ROW(20,25), ROW(3,4);
+----------+----------+
| column_0 | column_1 |
+----------+----------+
|        1 |        2 |
|        5 |        6 |
+----------+----------+
2 rows in set (0.00 sec)

请参阅第 15.2.4 节，“EXCEPT 子句” 和第 15.2.8 节，“INTERSECT 子句”，以获取更多信息。

在连接中。请参阅第 15.2.13.2 节，“JOIN 子句”，以获取更多信息和示例。
取代 VALUES() 在 INSERT 或 REPLACE 语句中，在这种情况下其语义与这里描述的略有不同。请参阅第 15.2.7 节，“INSERT 语句”，以获取详细信息。
取代源表在 CREATE TABLE ... SELECT 和 CREATE VIEW ... SELECT 中。请参阅这些语句的描述，以获取更多信息和示例。

PREV HOME UP NEXT