unnest

签名

PostgreSQL 18 里 unnest 的 4 条签名，按上游手册顺序排列。参数名用斜体，类型用弱化色，→ 之后是返回类型。说明取自本站手册译文：标「沿用」的借用了另一版的译文，标「EN」的本站暂无译文、按英文原文显示。

1. unnest ( tsvector ) → setof record ( lexeme text, positions smallint[], weights text )

   将tsvector展开为一组行，每行对应一个词位。
   • select * from unnest('cat:3 fat:2,4 rat:5A'::tsvector)→ lexeme | positions | weights --------+-----------+--------- cat | {3} | {D} fat | {2,4} | {D,D} rat | {5} | {A}

2. unnest ( anyarray ) → setof anyelement

   将数组展开到一组行。数组的元素按存储顺序读出。
   • unnest(ARRAY[1,2])→1 2
   • unnest(ARRAY[['foo','bar'],['baz','quux']])→foo bar baz quux

3. unnest ( anyarray, anyarray [, ... ] ) → setof anyelement, anyelement [, ... ]

   将多个数组（可能是不同的数据类型）展开到一组行中。如果数组的长度不完全相同，那么较短的数组将用NULL填充。这种形式只允许出现在查询的 FROM 子句中；参见第 7.2.1.4 节。
   • select * from unnest(ARRAY[1,2], ARRAY['foo','bar','baz']) as x(a,b)→ a | b ---+----- 1 | foo 2 | bar | baz

4. unnest ( anymultirange ) → setof anyrange

   将多范围按升序展开为一组范围。
   • unnest('{[1,2), [3,4)}'::int4multirange)→[1,2) [3,4)

演化历史

相邻两个大版本之间的差异，新的在前。版本号链到该版的签名。

1. PostgreSQL 14 ← 13 签名变更

   +unnest ( anymultirange ) → setof anyrange

2. PostgreSQL 13 ← 12 手册重排

   这一跳手册重排了函数表的写法，签名文本整体改写，只记函数的增删，不逐条比较签名。

3. PostgreSQL 9.6 ← 9.5 签名变更

   +unnest ( tsvector, OUT lexeme text, OUT positions smallint[], OUT weights text ) → setof record ↕array→textsearch 说明更新

4. PostgreSQL 9.4 ← 9.3 签名变更

   +unnest ( anyarray, anyarray [, ...] ) → setof anyelement, anyelement [, ...]

签名矩阵

每条签名在给出了签名的 18 个版本里的存在情况；方格指向该版的签名。只在正文里提到此函数、没有给出签名的版本不列进来，上面的版本轨迹里仍然有它们。签名文本在 PostgreSQL 13 前后写法不同，跨越那一跳的同一条签名会显示成两行。

存在 不存在

相关函数

同一分组里紧挨着的函数。

ts_statts_token_typetsquery_phrasetsvector_to_arraywebsearch_to_tsquery

同组函数