EXPLODE_BITMAP_OUTER

説明

explode_bitmap_outerテーブル関数は、bitmap型のデータを受け取り、bitmapの各ビットを個別の行にマッピングします。 一般的にbitmapデータを処理するために使用され、bitmap内の各要素を個別のレコードに展開します。LATERAL VIEWと組み合わせて使用する必要があります。 explode_bitmap_outerはexplode_bitmapと似ていますが、空またはNULL値を処理する際の動作が異なります。空またはNULLのbitmapを持つレコードの存在を許可し、結果においてそれらをNULL行に展開します。

構文

EXPLODE_BITMAP_OUTER(<bitmap>)

パラメータ

• <bitmap> BITMAP 型

戻り値

• <bitmap>内の各ビットに対して1行を返し、各行にはビット値が含まれます。
• <bitmap>がNULLの場合、NULLを含む1行が返されます。
• <bitmap>が空の場合、NULLを含む1行が返されます。

使用上の注意

1. <bitmap>パラメータがBITMAP型でない場合、エラーが報告されます。

例

0. データの準備

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

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 |
   +------+------+

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

3. NULLパラメータ

   select  * from example lateral view explode_bitmap_outer(NULL) t2 as c;

   +------+------+
   | k1   | e1   |
   +------+------+
   |    1 | NULL |
   +------+------+

4. 非配列パラメータ

   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))