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 |