@clickzetta/cz-cli-darwin-x64 0.3.1

package/bin/skills/lakehouse-doc/references/sql_functions/scalar_functions/math_functions/random.md

@@ -0,0 +1,67 @@
+### 随机数生成函数：RAND
+
+```sql
+RAND()
+```
+
+#### 功能描述
+
+`RAND()` 函数是一个非确定性的随机数生成函数，它可以返回一个在 \[0, 1) 区间内的随机浮点数，数值分布均匀。该函数在各种随机抽样、模拟和概率计算场景中具有广泛的应用。
+
+#### 返回类型
+
+该函数返回一个 `DOUBLE` 类型的值。
+
+#### 使用示例
+
+1. 生成一个随机数：
+   ```sql
+   SELECT RAND(); -- 返回一个 [0, 1) 区间内的随机浮点数
+   ```
+   结果示例：
+   ```
+   0.53298387155464
+   ```
+
+2. 在一个表格中为每一行生成一个随机数：
+   ```sql
+   SELECT id, RAND() AS random_number FROM users;
+   ```
+   结果示例：
+   ```
+   1, 0.3245897911074116
+   2, 0.6547382678236785
+   3, 0.12345678903485962
+   ```
+
+3. 配合其他数值函数使用，生成一个指定范围内的随机数：
+   ```sql
+   SELECT (RAND() * 100) AS random_value BETWEEN 0 AND 100; -- 生成一个 0 到 100 之间的随机数
+   ```
+   结果示例：
+   ```
+   67.39123456
+   ```
+
+4. 用于随机选择记录：
+   ```sql
+   SELECT * FROM products ORDER BY RAND() LIMIT 1; -- 随机选取一个产品记录
+   ```
+   结果示例：
+   ```
+   id: 3,
+   name: 'Randomly Selected Product',
+   price: 19.99
+   ```
+
+#### 注意事项
+
+* `RAND()` 函数每次调用都会生成一个新的随机数。例如：
+
+  ```sql
+  SELECT RAND(1); -- 使用种子 1 初始化随机数生成器
+  ```
+
+* 在某些数据库管理系统中，`RAND()` 函数可能有不同的行为或限制，请根据具体系统查阅相关文档。
+
+^

package/bin/skills/lakehouse-doc/references/sql_functions/scalar_functions/math_functions/round.md

@@ -0,0 +1,48 @@
+### ROUND 函数
+
+#### 功能描述
+ROUND 函数用于对数值类型的表达式进行四舍五入操作，保留指定位数的小数。该函数支持多种输入数据类型，包括 float、double、decimal、smallint、tinyint、int 和 bigint。
+
+#### 语法格式
+```sql
+ROUND(expr [, d])
+```
+
+#### 参数说明
+- `expr`：需要进行四舍五入操作的数值类型表达式。
+- `d`：用于指定保留小数位数的整数，支持负值。默认值为 0。
+
+#### 返回结果
+返回四舍五入后的数值结果，类型与输入的 `expr` 相同。
+
+#### 使用示例
+
+1. 保留一位小数：
+   ```sql
+   SELECT ROUND(3.14, 1); -- 结果为：3.1
+   ```
+
+2. 保留两位小数：
+   ```sql
+   SELECT ROUND(3.1415926, 2); -- 结果为：3.14
+   ```
+
+3. 保留整数部分：
+   ```sql
+   SELECT ROUND(2.5); -- 结果为：3
+   ```
+
+4. 保留整数部分（省略小数位数参数）：
+   ```sql
+   SELECT ROUND(314.1592, -1); -- 结果为：310
+   ```
+
+5. 对负数进行四舍五入：
+   ```sql
+   SELECT ROUND(-3.14, 1); -- 结果为：-3.1
+   ```
+
+6. 对 DECIMAL 类型进行四舍五入：
+   ```sql
+   SELECT ROUND(123.4567, 2); -- 结果为：123.46
+   ```

package/bin/skills/lakehouse-doc/references/sql_functions/scalar_functions/math_functions/shiftleft.md

@@ -0,0 +1,67 @@
+### SHIFTLEFT
+```sql
+shiftleft(value, n)
+```
+#### 功能
+对整数值进行左移位操作。左移 n 位相当于乘以 2^n。该函数支持 int 和 bigint 类型。
+
+#### 参数
+* value: int 或 bigint 类型，待移位的值
+* n: int 类型，移位的位数，必须大于等于 0
+
+#### 返回结果
+* 与 value 相同的类型（int 或 bigint）
+* 返回左移后的结果
+* 如果 value 或 n 为 NULL，则返回 NULL
+
+#### 举例
+```sql
+-- int 类型左移
+> SELECT shiftleft(1, 2);
+4
+
+> SELECT shiftleft(8, 2);
+32
+
+> SELECT shiftleft(0, 2);
+0
+
+-- bigint 类型左移
+> SELECT shiftleft(1L, 2);
+4
+
+> SELECT shiftleft(8L, 2);
+32
+
+-- NULL 处理
+> SELECT shiftleft(NULL, 2);
+NULL
+
+> SELECT shiftleft(1, NULL);
+NULL
+
+-- 负数左移
+> SELECT shiftleft(-4, 2);
+-16
+
+-- 实际应用：计算 2 的幂
+> SELECT shiftleft(1, 10);  -- 2^10 = 1024
+1024
+```
+
+#### 说明
+* 左移 n 位等价于乘以 2^n
+* 对于正数：shiftleft(x, n) = x * 2^n
+* 对于负数，左移操作保留符号位。
+* 移位操作可能导致溢出：
+  * int 类型范围：-2,147,483,648 到 2,147,483,647
+  * bigint 类型范围：-9,223,372,036,854,775,808 到 9,223,372,036,854,775,807
+* 如果移位后的结果超出类型范围，会发生溢出（结果不可预测）。
+* 移位操作是位运算，性能优于乘法运算
+* 常用于：
+  * 快速计算 2 的幂次
+  * 位标志和位掩码操作
+  * 数据编码和解码
+* 相关函数：
+  * shiftright - 算术右移（保留符号位）
+  * shiftrightunsigned - 逻辑右移（不保留符号位）

package/bin/skills/lakehouse-doc/references/sql_functions/scalar_functions/math_functions/shiftright.md

@@ -0,0 +1,70 @@
+### SHIFTRIGHT
+```sql
+shiftright(value, n)
+```
+#### 功能
+对整数值进行算术右移位操作。算术右移会保留符号位，即负数右移后仍为负数。右移 n 位相当于除以 2^n（向下取整）。该函数支持 int 和 bigint 类型。
+
+#### 参数
+* `value`: int 或 bigint 类型，待移位的值
+* `n`: int 类型，移位的位数，必须大于等于 0
+
+#### 返回结果
+* 与 value 相同的类型（int 或 bigint）
+* 返回右移后的结果
+* 如果 value 或 n 为 NULL，返回 NULL
+
+#### 举例
+```sql
+-- int 类型右移
+> SELECT shiftright(8, 2);
+2
+
+> SELECT shiftright(1, 2);
+0
+
+> SELECT shiftright(0, 2);
+0
+
+-- bigint 类型右移
+> SELECT shiftright(8L, 2);
+2
+
+> SELECT shiftright(32L, 2);
+8
+
+-- NULL 处理
+> SELECT shiftright(NULL, 2);
+NULL
+
+> SELECT shiftright(8, NULL);
+NULL
+
+-- 负数右移（保留符号位）
+> SELECT shiftright(-4, 2);
+-1
+
+-- 实际应用：快速除以 2 的幂
+> SELECT shiftright(1024, 10);  -- 1024 / 2^10 = 1
+1
+```
+
+#### 说明
+* shiftright 是算术右移，保留符号位
+* 对于正数：shiftright(x, n) = floor(x / 2^n)
+* 对于负数，算术右移保留符号位，右移后仍为负数
+* 右移操作等价于整数除法（向下取整）
+* 与 `shiftrightunsigned` 的区别：
+  * `shiftright` 是算术右移，保留符号位
+  * `shiftrightunsigned` 是逻辑右移，不保留符号位，用 0 填充最高位
+* 示例：对于 -4（二进制表示为 11111111111111111111111111111100）
+  * shiftright(-4, 2) = -1（保留符号位）
+  * shiftrightunsigned(-4, 2) = 1073741823（用 0 填充最高位）
+* 移位操作是位运算，性能优于除法运算
+* 常用于：
+  * 快速计算除以 2 的幂次
+  * 位标志和位掩码操作
+  * 数据编码和解码
+* 相关函数：
+  * `shiftleft` - 左移
+  * `shiftrightunsigned` - 逻辑右移（不保留符号位）

package/bin/skills/lakehouse-doc/references/sql_functions/scalar_functions/math_functions/shiftrightunsigned.md

@@ -0,0 +1,70 @@
+### SHIFTRIGHTUNSIGNED
+```sql
+shiftrightunsigned(value, n)
+```
+#### 功能
+对整数值进行逻辑右移位操作。逻辑右移不保留符号位，用 0 填充最高位，因此负数右移后会变成正数。该函数支持 int 和 bigint 类型。
+
+#### 参数
+* `value`: int 或 bigint 类型，待移位的值
+* `n`: int 类型，移位的位数，必须大于等于 0
+
+#### 返回结果
+* 与 value 相同的类型（int 或 bigint）
+* 返回右移后的结果
+* 如果 `value` 或 `n` 为 NULL，返回 NULL
+
+#### 举例
+```sql
+-- int 类型逻辑右移
+> SELECT shiftrightunsigned(8, 2);
+2
+
+> SELECT shiftrightunsigned(1, 2);
+0
+
+> SELECT shiftrightunsigned(0, 2);
+0
+
+-- bigint 类型逻辑右移
+> SELECT shiftrightunsigned(8L, 2);
+2
+
+> SELECT shiftrightunsigned(32L, 2);
+8
+
+-- NULL 处理
+> SELECT shiftrightunsigned(NULL, 2);
+NULL
+
+> SELECT shiftrightunsigned(8, NULL);
+NULL
+
+-- 负数逻辑右移（不保留符号位，用 0 填充）
+> SELECT shiftrightunsigned(-4, 2);
+1073741823
+
+-- 对比算术右移和逻辑右移
+> SELECT shiftright(-4, 2), shiftrightunsigned(-4, 2);
+-1	1073741823
+```
+
+#### 说明
+* `shiftrightunsigned` 是逻辑右移，不保留符号位，用 0 填充最高位
+* 对于正数，逻辑右移和算术右移的结果相同
+* 对于负数，逻辑右移会将符号位作为普通位处理，用 0 填充最高位
+* 与 `shiftright` 的区别：
+  * `shiftright` 是算术右移，保留符号位
+  * `shiftrightunsigned` 是逻辑右移，不保留符号位
+* 示例：对于 -4（int 类型，32 位二进制表示为 `11111111111111111111111111111100`）
+  * `shiftright(-4, 2)` = -1（保留符号位，结果为 `11111111111111111111111111111111`）
+  * `shiftrightunsigned(-4, 2)` = 1073741823（用 0 填充，结果为 `00111111111111111111111111111111`）
+* 对于 bigint 类型（64 位），处理方式相同，只是位数更多
+* 常用于：
+  * 无符号整数运算
+  * 位掩码操作
+  * 哈希计算
+  * 数据编码和解码
+* 相关函数：
+  * `shiftleft` - 左移
+  * `shiftright` - 算术右移（保留符号位）

package/bin/skills/lakehouse-doc/references/sql_functions/scalar_functions/math_functions/sign.md

@@ -0,0 +1,46 @@
+### SIGN 函数
+
+#### 功能描述
+`SIGN` 函数用于判断给定数值表达式 `expr` 的正负。根据 `expr` 的值，函数返回以下结果：
+- 当 `expr` 为正数时，返回 1.0；
+- 当 `expr` 为负数时，返回 -1.0；
+- 当 `expr` 为 0 时，返回 0。
+
+#### 语法
+```sql
+SIGN(expr)
+```
+#### 参数
+- `expr`: 需要判断正负的数值表达式，类型为 `DOUBLE`。
+
+#### 返回值
+返回类型为 `DOUBLE` 的结果，根据 `expr` 的正负情况返回 1.0、-1.0 或 0。
+
+#### 使用示例
+以下示例展示了如何使用 `SIGN` 函数来判断不同数值的正负：
+
+```sql
+-- 当 expr 为正数时，返回 1.0
+SELECT SIGN(10.5);
+-- 结果：1.0
+
+-- 当 expr 为负数时，返回 -1.0
+SELECT SIGN(-20.25);
+-- 结果：-1.0
+
+-- 当 expr 为 0 时，返回 0
+SELECT SIGN(0);
+-- 结果：0.0
+
+-- 判断带有小数的数值表达式的正负
+SELECT SIGN(3.14159);
+-- 结果：1.0
+
+-- 判断由字符串转换而来的数值表达式的正负
+SELECT SIGN(CAST('123.45' AS DOUBLE));
+-- 结果：1.0
+
+```
+
+#### 注意事项
+- 当 `expr` 为 `NULL` 时，`SIGN` 函数将返回 `NULL`。

package/bin/skills/lakehouse-doc/references/sql_functions/scalar_functions/math_functions/sin.md

@@ -0,0 +1,67 @@
+### 正弦函数 (SIN)
+
+#### 概述
+正弦函数 (SIN) 是一个数学函数，用于计算给定角度的正弦值。在 SQL 语言中，我们可以使用 `sin` 函数来实现这一功能。该函数接受一个参数，并返回一个 `double` 类型的值。
+
+#### 语法
+```
+sin(expr)
+```
+
+#### 参数
+- `expr`：一个 `double` 类型的数值，表示需要计算正弦值的角度（以弧度为单位）。
+
+#### 返回结果
+返回一个 `double` 类型的值，表示给定角度的正弦值。
+
+#### 使用示例
+
+1.  计算 0 弧度的正弦值：
+    ```sql
+SELECT sin(0);
+```
+    结果：
+    ```
+0.0
+```
+
+2.  计算 π/2 弧度（即 90°）的正弦值：
+    ```sql
+SELECT sin(pi()/2);
+```
+    结果：
+    ```
+1.0
+```
+
+3.  计算 π 弧度（即 180°）的正弦值：
+    ```sql
+SELECT sin(pi());
+```
+    结果：
+    ```
+1.2246467991473532E-16
+```
+
+4.  计算 3π/2 弧度（即 270°）的正弦值：
+    ```sql
+SELECT sin(3 * pi()/2);
+```
+    结果：
+    ```
+-1.0
+```
+
+5.  计算一个负角度（-π/4 弧度，即 -45°）的正弦值：
+    ```sql
+SELECT sin(-pi()/4);
+```
+    结果：
+    ```
+-0.7071067811865475
+```
+
+#### 注意事项
+- 确保输入的参数是一个有效的数值，否则可能会导致计算错误或返回 `NULL`。
+- 当输入的角度值为负数时，正弦函数会返回相应的负值。
+- 正弦函数在实际应用中可用于解决三角函数问题，以及分析振动和波动等现象。

package/bin/skills/lakehouse-doc/references/sql_functions/scalar_functions/math_functions/sinh.md

@@ -0,0 +1,46 @@
+### 双曲正弦函数 (SINH)
+
+---
+
+#### 功能描述
+`sinh` 函数用于计算给定数值表达式的双曲正弦（hyperbolic sine）。双曲正弦函数是数学中双曲函数的一种，其定义为 `sinh(x) = (e^x - e^(-x)) / 2`，其中 `e` 是自然对数的底数。
+
+#### 语法
+```
+sinh(expr)
+```
+#### 参数
+- `expr`: 需要计算双曲正弦的数值表达式，类型为 `double`。
+
+#### 返回结果
+返回计算后的双曲正弦值，类型为 `double`。
+
+#### 使用示例
+1. 计算 `sinh(0)`:
+```sql
+SELECT sinh(0);
+```
+结果:
+```
+0.0
+```
+2. 计算 `sinh(1)` 和 `sinh(-1)`:
+```sql
+SELECT sinh(1) AS sinh1, sinh(-1) AS sinhNeg1;
+```
+结果:
+```
+sinh1: 1.1752011936438014
+sinhNeg1: -1.1752011936438014
+```
+3. 计算 `sinh(2)` 和 `sinh(-2)`:
+```sql
+SELECT sinh(2) AS sinh2, sinh(-2) AS sinhNeg2;
+```
+结果:
+```
+sinh2: 3.62686176124242
+sinhNeg2: -3.626860407847019
+```
+
+。

package/bin/skills/lakehouse-doc/references/sql_functions/scalar_functions/math_functions/sqrt.md

@@ -0,0 +1,40 @@
+### SQRT 函数
+```
+sqrt(expr)
+```
+#### 功能描述
+SQRT 函数用于计算指定数值表达式（expr）的平方根。该函数接受一个 double 类型的参数，并返回一个 double 类型的计算结果。
+
+#### 参数说明
+* `expr` (double 类型)：需要计算平方根的数值表达式。
+
+#### 返回结果
+返回一个 double 类型的数值，表示参数 expr 的平方根。
+
+#### 使用示例
+1. 计算 0.16 的平方根：
+```sql
+SELECT SQRT(0.16);
+```
+结果：
+```
+0.4
+```
+
+2. 计算 25 的平方根：
+```sql
+SELECT SQRT(25);
+```
+结果：
+```
+5.0
+```
+
+3. 计算 9.8596 的平方根（保留两位小数）：
+```sql
+SELECT ROUND(SQRT(9.8596), 2);
+```
+结果：
+```
+3.14
+```

package/bin/skills/lakehouse-doc/references/sql_functions/scalar_functions/math_functions/tan.md

@@ -0,0 +1,42 @@
+### TAN 函数
+
+#### 概述
+`TAN` 函数用于计算给定角度的正切值。在数学中，正切值表示直角三角形中对边与邻边的比值。此函数在三角函数计算和角度转换等场景中具有广泛的应用。
+
+#### 语法
+```
+TAN(expr)
+```
+#### 参数
+- `expr`: 需要计算正切值的角度，类型为 `DOUBLE`。
+
+#### 返回结果
+返回计算结果的正切值，类型为 `DOUBLE`。
+
+#### 使用示例
+1.  计算 0 度的正切值：
+    ```sql
+   SELECT TAN(0);
+   -- 结果：0.0
+   ```
+2.  计算 45 度的正切值：
+    ```sql
+   SELECT TAN(45);
+   -- 结果：1.6197751905438615
+   ```
+3.  计算 90 度的正切值（结果为无穷大）：
+    ```sql
+   SELECT TAN(90);
+   -- 结果：-1.995200412208242
+   ```
+4.  计算 -90 度的正切值（结果为负无穷大）：
+    ```sql
+   SELECT TAN(-90);
+   -- 结果：1.995200412208242
+   ```
+5.  计算 180 度的正切值：
+    ```sql
+   SELECT TAN(180);
+   -- 结果：1.3386902103511544
+   ```
+

package/bin/skills/lakehouse-doc/references/sql_functions/scalar_functions/math_functions/tanh.md

@@ -0,0 +1,38 @@
+### TANH 函数
+```sql
+TANH(expr)
+```
+#### 功能描述
+TANH 函数用于计算给定数值表达式 `expr` 的双曲正切（hyperbolic tangent），返回结果为双曲正切值。
+
+#### 参数说明
+* `expr`：待计算的数值表达式，类型为浮点数（double）。
+
+#### 返回结果
+返回计算结果的双曲正切值，类型为浮点数（double）。
+
+#### 使用示例
+```sql
+-- 计算 0 的双曲正切值
+> SELECT TANH(0);
+0.0
+
+-- 计算 1 的双曲正切值
+> SELECT TANH(1);
+0.7615941559557649
+
+-- 计算 -1 的双曲正切值
+> SELECT TANH(-1);
+-0.7615941559557649
+
+-- 计算一个负数值 -2 的双曲正切值
+> SELECT TANH(-2);
+0.9640275800758169 
+
+-- 计算一个较大正数值 5 的双曲正切值
+> SELECT TANH(5);
+0.9999092042625951
+
+-- 计算一个较小负数值 -0.5 的双曲正切值
+> SELECT TANH(-0.5);
+-0.46211715726

package/bin/skills/lakehouse-doc/references/sql_functions/scalar_functions/nested_functions/array.md

@@ -0,0 +1,46 @@
+### 数组函数：array
+``` sql
+array(e1, e2, ... eN)
+```
+
+#### 功能描述
+`array` 函数用于创建一个包含指定元素的数组。该函数接受任意数量的参数，并将它们作为数组的元素。所有元素将按照传入的顺序排列。
+
+#### 参数说明
+- `e1, e2, ... eN`: `T` 类型，可以是任意相同类型的值。如果传入不同类型的值，系统将尝试进行隐式类型转换。
+
+#### 返回类型
+- 返回一个 `array<T>` 类型的数组，其中 `T` 为元素的具体类型。
+
+#### 使用示例
+1. 创建一个包含整数的数组：
+   ```sql
+   > SELECT array(1, 2, 3);
+   [1, 2, 3]
+   ```
+2. 创建一个包含浮点数的数组：
+   ```sql
+   > SELECT array(1.5, 2.3, 4.7);
+   [1.5, 2.3, 4.7]
+   ```
+3. 创建一个包含字符串的数组：
+   ```sql
+   > SELECT array('apple', 'banana', 'cherry');
+   ['apple', 'banana', 'cherry']
+   ```
+4. 隐式类型转换示例：
+   ```sql
+   > SELECT array(1, '2', 3.0);
+   [1.0,2.0,3.0] -- 字符串 '2' 被隐式转换为数值类型
+   ```
+5. 使用 `array` 函数与 `SELECT` 语句结合，从表中选择多个字段并创建数组：
+   ```sql
+   > SELECT array(column1, column2, column3) FROM my_table;
+   ```
+   假设 `my_table` 包含三列 `column1`, `column2`, `column3`，该查询将为每一行返回一个包含这三列值的数组。
+
+#### 注意事项
+- 当传入的参数类型不一致时，系统将尝试进行隐式类型转换。如果转换失败，将元素返回为 null。
+- 在创建数组时，请确保所有元素的类型兼容，以避免不必要的类型转换和潜在的性能损失。
+
+通过使用 `array` 函数，您可以轻松地在 SQL 查询中创建和管理数组数据，从而更灵活地处理和分析数据。

package/bin/skills/lakehouse-doc/references/sql_functions/scalar_functions/nested_functions/array_append.md

@@ -0,0 +1,26 @@
+### ARRAY_APPEND
+```sql
+array_append(array, element)
+```
+
+#### 功能
+在数组末尾追加一个元素，返回新的数组。
+
+#### 参数
+* `array`: `array<T>` - 输入的数组
+* `element`: `T` - 要追加的元素
+
+#### 返回结果
+* `array<T>` - 追加元素后的新数组。
+
+#### 举例
+```sql
+> SELECT array_append(array(1, 2, 3), 3);
+[1,2,3,3]
+
+> SELECT array_append(array(1, 2, 3), cast(null as int));
+[1,2,3,null]
+
+> SELECT array_append(cast(array() as array<int>), 1);
+[1]
+```