メインコンテンツまでスキップ
バージョン: 26.x

EXPLODE_BITMAP_OUTER

説明

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

構文

EXPLODE_BITMAP_OUTER(<bitmap>)

パラメータ

戻り値

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

使用上の注意

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

  1. データの準備

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

    insert into example values(1);
  2. 通常パラメータ

    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 |
    +------+------+
  3. 空の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 |
    +------+------+
  4. NULLパラメータ

    select  * from example lateral view explode_bitmap_outer(NULL) t2 as c;
    +------+------+
    | k1 | e1 |
    +------+------+
    | 1 | NULL |
    +------+------+
  5. 非配列パラメータ

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