VALUES

计算一个行集合。

概要

  1. VALUES ( expression [, ...] ) [, ...]
  2.    [ORDER BY sort_expression [ASC | DESC | USING operator] [, ...]]
  3.    [LIMIT {count | ALL}] [OFFSET start]

描述

VALUES计算由值表达式指定的一个行值或者一组行值。 更常见的是把它用来生成一个大型命令内的”常量表”，但是它也可以被独自使用。

当多于一行被指定时，所有行都必须具有相同数量的元素。 结果表的列数据类型 由出现在该列的表达式的显式或者推导类型组合决定，决定的规则与UNION相同。

在大型的命令中，在语法上允许VALUES出现在SELECT出现的任何地方。因为语法把它当做一个SELECT，可以为一个VALUES命令使用ORDERBY、LIMIT和OFFSET 子句。

参数

expression

要在结果表（行集合）中指定位置计算并且插入的一个常量或者表达式。在一个出现于INSERT顶层的VALUES列表中， expression可以被DEFAULT替代以表示应该插入目标列的默认值。 当VALUES出现在其他环境中时，不能使用DEFAULT。

sort_expression

一个指示如何排序结果行的表达式或者整型常量。这个表达式 可以用column1、column2等来引用该VALUES结果的列。更多细节，见SELECT的参数中的“ORDER BY子句”。

operator

一个排序操作符。更多细节，请见SELECT的参数中的“ORDER BY子句”。

LIMIT count

OFFSET start

要返回的最大行数。更多细节，请见SELECT的参数中的“LIMIT子句”。

注解

应该避免具有大量行的VALUES列表，否则可能会 碰到内存不足失败或者很差的性能。出现在INSERT中的VALUES是一种特殊情况（因为想要的列类型 可以从INSERT的目标表得知，并且不需要通过扫描该VALUES列表来推导），因此它可以处理比其他环境中更大的列表。

示例

一个纯粹的VALUES命令：

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

这将返回一个具有两列、三行的表。它实际等效于：

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

更常用地，VALUES可以被用在一个大型SQL命令中。 在INSERT中最常用：

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

在INSERT环境中，一个VALUES 列表的项可以是DEFAULT指示应该使用该列的默认值而不是指定一个值：

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

VALUES也可以被用在可以写子-SELECT 的地方，例如在一个FROM子句中：

  1. SELECT f.* FROM films f, (VALUES('MGM', 'Horror'), ('UA', 
  2. 'Sci-Fi')) AS t (studio, kind) WHERE f.studio = t.studio AND 
  3. f.kind = t.kind;
  4. UPDATE employees SET salary = salary * v.increase FROM 
  5. (VALUES(1, 200000, 1.2), (2, 400000, 1.4)) AS v (depno, 
  6. target, increase) WHERE employees.depno = v.depno AND 
  7. employees.sales >= v.target;

注意当VALUES被用在一个FROM子句中时， 需要提供一个AS句，与SELECT相同。 不需要为所有的列用AS子句指定名称，但是那样做是一种好习惯。在Greenplum数据库中，VALUES的默认列名是column1、column2等，但在其他数据库系统中可能会不同。

当在INSERT中使用VALUES时，值都会被自动地强制为相应目标列的数据类型。当在其他环境中使用时，有必要指定正确的数据类型。如果项都是带引号的字符串常量，强制第一个就足以为所有项假设数据类型：

  1. SELECT * FROM machines WHERE ip_address IN 
  2. (VALUES('192.168.0.1'::inet), ('192.168.0.10'), 
  3. ('192.0.2.43'));

tips： 对于简单的IN测试，最好使用IN的list-of-scalars形式 而不是写一个上面那样的VALUES查询。标量列表方法的书写更少并且常常更加高效。

兼容性

VALUES符合 SQL 标准，但LIMIT 和OFFSET是Greenplum数据库的扩展。

另见

INSERT, SELECT

上级主题： SQL命令参考