POSEXPLODE_OUTER

説明

posexplode_outer テーブル関数は <array> 列を複数行に展開し、位置を示す列を追加して、STRUCT 型で返します。 Lateral View と併用し、複数の Lateral View をサポートします。 posexplode_outer と posexplode の主な違いは、null 値の扱いです。

構文

POSEXPLODE_OUTER(<array>)

パラメータ

• <array> 配列型。NULL はサポートされません。

戻り値

• 単一列、複数行の STRUCT データを返します。STRUCT は次の二つの列で構成されます。
  1. 0 から始まり、1 ずつ増加して n – 1 に至る整数の列。n は結果の行数を表します。
  2. <array> の全要素を含む列。
• <array> が NULL または空の配列（要素数が 0）の場合、NULL を含む 1 行を返します。

使用上の注意

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_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 |
   +------+------+-------+
2. 空の配列

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

   +------+------+
   | k1   | c    |
   +------+------+
   |    1 | NULL |
   +------+------+
3. 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
4. 配列型以外のパラメータ

   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)