Перейти к содержимому
Последнее обновление

MAP_FROM_ENTRIES

Описание​

Создаёт MAP<K, V> из массива, элементы которого представляют собой STRUCT с двумя полями. Первое поле используется в качестве ключа, а второе в качестве значения.

Синтаксис​

MAP_FROM_ENTRIES(<entries>)

Параметры​

ПараметрОписание
<entries>Массив типа ARRAY<STRUCT<K, V>>. Каждый STRUCT должен содержать ровно два поля. Массив может быть NULL, и оба поля внутри STRUCT могут быть NULL, но сам элемент массива типа STRUCT не может быть NULL. Тип K должен поддерживаться для ключей MAP.

Возвращаемое значение​

Возвращает MAP<K, V>.

  • Если <entries> имеет значение NULL, возвращается NULL.
  • Поля со значением NULL внутри STRUCT, который сам не равен NULL, сохраняются как ключи или значения NULL.
  • Если сам элемент массива типа STRUCT равен NULL, возникает ошибка во время выполнения.
  • Если входное значение не является массивом STRUCT или STRUCT содержит меньше или больше двух полей, возникает ошибка на этапе анализа.
  • Если тип K не поддерживается для ключей MAP, возникает ошибка на этапе анализа.
  • Если ключ встречается несколько раз, сохраняется значение из его последнего вхождения.

Примеры​

SELECT map_from_entries(array(struct(1, 10), struct(2, 20))) AS result;
+--------------+
| result       |
+--------------+
| {1:10, 2:20} |
+--------------+
SELECT map_from_entries(array(struct(1, 10), struct(1, 20))) AS result;
+--------+
| result |
+--------+
| {1:20} |
+--------+
SELECT map_from_entries(CAST(NULL AS ARRAY<STRUCT<k:INT,v:INT>>));
+------------------------------------------------------------+
| map_from_entries(CAST(NULL AS ARRAY<STRUCT<k:INT,v:INT>>)) |
+------------------------------------------------------------+
| NULL                                                       |
+------------------------------------------------------------+
SELECT map_from_entries(array(
    struct(CAST(NULL AS INT), 10),
    struct(2, CAST(NULL AS INT)))) AS result;
+-------------------+
| result            |
+-------------------+
| {null:10, 2:null} |
+-------------------+

Следующий пример завершается ошибкой, поскольку массив содержит элемент STRUCT со значением NULL:

SELECT map_from_entries(array(CAST(NULL AS STRUCT<k:INT,v:INT>)));
ERROR 1105 (HY000): Map entry of function map_from_entries cannot be null

Следующий пример завершается ошибкой на этапе анализа, поскольку STRUCT содержит три поля:

SELECT map_from_entries(array(struct(1, 2, 3)));
ERROR 1105 (HY000): map_from_entries requires an array of structs with exactly two fields
Report issue