bitmap_to_binary

将 Bitmap 值转换为 Binary 字符串。

bitmap_to_binary 主要用于导出 Bitmap 数据。压缩效果优于 bitmap_to_base64。

如果您计划将数据直接导出到 Parquet 等二进制文件，建议使用此函数。

此函数从 v3.0 版本开始支持。

语法

VARBINARY bitmap_to_binary(BITMAP bitmap)

参数

bitmap：要转换的 Bitmap，必需。如果输入值无效，则返回错误。

返回值

返回 VARBINARY 类型的值。

示例

示例 1：将此函数与其他 bitmap 函数一起使用。

mysql> select hex(bitmap_to_binary(bitmap_from_string("0, 1, 2, 3")));
+---------------------------------------------------------+
| hex(bitmap_to_binary(bitmap_from_string('0, 1, 2, 3'))) |
+---------------------------------------------------------+
| 023A3000000100000000000300100000000000010002000300      |
+---------------------------------------------------------+
1 row in set (0.01 sec)

mysql> select hex(bitmap_to_binary(to_bitmap(1)));
+-------------------------------------+
| hex(bitmap_to_binary(to_bitmap(1))) |
+-------------------------------------+
| 0101000000                          |
+-------------------------------------+
1 row in set (0.01 sec)

mysql> select hex(bitmap_to_binary(bitmap_empty()));
+---------------------------------------+
| hex(bitmap_to_binary(bitmap_empty())) |
+---------------------------------------+
| 00                                    |
+---------------------------------------+
1 row in set (0.01 sec)

示例 2：将 BITMAP 列中的每个值转换为二进制字符串。

1. 创建 Aggregate 表 page_uv，其中 AGGREGATE KEY 为 (page_id, visit_date)。此表包含一个 BITMAP 列 visit_users，其值将被聚合。

       CREATE TABLE `page_uv`
       (`page_id` INT NOT NULL,
       `visit_date` datetime NOT NULL,
       `visit_users` BITMAP BITMAP_UNION NOT NULL
       ) ENGINE=OLAP
       AGGREGATE KEY(`page_id`, `visit_date`)
       DISTRIBUTED BY HASH(`page_id`)
       PROPERTIES (
       "replication_num" = "3",
       "storage_format" = "DEFAULT"
       );

2. 将数据插入到此表中。

     insert into page_uv values
     (1, '2020-06-23 01:30:30', to_bitmap(13)),
     (1, '2020-06-23 01:30:30', to_bitmap(23)),
     (1, '2020-06-23 01:30:30', to_bitmap(33)),
     (1, '2020-06-23 02:30:30', to_bitmap(13)),
     (2, '2020-06-23 01:30:30', to_bitmap(23));
     
     select * from page_uv order by page_id;
     +---------+---------------------+-------------+
     | page_id | visit_date          | visit_users |
     +---------+---------------------+-------------+
     |       1 | 2020-06-23 01:30:30 | NULL        |
     |       1 | 2020-06-23 02:30:30 | NULL        |
     |       2 | 2020-06-23 01:30:30 | NULL        |
     +---------+---------------------+-------------+

3. 将 visit_users 列中的每个值转换为二进制编码的字符串。

      mysql> select page_id, hex(bitmap_to_binary(visit_users)) from page_uv;
      +---------+------------------------------------------------------------+
      | page_id | hex(bitmap_to_binary(visit_users))                         |
      +---------+------------------------------------------------------------+
      |       1 | 0A030000000D0000000000000017000000000000002100000000000000 |
      |       1 | 010D000000                                                 |
      |       2 | 0117000000                                                 |
      +---------+------------------------------------------------------------+
      3 rows in set (0.01 sec)