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 |