@clickzetta/cz-cli-darwin-x64 0.3.1

package/bin/skills/lakehouse-doc/references/sql_functions/scalar_functions/datetime_functions/unix_timestamp.md

@@ -0,0 +1,96 @@
+### UNIX\_TIMESTAMP 函数
+
+#### 功能描述
+
+`UNIX_TIMESTAMP` 函数用于获取当前时间或指定时间的 UNIX 时间戳（Unix timestamp），即从 1970 年 1 月 1 日 00:00:00 UTC 到指定时间的总秒数。如果不指定任何参数，默认返回当前时间的 UNIX 时间戳。
+
+#### 语法
+
+```
+unix_timestamp([expr [, fmt]])
+```
+
+#### 参数说明
+
+* `expr`：可以是 date、timestamp\_ltz 或 string 类型，表示要转换为 UNIX 时间戳的时间。如果不指定该参数，则默认使用当前时间。
+* `fmt`：字符串类型，表示输入时间的格式。如果不指定该参数，将根据系统默认的时间格式进行解析。
+
+#### 返回结果
+
+返回一个 bigint 类型的值，表示 UNIX 时间戳。
+
+#### 使用示例
+
+1. 获取当前时间的 UNIX 时间戳：
+
+```
+SELECT UNIX_TIMESTAMP() as res;
++------------+
+|    res     |
++------------+
+| 1737447675 |
++------------+
+```
+
+2. 获取指定时间的 UNIX 时间戳：
+
+```
+SELECT UNIX_TIMESTAMP('2022-02-23 10:00:00')as res;
++------------+
+|    res     |
++------------+
+| 1645581600 |
++------------+
+```
+
+3. 获取指定时间格式的 UNIX 时间戳：
+
+```
+SELECT UNIX_TIMESTAMP('2022-02-23 10:00:00', 'yyyy-MM-dd HH:mm:ss')as res;
++------------+
+|    res     |
++------------+
+| 1645581600 |
++------------+
+```
+
+4. 将字符串类型的时间转换为 UNIX 时间戳：
+
+```
+SELECT UNIX_TIMESTAMP('2022-02-23 10:00:00', 'yyyy-MM-dd HH:mm:ss')as res;
++------------+
+|    res     |
++------------+
+| 1645581600 |
++------------+
+```
+
+5. 将 timestamp 类型的时间转换为 UNIX 时间戳：
+
+```
+SELECT UNIX_TIMESTAMP(TIMESTAMP "2022-02-23 10:00:00")as res;
++------------+
+|    res     |
++------------+
+| 1645581600 |
++------------+
+```
+
+6. 将 date 类型的时间转换为 UNIX 时间戳：
+
+```
+SELECT UNIX_TIMESTAMP(DATE '2022-02-23')as res;
++------------+
+|    res     |
++------------+
+| 1645545600 |
++------------+
+```
+
+#### 注意事项
+
+* 当输入的时间格式不正确或无法识别时，函数将返回 NULL。
+* 如果指定的时间超出了系统支持的时间范围，函数将返回 NULL。
+* 在使用该函数时，建议明确指定输入时间的格式，以避免因系统默认时间格式不同而导致的解析错误。
+
+

package/bin/skills/lakehouse-doc/references/sql_functions/scalar_functions/datetime_functions/week.md

@@ -0,0 +1,31 @@
+### 函数名称
+`WEEK`
+
+### 功能描述
+`WEEK` 函数用于计算并返回给定日期（`date` 或 `timestamp_ltz` 类型）在当年是第几个星期。需要注意的是，该函数将一周的开始定义为星期一。同时，每年的第一个星期是指第一个包含四天或以上的星期。
+
+### 参数说明
+- `expr`: 输入的日期或时间戳（`date` 或 `timestamp_ltz`）参数。
+
+### 返回类型
+- 返回一个整数，表示给定日期在当年是第几个星期。
+
+### 使用示例
+1. 计算某个特定日期是当年的第几周：
+   ```sql
+   SELECT WEEK('2022-03-31'); -- 结果为：13
+   ```
+2. 对于一个时间戳类型的数据，同样可以计算出其所在的星期数：
+   ```sql
+   SELECT WEEK(TIMESTAMP "2022-03-31 03:21:00"); -- 结果同样为：13
+   ```
+3. 可以使用 `WEEK` 函数结合其他日期函数进行更复杂的日期计算，例如找出当前时间所在的星期数：
+   ```sql
+   SELECT WEEK(CURRENT_TIMESTAMP()) AS week_number; -- 结果将显示当前日期所在的星期数
+   ```
+
+### 注意事项
+- 该函数对输入的数据类型有一定的要求，请确保输入的是日期或时间戳类型。
+- 当输入的时间戳包含时区信息时，函数会考虑时区转换后的结果进行计算。
+
+以上就是 `WEEK` 函数的详细说明和使用示例。通过该函数，用户可以方便地获取特定日期在一年中的星期位置，从而进行相关的日期计算和数据分析。

package/bin/skills/lakehouse-doc/references/sql_functions/scalar_functions/datetime_functions/weekday.md

@@ -0,0 +1,51 @@
+### 函数名称
+
+`weekday` 函数
+
+### 功能描述
+
+`weekday` 函数用于计算并返回给定日期（`date` 类型）或时间戳（`timestamp` 类型）在所属星期的第几天。该函数对于需要根据星期几进行数据处理或统计的场景非常有用。
+
+### 参数说明
+
+* `expr`: `date` 或 `timestamp_ltz` 类型，表示需要计算星期的日期或时间戳。
+
+### 返回结果
+
+返回一个整数，表示星期几。其中，0 表示星期一，1 表示星期二，依此类推，6 表示星期日。
+
+### 使用示例
+
+1. 计算当前时间所属星期的第几天：
+   ```sql
+   SELECT weekday(current_timestamp()) as res;
+   ```
+   结果将返回查询执行时刻所在的星期几。
+
+2. 计算特定日期所属星期的第几天：
+   ```sql
+   SELECT weekday('2022-03-31') as res;
+   +-----+
+   | res |
+   +-----+
+   | 3   |
+   +-----+
+   ```
+
+3. 计算时间戳所属星期的第几天：
+   ```sql
+   SELECT weekday(timestamp_ltz '2022-03-31 13:15:00')as res;
+   +-----+
+   | res |
+   +-----+
+   | 3   |
+   +-----+
+   ```
+### 注意事项
+
+* 当输入的日期或时间戳无效时，`weekday` 函数将返回错误。
+* 该函数在不同地区的星期计算方式可能存在差异，请根据实际情况进行调整。
+
+### 结论
+
+`weekday` 函数是一个简单且实用的工具，可以帮助用户快速获取日期或时间戳所属星期的第几天。通过上述示例，用户可以更好地理解并应用该函数。

package/bin/skills/lakehouse-doc/references/sql_functions/scalar_functions/datetime_functions/weekofyear.md

@@ -0,0 +1,29 @@
+### 函数名称
+`WEEKOFYEAR`
+
+### 功能描述
+`WEEKOFYEAR` 函数用于计算并返回给定日期（`date` 或 `timestamp_ltz` 类型）在当年是第几个星期。需要注意的是，该函数将一周的开始定义为星期一，并且每年的第一周是指包含该年第一个星期四（即有四天或更多天在当年）的星期。
+
+### 参数说明
+- `expr`: 输入的日期或时间戳（`date` 或 `timestamp_ltz`）。
+
+### 返回类型
+- 返回一个整数，表示给定日期在当年是第几个星期。
+
+### 使用示例
+1. 计算某个特定日期是第几个星期：
+   ```sql
+   SELECT WEEKOFYEAR('2022-03-31'); -- 结果为：13
+   ```
+2. 对于当前时间戳，计算其所在的星期数：
+   ```sql
+   SELECT WEEKOFYEAR(CURRENT_TIMESTAMP()); -- 结果将根据当前时间戳计算
+   ```
+
+   
+### 注意事项
+- 该函数对于输入的日期格式有一定的要求，确保输入的日期格式正确无误。
+- 当输入的时间戳（`timestamp_ltz`）跨越了当年的第一个星期四时，返回的结果可能会有所不同。
+- 在进行日期计算时，需要注意时区的影响，尤其是对于跨越不同时区的日期和时间戳。
+
+以上是 `WEEKOFYEAR` 函数的详细帮助文档，包括功能描述、参数说明、返回类型、使用示例和注意事项。希望这些信息能帮助您更好地理解和使用该函数。

package/bin/skills/lakehouse-doc/references/sql_functions/scalar_functions/datetime_functions/year.md

@@ -0,0 +1,46 @@
+### YEAR 函数
+
+#### 功能描述
+
+YEAR 函数用于从不同类型的日期表达式中提取年份部分，并以整数形式返回。
+
+#### 语法
+
+```sql
+YEAR(expr)
+```
+
+#### 参数说明
+
+* `expr`: 可以是不同类型的日期表达式，包括字符串（date/string）、时间（time/timetz）和时间戳（timestamp/timestamptz）。
+
+#### 返回类型
+
+整数（int）
+
+#### 使用示例
+
+1. 从字符串形式的日期中提取年份：
+   ```sql
+   SELECT YEAR('2022-03-31');
+   -- 结果：2022
+   ```
+
+2. 从时间戳形式的日期中提取年份：
+   ```sql
+   SELECT YEAR(TIMESTAMP "2022-03-31 14:59:59");
+   -- 结果：2022
+   ```
+
+3. 从当前时间戳中提取年份：
+   ```sql
+   SELECT YEAR(now());
+   -- 结果：根据当前时间戳返回年份
+   ```
+
+#### 注意事项
+
+* 当输入的日期表达式为字符串类型时，请确保其符合数据库支持的日期格式，否则可能导致解析错误。
+* 在使用 YEAR 函数时，请确保传入的参数类型正确，以避免类型不匹配的错误。
+
+^

package/bin/skills/lakehouse-doc/references/sql_functions/scalar_functions/datetime_functions/yearofweek.md

@@ -0,0 +1,64 @@
+### YEAROFWEEK 函数
+
+```
+yearofweek(expr)
+```
+
+#### 功能描述
+
+YEAROFWEEK 函数用于返回给定日期（expr）对应的 ISO 周编号年份。ISO 周编号年份是根据国际标准 ISO 8601 进行计算的，该标准将每周的第一天设为周一。
+
+#### 参数说明
+
+* expr：传入的日期或时间戳，类型为 date 或 timestamp\_ltz。
+
+#### 返回结果
+
+返回一个整型数值，表示给定日期所在的 ISO 周编号年份。
+
+#### 使用示例
+
+1. 根据当前时间获取 ISO 周编号年份：
+
+```
+SELECT YEAROFWEEK(NOW()) as res;
++------+
+| res  |
++------+
+| 2025 |
++------+
+```
+
+2. 计算指定日期所在的 ISO 周编号年份：
+
+```
+SELECT YEAROFWEEK('2022-03-31')as res;
++------+
+| res  |
++------+
+| 2022 |
++------+
+```
+
+3. 计算某个时间戳所在的 ISO 周编号年份：
+
+```
+SELECT YEAROFWEEK(TIMESTAMP "2022-03-31 03:21:00")as res;
++------+
+| res  |
++------+
+| 2022 |
++------+
+```
+
+4. 计算并比较两个不同日期的 ISO 周编号年份：
+
+```
+SELECT YEAROFweek('2022-03-31') AS year1, YEAROFweek('2023-03-31') AS year2;
++-------+-------+
+| year1 | year2 |
++-------+-------+
+| 2022  | 2023  |
++-------+-------+
+```
+

package/bin/skills/lakehouse-doc/references/sql_functions/scalar_functions/datetime_functions/years.md

@@ -0,0 +1,21 @@
+### YEARS
+```sql
+years(expr)
+```
+#### 功能
+返回从 epoch (1970-01-01 00:00:00) 到指定时间戳之间的年数。
+#### 参数
+* `expr`：DATE / TIMESTAMP_LTZ / TIMESTAMP_NTZ 类型的表达式
+#### 返回结果
+* `bigint` 类型，表示从 epoch 开始的年数。
+#### 举例
+```sql
+> SELECT years(timestamp_ntz '1970-01-01 00:00:00');
+0
+
+> SELECT years(timestamp_ntz '2000-01-01 00:00:00');
+30
+
+> SELECT years(timestamp_ntz '2020-08-09 03:04:05');
+50
+```

package/bin/skills/lakehouse-doc/references/sql_functions/scalar_functions/geo_functions/st_geohash.md

@@ -0,0 +1,34 @@
+### ST_GEOHASH 函数
+
+#### 功能描述
+`ST_GEOHASH` 函数是一个根据指定的经度（lon）和纬度（lat）计算对应的 geohash 编码的地理空间函数。该函数接受三个参数：经度、纬度和精度（precision）。计算结果是一个字符串，其长度由精度参数决定，最大长度为 12。
+
+#### 参数说明
+- **lon** (double): 指定的经度值。
+- **lat** (double): 指定的纬度值。
+- **precision** (int): 指定 geohash 编码的长度精度，取值范围为1至12。
+
+#### 返回结果
+返回一个表示 geohash 编码的字符串。
+
+#### 使用示例
+1. 计算精度为5的 geohash 编码（经度：116.3, 纬度：39.9）：
+   ```sql
+   SELECT ST_GEOHASH(116.3, 39.9, 5);
+   -- 返回结果：wx4dy
+   ```
+2. 计算精度为8的 geohash 编码（经度：120.0, 纬度：30.0）：
+   ```sql
+   SELECT ST_GEOHASH(120.0, 30.0, 8);
+   -- 返回结果：wtm6dtm6
+   ```
+3. 计算精度为12的 geohash 编码（经度：121.5, 纬度：31.0）：
+   ```sql
+   SELECT ST_GEOHASH(121.5, 31.0, 12);
+   -- 返回结果：wtw2kg3s54y7
+   ```
+
+#### 注意事项
+- 请确保输入的经度和纬度值在合理的范围内，即经度在 -180 至 180 之间，纬度在 -85.05112878 至 85.05112878 之间。
+- 精度参数会影响生成的 geohash 编码的长度和分辨率，参数值越大，编码越长，表示的地理范围越精确。但请注意，过高的精度参数值可能导致不必要的计算开销，从而影响性能。
+- geohash 编码可用于地理空间数据的索引、存储和查询，但请注意，它并非一种完美的地理空间数据表示方法，可能会存在一定的误差。在使用时，请根据实际需求和场景选择合适的精度和方法。

package/bin/skills/lakehouse-doc/references/sql_functions/scalar_functions/geo_functions/st_latfromgeohash.md

@@ -0,0 +1,59 @@
+### ST\_LATFROMGEOHASH 函数
+
+#### 功能描述
+
+`ST_LATFROMGEOHASH` 函数用于根据给定的 geohash 字符串计算并返回对应的纬度值。该函数可以广泛应用于地图服务、位置查询和地理信息系统等领域。
+
+#### 函数语法
+
+```
+ST_LATFROMGEOHASH(hashstr)
+```
+
+#### 参数说明
+
+* `hashstr` (string): 需要计算纬度的 geohash 字符串。
+
+#### 返回结果
+
+返回计算得到的纬度值，数据类型为 double。
+
+#### 使用示例
+
+1. 计算某个 geohash 字符串的纬度值：
+   ```sql
+   SELECT ST_LATFROMGEOHASH('v0gs3y0z') as res;
+   +-------------------+
+   |        res        |
+   +-------------------+
+   | 50.00006675720215 |
+   +-------------------+
+   ```
+
+2. 在查询语句中结合其他地理信息函数使用：
+   ```sql
+   SELECT ST_LATFROMGEOHASH(ST_GEOHASH(116.397428, 39.90923,3)) as res;
+   +-----------+
+   |    res    |
+   +-----------+
+   | 40.078125 |
+   +-----------+
+   ```
+
+3. 对于一组 geohash 字符串批量计算纬度值：
+   ```sql
+   SELECT ST_LATFROMGEOHASH('v0gs3y0z')as res1, ST_LATFROMGEOHASH('wh5g5jc3d') as res2, ST_LATFROMGEOHASH('4s7qfj9p0') as res3;
+   +-------------------+--------------------+--------------------+
+   |       res1        |        res2        |        res3        |
+   +-------------------+--------------------+--------------------+
+   | 50.00006675720215 | 23.059208393096924 | -64.87579107284546 |
+   +-------------------+--------------------+--------------------+
+   ```
+  
+
+#### 注意事项
+
+* 确保输入的 geohash 字符串是有效的，否则可能导致计算结果不准确。
+* 在使用该函数时，请确保已安装并启用了相关的地理信息扩展插件。
+
+通过以上示例，您可以看到 `ST_LATFROMGEOHASH` 函数可以方便地从 geohash 字符串中提取纬度信息，从而为地理信息系统和位置服务提供便利。

package/bin/skills/lakehouse-doc/references/sql_functions/scalar_functions/geo_functions/st_longfromgeohash.md

@@ -0,0 +1,53 @@
+### ST\_LONGFROMGEOHASH 函数
+
+#### 功能描述
+
+ST\_LONGFROMGEOHASH 函数用于根据给定的 geohash 字符串计算并返回对应的经度值。该函数可广泛应用于地图服务、位置信息处理等领域。
+
+#### 参数说明
+
+* `hashstr` (STRING 类型)：传入的 GeoHash 字符串。
+
+#### 返回结果
+
+返回计算得到的经度值，数据类型为 `double`。
+
+#### 使用示例
+
+以下为 ST\_LONGFROMGEOHASH 函数的使用示例：
+
+1.  根据指定的 GeoHash 字符串获取经度：
+    ```sql
+   SELECT ST_LONGFROMGEOHASH('v0gs3y0z') as res;
+   +-------------------+
+   |        res        |
+   +-------------------+
+   | 49.99998092651367 |
+   +-------------------+
+   ```
+
+2.  将 GeoHash 字符串与其他地理信息数据关联，获取更准确的位置信息：
+    ```sql
+   SELECT
+     ST_LONGFROMGEOHASH(geohash字段) AS `经度 `,
+     ST_LATFROMGEOHASH(geohash字段) AS `纬度`se
+   FROM your_table;
+   ```
+    此查询将返回包含地点名称、对应经度和纬度的结果。
+
+3.  结合地理编码功能，获取建筑物或地址的经纬度信息：
+    ```sql
+   SELECT
+     ST_LONGFROMGEOHASH(geohash字段) AS `经度 `,
+     ST_LATFROMGEOHASH(geohash字段) AS `纬度`
+   FROM your_table;
+   ```
+    此查询将返回包含建筑物或地址的经度、纬度和地理信息的结果。
+
+#### 注意事项
+
+* 请确保传入的 GeoHash 字符串正确无误，否则可能导致计算结果不准确。
+* 根据 GeoHash 计算得到的经度值可能存在一定的误差，具体取决于 GeoHash 的精度。
+* 在使用 ST\_LONGFROMGEOHASH 函数时，请确保已安装并启用了空间数据库扩展功能。
+
+^

package/bin/skills/lakehouse-doc/references/sql_functions/scalar_functions/hash_functions/bucket.md

@@ -0,0 +1,33 @@
+### BUCKET
+```sql
+bucket(numBuckets, col)
+```
+#### 功能
+根据指定的桶数量和列值计算哈希桶编号。该函数使用哈希函数将输入值映射到 [0, numBuckets) 范围内的整数，常用于数据分区和分布式计算场景。
+
+#### 参数
+* `numBuckets`: int 类型，桶的数量，必须大于 0
+* `col`: 任意类型，待计算哈希桶的列值
+
+#### 返回结果
+* int 类型
+* 返回值范围为 [0, numBuckets)
+* 如果输入值为 NULL，则返回 NULL
+
+#### 举例
+```sql
+-- 将数据分配到 10 个桶中
+> SELECT bucket(10, 'test');
+4
+
+> SELECT bucket(10, 123);
+4
+
+```
+
+#### 说明
+* `BUCKET` 函数使用哈希算法确保相同的输入值总是映射到相同的桶
+* 常用于数据分区、采样和负载均衡等场景
+* 返回的桶编号从 0 开始，最大值为 numBuckets - 1
+* 不同类型的相同值（如整数 1 和字符串 '1'）可能会映射到不同的桶
+* 该函数是确定性的，相同的输入总是产生相同的输出。

package/bin/skills/lakehouse-doc/references/sql_functions/scalar_functions/hash_functions/general_hash.md

@@ -0,0 +1,49 @@
+### 通用哈希函数
+
+#### 功能描述
+本节介绍的两个通用哈希函数 `general_complexhash2` 和 `general_murmurhash3` 可用于对任意类型的数据进行哈希计算。`general_complexhash2` 根据输入数据的类型自动选择更高效的计算方法，而 `general_murmurhash3` 则采用著名的 MurmurHash3 算法进行哈希计算。
+
+#### 使用方法
+* **general_complexhash2(expr)**: 对任意类型的输入数据 `expr` 进行哈希计算，并返回一个整型结果。
+* **general_murmurhash3(expr)**: 对任意类型的输入数据 `expr` 使用 MurmurHash3 算法进行哈希计算，并返回一个整型结果。
+
+#### 参数
+* **expr**: 任意类型的输入数据。
+
+#### 返回结果
+* 返回一个整型数值，表示输入数据的哈希值。
+
+#### 示例
+```sql
+-- 使用 general_complexhash2 计算字符串的哈希值
+> SELECT general_complexhash2('hello');
+-- 结果：-5436999610281751320
+
+-- 使用 general_murmurhash3 计算字符串的哈希值
+> SELECT general_murmurhash3('hello');
+-- 结果：-8014657081559513573
+
+-- 对不同数据类型进行哈希计算
+> SELECT general_complexhash2(123);
+-- 结果：9208534749291869864
+
+
+> SELECT general_murmurhash3(123);
+-- 结果：5808450433748234714
+
+-- 对浮点数类型进行哈希计算
+> SELECT general_complexhash2(3.14);
+-- 结果：-3844631488065270338
+
+
+> SELECT general_murmurhash3(3.14);
+-- 结果：9195935839840165100
+
+-- 对日期类型进行哈希计算
+> SELECT general_complexhash2(date'2022-01-01');
+-- 结果：-8898766858233323866
+
+-- 对时间类型进行哈希计算
+> SELECT general_complexhash2(timestamp'2022-01-01 10:00:00');
+-- 结果：1671608758248121621
+```

package/bin/skills/lakehouse-doc/references/sql_functions/scalar_functions/hash_functions/hash_combine.md

@@ -0,0 +1,37 @@
+### HASH_COMBINE 和 HASH_COMBINE_COMMUTATIVE 函数
+
+#### 功能描述
+`hash_combine` 函数用于将多个哈希值 h1, h2, ..., hN 组合成一个新的哈希值。该函数的特点是组合值的顺序会影响最终的哈希值。
+
+`hash_combine_commutative` 函数与 `hash_combine` 类似，也用于将多个哈希值 h1, h2, ..., hN 组合成一个新的哈希值。不同之处在于，该函数的特点是组合值的顺序不会影响最终的哈希值，即满足交换律。
+
+#### 参数说明
+* `h1`, `h2`, ..., `hN`: bigint 类型，表示要组合的哈希值。
+
+#### 返回结果
+返回一个 `bigint` 类型的值，表示组合后的哈希值。
+
+#### 使用示例
+以下示例展示了如何使用 `hash_combine` 和 `hash_combine_commutative` 函数：
+
+```sql
+-- 使用 hash_combine 函数
+SELECT hash_combine(1, 2, 3) AS hash_combine_result1;
+-- 结果：175247765312
+
+SELECT hash_combine(3, 2, 1) AS hash_combine_result2;
+-- 结果：175247756320
+
+-- 使用 hash_combine_commutative 函数
+SELECT hash_combine_commutative(1, 2, 3) AS hash_commutative_result1;
+-- 结果：10777284388
+
+SELECT hash_combine_commutative(3, 2, 1) AS hash_commutative_result2;
+-- 结果：10777284388
+```
+
+从上述示例中可以看出，`hash_combine` 函数在组合值的顺序改变时，结果也会发生变化；而 `hash_combine_commutative` 函数在组合值的顺序改变时，结果保持不变。
+
+#### 注意事项
+* 当需要组合的哈希值数量较少时，可以使用这两个函数。但如果需要合并大量的哈希值，建议使用其他方法，以避免性能问题。
+* 在实际应用中，可以根据具体需求选择合适的函数。如果对组合值的顺序有要求，可以使用 `hash_combine` 函数；如果对顺序无要求，可以使用 `hash_combine_commutative` 函数。

package/bin/skills/lakehouse-doc/references/sql_functions/scalar_functions/hash_functions/hash_combine_commutative.md

@@ -0,0 +1,54 @@
+### HASH_COMBINE_COMMUTATIVE
+```sql
+hash_combine_commutative(value1, value2, ...)
+```
+#### 功能
+对多个值进行可交换的哈希组合。与普通的 `hash_combine` 不同，`hash_combine_commutative` 的结果不受参数顺序影响，即 `hash_combine_commutative(a, b, c)` 与 `hash_combine_commutative(c, b, a)` 的结果相同。该函数常用于需要对无序集合进行哈希计算的场景。
+
+#### 参数
+* `value1`, `value2`, ...: 任意类型，待组合哈希的值，至少需要一个参数
+
+#### 返回结果
+* `bigint` 类型
+* 返回所有输入值的可交换哈希组合结果
+* 结果与参数顺序无关
+
+#### 举例
+```sql
+-- 参数顺序不影响结果
+> SELECT hash_combine_commutative(1, 2, 3);
+10777284388
+
+> SELECT hash_combine_commutative(3, 2, 1);
+10777284388
+
+
+-- 用于计算 bitmap 的哈希值
+> SELECT
+    general_murmurhash3(bitmap_build(array(1L, 2L, 3L))),
+    hash_combine_commutative(
+      general_murmurhash3(3L),  -- size
+      general_murmurhash3(1L),
+      general_murmurhash3(2L),
+      general_murmurhash3(3L)
+    );
+-4327490212287121842	-4327490212287121842
+
+-- 用于计算 map 的哈希值（key-value 对的顺序不影响结果）
+> SELECT general_murmurhash3(map(1, '2', 3, '4')),
+         hash_combine(
+           general_murmurhash3(size(map(1, '2', 3, '4'))),
+           hash_combine_commutative(
+             hash_combine(general_murmurhash3(1), general_murmurhash3('2')),
+             hash_combine(general_murmurhash3(3), general_murmurhash3('4'))
+           )
+         );
+-7258238779908172255	-7258238779908172255
+```
+
+#### 说明
+* `hash_combine_commutative` 是可交换的（commutative），即参数顺序不影响结果
+* 与 `hash_combine` 的区别：`hash_combine` 考虑参数顺序，`hash_combine_commutative` 不考虑参数顺序
+* 常用于计算无序数据结构（如 `set`、`bitmap`、`map`）的哈希值
+* 该函数与 `general_murmurhash3` 配合使用，可以实现复杂数据结构的哈希计算
+* 适用于需要对集合进行去重或比较的场景，因为集合中元素的顺序通常不重要