@clickzetta/cz-cli-darwin-x64 0.3.76 → 0.3.80

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

@@ -1,96 +0,0 @@
-### 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

@@ -1,31 +0,0 @@
-### 函数名称
-`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

@@ -1,51 +0,0 @@
-### 函数名称
-
-`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

@@ -1,29 +0,0 @@
-### 函数名称
-`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

@@ -1,46 +0,0 @@
-### 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

@@ -1,64 +0,0 @@
-### 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

@@ -1,21 +0,0 @@
-### 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

@@ -1,34 +0,0 @@
-### 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

@@ -1,59 +0,0 @@
-### 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

@@ -1,53 +0,0 @@
-### 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

@@ -1,33 +0,0 @@
-### 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

@@ -1,49 +0,0 @@
-### 通用哈希函数
-
-#### 功能描述
-本节介绍的两个通用哈希函数 `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

@@ -1,37 +0,0 @@
-### 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

@@ -1,54 +0,0 @@
-### 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` 配合使用，可以实现复杂数据结构的哈希计算
-* 适用于需要对集合进行去重或比较的场景，因为集合中元素的顺序通常不重要