バージョン: 26.x

POSEXPLODE_OUTER

説明

posexplode_outerTable関数は、<array>列を複数行に展開し、位置を示す列を追加して、STRUCT型を返します。 Lateral Viewと組み合わせて使用する必要があり、複数のLateral Viewをサポートします。 posexplode_outerとposexplodeの主な違いは、null値の処理方法です。

構文

POSEXPLODE_OUTER(<array>)

パラメータ

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

戻り値

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

使用上の注意

<array>はNULLまたは他の型であってはなりません。そうでなければエラーが報告されます。

例

データの準備

create table example(
    k1 int
) properties(
    "replication_num" = "1"
);

insert into example values(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 |
+------+------+-------+

空の配列

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

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

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

非配列パラメータ

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)

説明​

構文​

パラメータ​

戻り値​

使用上の注意​

例​

説明

構文

パラメータ

戻り値

使用上の注意

例