EXPLODE_BITMAP_OUTER
説明
explode_bitmap_outerTable関数は、bitmap型のデータを受け取り、bitmapの各ビットを個別の行にマッピングします。
この関数は、bitmapデータを処理し、bitmap内の各要素を個別のレコードに展開するためによく使用されます。LATERAL VIEWと組み合わせて使用する必要があります。
explode_bitmap_outerはexplode_bitmapと似ていますが、空またはNULL値を処理する際の動作が異なります。この関数は、空またはNULLのbitmapを持つレコードの存在を許可し、それらを結果のNULL行として展開します。
構文
EXPLODE_BITMAP_OUTER(<bitmap>)
パラメータ
<bitmap>BITMAP型
戻り値
<bitmap>内の各ビットに対して行を返し、各行にはビット値が含まれます。<bitmap>が NULL の場合、NULL を含む 1 行が返されます。<bitmap>が空の場合、NULL を含む 1 行が返されます。
使用上の注意
<bitmap>パラメータがBITMAP型でない場合、エラーが報告されます。
例
-
データの準備
create table example(
k1 int
) properties(
"replication_num" = "1"
);
insert into example values(1); -
通常パラメータ
select k1, e1 from example lateral view explode_bitmap_outer(bitmap_from_string("1,3,4,5,6,10")) t2 as e1 order by k1, e1;+------+------+
| k1 | e1 |
+------+------+
| 1 | 1 |
| 1 | 3 |
| 1 | 4 |
| 1 | 5 |
| 1 | 6 |
| 1 | 10 |
+------+------+ -
空のBITMAP
select k1, e1 from example lateral view explode_bitmap_outer(bitmap_from_string("")) t2 as e1 order by k1, e1;+------+------+
| k1 | e1 |
+------+------+
| 1 | NULL |
+------+------+ -
NULLパラメータ
select * from example lateral view explode_bitmap_outer(NULL) t2 as c;+------+------+
| k1 | e1 |
+------+------+
| 1 | NULL |
+------+------+ -
非配列パラメータ
select * from example lateral view explode_bitmap_outer('abc') t2 as c;ERROR 1105 (HY000): errCode = 2, detailMessage = Can not find the compatibility function signature: explode_bitmap_outer(VARCHAR(3))