PostgreSQL 9.4.4 中文手册
上一页 | 上一级 | 章 9. 函数和操作符 | 下一页

# 9.24. 返回集合的函数

本节描述那些可能返回多于一行的函数。在这个类中最广泛使用的函数是序列号生成函数， 如表 9-54和表 9-55所述。 另外，更专业的集合返回函数在这个手册的其他地方描述。 参阅第 7.2.1.4 节获取组合多个设置返回函数的方法。

表 9-54. 序列号生成函数

函数 | 参数类型 | 返回类型 | 描述
--- | --- | --- | ---
``generate_series(`start`, `stop`)`` | `int` 或 `bigint` | `setof int` 或 `setof bigint` (与参数类型相同) | 生成一个数值序列，从`start`到`stop`，步长为 1 。
``generate_series(`start`, `stop`, `step`)`` | `int` 或 `bigint` | `setof int` 或 `setof bigint` (与参数类型相同) | 生成一个数值序列，从`start`到`stop`，步长为`step`。
``generate_series(`start`, `stop`, `step` `interval`)`` | `timestamp` 或 `timestamp with time zone` | `setof timestamp` 或 `setof timestamp with time zone` (与参数类型相同) | 生成一个数值序列，从`start`到`stop`，步长为`step`。

如果`step`是正数且`start`大于`stop`， 那么返回零行。相反，如果`step`是负数且`start` 小于`stop`，那么也返回零行。如果输入是`NULL`，同样产生零行。 `step`为零则是一个错误。下面是一些例子：

    SELECT * FROM generate_series(2,4);
     generate_series
    -----------------
                   2
                   3
                   4
    (3 rows)

    SELECT * FROM generate_series(5,1,-2);
     generate_series
    -----------------
                   5
                   3
                   1
    (3 rows)

    SELECT * FROM generate_series(4,3);
     generate_series
    -----------------
    (0 rows)

    -- this example relies on the date-plus-integer operator
    SELECT current_date + s.a AS dates FROM generate_series(0,14,7) AS s(a);
       dates
    ------------
     2004-02-05
     2004-02-12
     2004-02-19
    (3 rows)

    SELECT * FROM generate_series('2008-03-01 00:00'::timestamp,
                                  '2008-03-04 12:00', '10 hours');
       generate_series
    ---------------------
     2008-03-01 00:00:00
     2008-03-01 10:00:00
     2008-03-01 20:00:00
     2008-03-02 06:00:00
     2008-03-02 16:00:00
     2008-03-03 02:00:00
     2008-03-03 12:00:00
     2008-03-03 22:00:00
     2008-03-04 08:00:00
    (9 rows)

表 9-55. 下标生成函数

函数 | 返回类型 | 描述
--- | --- | ---
``generate_subscripts(`array anyarray`, `dim int`)`` | `setof int` | 生成一系列包括给定数组的下标。
``generate_subscripts(`array anyarray`, `dim int`, `reverse boolean`)`` | `setof int` | 生成一系列包括给定数组的下标。当`reverse`为真时， 该系列则以相反的顺序返回。

`generate_subscripts`是一个为给定数组中的指定维度生成有效下标集的便利函数。 如果数组中没有所请求的维度或者NULL数组，返回0行（但是会给数组元素为空的返回有效下标）。 下面一些例子：

    -- basic usage
    SELECT generate_subscripts('{NULL,1,NULL,2}'::int[], 1) AS s;
     s
    ---
     1
     2
     3
     4
    (4 rows)

    -- presenting an array, the subscript and the subscripted
    -- value requires a subquery
    SELECT * FROM arrays;
             a
    --------------------
     {-1,-2}
     {100,200,300}
    (2 rows)

    SELECT a AS array, s AS subscript, a[s] AS value
    FROM (SELECT generate_subscripts(a, 1) AS s, a FROM arrays) foo;
         array     | subscript | value
    ---------------+-----------+-------
     {-1,-2}       |         1 |    -1
     {-1,-2}       |         2 |    -2
     {100,200,300} |         1 |   100
     {100,200,300} |         2 |   200
     {100,200,300} |         3 |   300
    (5 rows)

    -- unnest a 2D array
    CREATE OR REPLACE FUNCTION unnest2(anyarray)
    RETURNS SETOF anyelement AS $$
    select $1[i][j]
       from generate_subscripts($1,1) g1(i),
            generate_subscripts($1,2) g2(j);
    $$ LANGUAGE sql IMMUTABLE;
    CREATE FUNCTION
    SELECT * FROM unnest2(ARRAY[[1,2],[3,4]]);
     unnest2
    ---------
           1
           2
           3
           4
    (4 rows)

当`FROM`子句中的一个函数带有`WITH ORDINALITY` 前缀时，一个`bigint`字段添加到输出中，该字段从1开始增长，步长为1。 这在设置返回函数比如`unnest()`的情况下非常有用。

    -- set returning function WITH ORDINALITY
    SELECT * FROM pg_ls_dir('.') WITH ORDINALITY AS t(ls,n);
           ls        | n
    -----------------+----
     pg_serial       |  1
     pg_twophase     |  2
     postmaster.opts |  3
     pg_notify       |  4
     postgresql.conf |  5
     pg_tblspc       |  6
     logfile         |  7
     base            |  8
     postmaster.pid  |  9
     pg_ident.conf   | 10
     global          | 11
     pg_clog         | 12
     pg_snapshots    | 13
     pg_multixact    | 14
     PG_VERSION      | 15
     pg_xlog         | 16
     pg_hba.conf     | 17
     pg_stat_tmp     | 18
     pg_subtrans     | 19
    (19 rows)

上一页 | 起始页 | 下一页
行和数组比较 | 上一级 | 系统信息函数