@clickzetta/cz-cli-darwin-x64 0.3.1

package/bin/skills/lakehouse-doc/references/sql_functions/aggregate_functions/variance.md

@@ -0,0 +1,47 @@
+### VARIANCE 函数
+
+```
+variance([DISTINCT] expr)
+```
+
+#### 功能描述
+
+`VARIANCE` 函数是 `VAR_SAMP` 的别名，用于计算一组数值数据的样本方差。方差是衡量数据分布离散程度的统计量，它可以反映数据的波动性大小。
+
+#### 参数说明
+
+* `expr`：数值类型，可以是 `TINYINT`、`SMALLINT`、`INT`、`BIGINT`、`FLOAT`、`DOUBLE` 或 `DECIMAL` 类型。
+* `DISTINCT`（可选）：表示计算去重后的集合方差。如果不设置该参数，则计算包含重复值的集合方差。
+
+#### 返回类型
+
+* 返回 `DOUBLE` 类型的数值，表示计算得到的样本方差。
+
+#### 注意事项
+
+* 如果传入的参数包含 `NULL` 值，则 `NULL` 值不参与计算。
+* `VARIANCE` 函数与 `VAR_SAMP` 函数完全相同，可以互换使用。
+
+#### 使用示例
+
+1. 计算包含重复值的样本方差
+
+```sql
+SELECT variance(col) FROM VALUES (1), (2), (3), (3), (NULL) AS tab(col);
++--------------------+
+| `variance`(col)    |
++--------------------+
+| 0.9166666666666666 |
++--------------------+
+```
+
+2. 计算去重后的样本方差
+
+```sql
+SELECT variance(DISTINCT col) FROM VALUES (1), (2), (3), (3), (NULL) AS tab(col);
++--------------------------+
+| `variance`(DISTINCT col) |
++--------------------------+
+| 1.0                      |
++--------------------------+
+```

package/bin/skills/lakehouse-doc/references/sql_functions/aggregate_functions/wm_concat.md

@@ -0,0 +1,79 @@
+### WM_CONCAT 函数
+
+#### 概述
+
+`WM_CONCAT` 函数用于将一列的值通过指定的分隔符进行连接。此函数可以处理字符串类型数据，并在连接时可以选择去重或保留所有值。
+
+#### 语法
+
+```sql
+wm_concat([DISTINCT] separator, col)
+```
+
+#### 参数说明
+
+* `separator`: 字符串类型常量,作为连接值的分隔符。
+* `col`: 字符串类型,需要进行连接的列。
+
+#### 返回结果
+
+返回一个字符串类型的值，其中包含连接后的结果。如果设置了`DISTINCT`关键字,则计算去重后的集合；否则,保留所有值。`NULL`值不参与计算。
+
+#### 使用示例
+
+1. 使用&&拼接
+
+```sql
+SELECT wm_concat('&&', col) FROM VALUES ('row1'), (NULL), ('row3') AS t(col);
++----------------------+
+| wm_concat('&&', col) |
++----------------------+
+| row1&&row3           |
++----------------------+
+```
+
+2. 带分隔符的连接：
+
+```sql
+SELECT wm_concat(',', col) FROM VALUES (1), (NULL), (3) AS t(col);
++---------------------+
+| wm_concat(',', col) |
++---------------------+
+| 1,3                 |
++---------------------+
+```
+
+3. 去重连接并分组：
+
+```sql
+SELECT k, wm_concat(DISTINCT '|', v)
+FROM VALUES
+(1, 'ALLEN'),
+(1, NULL),
+(1, 'ALLEN'),
+(2, 'KING'),
+(2, 'ALEX') AS t(k, v) GROUP BY k;
++---+----------------------------+
+| k | wm_concat(DISTINCT '|', v) |
++---+----------------------------+
+| 1 | ALLEN                      |
+| 2 | KING|ALEX                  |
++---+----------------------------+
+```
+
+4. 连接时处理空格和特殊字符：
+
+```sql
+SELECT wm_concat(' - ', col) FROM VALUES ('John Doe'), ('Jane Smith'), (NULL), ('Alice Jones') AS t(col);
++-------------------------------------+
+|        wm_concat(' - ', col)        |
++-------------------------------------+
+| John Doe - Jane Smith - Alice Jones |
++-------------------------------------+
+```
+
+#### 注意事项
+
+* 当`col`列中的值为`NULL`时,`WM_CONCAT`函数不会将其包含在结果中。
+* 如果需要连接的列中包含空格或特殊字符，请确保使用适当的分隔符以避免歧义。
+* 使用`DISTINCT`关键字可以有效地去除重复的字符串值,但请注意,这可能会影响性能。在处理大量数据时,请谨慎使用此选项。

package/bin/skills/lakehouse-doc/references/sql_functions/context_functions/current_instance_id.md

@@ -0,0 +1,16 @@
+### CURRENT_INSTANCE_ID 函数
+
+#### 功能描述
+`CURRENT_INSTANCE_ID()` 函数用于获取当前会话所关联的实例（`instance`）的唯一标识符（`ID`）。该函数在分布式数据库系统中尤为重要,因为它可以帮助用户识别和追踪当前操作所处的实例。
+
+#### 使用方法
+`CURRENT_INSTANCE_ID()` 函数无需任何参数输入,直接调用即可。返回值是一个整数（`INT`）,表示当前会话关联的实例的`ID`。
+
+#### 示例
+以下是几个使用 `CURRENT_INSTANCE_ID()` 函数的示例：
+
+1. 在查询过程中获取当前实例ID：
+   ```sql
+   SELECT current_instance_id();
+   ```
+   执行上述查询后,将返回当前会话所关联的实例`ID`,例如：`123`。

package/bin/skills/lakehouse-doc/references/sql_functions/context_functions/current_schema.md

@@ -0,0 +1,29 @@
+### CURRENT_SCHEMA 函数
+
+#### 功能描述
+`CURRENT_SCHEMA` 函数用于获取当前会话正在使用的 `schema` 名称。该函数无需传入任何参数,返回值为字符串类型,表示当前会话的 `schema` 名称。
+
+#### 使用场景
+- 当需要根据当前会话的 `schema` 动态执行 `SQL` 语句时。
+- 在多 `schema` 环境下,用于判断当前会话所处的 `schema`。
+
+#### 返回结果
+`CURRENT_SCHEMA` 函数返回一个字符串,表示当前会话的 `schema` 名称。
+
+#### 使用示例
+
+**示例 1：获取当前 schema**
+```sql
+SELECT CURRENT_SCHEMA();
+```
+执行该语句后,如果当前会话使用的是默认 `schema`,则返回 "default"。
+
+**示例 2：切换 schema 后获取当前 schema**
+```sql
+-- 切换到指定 schema
+USE SCHEMA schema1;
+
+-- 获取当前 schema
+SELECT CURRENT_SCHEMA();
+```
+执行该语句后,返回 "schema1",表示当前会话已经切换到 "schema1"。

package/bin/skills/lakehouse-doc/references/sql_functions/context_functions/current_session_id.md

@@ -0,0 +1,30 @@
+### CURRENT_SESSION_ID 函数
+
+```
+current_session_id()
+```
+
+#### 功能描述
+
+`CURRENT_SESSION_ID` 函数用于返回当前会话的 Session ID。
+
+#### 参数说明
+
+* 无参数。
+
+#### 返回类型
+
+* 返回 `STRING` 类型的字符串，表示当前会话的 Session ID。
+
+#### 使用示例
+
+1. 获取当前会话 ID
+
+```sql
+SELECT current_session_id();
++--------------------------------------+
+| current_session_id()                 |
++--------------------------------------+
+| 18ae19ca-8789-4029-93bd-512c6aebd3fa |
++--------------------------------------+
+```

package/bin/skills/lakehouse-doc/references/sql_functions/context_functions/current_user.md

@@ -0,0 +1,29 @@
+### CURRENT_USER 函数
+
+#### 简介
+
+`CURRENT_USER` 函数用于获取当前数据库会话的用户名称。该函数不需要任何参数，并返回一个字符串类型的值，表示当前会话用户的名称。
+
+#### 语法
+
+```sql
+CURRENT_USER()
+```
+
+#### 返回结果
+
+`CURRENT_USER` 函数返回一个字符串，表示当前数据库会话的用户名称。
+
+#### 使用示例
+
+1. 查询当前会话的用户名称：
+
+```sql
+SELECT CURRENT_USER();
+```
+
+   执行该查询后，结果可能如下：
+
+   ```
+   user1
+   ```

package/bin/skills/lakehouse-doc/references/sql_functions/context_functions/current_user_id.md

@@ -0,0 +1,21 @@
+### CURRENT_USER_ID 函数
+
+#### 功能描述
+`CURRENT_USER_ID` 函数用于获取当前数据库会话用户的 `ID`。这个函数可以帮助您快速了解当前操作用户的身份，从而进行权限控制或其他相关操作。
+
+#### 使用方法
+`CURRENT_USER_ID` 函数不需要任何参数。您只需在 `SQL` 查询中调用此函数，它就会返回当前会话用户的 `ID`。
+
+#### 返回结果
+返回值类型为整数（`INT`），表示当前会话用户的 `ID`。
+
+#### 使用示例
+
+1. 查询当前用户的ID并显示结果：
+```sql
+SELECT CURRENT_USER_ID();
+```
+执行上述查询后，您将看到类似于以下的输出，它表示当前会话用户的 `ID`：
+```
+123
+```

package/bin/skills/lakehouse-doc/references/sql_functions/context_functions/current_vcluster.md

@@ -0,0 +1,40 @@
+### current_vcluster 函数
+
+#### 功能描述
+`current_vcluster` 函数用于获取当前会话所使用的计算集群名称。该函数无需传入任何参数,返回值为字符串类型,表示当前会话正在使用的计算集群。
+
+#### 使用场景
+在多计算集群的环境中,了解当前会话所使用的计算集群对于管理和优化资源分配具有重要意义。通过使用 `current_vcluster` 函数,用户可以轻松地查询和切换当前会话所使用的计算集群。
+
+#### 示例
+以下是 `current_vcluster` 函数的使用示例：
+
+1. 查询当前会话所使用的计算集群：
+```sql
+SELECT current_vcluster();
+```
+执行上述查询后,返回结果可能如下：
+```
+default
+```
+
+2. 切换计算集群并查询：
+```sql
+USE VCLUSTER test; -- 切换至名为test的计算集群
+SELECT current_vcluster();
+```
+执行上述查询后,返回结果可能如下：
+```
+test
+```
+
+3. 在不同的计算集群之间切换,并观察 `current_vcluster` 函数的返回值：
+```sql
+-- 切换至名为dev的计算集群
+USE VCLUSTER dev;
+SELECT current_vcluster();
+
+-- 切换回默认计算集群
+USE VCLUSTER default;
+SELECT current_vcluster();
+```

package/bin/skills/lakehouse-doc/references/sql_functions/context_functions/current_workspace.md

@@ -0,0 +1,19 @@
+### CURRENT_WORKSPACE 函数
+
+#### 功能描述
+`CURRENT_WORKSPACE` 函数用于获取当前数据库会话所连接的 `workspace` 名称。该函数不需要任何参数,返回值为字符串类型,表示当前会话所操作的 `workspace` 名称。
+
+#### 使用场景
+在多 `workspace` 环境下,可以通过 `CURRENT_WORKSPACE` 函数快速获取当前会话所在的 `workspace`,从而进行相关操作,如权限管理、数据隔离等。
+
+#### 示例
+以下是使用 `CURRENT_WORKSPACE` 函数的示例：
+
+1. 查询当前会话所在的 workspace 名称：
+```sql
+SELECT current_workspace();
+```
+执行结果：
+```
+"default"
+```

package/bin/skills/lakehouse-doc/references/sql_functions/context_functions/current_workspace_id.md

@@ -0,0 +1,24 @@
+### 获取当前工作区ID函数
+```sql
+current_workspace_id()
+```
+#### 功能描述
+`current_workspace_id()` 函数用于获取当前会话所在的工作区`ID`。该函数无需传入任何参数,将返回当前会话所关联的工作区的唯一标识符（整数值）。
+
+#### 使用场景
+在多工作区的环境中,需要根据当前用户所在的工作区执行特定操作时,可以使用此函数获取当前工作区的`ID`。
+
+#### 返回结果
+返回值类型为整数（`INT`）,表示当前会话所在的工作区`ID`。
+
+#### 使用示例
+以下示例展示了如何使用 `current_workspace_id()` 函数获取当前工作区`ID`,并根据不同的工作区执行不同的操作。
+
+示例 1：查询当前工作区ID
+```sql
+SELECT current_workspace_id();
+```
+执行结果：
+```
+123
+```

package/bin/skills/lakehouse-doc/references/sql_functions/scalar_functions/bitmap_functions/binary_to_bitmap.md

@@ -0,0 +1,29 @@
+### 函数名称：BINARY_TO_BITMAP
+
+```
+binary_to_bitmap(binary)
+```
+
+#### 功能描述
+`binary_to_bitmap` 函数的主要作用是将 binary 类型的输入数据转换为 bitmap 类型。该函数通常与 `bitmap_to_binary` 函数配合使用，后者将 bitmap 类型转换为 binary 类型。这种转换在处理位图数据时非常有用，尤其是在需要在不同数据格式之间进行转换的场景中。
+
+#### 参数说明
+* binary：待转换的 binary 类型数据。
+
+#### 返回结果
+返回转换后的 bitmap 类型数据。
+
+#### 使用示例
+
+1. 通过 `bitmap_build` 函数创建一个位图数组，并使用 `bitmap_to_binary` 函数将其转换为 binary 类型，最后使用 `binary_to_bitmap` 函数将其还原为 bitmap 类型：
+```sql
+SELECT binary_to_bitmap(bitmap_to_binary(bitmap_build(array(1,2,3))));
+-- 返回结果：[1,2,3]
+```
+
+
+#### 注意事项
+- 确保输入的 binary 数据是有效的，否则函数可能无法正确执行。
+- 在实际应用中，可能需要结合其他位图函数来实现更复杂的操作。建议在使用 `binary_to_bitmap` 函数之前，先了解相关函数的使用方法。
+
+通过以上示例和说明，您可以更好地理解 `binary_to_bitmap` 函数的用途和使用方法。在处理位图数据时，该函数可以帮助您在不同数据格式之间轻松转换，从而提高数据处理的效率。

package/bin/skills/lakehouse-doc/references/sql_functions/scalar_functions/bitmap_functions/bitmap_and.md

@@ -0,0 +1,39 @@
+### BITMAP_AND 函数
+
+#### 功能描述
+BITMAP_AND 函数用于计算两个 bitmap 类型数据的交集。该函数接受两个 bitmap 类型的参数，并返回一个新的 bitmap 类型结果，其中包含两个输入 bitmap 的共同元素。
+
+#### 参数说明
+* `left`：第一个 bitmap 类型参数。
+* `right`：第二个 bitmap 类型参数。
+
+#### 返回类型
+返回一个 bitmap 类型的结果。
+
+#### 使用示例
+以下示例展示了如何使用 BITMAP_AND 函数计算两个 bitmap 类型数据的交集。
+
+示例 1：
+```sql
+SELECT bitmap_and(bitmap_build(array(1, 2, 3)), bitmap_build(array(2, 3, 4)));
+```
+结果：
+```plaintext
+[2, 3] -- 结果按 array 形式演示，客户端支持 bitmap 类型打印,可以使用bitmap_to_array函数展示
+```
+
+示例 2：
+```sql
+SELECT bitmap_to_array(bitmap_and(bitmap_build(array(1, 2, 3, 5, 6)), bitmap_build(array(2, 3, 4, 6, 7))));
+```
+结果：
+```plaintext
+[2, 3, 6]
+```
+
+
+
+#### 注意事项
+* BITMAP_AND 函数要求两个输入参数都是 bitmap 类型，否则会导致函数执行失败。
+* 结果按 array 形式展示，但实际返回的是一个 bitmap 类型数据。客户端可能不支持直接打印 bitmap 类型数据，需要使用相应的转换函数（如 `bitmap_to_array`）将其转换为可打印的格式。
+* 当输入的 bitmap 类型数据中的元素数量较大时，BITMAP_AND 函数的计算效率可能受到影响。在这种情况下，可以考虑使用其他数据类型或方法进行计算。

package/bin/skills/lakehouse-doc/references/sql_functions/scalar_functions/bitmap_functions/bitmap_and_cardinality.md

@@ -0,0 +1,48 @@
+### BITMAP_AND_CARDINALITY 函数
+
+#### 概述
+`BITMAP_AND_CARDINALITY` 函数用于计算两个 bitmap 类型参数的集合交集，并返回结果集中的元素数量。该函数在处理大量数据时具有较高的性能优势，特别适用于需要快速计算集合关系的场景。
+
+#### 语法
+```
+bitmap_and_cardinality(left, right)
+```
+#### 参数说明
+
+* `left` (bitmap 类型): 第一个输入的 bitmap 数据。
+* `right` (bitmap 类型): 第二个输入的 bitmap 数据。
+
+#### 返回结果
+返回一个 bigint 类型的值，表示两个输入 bitmap 交集中的元素数量。
+
+#### 使用示例
+
+**示例 1**：计算两个简单 bitmap 的交集元素数量
+```sql
+SELECT bitmap_and_cardinality(bitmap_build(array(1, 2, 3)), bitmap_build(array(2, 3, 4)));
+```
+结果：
+```
+2
+```
+在这个例子中，两个 bitmap 分别为 `{1, 2, 3}` 和 `{2, 3, 4}`，它们的交集为 `{2, 3}`，因此结果为 2。
+
+**示例 2**：结合实际数据表计算交集元素数量
+假设我们有一个名为 `users` 的数据表，其中包含以下列：`id`, `username`, `interests`。`interests` 列存储了用户的兴趣爱好，数据类型为 bitmap。
+
+现在，我们想要计算喜欢“篮球”和“足球”的用户数量。可以使用以下 SQL 查询实现：
+```sql
+SELECT bitmap_and_cardinality(
+    bitmap_or(
+        bitmap_and(interests, 'basketball'),
+        bitmap_and(interests, 'football')
+    ),
+    interests
+) AS shared_interests_count
+FROM users;
+```
+在这个例子中，我们首先使用 `bitmap_and` 函数筛选出喜欢“篮球”和“足球”的用户，然后使用 `bitmap_or` 函数计算这两个集合的并集。最后，使用 `bitmap_and_cardinality` 函数计算并集中的元素数量，即喜欢“篮球”和“足球”的用户数量。
+
+#### 注意事项
+* 确保输入参数的数据类型为 bitmap，否则会导致函数执行失败。
+* 当输入的 bitmap 为空时，函数返回 0。

package/bin/skills/lakehouse-doc/references/sql_functions/scalar_functions/bitmap_functions/bitmap_andnot.md

@@ -0,0 +1,61 @@
+### BITMAP_ANDNOT 函数
+```
+bitmap_andnot(left, right)
+```
+
+#### 功能描述
+BITMAP_ANDNOT 函数用于计算两个 bitmap 类型参数的集合差（andnot 运算），返回一个新的 bitmap 类型结果。该函数在处理大量数据时具有较高的性能优势。
+
+#### 参数说明
+* left, right: 这两个参数均为 bitmap 类型，分别表示进行集合差运算的左侧和右侧 bitmap 数据。
+
+#### 返回结果
+返回一个新的 bitmap 类型结果，其中包含左侧 bitmap 中存在但右侧 bitmap 中不存在的元素。
+
+#### 使用示例
+1. 计算两个简单 bitmap 的集合差：
+```sql
+SELECT bitmap_andnot('01', '10');
+```
+结果：`00`
+
+2. 使用数组构建 bitmap 并计算集合差：
+```sql
+SELECT bitmap_to_array(bitmap_andnot(bitmap_build(array(1, 2, 3)), bitmap_build(array(2, 3, 4))));
+```
+结果：按 array 形式表示为 `[1]`，具体客户端支持的 bitmap 打印方式可能有所不同。
+
+3. 计算两个较大规模的 bitmap 集合差：
+```sql
+SELECT bitmap_to_array(bitmap_andnot(
+  bitmap_build(array(1, 2, 3, 4, 5, 6, 7, 8, 9)),
+  bitmap_build(array(3, 4, 5, 6, 7, 8, 9, 10))
+));
+```
+结果：按 array 形式表示为 `[1, 2]`
+
+4. 在实际业务场景中，可以利用 BITMAP_ANDNOT 函数对用户兴趣标签进行筛选。例如，从兴趣标签库中排除掉某些特定用户群体不感兴趣的标签：
+```sql
+SELECT user_interests
+FROM users
+WHERE user_id = 1;
+```
+假设上述查询结果为：
+```
+user_id | user_interests
+--------+-----------------
+1       | 0000000000001111
+```
+现在我们要排除掉用户不感兴趣的标签 4 和 5：
+```sql
+SELECT bitmap_andnot(user_interests, bitmap_build(array(4, 5)))
+FROM users
+WHERE user_id = 1;
+```
+结果：
+```
+user_id | user_interests
+--------+-----------------
+1       | 0000000000000101
+```
+通过 BITMAP_ANDNOT 函数，我们成功地从用户兴趣标签中排除了不感兴趣的标签 4 和 5。

package/bin/skills/lakehouse-doc/references/sql_functions/scalar_functions/bitmap_functions/bitmap_andnot_cardinality.md

@@ -0,0 +1,60 @@
+### BITMAP_ANDNOT_CARDINALITY 函数
+
+
+#### 功能描述
+BITMAP_ANDNOT_CARDINALITY 函数用于计算两个 bitmap 类型参数的集合差（即 ANDNOT 操作），并返回结果 bitmap 中元素的数量。该函数在处理大规模数据集时，能够高效地进行集合操作，尤其适用于需要快速计算集合之间关系的场景。
+
+#### 函数语法
+```
+bitmap_andnot_cardinality(left, right)
+```
+* left: 第一个 bitmap 参数。
+* right: 第二个 bitmap 参数。
+
+#### 返回类型
+返回一个 bigint 类型的值，表示结果 bitmap 中元素的数量。
+
+#### 使用示例
+以下示例展示了如何使用 BITMAP_ANDNOT_CARDINALITY 函数来计算两个 bitmap 的集合差，并获取结果中元素的数量。
+
+**示例 1**：计算两个简单 bitmap 的集合差
+```sql
+SELECT bitmap_andnot_cardinality(
+    bitmap_build(array(1, 2, 3)),
+    bitmap_build(array(2, 3, 4))
+);
+```
+结果：
+```
+1
+```
+在这个例子中，第一个 bitmap 包含元素 1、2 和 3，第二个 bitmap 包含元素 2、3 和 4。集合差操作后，结果 bitmap 只包含第一个 bitmap 中存在但第二个 bitmap 中不存在的元素，即只包含元素 1，因此结果为 1。
+
+**示例 2**：在实际数据表中应用 BITMAP_ANDNOT_CARDINALITY 函数
+假设我们有一个名为 `orders` 的数据表，其中包含以下列：`order_id`、`customer_id` 和 `order_date`。我们想要找出在特定日期范围内，某个特定客户没有下过的订单数量。
+
+```sql
+SELECT customer_id,
+       bitmap_andnot_cardinality(
+           bitmap_union(
+               -- 构建特定日期范围内所有订单的 bitmap
+               SELECT bitmap_or(
+                   bitmap_build(
+                       -- 提取每个订单的 customer_id
+                       array_agg(DISTINCT order_id)
+                   ) FROM orders
+                   WHERE order_date BETWEEN '2022-01-01' AND '2022-01-31'
+               )
+           ),
+           -- 构建特定客户所有订单的 bitmap
+           bitmap_build(
+               array_agg(DISTINCT order_id)
+           ) FROM orders
+           WHERE customer_id = 12345
+       ) AS orders_count
+FROM orders
+WHERE order_date BETWEEN '2022-01-01' AND '2022-01-31'
+GROUP BY customer_id;
+```
+在这个例子中，我们首先使用 `bitmap_union` 函数来构建特定日期范围内所有订单的 bitmap。然后，我们使用 `bitmap_build` 函数来构建特定客户所有订单的 bitmap。最后，我们使用 BITMAP_ANDNOT_CARDINALITY 函数来计算这两个 bitmap 的集合差，并返回结果中元素的数量，即该客户在特定日期范围内没有下过的订单数量。
+

package/bin/skills/lakehouse-doc/references/sql_functions/scalar_functions/bitmap_functions/bitmap_build.md

@@ -0,0 +1,58 @@
+### BITMAP_BUILD 函数
+
+#### 概述
+`bitmap_build` 函数用于从整数类型的数组表达式（expr）构建 bitmap 类型。该函数接受一个数组作为输入，并返回一个 bitmap 类型的结果。
+
+#### 语法
+```
+bitmap_build(expr)
+```
+
+#### 参数
+- `expr`: `array<T>` 类型，其中 T 是整数类型。
+
+#### 返回值
+- 返回一个 bitmap 类型的结果。
+
+#### 使用示例
+1. 从包含整数 1、2、3 的数组构建 bitmap 类型：
+   ```sql
+   SELECT bitmap_build(array(1, 2, 3));
+   ```
+   结果将以数组形式展示，但实际上是一个 bitmap 类型：
+   ```
+   [1,2,3]
+   ```
+   
+2. 将上述结果转换回数组形式以验证其内容：
+   ```sql
+   SELECT bitmap_to_array(bitmap_build(array(1, 2, 3)));
+   ```
+   结果将显示为数组形式：
+   ```
+   [1,2,3]
+   ```
+
+3. 构建一个包含多个连续整数的 bitmap 类型：
+   ```sql
+   SELECT bitmap_build(array(1, 2, 3, 4, 5));
+   ```
+   结果将展示为：
+   ```
+   [1,2,3,4,5]
+   ```
+
+4. 从包含负整数和零值的数组构建 bitmap 类型：
+   ```sql
+   SELECT bitmap_build(array(-1, 0, 2, -3));
+   ```
+   结果将展示为：
+   ```
+   [-1, 0, 2, -3]
+   ```
+
+#### 注意事项
+- 客户端不支持直接打印 bitmap 类型的结果，如果直接查看 bitmap 结果会报错，因此在实际使用中如需显示，需要使用 bitmap_to_array 函数将其转化为 array。
+- 当处理大型数据集时，bitmap 类型可以提高查询性能，因为它占用的内存空间相对较小。
+
+通过以上示例和说明，您可以更好地理解如何使用 `bitmap_build` 函数从整数数组构建 bitmap 类型，并在实际应用中发挥其优势。