描述

VALUES 计算由值表达式指定的行值或行值集。它最常用于在更大的命令中生成一个“常量表”，但也可以单独使用。

当指定多行时，所有行都必须具有相同数量的元素。结果表的列的数据类型是通过组合出现在该列中的表达式的显式或隐式类型来确定的，使用的规则与UNION相同（参见第 10.5 节）。

在更大的命令中，VALUES 在语法上允许出现在任何SELECT出现的位置。因为它在语法上被视为SELECT，因此可以使用ORDER BY、LIMIT（或等效的FETCH FIRST）和OFFSET子句与VALUES命令一起使用。

参数

注释

应避免使用具有大量行的VALUES列表，因为您可能会遇到内存不足错误或性能下降。VALUES出现在INSERT中是一个特殊情况（因为所需的列类型是从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子句为所有列指定名称，但最好这样做。（VALUES的默认列名为column1、column2等，在PostgreSQL中，但在其他数据库系统中这些名称可能不同。）

当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。

另请参见