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

Hive Bitmap UDF

Hive Bitmap UDF は、Hive で直接使用できる UDF を提供します。これらは Bitmap データを生成し、Bitmap に関連する計算を行うために使用できます。

Hive Bitmap UDF で定義された Bitmap フォーマットは StarRocks のフォーマットと一致しており、Bitmap データを StarRocks にロードしたり、StarRocks から Hive にアンロードしたりする際に直接使用できます。

適用シナリオ:

  • 生データの量が多く、これらのデータを直接 StarRocks にロードして計算すると、StarRocks クラスターに大きな負荷がかかります。望ましい解決策は、Hive で Bitmap データを生成し、それを StarRocks にロードすることです。
  • StarRocks で生成された Bitmap データを他のシステムで使用するために Hive にエクスポートします。

サポートされているソースおよびターゲットデータタイプ:

  • v3.1 以降では、String、Base64、Binary のデータのロードとアンロードをサポートしています。
  • v2.5 および v3.0 では、String と Base64 データのロードとアンロードのみをサポートしています。

生成可能な Hive Bitmap UDF​

  • com.starrocks.hive.udf.UDAFBitmapAgg

    列内の複数の非 NULL 値を 1 行の Bitmap 値に結合します。これは StarRocks の組み込み集計関数 bitmap_agg に相当します。

  • com.starrocks.hive.udf.UDAFBitmapUnion

    一連のビットマップの和集合を計算します。これは StarRocks の組み込み集計関数 bitmap_union に相当します。

  • com.starrocks.hive.udf.UDFBase64ToBitmap

    base64 エンコードされた文字列をビットマップに変換します。これは StarRocks の組み込み関数 base64_to_bitmap に相当します。

  • com.starrocks.hive.udf.UDFBitmapAnd

    2 つのビットマップの交差を計算します。これは StarRocks の組み込み関数 bitmap_and に相当します。

  • com.starrocks.hive.udf.UDFBitmapCount

    ビットマップ内の値の数をカウントします。これは StarRocks の組み込み関数 bitmap_count に相当します。

  • com.starrocks.hive.udf.UDFBitmapFromString

    カンマ区切りの文字列をビットマップに変換します。これは StarRocks の組み込み関数 bitmap_from_string に相当します。

  • com.starrocks.hive.udf.UDFBitmapOr

    2 つのビットマップの和集合を計算します。これは StarRocks の組み込み関数 bitmap_or に相当します。

  • com.starrocks.hive.udf.UDFBitmapToBase64

    Bitmap を Base64 文字列に変換します。これは StarRocks の組み込み関数 bitmap_to_base64 に相当します。

  • com.starrocks.hive.udf.UDFBitmapToString

    ビットマップをカンマ区切りの文字列に変換します。これは StarRocks の組み込み関数 bitmap_to_string に相当します。

  • com.starrocks.hive.udf.UDFBitmapXor

    2 つのビットマップのユニークな要素の集合を計算します。これは StarRocks の組み込み関数 bitmap_xor に相当します。

使用方法​

  1. FE で Hive UDF をコンパイルして生成します。

    ./build.sh --hive-udf

    fe/hive-udf/ ディレクトリに JAR パッケージ hive-udf-1.0.0.jar が生成されます。

  2. JAR パッケージを HDFS にアップロードします。

    hadoop fs -put -f ./hive-udf-1.0.0.jar hdfs://<hdfs_ip>:<hdfs_port>/hive-udf-1.0.0.jar

  3. JAR パッケージを Hive にロードします。

    hive> add jar hdfs://<hdfs_ip>:<hdfs_port>/hive-udf-1.0.0.jar;

  4. UDF 関数をロードします。

    hive> create temporary function bitmap_agg as 'com.starrocks.hive.udf.UDAFBitmapAgg';
    hive> create temporary function bitmap_union as 'com.starrocks.hive.udf.UDAFBitmapUnion';
    hive> create temporary function base64_to_bitmap as 'com.starrocks.hive.udf.UDFBase64ToBitmap';
    hive> create temporary function bitmap_and as 'com.starrocks.hive.udf.UDFBitmapAnd';
    hive> create temporary function bitmap_count as 'com.starrocks.hive.udf.UDFBitmapCount';
    hive> create temporary function bitmap_from_string as 'com.starrocks.hive.udf.UDFBitmapFromString';
    hive> create temporary function bitmap_or as 'com.starrocks.hive.udf.UDFBitmapOr';
    hive> create temporary function bitmap_to_base64 as 'com.starrocks.hive.udf.UDFBitmapToBase64';
    hive> create temporary function bitmap_to_string as 'com.starrocks.hive.udf.UDFBitmapToString';
    hive> create temporary function bitmap_xor as 'com.starrocks.hive.udf.UDFBitmapXor';

使用例​

Hive で Bitmap を生成し、Binary フォーマットで StarRocks にロードする​

  1. Hive ソーステーブルを作成します。

    hive> create table t_src(c1 bigint, c2 bigint) stored as parquet;

    hive> insert into t_src values (1,1), (1,2), (1,3), (2,4), (2,5);

    hive> select * from t_src;
    1       1
    1       2
    1       3
    2       4
    2       5

  2. Hive ビットマップテーブルを作成します。

    hive> create table t_bitmap(c1 bigint, c2 binary) stored as parquet;

    Hive は UDFBitmapAgg を通じてビットマップを生成し、それをビットマップテーブルに書き込みます。

    hive> insert into t_bitmap select c1, bitmap_agg(c2) from t_src group by c1;

  3. StarRocks ビットマップテーブルを作成します。

    mysql> create table t1(c1 int, c2 bitmap bitmap_union) aggregate key(c1) distributed by hash(c1);

  4. Bitmap データを異なる方法で StarRocks にロードします。

    • files 関数を使用してデータをロードします。
    mysql> insert into t1 select c1, bitmap_from_binary(c2) from files (
        "path" = "hdfs://<hdfs_ip>:<hdfs_port>/<hdfs_db>/t_bitmap/*",
        "format"="parquet",
        "compression" = "uncompressed"
        );
    • Hive Catalog を使用してデータをロードします。
    mysql> insert into t1 select c1, bitmap_from_binary(c2) from hive_catalog_hms.xxx_db.t_bitmap;

  5. 結果を確認します。

    mysql> select c1, bitmap_to_string(c2) from t1;                                                                                                                                                                                                                                   
    +------+----------------------+                                                                                                                                                                                                                                                   
    | c1   | bitmap_to_string(c2) |
    +------+----------------------+
    |    1 | 1,2,3                |
    |    2 | 4,5                  |
    +------+----------------------+

StarRocks から Hive へ Bitmap をエクスポートする​

  1. StarRocks に Bitmap テーブルを作成し、このテーブルにデータを書き込みます。

    mysql> create table t1(c1 int, c2 bitmap bitmap_union) aggregate key(c1) buckets 3 distributed by hash(c1);

    mysql> select c1, bitmap_to_string(c2) from t1;                                                                                                                                                                                                                                   
    +------+----------------------+                                                                                                                                                                                                                                                   
    | c1   | bitmap_to_string(c2) |
    +------+----------------------+
    |    1 | 1,2,3                |
    |    2 | 4,5                  |
    +------+----------------------+

  2. Hive に Bitmap テーブルを作成します。

    hive> create table t_bitmap(c1 bigint, c2 binary) stored as parquet;

  3. 異なる方法でデータをエクスポートします。

    • INSERT INTO FILES (Binary フォーマット) を使用してデータをエクスポートします。
    mysql> insert into files (
        "path" = "hdfs://<hdfs_ip>:<hdfs_port>/<hdfs_db>/t_bitmap/",
        "format"="parquet",
        "compression" = "uncompressed"
    ) select c1, bitmap_to_binary(c2) as c2 from t1;
    • Hive Catalog (Binary フォーマット) を使用してデータをエクスポートします。
    mysql> insert into hive_catalog_hms.<hdfs_db>.t_bitmap select c1, bitmap_to_binary(c2) from t1;

  4. Hive で結果を確認します。

    hive> select c1, bitmap_to_string(c2) from t_bitmap;
    1       1,2,3
    2       4,5
Rocky the happy otterStarRocks Assistant

AI generated answers are based on docs and other sources. Please test answers in non-production environments.