Распаковка

Примеры

Распакуйте список, сгенерировав 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 предложении. Вызов unnest с параметром recursive будет распаковывать списки и структуры на несколько уровней. Глубина распаковки может быть ограничена с помощью параметра 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);

Вызов unnest с параметром recursive полностью распакует списки, а затем полностью распакует структуры. Это может быть полезно для полного сглаживания столбцов, содержащих списки в списках или списки структур. Обратите внимание, что списки *внутри* структур не распаковываются.

Установка максимальной глубины распаковки

Параметр max_depth позволяет ограничить максимальную глубину рекурсивной распаковки (которая предполагается по умолчанию и не должна указываться отдельно). Например, распаковка до max_depth 2 дает следующее:

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

В то же время, распаковка до max_depth 3 приводит к:

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

Отслеживание позиций элементов списка

Чтобы отслеживать позицию каждой записи в исходном списке, unnest можно комбинировать с generate_subscripts:

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