メインコンテンツまでスキップ

base64_to_bitmap

Description​

StarRocks にビットマップデータをインポートする前に、データをシリアライズし、Base64 文字列としてエンコードする必要があります。Base64 文字列を StarRocks にインポートする際には、その文字列をビットマップデータに変換する必要があります。この関数は、Base64 文字列をビットマップデータに変換するために使用されます。

この関数は v2.3 からサポートされています。

Syntax​

BITMAP base64_to_bitmap(VARCHAR bitmap)

Parameters​

bitmap: サポートされているデータ型は VARCHAR です。StarRocks にビットマップデータをロードする前に、Java または C++ を使用して BitmapValue オブジェクトを作成 し、要素を追加し、データをシリアライズして Base64 文字列としてエンコードします。その後、この関数の入力パラメータとして Base64 文字列を渡します。

Return value​

BITMAP 型の値を返します。

Examples​

bitmapdb という名前のデータベースと bitmap という名前のテーブルを作成します。Stream Load を使用して JSON データを bitmap_table にインポートします。この過程で、base64_to_bitmap を使用して JSON ファイル内の Base64 文字列をビットマップデータに変換します。

  1. StarRocks にデータベースとテーブルを作成します。この例では、主キーテーブルを作成します。

    CREATE database bitmapdb;
    USE bitmapdb;
    CREATE TABLE `bitmap_table` (
    `tagname` varchar(65533) NOT NULL COMMENT "Tag name",
    `tagvalue` varchar(65533) NOT NULL COMMENT "Tag value",
    `userid` bitmap NOT NULL COMMENT "User ID"
    ) ENGINE=OLAP
    PRIMARY KEY(`tagname`, `tagvalue`)
    COMMENT "OLAP"
    DISTRIBUTED BY HASH(`tagname`)
    PROPERTIES (
    "replication_num" = "3",
    "storage_format" = "DEFAULT"
    );

  2. Stream Load を使用して JSON データを bitmap_table にインポートします。

    simpledata という名前の JSON ファイルがあるとします。このファイルには以下の内容があり、userid は Base64 エンコードされた文字列です。

    {
        "tagname": "Product", "tagvalue": "Insurance", "userid":"AjowAAABAAAAAAACABAAAAABAAIAAwA="
    }

    base64_to_bitmap を使用して userid をビットマップ値に変換します。

    curl --location-trusted -u <username>:<password>\
        -H "columns: c1,c2,c3,tagname=c1,tagvalue=c2,userid=base64_to_bitmap(c3)"\
        -H "label:bitmap123"\
        -H "format: json"\
        -H "jsonpaths: [\"$.tagname\",\"$.tagvalue\",\"$.userid\"]"\
        -T simpleData http://host:port/api/bitmapdb/bitmap_table/_stream_load

  3. bitmap_table からデータをクエリします。

    mysql> select tagname,tagvalue,bitmap_to_string(userid) from bitmap_table;
    +--------------+----------+----------------------------+
    | tagname      | tagvalue | bitmap_to_string(`userid`) |
    +--------------+----------+----------------------------+
    | Product      | Insurance      | 1,2,3                |
    +--------------+----------+----------------------------+
    1 rows in set (0.01 sec)