EXPLODE_MAP_OUTER

Описание

Табличная функция explode_map_outer принимает значение типа map и разворачивает его в несколько строк, каждая из которых содержит пару ключа и значения. Её следует использовать совместно с LATERAL VIEW.

Синтаксис

EXPLODE_MAP_OUTER(<map>)

Параметры

• <map> Значение типа MAP.

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

• Возвращает результат из одного столбца и нескольких строк, содержащий все элементы из <map>. Тип столбца: Nullable<Struct<K, V>>.
• Если <map> равен NULL или пуст, возвращается 1 строка со значением NULL.

Примеры

0. Подготовка данных

   create table example(
       k1 int
   ) properties(
       "replication_num" = "1"
   );
   
   insert into example values(1);
1. Обычные параметры

   select  * from example lateral view explode_map_outer(map("k", "v", "k2", 123, null, null)) t2 as c;

   +------+-----------------------------+
   | k1   | c                           |
   +------+-----------------------------+
   |    1 | {"col1":"k", "col2":"v"}    |
   |    1 | {"col1":"k2", "col2":"123"} |
   |    1 | {"col1":null, "col2":null}  |
   +------+-----------------------------+
2. Разворачивание пар ключей и значений в отдельные столбцы

   select  * from example lateral view explode_map_outer(map("k", "v", "k2", 123, null, null)) t2 as k, v;

   +------+------+------+
   | k1   | k    | v    |
   +------+------+------+
   |    1 | k    | v    |
   |    1 | k2   | 123  |
   |    1 | NULL | NULL |
   +------+------+------+
3. Пустой объект

   select  * from example lateral view explode_map_outer(map()) t2 as c;

   +------+------+
   | k1   | c    |
   +------+------+
   |    1 | NULL |
   +------+------+
4. Параметр NULL

   select  * from example lateral view explode_map_outer(cast('ab' as map<string,string>)) t2 as c;

   +------+------+
   | k1   | c    |
   +------+------+
   |    1 | NULL |
   +------+------+