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

POSEXPLODE_OUTER

Описание​

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

Синтаксис​

POSEXPLODE_OUTER(<array>)

Параметры​

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

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

  • Возвращает данные типа STRUCT в одном столбце и нескольких строках. STRUCT состоит из двух столбцов:
    1. Столбец целых чисел, начиная с 0 и увеличиваясь на 1 до n – 1, где n обозначает количество строк результата.
    2. Столбец, содержащий все элементы <array>.
  • Если <array> имеет значение NULL или является пустым массивом (количество элементов равно 0), возвращается 1 строка со значением NULL.

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

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

Примеры​

  1. Подготовка данных 
    create table example(
        k1 int
    ) properties(
        "replication_num" = "1"
    );

    insert into example values(1);
  2. Обычные параметры 
    select  * from (select 1 as k1) t1 lateral view posexplode_outer([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_outer([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 |
    +------+------+-------+
  3. Пустой массив 
    select  * from (select 1 as k1) t1 lateral view posexplode_outer([]) t2 as c;
    +------+------+
    | k1   | c    |
    +------+------+
    |    1 | NULL |
    +------+------+
  4. Параметр NULL 
    select  * from (select 1 as k1) t1 lateral view posexplode_outer(NULL) t2 as c;
    ERROR 1105 (HY000): errCode = 2, detailMessage = only support array type for posexplode_outer function but got NULL
  5. Параметр, не являющийся массивом 
    select  * from (select 1 as k1) t1 lateral view posexplode_outer('abc') t2 as c;
    ERROR 1105 (HY000): errCode = 2, detailMessage = only support array type for posexplode_outer function but got VARCHAR(3)
Report issue