VALUES ( expression [, ...] ) [, ...]
    [ ORDER BY sort_expression [ ASC | DESC | USING operator ] [, ...] ]
    [ LIMIT { count | ALL } ]
    [ OFFSET start [ ROW | ROWS ] ]
    [ FETCH { FIRST | NEXT } [ count ] { ROW | ROWS } ONLY ]

描述

VALUES根据给定的值表达式计算一个或一组行的值。 它通常用于在一个较大的命令内生成一个"常数表"，当同时它也可以用于自身。

如果指定了多行，那么每一行都必须拥有相同的元素个数。 结果表字段的数据类型将根据表达式的明确或隐含的数据类型确定， 使用的规则与UNION(参阅Section 10.5)相同。

在大命令里面，VALUES允许出现在任何SELECT可以出现的地方。 因为它在语法上非常类似于SELECT， 可以在VALUES命令中使用ORDER BY，LIMIT(或 等价于FETCH FIRST) 和OFFSET子句。

参数

注意

应当避免使用VALUES返回数量非常大的结果行， 否则可能会遭遇内存耗尽或者性能低下。出现在INSERT中的VALUES是一个特殊情况， 因为目标字段类型可以从INSERT的目标表获知， 并不需要通过扫描VALUES列表来推测， 所以在此情况下可以处理非常大的结果行。

例子

一个光秃秃的VALUES命令：

VALUES (1, 'one'), (2, 'two'), (3, 'three');

这将返回一个三行两列的表，它在效果上相当于：

SELECT 1 AS column1, 'one' AS column2
UNION ALL
SELECT 2, 'two'
UNION ALL
SELECT 3, 'three';

通常，VALUES会用于一个大SQL命令中，最常见的是用于INSERT命令：

INSERT INTO films (code, title, did, date_prod, kind)
    VALUES ('T_601', 'Yojimbo', 106, '1961-06-16', 'Drama');

在用于INSERT时，VALUES列表中的项可以使用DEFAULT 来表示使用字段的缺省值：

INSERT INTO films VALUES
    ('UA502', 'Bananas', 105, DEFAULT, 'Comedy', '82 minutes'),
    ('T_601', 'Yojimbo', 106, DEFAULT, 'Drama', DEFAULT);

VALUES还可以用于子SELECT可以应用的场合。 比如在一个FROM子句中：

SELECT f.*
  FROM films f, (VALUES('MGM', 'Horror'), ('UA', 'Sci-Fi')) AS t (studio, kind)
  WHERE f.studio = t.studio AND f.kind = t.kind;

UPDATE employees SET salary = salary * v.increase
  FROM (VALUES(1, 200000, 1.2), (2, 400000, 1.4)) AS v (depno, target, increase)
  WHERE employees.depno = v.depno AND employees.sales >= v.target;

当VALUES用于FROM子句中的时候，必须使用AS子句， 这与用于SELECT时一样。并不要求AS子句为每个字段都指定一个别名， 但是这样做是一个好习惯。PostgreSQL中VALUES缺省的字段名是 column1，column2等等，但这些缺省的名字并不一定与其他数据库系统相同。

当VALUES用于INSERT的时候，所有的值都将按照目标字段自动做类型转换。 但是在其他场合就可能必须明确指定恰当的数据类型。 如果所有的项都是引号包围的字面常量，强制指定第一个类型就可以确定所有的类型：

SELECT * FROM machines
WHERE ip_address IN (VALUES('192.168.0.1'::inet), ('192.168.0.10'), ('192.168.1.43'));

兼容性

VALUES符合SQL标准， 此外，LIMIT和OFFSET是PostgreSQL扩展。 参阅下面的SELECT。

又见

INSERT, SELECT