⌘+k ctrl+k
1.1.3 (stable)
Search Shortcut cmd + k | ctrl + k
Unnesting

Examples

展开一个列表,生成3行(1, 2, 3):

SELECT unnest([1, 2, 3]);

解构一个结构体,生成两列 (a, b):

SELECT unnest({'a': 42, 'b': 84});

递归展开结构体列表:

SELECT unnest([{'a': 42, 'b': 84}, {'a': 100, 'b': NULL}], recursive := true);

使用max_depth限制递归展开的深度:

SELECT unnest([[[1, 2], [3, 4]], [[5, 6], [7, 8, 9], []], [[10, 11]]], max_depth := 2);

unnest 特殊函数用于将列表或结构体展开一层。该函数可以作为常规标量函数使用,但只能在 SELECT 子句中使用。使用 recursive 参数调用 unnest 将展开多层列表和结构体。可以使用 max_depth 参数限制展开的深度(默认情况下假定为 recursive 展开)。

解嵌套列表

展开一个列表,生成3行(1, 2, 3):

SELECT unnest([1, 2, 3]);

展开一个标量列表,生成3行 ((1, 10), (2, 11), (3, NULL)):

SELECT unnest([1, 2, 3]), unnest([10, 11]);

展开一个标量列表,生成3行 ((1, 10), (2, 10), (3, 10)):

SELECT unnest([1, 2, 3]), 10;

展开由子查询生成的列表列:

SELECT unnest(l) + 10 FROM (VALUES ([1, 2, 3]), ([4, 5])) tbl(l);

空结果:

SELECT unnest([]);

空结果:

SELECT unnest(NULL);

在列表上使用unnest将为列表中的每个条目生成一个元组。当unnest与常规标量表达式结合使用时,这些表达式会为列表中的每个条目重复。当在同一个SELECT子句中解嵌套多个列表时,这些列表会并排解嵌套。如果一个列表比另一个长,较短的列表将用NULL值填充。

一个空列表和一个NULL列表都会展开为零个元素。

解构结构体

解构一个结构体,生成两列 (a, b):

SELECT unnest({'a': 42, 'b': 84});

解构一个结构体,生成两列 (a, b):

SELECT unnest({'a': 42, 'b': {'x': 84}});

unnest 在结构体上使用时,将为结构体中的每个条目生成一列。

递归展开

递归地展开一个列表的列表,生成5行(1, 2, 3, 4, 5):

SELECT unnest([[1, 2, 3], [4, 5]], recursive := true);

递归展开结构体列表,生成两行两列(a, b):

SELECT unnest([{'a': 42, 'b': 84}, {'a': 100, 'b': NULL}], recursive := true);

解构一个结构体,生成两列 (a, b):

SELECT unnest({'a': [1, 2, 3], 'b': 88}, recursive := true);

使用recursive设置调用unnest将完全展开列表,然后完全展开结构体。这对于完全展平包含列表中的列表或结构体列表的列非常有用。请注意,结构体内部的列表不会被展开。

设置解嵌套的最大深度

max_depth 参数允许限制递归展开的最大深度(默认情况下假设为无限深度,不需要单独指定)。 例如,展开到 max_depth 为 2 时,结果如下:

SELECT unnest([[[1, 2], [3, 4]], [[5, 6], [7, 8, 9], []], [[10, 11]]], max_depth := 2) AS x;
x
[1, 2]
[3, 4]
[5, 6]
[7, 8, 9]
[]
[10, 11]

同时,展开到max_depth为3的结果是:

SELECT unnest([[[1, 2], [3, 4]], [[5, 6], [7, 8, 9], []], [[10, 11]]], max_depth := 3) AS x;
x
1
2
3
4
5
6
7
8
9
10
11

跟踪列表条目位置

为了跟踪每个条目在原始列表中的位置,unnest 可以与 generate_subscripts 结合使用:

SELECT unnest(l) AS x, generate_subscripts(l, 1) AS index
FROM (VALUES ([1, 2, 3]), ([4, 5])) tbl(l);
x 索引
1 1
2 2
3 3
4 1
5 2