大网数据广告活动
数据库部署与 SQL 参考

StarRocks 中文参考:base64_to_bitmap

· 52CE 我爱测

导入外部 bitmap 数据到 StarRocks 时,需要先对 bitmap 数据进行序列化和 Base64 编码,生成 Base64 字符串。导入字符串到 StarRocks 时再进行 Base64 到 bitmap 的转化。 该函数用于将 Base64 编码的字符串转化为 bitmap。

base64_to_bitmap

导入外部 bitmap 数据到 StarRocks 时,需要先对 bitmap 数据进行序列化和 Base64 编码,生成 Base64 字符串。导入字符串到 StarRocks 时再进行 Base64 到 bitmap 的转化。 该函数用于将 Base64 编码的字符串转化为 bitmap。

该函数从 2.3 版本开始支持。

语法

BITMAP base64_to_bitmap(VARCHAR bitmap)

参数说明

bitmap:支持的数据类型为 VARCHAR。导入外部 bitmap 数据时,可使用 Java 或者 C++ 接口先创建 BitmapValue 对象,然后添加元素、序列化、Base64 编码,将得到的 Base64 字符串作为该函数的入参。

返回值说明

返回 BITMAP 类型的数据。

示例

创建库表 bitmapdb.bitmap_table,使用 Stream Load 将 JSON 格式数据导入到 bitmap_table 中,过程中使用base64_to_bitmap 函数进行数据转换。

  1. 在 StarRocks 中创建库和表,以创建主键表为例。

    CREATE database bitmapdb;
    USE bitmapdb;
    CREATE TABLE `bitmap_table` (
    `tagname` varchar(65533) NOT NULL COMMENT "标签名称",
    `tagvalue` varchar(65533) NOT NULL COMMENT "标签值",
    `userid` bitmap NOT NULL COMMENT "访问用户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 中。

    假设有 JSON 格式文件simpledata, 内容如下,userid为 Base64 编码后的字符串:

    {
        "tagname": "持有产品",
        "tagvalue": "保险",
        "userid":"AjowAAABAAAAAAACABAAAAABAAIAAwA="
    }
    
    • 导入 JSON 文件中的数据到 bitmap_table,使用 base64_to_bitmap 函数将 userid 转化为bitmap。
    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`) |
    +--------------+----------+----------------------------+
    | 持有产品      | 保险      | 1,2,3                      |
    +--------------+----------+----------------------------+
    1 rows in set (0.01 sec)
    

本文来自 StarRocks 文档贡献者,按 Apache 2.0 整理版式与相对链接,保留正文与代码。图示请参阅原文。作者与贡献记录。

资料来源与适用范围

资料来源
StarRocks 文档贡献者
适用范围
main 文档快照(2026-11-16)
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
Apache 2.0

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。