Postgresql 中文操作指南

VALUES

VALUES — 计算一组行

Synopsis

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

Description

VALUES 计算由值表达式指定的行值或行值集合。它最常用于在更大的命令内生成“常量表”，但它可以自行使用。

当指定超过一行时，所有行都必须具有相同数量的元素。结果表列的数据类型是由结合该列中出现的表达式的显式或推断类型决定的，采用与 UNION 相同的规则（参见 Section 10.5 ）。

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

Parameters

  • expression

    • 用于计算并插入在结果表（行集合）中指示位置的常量或表达式。出现在 INSERT 顶层的 VALUES 列表中， expression 可以被 DEFAULT 替换，以指示应插入目标列的默认值。 DEFAULT 不可在其他上下文中出现 VALUES 时使用。

  • sort_expression

    • 用于指示如何对结果行排序的表达式或整型常量。此表达式可以引用 VALUES 结果的列，如 column1 、 column2 等。有关更多详细信息，请参见 SELECT 文档中的 ORDER BY Clause 。

  • operator

  • count

    • 要返回的最大行数。有关详细信息，请参见 SELECT 文档中的 LIMIT Clause 。

  • start

    • 在开始返回行前要跳过的行数。有关详细信息，请参见 SELECT 文档中的 LIMIT Clause 。

Notes

VALUES 列表与行数极大时应避免，因为你可能会遇到内存不足故障或性能不佳。出现在 INSERT 中的 VALUES 是一个特例（因为所需列类型已从 INSERT 的目标表中得知，并且无需通过扫描 VALUES 列表来推断），因此它可以处理比其他上下文中实际处理更大的列表。

Examples

一个不带参数的 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);

能够在可能会写入子 SELECT 的地方使用 VALUES ，例如在 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 的默认列名称在 PostgreSQL 中是 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'));

Tip

对于简单的 IN 测试，依靠 IN 的 list-of-scalars 形式比编写上述 VALUES 查询更好。标量方法列表所需编写内容较少，通常效率更高。

Compatibility

VALUES 符合 SQL 标准。 LIMIT 和 OFFSET 是 PostgreSQL 扩展；另请参阅 SELECT 下的内容。

See Also

INSERT 、 SELECT