@clickzetta/cz-cli-darwin-x64 0.3.1

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

@@ -0,0 +1,43 @@
+### BITMAP_CARDINALITY 函数
+
+#### 功能描述
+BITMAP_CARDINALITY 函数用于计算 bitmap 类型中元素的个数。该函数接受一个 bitmap 类型的参数，并返回一个 bigint 类型的值，表示 bitmap 中元素的个数。
+
+#### 参数说明
+- bitmap: 输入的 bitmap 类型数据。
+
+#### 返回结果
+- 返回一个 bigint 类型的值，表示 bitmap 中元素的个数。
+
+#### 使用示例
+1. 计算单个 bitmap 的元素个数：
+   ```sql
+   SELECT bitmap_cardinality(bitmap_build(ARRAY[1, 2, 3, 4, 5]));
+   ```
+   结果：
+   ```
+   5
+   ```
+   上述示例中，我们使用 `bitmap_build` 函数创建了一个包含 1 到 5 的 bitmap，并使用 `bitmap_cardinality` 函数计算出该 bitmap 中元素的个数为 5。
+
+2. 计算多个 bitmap 组合后的元素个数：
+   ```sql
+   SELECT bitmap_cardinality(bitmap_union(bitmap_build(ARRAY[1, 2]), bitmap_build(ARRAY[3, 4])));
+   ```
+   结果：
+   ```
+   4
+   ```
+   在这个示例中，我们分别创建了两个 bitmap，一个包含 1 和 2，另一个包含 3 和 4。然后使用 `bitmap_union` 函数将这两个 bitmap 合并，最后使用 `bitmap_cardinality` 函数计算合并后的 bitmap 中元素的个数为 4。
+
+3. 计算两个 bitmap 交集的元素个数：
+   ```sql
+   SELECT bitmap_cardinality(bitmap_intersect(bitmap_build(ARRAY[1, 2, 3]), bitmap_build(ARRAY[2, 3, 4])));
+   ```
+   结果：
+   ```
+   2
+   ```
+   在这个示例中，我们创建了两个 bitmap，一个包含 1、2 和 3，另一个包含 2、3 和 4。使用 `bitmap_intersect` 函数计算两个 bitmap 的交集，然后使用 `bitmap_cardinality` 函数计算交集结果中元素的个数为 2。
+
+通过以上示例，您可以更好地理解 BITMAP_CARDINALITY 函数的使用方法和场景。在实际应用中，您可以根据需要创建和操作 bitmap 类型数据，并利用该函数计算元素个数。

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

@@ -0,0 +1,50 @@
+### BITMAP_CONTAINS 函数
+
+---
+
+#### 功能描述
+BITMAP_CONTAINS 函数用于检查一个 bitmap 类型的数据结构中是否包含指定的值。当给定的值存在于 bitmap 中时，函数返回 true，否则返回 false。
+
+#### 函数语法
+```
+bitmap_contains(bitmap, value)
+```
+
+- **bitmap**: 待检查的 bitmap 类型数据。
+- **value**: 需要查询的整数值。
+
+#### 返回结果
+返回一个布尔值，表示 bitmap 中是否包含指定的 value。
+
+#### 使用示例
+以下示例展示了如何使用 BITMAP_CONTAINS 函数来检查 bitmap 中是否包含特定的值：
+
+1. 检查 bitmap 中是否包含值 2：
+   ```sql
+   SELECT bitmap_contains(bitmap_build(array(1, 2, 3)), 2);
+   -- 结果：true
+   ```
+
+2. 检查 bitmap 中是否包含值 4：
+   ```sql
+   SELECT bitmap_contains(bitmap_build(array(1, 2, 3)), 4);
+   -- 结果：false
+   ```
+
+3. 创建一个包含多个值的 bitmap，并检查是否包含特定的值：
+   ```sql
+   SELECT bitmap_contains(bitmap_build(array(10, 20, 30, 40, 50)), 30);
+   -- 结果：true
+   ```
+
+4. 检查 bitmap 中是否包含多个不同的值：
+   ```sql
+   SELECT bitmap_contains(bitmap_build(array(1, 15, 22, 33, 45, 55, 66, 77, 88, 99, 100)), 45);
+   -- 结果：true
+   ```
+
+#### 注意事项
+- 确保 value 参数是一个整数，否则可能会导致函数执行错误。
+- BITMAP_CONTAINS 函数适用于快速检查大量数据中某个特定值是否存在，以提高查询效率。
+
+通过以上示例和说明，您可以更好地理解 BITMAP_CONTAINS 函数的用途和用法。在实际应用中，您可以根据需要创建和查询 bitmap 数据结构，以实现高效的数据管理和查询。

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

@@ -0,0 +1,45 @@
+### BITMAP_COUNT 函数
+
+```
+bitmap_count(bitmap)
+```
+
+#### 功能描述
+
+`BITMAP_COUNT` 函数用于求 bitmap 中元素个数，等价于 `BITMAP_CARDINALITY`。
+
+#### 参数说明
+
+* `bitmap`：`BITMAP` 类型。
+
+#### 返回类型
+
+* 返回 `BIGINT` 类型。
+
+#### 注意事项
+
+* 此函数是 `BITMAP_CARDINALITY` 的别名，两者功能完全相同。
+
+#### 使用示例
+
+1. 计算 bitmap 中元素个数
+
+```sql
+SELECT bitmap_count(bitmap_build(array(1, 2, 3)));
++----------------------------------------------+
+| bitmap_count(bitmap_build(array(1, 2, 3)))   |
++----------------------------------------------+
+| 3                                            |
++----------------------------------------------+
+```
+
+2. 计算更多元素的 bitmap
+
+```sql
+SELECT bitmap_count(bitmap_build(array(1, 2, 3, 4, 5)));
++----------------------------------------------------+
+| bitmap_count(bitmap_build(array(1, 2, 3, 4, 5)))   |
++----------------------------------------------------+
+| 5                                                  |
++----------------------------------------------------+
+```

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

@@ -0,0 +1,52 @@
+### BITMAP_EMPTY 函数
+
+```
+bitmap_empty()
+```
+
+#### 功能描述
+
+`BITMAP_EMPTY` 函数用于返回一个空的 bitmap。
+
+#### 参数说明
+
+* 无参数。
+
+#### 返回类型
+
+* 返回 `BITMAP` 类型，即一个不包含任何元素的空 bitmap。
+
+#### 使用示例
+
+1.  创建空 bitmap
+
+    ```sql
+SELECT bitmap_empty();
++----------------+
+| bitmap_empty() |
++----------------+
+| []             |
++----------------+
+```
+
+2.  计算空 bitmap 的元素个数
+
+    ```sql
+SELECT bitmap_cardinality(bitmap_empty());
++-----------------------------------+
+| bitmap_cardinality(bitmap_empty())|
++-----------------------------------+
+| 0                                 |
++-----------------------------------+
+```
+
+3.  将空 bitmap 转换为数组
+
+    ```sql
+SELECT bitmap_to_array(bitmap_empty());
++--------------------------------+
+| bitmap_to_array(bitmap_empty())|
++--------------------------------+
+| []                             |
++--------------------------------+
+```

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

@@ -0,0 +1,49 @@
+### BITMAP_HAS_ALL 函数
+```
+bitmap_has_all(left, right)
+```
+
+#### 功能描述
+BITMAP_HAS_ALL 函数用于检查第二个参数（right）的 bitmap 是否是第一个参数（left）的子集。当 right bitmap 中的所有位都在 left bitmap 中时，返回 true，否则返回 false。
+
+#### 参数说明
+- left: 输入的第一个 bitmap 类型参数。
+- right: 输入的第二个 bitmap 类型参数。
+
+#### 返回类型
+返回值类型为布尔值（boolean）。
+
+#### 使用示例
+1. 检查两个 bitmap 是否有包含关系：
+```sql
+SELECT bitmap_has_all(bitmap_build(array(1, 2, 3)), bitmap_build(array(2, 3)));
+-- 返回结果：true
+```
+在这个例子中，right bitmap（2, 3）是 left bitmap（1, 2, 3）的子集，因为 right bitmap 中的所有位都在 left bitmap 中，所以返回 true。
+
+2. 检查两个 bitmap 是否没有包含关系：
+```sql
+SELECT bitmap_has_all(bitmap_build(array(1, 2, 3)), bitmap_build(array(2, 3, 4)));
+-- 返回结果：false
+```
+在这个例子中，right bitmap（2, 3, 4）不是 left bitmap（1, 2, 3）的子集，因为 right bitmap 包含了 left bitmap 中没有的位（4），所以返回 false。
+
+3. 检查一个 bitmap 是否包含另一个 bitmap 的所有位：
+```sql
+SELECT bitmap_has_all(bitmap_build(array(1, 2, 3, 4)), bitmap_build(array(3, 4)));
+-- 返回结果：true
+```
+在这个例子中，left bitmap（1, 2, 3, 4）包含了 right bitmap（3, 4）的所有位，所以返回 true。
+
+4. 检查一个 bitmap 是否不包含另一个 bitmap 的所有位：
+```sql
+SELECT bitmap_has_all(bitmap_build(array(1, 2, 3, 5)), bitmap_build(array(4, 5, 6)));
+-- 返回结果：false
+```
+在这个例子中，left bitmap（1, 2, 3, 5）不包含 right bitmap（4, 5, 6）的所有位，因为 left bitmap 中缺少 right bitmap 中的位（4）和位（6），所以返回 false。
+
+#### 注意事项
+- 当 left 或 right 参数为 NULL 时，函数将返回 NULL。
+- 确保输入的参数类型正确，否则可能导致函数执行错误或返回意外结果。
+
+通过以上示例和说明，您可以更好地理解 BITMAP_HAS_ALL 函数的用途和使用方法。在实际应用中，您可以根据需要对 bitmap 进行包含关系检查，以便进行相应的数据处理和分析。

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

@@ -0,0 +1,65 @@
+### BITMAP_HAS_ANY 函数
+
+---
+
+**功能描述**
+
+BITMAP_HAS_ANY 函数用于检查左侧 bitmap（位图）是否包含右侧 bitmap 中的任意一个元素。换句话说，该函数用于判断两个 bitmap 是否存在交集。
+
+**语法格式**
+
+```
+bitmap_has_any(left, right)
+```
+
+**参数说明**
+
+- `left`: 第一个 bitmap 类型参数。
+- `right`: 第二个 bitmap 类型参数。
+
+**返回结果**
+
+返回一个布尔值（boolean），如果左侧 bitmap 包含右侧 bitmap 中的任意一个元素，则返回 true；否则返回 false。
+
+**使用示例**
+
+1. 检查两个 bitmap 是否有交集：
+
+```sql
+SELECT bitmap_has_any(bitmap_build(array(1, 2, 3)), bitmap_build(array(2, 3)));
+```
+
+结果：
+
+```
+ true
+```
+
+2. 检查一个 bitmap 是否包含另一个 bitmap 的所有元素：
+
+```sql
+SELECT bitmap_has_any(bitmap_build(array(1, 2, 3, 4)), bitmap_build(array(3, 4)));
+```
+
+结果：
+
+```
+ false
+```
+
+3. 判断一个 bitmap 是否完全包含在另一个 bitmap 中：
+
+```sql
+SELECT bitmap_has_any(bitmap_build(array(1, 2, 3)), bitmap_build(array(1, 2, 3, 4)));
+```
+
+结果：
+
+```
+ true
+```
+
+**注意事项**
+
+- 确保传入的参数类型正确，否则可能导致函数执行失败。
+- BITMAP_HAS_ANY 函数主要用于 bitmap 类型数据的比较，对于其他数据类型可能不适用。

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

@@ -0,0 +1,52 @@
+### BITMAP_HASH 函数
+
+```
+bitmap_hash(expr)
+```
+
+#### 功能描述
+
+`BITMAP_HASH` 函数用于对输入的字符串进行哈希运算，返回包含哈希值的 bitmap。
+
+#### 参数说明
+
+* `expr`：`STRING` 类型的表达式。
+
+#### 返回类型
+
+* 返回 `BITMAP` 类型，包含一个整数哈希值。
+
+#### 使用示例
+
+1. 对字符串进行哈希
+
+```sql
+SELECT bitmap_hash('hello');
++-----------------------+
+| bitmap_hash('hello')  |
++-----------------------+
+| [1321743225]          |
++-----------------------+
+```
+
+2. 对另一个字符串进行哈希
+
+```sql
+SELECT bitmap_hash('world');
++-----------------------+
+| bitmap_hash('world')  |
++-----------------------+
+| [2453398188]          |
++-----------------------+
+```
+
+3. NULL 值处理
+
+```sql
+SELECT bitmap_hash(null);
++-------------------+
+| bitmap_hash(null) |
++-------------------+
+| NULL              |
++-------------------+
+```

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

@@ -0,0 +1,26 @@
+### BITMAP_MAX 函数
+#### 简介
+BITMAP_MAX 函数用于从给定的 bitmap 类型数据中提取最大值。该函数对于处理一组整数范围非常有用，可以快速找到其中的最大值。
+
+#### 语法
+```
+bitmap_max(bitmap)
+```
+#### 参数
+- **bitmap**: 输入的 bitmap 类型数据。
+
+#### 返回值
+- 返回一个 bigint 类型的值，表示输入 bitmap 中的最大元素。
+
+#### 使用示例
+1. 从数组构建 bitmap 并找到最大值：
+```
+SELECT bitmap_max(bitmap_build(array(1, 2, 3, 4, 5)));
+-- 输出结果：5
+```
+
+#### 注意事项
+- 确保输入的 bitmap 数据不为空，否则函数将返回 NULL。
+- BITMAP_MAX 函数适用于处理整数范围，对于非整数类型的数据可能无法正确返回结果。
+
+通过以上示例和说明，您可以更好地理解 BITMAP_MAX 函数的用途和使用方法。在实际应用中，可以根据需要灵活运用该函数来处理各种 bitmap 类型数据。

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

@@ -0,0 +1,33 @@
+### BITMAP_MIN 函数
+
+#### 概述
+BITMAP_MIN 函数用于从输入的 bitmap 对象中找出最大的元素，并返回其值。该函数对于处理和分析 bitmap 类型数据非常有用。
+
+#### 语法
+```
+bitmap_min(bitmap)
+```
+
+#### 参数
+- bitmap：bitmap 类型，表示输入的 bitmap 对象。
+
+#### 返回结果
+- 返回一个 bigint 类型的值，表示输入 bitmap 中的最大元素。
+
+#### 使用示例
+
+
+
+1. 从包含多个元素的 bitmap 对象中查找最小元素：
+```sql
+SELECT bitmap_min(bitmap_build(array(1, 2, 3)));
+```
+结果：
+```
+1
+```
+
+
+#### 注意事项
+- 如果输入的 bitmap 对象为空，BITMAP_MIN 函数将返回 0。
+- BITMAP_MIN 函数仅适用于 bitmap 类型的数据。对于其他类型的数据，可能会导致错误或不正确的结果。

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

@@ -0,0 +1,61 @@
+### BITMAP_OR 函数
+
+---
+
+#### 功能描述
+
+BITMAP_OR 函数用于计算两个 bitmap 类型数据的集合并集（OR 运算）。该函数将两个 bitmap 输入作为参数，并返回一个新的 bitmap 结果，其中包含了两个输入 bitmap 中所有的非零值。
+
+#### 语法格式
+
+```
+bitmap_or(left, right)
+```
+
+#### 参数说明
+
+* **left**, **right**: 这两个参数都是 bitmap 类型，代表需要进行 OR 运算的两个集合。
+
+#### 返回类型
+
+函数返回一个 bitmap 类型的结果。
+
+#### 使用示例
+
+以下示例展示了如何使用 BITMAP_OR 函数：
+
+1. **基础使用**  
+   计算两个简单 bitmap 的 OR 集合：
+   ```sql
+   SELECT bitmap_or(bitmap_build(array(1, 2, 3)), bitmap_build(array(2, 3, 4)));
+   ```
+   预期结果：`[1, 2, 3, 4]` （结果以 array 形式展示，实际客户端可能不支持 bitmap 类型打印）
+
+2. **结合数组函数使用**  
+   使用 bitmap_or 函数处理数组，并转换结果为数组形式：
+   ```sql
+   SELECT bitmap_to_array(bitmap_or(bitmap_build(array(1, 2, 3)), bitmap_build(array(2, 3, 4))));
+   ```
+   预期结果：`[1, 2, 3, 4]`
+
+3. **多集合运算**  
+   对多个 bitmap 进行连续的 OR 运算：
+   ```sql
+   SELECT bitmap_to_array(bitmap_or(bitmap_or(bitmap_build(array(1, 2, 3)), bitmap_build(array(2, 3, 4))), bitmap_build(array(3, 4, 5))));
+   ```
+   预期结果：`[1, 2, 3, 4, 5]`
+
+4. **处理空值**  
+   当输入的 bitmap 之一为空时，结果将反映非空的 bitmap：
+   ```sql
+   SELECT bitmap_to_array(bitmap_or(bitmap_build(array(1, 2, 3)), NULL));
+   ```
+   预期结果：`[1, 2, 3]`
+
+#### 注意事项
+- 客户端不支持直接打印 bitmap 类型的结果，如果直接查看bitmap结果会报错，因此在实际使用中如果要屏显需要使用bitmap_to_array转化成array。
+* BITMAP_OR 函数要求两个输入参数都是 bitmap 类型，否则将返回错误。
+* 当处理大型数据集时，请注意内存使用情况，因为 bitmap 可能会占用较大的内存空间。
+
+
+通过以上示例和说明，您可以更好地理解 BITMAP_OR 函数的用途和使用方法。在实际应用中，BITMAP_OR 函数可以有效地处理和分析 bitmap 类型数据，帮助您完成复杂的数据集合运算任务。

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

@@ -0,0 +1,27 @@
+# BITMAP_OR_CARDINALITY 函数
+
+## 功能描述
+`BITMAP_OR_CARDINALITY` 函数计算两个位图（bitmap）的逻辑"或"（disjunction）操作的基数（cardinality），即返回两个位图合并后唯一元素的数量。此函数对于确定两个集合合并后的总不同元素数非常有用，尤其是在处理大型数据集时，位图提供了一种高效的数据处理方式。
+
+## 语法
+```
+BITMAP_OR_CARDINALITY(bitmap1, bitmap2)
+```
+
+## 参数说明
+- **bitmap1**：第一个位图对象。
+- **bitmap2**：第二个位图对象。
+
+## 返回值
+返回两个位图进行逻辑"或"操作后的基数，即合并后的唯一元素数量。
+
+## 示例
+以下示例展示了如何使用 `BITMAP_OR_CARDINALITY` 函数来计算两个位图合并后的基数：
+
+```sql
+SELECT bitmap_or_cardinality(bitmapBuild([1,2,3]), bitmapBuild([2,3,4])) AS result;
+```
+
+假设第一个位图包含元素 `[1, 2, 3]`，第二个位图包含元素 `[2, 3, 4]`。这两个位图的逻辑"或"操作将合并这些元素，去除重复项，结果为 `[1, 2, 3, 4]`。`BITMAP_OR_CARDINALITY` 函数计算这个结果位图中的唯一元素数量，返回结果为 `4`。
+
+

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

@@ -0,0 +1,42 @@
+### BITMAP_REMOVE 函数
+
+```
+bitmap_remove(bitmap, value)
+```
+
+#### 功能描述
+
+`BITMAP_REMOVE` 函数用于从 bitmap 中移除指定的值。
+
+#### 参数说明
+
+* `bitmap`：`BITMAP` 类型。
+* `value`：整数类型，要移除的值。
+
+#### 返回类型
+
+* 返回 `BITMAP` 类型，移除指定值后的新 bitmap。
+
+#### 使用示例
+
+1. 从 bitmap 中移除元素
+
+```sql
+SELECT bitmap_remove(bitmap_build(array(1, 2)), 1);
++-----------------------------------------------+
+| bitmap_remove(bitmap_build(array(1, 2)), 1)   |
++-----------------------------------------------+
+| [2]                                           |
++-----------------------------------------------+
+```
+
+2. 移除中间元素
+
+```sql
+SELECT bitmap_remove(bitmap_build(array(1, 2, 3)), 2);
++--------------------------------------------------+
+| bitmap_remove(bitmap_build(array(1, 2, 3)), 2)   |
++--------------------------------------------------+
+| [1,3]                                            |
++--------------------------------------------------+
+```

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

@@ -0,0 +1,60 @@
+### BITMAP_SUBSET_IN_RANGE 函数
+
+``` sql
+bitmap_subset_in_range(bitmap, range_start, range_end)
+```
+
+#### 功能描述
+BITMAP_SUBSET_IN_RANGE 函数用于从给定的 bitmap 中提取一个指定区间的子集。该区间以 range_start 为起始点（包含），以 range_end 为结束点（不包含）。当前版本仅支持 int 类型的区间数值。
+
+#### 参数说明
+- bitmap: 输入的 bitmap 类型数据。
+- range_start: 区间起始点，int 类型数据。起始值是1
+- range_end: 区间终点，int 类型数据。
+
+#### 返回类型
+返回一个 bitmap 类型数据，包含指定区间内的元素。
+
+#### 使用示例
+
+1. 提取区间 [1, 3) 的子集：
+
+``` sql
+SELECT bitmap_subset_in_range(bitmap_build(array(2, 1, 3, 4)), 1, 3);
+```
+
+结果：
+
+```
+[1, 2]
+```
+
+2. 提取区间 [5, 7) 的子集（结果为空，因为区间内没有元素）：
+
+``` sql
+SELECT bitmap_subset_in_range(bitmap_build(array(1, 3, 5, 7, 9)), 5, 7);
+```
+
+结果：
+
+```
+[]
+```
+
+3. 从一个包含多个元素的 bitmap 中提取区间 [2, 5) 的子集：
+
+``` sql
+SELECT bitmap_subset_in_range(bitmap_build(array(1, 2, 3, 4, 5, 6, 7, 8, 9)), 2, 5);
+```
+
+结果：
+
+```
+[2, 3, 4]
+```
+
+#### 注意事项
+- 请确保输入的 bitmap 类型数据有效。
+- 当区间为空时，返回结果将是一个空的 bitmap 类型数据。
+- 请确保 range_start 和 range_end 的值是有效的 int 类型数值。
+- 客户端不支持直接打印 bitmap 类型的结果，如果直接查看 bitmap 结果会报错，因此在实际使用中如需显示，需要使用 bitmap_to_array 转换成 array。

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

@@ -0,0 +1,36 @@
+### BITMAP_SUBSET_IN_RANGE 函数
+
+#### 功能描述
+BITMAP_SUBSET_IN_RANGE 函数用于从给定的 bitmap 类型数据中提取一个指定范围的子集。该函数根据 `range_start`（范围起始值）和 `cardinality_limit`（范围大小限制）两个参数来确定子集的具体内容。目前，该函数仅支持 int 类型的数值。
+
+#### 参数说明
+* bitmap: 输入的 bitmap 类型数据。
+* range_start: int 类型，表示范围的起始值。
+* cardinality_limit: int 类型，表示范围的大小限制。
+
+#### 返回结果
+返回一个 bitmap 类型数据，包含指定范围内的元素。
+
+#### 使用示例
+以下示例展示了如何使用 BITMAP_SUBSET_IN_RANGE 函数来提取 bitmap 数据的子集：
+
+1. 提取从第二个元素开始、由两个元素组成的子集：
+```sql
+SELECT BITMAP_SUBSET_IN_RANGE(bitmap_build(array(2, 1, 3)), 1, 2);
+```
+结果：
+```
+[1]
+```
+
+2. 将提取的子集转换为数组形式：
+```sql
+SELECT BITMAP_TO_ARRAY(BITMAP_SUBSET_IN_RANGE(bitmap_build(array(2, 1, 3)), 1, 2));
+```
+结果：
+```
+[ 1]
+```
+
+
+通过以上示例，您可以看到 BITMAP_SUBSET_IN_RANGE 函数在不同场景下的应用。该函数可以帮助您更方便地处理和分析 bitmap 类型数据。

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

@@ -0,0 +1,24 @@
+### 将 Bitmap 转换为 Array 函数：bitmap_to_array
+
+#### 功能描述
+`bitmap_to_array` 函数的主要功能是将传入的 bitmap 类型数据转换成一个 `array<bigint>` 类型的数据。该函数在处理位图数据以及需要将位图转换为数组的场景下非常有用。
+
+#### 函数语法
+```
+bitmap_to_array(bitmap)
+```
+* `bitmap`：需要转换的 bitmap 类型数据。
+
+#### 返回类型
+该函数返回一个 `array<bigint>` 类型的数据。
+
+#### 使用示例
+以下是 `bitmap_to_array` 函数的几个使用示例：
+
+示例 1：结合 `bitmap_build` 函数，将整数数组转换为位图，然后再将位图转换回整数数组。
+```sql
+SELECT bitmap_to_array(bitmap_build(array(1, 2, 3)));
+-- 返回结果为 [1, 2, 3]
+```
+
+通过上述示例，可以看到 `bitmap_to_array` 函数在处理位图数据时的灵活性和实用性。在实际应用中，您可以根据需要将位图数据与数组进行转换，以便进行更复杂的数据处理和分析。