POSEXPLODE

Описание

Табличная функция posexplode разворачивает столбец <array> в несколько строк и добавляет столбец с позицией элемента, возвращая данные типа STRUCT. Она используется совместно с Lateral View и поддерживает несколько Lateral View. Основное различие между posexplode и posexplode_outer заключается в обработке значений NULL.

Синтаксис

POSEXPLODE(<array>)

Параметры

• <array>: тип Array, NULL не поддерживается.

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

• Возвращает данные типа STRUCT в одном столбце и нескольких строках. STRUCT состоит из двух столбцов:

1. Столбец целых чисел, начиная с 0 с шагом 1 до n – 1, где n обозначает количество строк результата.
2. Столбец, содержащий все элементы <array>.

• Если <array> имеет значение NULL или является пустым массивом (количество элементов равно 0), возвращается 0 строк.

Примечания по использованию

1. <array> не может быть NULL или иметь другой тип, иначе возникает ошибка.

Примеры

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

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

   select  * from (select 1 as k1) t1 lateral view posexplode([1, 2, null, 4, 5]) t2 as c;

   +------+-----------------------+
   | k1   | c                     |
   +------+-----------------------+
   |    1 | {"pos":0, "col":1}    |
   |    1 | {"pos":1, "col":2}    |
   |    1 | {"pos":2, "col":null} |
   |    1 | {"pos":3, "col":4}    |
   |    1 | {"pos":4, "col":5}    |
   +------+-----------------------+

   select  * from (select 1 as k1) t1 lateral view posexplode([1, 2, null, 4, 5]) t2 as pos, value;

   +------+------+-------+
   | k1   | pos  | value |
   +------+------+-------+
   |    1 |    0 |     1 |
   |    1 |    1 |     2 |
   |    1 |    2 |  NULL |
   |    1 |    3 |     4 |
   |    1 |    4 |     5 |
   +------+------+-------+
2. Пустой массив

   select  * from (select 1 as k1) t1 lateral view posexplode([]) t2 as c;

   Empty set (0.03 sec)
3. Параметр NULL

   select  * from (select 1 as k1) t1 lateral view posexplode(NULL) t2 as c;

   ERROR 1105 (HY000): errCode = 2, detailMessage = only support array type for posexplode function but got NULL
4. Параметр, не являющийся массивом

   select  * from (select 1 as k1) t1 lateral view posexplode('abc') t2 as c;

   ERROR 1105 (HY000): errCode = 2, detailMessage = only support array type for posexplode function but got VARCHAR(3)