@clickzetta/cz-cli-darwin-x64 0.3.75 → 0.3.78

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

@@ -1,427 +0,0 @@
-# 逻辑和位运算符
-
-## 逻辑非 (!)
-**功能**：对表达式进行逻辑非操作，即如果表达式为真（true），返回假（false）；如果表达式为假（false），返回真（true）。
-
-**参数**：
-- `expr`：布尔类型表达式。
-
-**返回结果**：
-- 布尔类型值。
-
-**示例**：
-```sql
-SELECT !true; -- 返回 false
-SELECT !false; -- 返回 true
-SELECT !NULL; -- 返回 NULL
-```
-
-## 按位非 (~)
-**功能**：对表达式进行按位非操作，即将每一位的0变成1，1变成0。
-
-**参数**：
-- `expr`：整数类型表达式。
-
-**返回结果**：
-- 与输入表达式相同类型的值。
-
-**示例**：
-```sql
-SELECT ~0; -- 返回 -1
-```
-
-## 不等于 (!=)
-**功能**：比较两个表达式，如果它们不相等，返回真（true）。
-
-**参数**：
-- `expr1`：布尔类型表达式。
-- `expr2`：与`expr1`相同类型的表达式。
-
-**返回结果**：
-- 布尔类型值。
-
-**示例**：
-```sql
-SELECT 1 != 0; -- 返回 true
-SELECT 10 != 10; -- 返回 false
-SELECT 10 != NULL; -- 返回 NULL
-```
-
-## 取模 (%)
-**功能**：返回两个数值表达式相除的余数。
-
-**参数**：
-- `expr1`：数值类型表达式，包括 float、double、decimal、tinyint、smallint、int、bigint。
-- `expr2`：与`expr1`相同类型的表达式。
-
-**返回结果**：
-- 与输入参数相同类型的值。
-
-**示例**：
-```sql
-SELECT 2 % 1.8; -- 返回 0.2
-SELECT -10 % 3; -- 返回 -1
-```
-
-## 乘法 (*)
-**功能**：返回两个数值表达式的乘积。
-
-**参数**：
-- `expr1`：数值类型表达式，包括 float、double、decimal、tinyint、smallint、int、bigint。
-- `expr2`：与`expr1`相同类型的表达式。
-
-**返回结果**：
-- 与输入参数相同类型的值。
-
-**示例**：
-```sql
-SELECT 1.4 * 2.3; -- 返回 3.22
-```
-
-## 加法 (+)
-**功能**：返回两个数值表达式的和。
-
-**参数**：
-- `expr1`：数值类型表达式，包括 float、double、decimal、tinyint、smallint、int、bigint。
-- `expr2`：与`expr1`相同类型的表达式。
-
-**返回结果**：
-- 与输入参数相同类型的值。
-
-**示例**：
-```sql
-SELECT 1.4 + 2.3; -- 返回 3.7
-```
-
-## 正号 (+)
-**功能**：返回表达式的值，不进行任何改变。
-
-**参数**：
-- `expr`：数值类型表达式。
-
-**返回结果**：
-- 与输入参数相同类型的值。
-
-**示例**：
-```sql
-SELECT +10; -- 返回 10
-SELECT +(-10); -- 返回 -10
-```
-
-## 减法 (-)
-**功能**：返回两个数值表达式的差。
-
-**参数**：
-- `expr1`：数值类型表达式，包括 float、double、decimal、tinyint、smallint、int、bigint。
-- `expr2`：与`expr1`相同类型的表达式。
-
-**返回结果**：
-- 与输入参数相同类型的值。
-
-**示例**：
-```sql
-SELECT 3.3 - 10; -- 返回 -6.7
-```
-
-## 负号 (-)
-**功能**：返回表达式的负值。
-
-**参数**：
-- `expr`：数值类型表达式。
-
-**返回结果**：
-- 与输入参数相同类型的值。
-
-**示例**：
-```sql
-SELECT -(-10); -- 返回 10
-SELECT -(1.1); -- 返回 -1.1
-```
-
-## 除法 (/)
-**功能**：返回两个数值表达式相除的商。
-
-**参数**：
-- `expr1`：数值类型表达式，包括 float、double、decimal。
-- `expr2`：与`expr1`相同类型的表达式。
-
-**返回结果**：
-- 与输入参数相同类型的值。
-
-**示例**：
-```sql
-SELECT 3.3 / 1.5; -- 返回 2.2
-SELECT 9L / 2L; -- 返回 4.5
-```
-
-## 整数除法 (DIV)
-**功能**：返回两个数值表达式相除的整数部分。
-
-**参数**：
-- `dividend`：被除数，数值类型表达式。
-- `divisor`：除数，与被除数相同类型的表达式。
-
-**返回结果**：
-- 整数类型值。
-
-**示例**：
-```sql
-SELECT 10 DIV 3; -- 返回 3
-SELECT 20 DIV 4; -- 返回 5
-SELECT 7 DIV 2; -- 返回 3
-```
-
-## 小于 (<)
-**功能**：比较两个表达式，如果第一个表达式小于第二个，返回真（true）。
-
-**参数**：
-- `expr1`：可比较类型的表达式。
-- `expr2`：与`expr1`相同类型的表达式。
-
-**返回结果**：
-- 布尔类型值。
-
-**示例**：
-```sql
-SELECT 1 < 2; -- 返回 true
-SELECT 10 < 10; -- 返回 false
-SELECT 'a' < 'b'; -- 返回 true
-```
-
-## 小于等于 (<=)
-**功能**：比较两个表达式，如果第一个表达式小于或等于第二个，返回真（true）。
-
-**参数**：
-- `expr1`：可比较类型的表达式。
-- `expr2`：与`expr1`相同类型的表达式。
-
-**返回结果**：
-- 布尔类型值。
-
-**示例**：
-```sql
-SELECT 1 <= 2; -- 返回 true
-SELECT 10 <= 10; -- 返回 true
-SELECT 'a' <= 'b'; -- 返回 true
-```
-
-## 大于 (>)
-**功能**：比较两个表达式，如果第一个表达式大于第二个，返回真（true）。
-
-**参数**：
-- `expr1`：可比较类型的表达式。
-- `expr2`：与`expr1`相同类型的表达式。
-
-**返回结果**：
-- 布尔类型值。
-
-**示例**：
-```sql
-SELECT 2 > 1; -- 返回 true
-SELECT 10 > 10; -- 返回 false
-SELECT 'b' > 'a'; -- 返回 true
-```
-
-## 大于等于 (>=)
-**功能**：比较两个表达式，如果第一个表达式大于或等于第二个，返回真（true）。
-
-**参数**：
-- `expr1`：可比较类型的表达式。
-- `expr2`：与`expr1`相同类型的表达式。
-
-**返回结果**：
-- 布尔类型值。
-
-**示例**：
-```sql
-SELECT 2 >= 1; -- 返回 true
-SELECT 10 >= 10; -- 返回 true
-SELECT 'b' >= 'a'; -- 返回 true
-```
-
-## 等于 (=)
-**功能**：比较两个表达式，如果它们相等，返回真（true）。
-
-**参数**：
-- `expr1`：可比较类型的表达式。
-- `expr2`：与`expr1`相同类型的表达式。
-
-**返回结果**：
-- 布尔类型值。
-
-**示例**：
-```sql
-SELECT 1 = 1; -- 返回 true
-SELECT 10 = 5; -- 返回 false
-SELECT 10 = NULL; -- 返回 NULL
-```
-
-## 等于 (==)
-**功能**：比较两个表达式，如果它们相等，返回真（true）。功能与 `=` 相同。
-
-**参数**：
-- `expr1`：可比较类型的表达式。
-- `expr2`：与`expr1`相同类型的表达式。
-
-**返回结果**：
-- 布尔类型值。
-
-**示例**：
-```sql
-SELECT 1 == 1; -- 返回 true
-SELECT 10 == 5; -- 返回 false
-SELECT 10 == NULL; -- 返回 NULL
-```
-
-## 不等于 (<>)
-**功能**：比较两个表达式，如果它们不相等，返回真（true）。功能与 `!=` 相同。
-
-**参数**：
-- `expr1`：可比较类型的表达式。
-- `expr2`：与`expr1`相同类型的表达式。
-
-**返回结果**：
-- 布尔类型值。
-
-**示例**：
-```sql
-SELECT 1 <> 0; -- 返回 true
-SELECT 10 <> 10; -- 返回 false
-SELECT 10 <> NULL; -- 返回 NULL
-```
-
-## NULL 安全等于 (<=>)
-**功能**：比较两个表达式，与 `=` 类似，但对 NULL 值有特殊处理。如果两个值都是 NULL，返回真（true）；如果其中一个是 NULL，返回假（false）。
-
-**参数**：
-- `expr1`：可比较类型的表达式。
-- `expr2`：与`expr1`相同类型的表达式。
-
-**返回结果**：
-- 布尔类型值。
-
-**示例**：
-```sql
-SELECT 1 <=> 1; -- 返回 true
-SELECT NULL <=> NULL; -- 返回 true
-SELECT 1 <=> NULL; -- 返回 false
-SELECT NULL <=> 1; -- 返回 false
-```
-
-## 逻辑与 (AND)
-**功能**：对两个布尔表达式进行逻辑与操作。只有当两个表达式都为真（true）时，返回真（true）。
-
-**参数**：
-- `expr1`：布尔类型表达式。
-- `expr2`：布尔类型表达式。
-
-**返回结果**：
-- 布尔类型值。
-
-**示例**：
-```sql
-SELECT true AND true; -- 返回 true
-SELECT true AND false; -- 返回 false
-SELECT false AND false; -- 返回 false
-SELECT true AND NULL; -- 返回 NULL
-```
-
-## 逻辑或 (OR)
-**功能**：对两个布尔表达式进行逻辑或操作。只要有一个表达式为真（true），返回真（true）。
-
-**参数**：
-- `expr1`：布尔类型表达式。
-- `expr2`：布尔类型表达式。
-
-**返回结果**：
-- 布尔类型值。
-
-**示例**：
-```sql
-SELECT true OR false; -- 返回 true
-SELECT false OR false; -- 返回 false
-SELECT false OR NULL; -- 返回 NULL
-SELECT true OR NULL; -- 返回 true
-```
-
-## 逻辑非 (NOT)
-**功能**：对布尔表达式进行逻辑非操作。与 `!` 运算符功能相同。
-
-**参数**：
-- `expr`：布尔类型表达式。
-
-**返回结果**：
-- 布尔类型值。
-
-**示例**：
-```sql
-SELECT NOT true; -- 返回 false
-SELECT NOT false; -- 返回 true
-SELECT NOT NULL; -- 返回 NULL
-```
-
-## 按位与 (&)
-**功能**：对两个整数表达式进行按位与操作。
-
-**参数**：
-- `expr1`：整数类型表达式。
-- `expr2`：与`expr1`相同类型的表达式。
-
-**返回结果**：
-- 与输入表达式相同类型的值。
-
-**示例**：
-```sql
-SELECT 12 & 10; -- 返回 8 (二进制: 1100 & 1010 = 1000)
-SELECT 7 & 3; -- 返回 3 (二进制: 0111 & 0011 = 0011)
-```
-
-## 按位或 (|)
-**功能**：对两个整数表达式进行按位或操作。
-
-**参数**：
-- `expr1`：整数类型表达式。
-- `expr2`：与`expr1`相同类型的表达式。
-
-**返回结果**：
-- 与输入表达式相同类型的值。
-
-**示例**：
-```sql
-SELECT 12 | 10; -- 返回 14 (二进制: 1100 | 1010 = 1110)
-SELECT 7 | 3; -- 返回 7 (二进制: 0111 | 0011 = 0111)
-```
-
-## 按位异或 (^)
-**功能**：对两个整数表达式进行按位异或操作。
-
-**参数**：
-- `expr1`：整数类型表达式。
-- `expr2`：与`expr1`相同类型的表达式。
-
-**返回结果**：
-- 与输入表达式相同类型的值。
-
-**示例**：
-```sql
-SELECT 12 ^ 10; -- 返回 6 (二进制: 1100 ^ 1010 = 0110)
-SELECT 7 ^ 3; -- 返回 4 (二进制: 0111 ^ 0011 = 0100)
-```
-
-## 字符串连接 (||)
-**功能**：连接两个字符串表达式。
-
-**参数**：
-- `expr1`：字符串类型表达式。
-- `expr2`：字符串类型表达式。
-
-**返回结果**：
-- 字符串类型值。
-
-**示例**：
-```sql
-SELECT 'Hello' || ' ' || 'World'; -- 返回 'Hello World'
-SELECT 'abc' || 'def'; -- 返回 'abcdef'
-SELECT 'value: ' || 123; -- 返回 'value: 123'
-```
-

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

@@ -1,41 +0,0 @@
-### PI 函数
-#### 简介
-`pi()` 函数用于返回圆周率常量 π 的值。该函数不需要任何参数。
-#### 语法
-```
-pi()
-```
-#### 返回类型
-该函数返回一个 double 类型的数值。
-#### 使用示例
-**示例 1：查询圆周率的值**
-```
-SELECT pi();
-```
-返回结果：
-```
-3.141592653589793
-```
-
-**示例 2：计算圆的面积**
-已知半径为 5：
-```
-SELECT pi() * 5 * 5;
-```
-返回结果：
-```
-78.53981633974483
-```
-
-**示例 3：计算球的体积**
-已知半径为 3：
-```
-SELECT 4/3 * pi() * 3 * 3 * 3;
-```
-返回结果：
-```
-113.09724459528809
-```
-#### 注意事项
-- `pi()` 函数返回的 π 值是一个近似值，其具体精度取决于所使用的数据库系统。
-- 在实际应用中，根据需要保留适当的小数位数。

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

@@ -1,31 +0,0 @@
-### PMOD 函数
-```
-pmod(expr1, expr2)
-```
-#### 功能描述
-PMOD 函数用于计算两个数值表达式之间的模运算结果，并返回结果的正值。具体来说，该函数首先计算 `expr1 % expr2`，然后将结果与 `expr2` 相加，最后再对 `expr2` 取模，从而确保返回值始终为正数。这一特性使得 PMOD 函数在处理循环或周期性问题时非常有用。
-
-#### 参数说明
-* **expr1**：一个数值类型的表达式，可以是 float、double、decimal、tinyint、smallint、int 或 bigint 类型。
-* **expr2**：与 expr1 类型相同的数值表达式。
-
-#### 返回值
-返回类型与输入参数 expr1 和 expr2 相同。
-
-#### 使用示例
-1.  计算 2 与 1.8 之间的模运算结果：
-    ```sql
-SELECT pmod(2, 1.8); -- 结果为 0.2
-```
-2.  计算 -10 与 3 之间的模运算结果，并确保返回正值：
-    ```sql
-SELECT pmod(-10, 3); -- 结果为 2
-```
-3.  对于整数和小数的混合计算，PMOD 函数同样适用：
-    ```sql
-SELECT pmod(5.5, 3); -- 结果为 2.5
-```
-4.  在处理周期性问题时，比如计算一天中剩余的时间，可以使用 PMOD 函数：
-    ```sql
-SELECT pmod(12, 24); -- 结果为 12，表示从 12:00 开始还有 12 小时
-```

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

@@ -1,15 +0,0 @@
-### POSITIVE
-```sql
-positive(expr)
-```
-#### 功能
-返回 expr 的值。
-#### 参数
-* expr：数值类型（SMALLINT、TINYINT、INT、BIGINT、DECIMAL、DOUBLE、FLOAT）
-#### 返回值
-返回值类型与参数类型一致。
-#### 举例
-```sql
-> SELECT positive(1);
-1
-```

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

@@ -1,39 +0,0 @@
-### 幂运算函数：POW
-
-#### 功能描述
-`POW` 函数用于计算一个数的指定次方，即求解 `expr1` 的 `expr2` 次幂。该函数在数学、科学和工程计算等领域有广泛的应用。
-
-#### 语法
-```
-POW(expr1, expr2)
-```
-#### 参数说明
-* `expr1`：基数，类型为双精度浮点数（double）。
-* `expr2`：指数，类型为双精度浮点数（double）。
-
-#### 返回结果
-返回值类型为双精度浮点数（double），表示 `expr1` 的 `expr2` 次方的计算结果。
-
-#### 使用示例
-1. 计算 2 的 3 次方：
-   ```sql
-   SELECT POW(2, 3); -- 结果为 8.0
-   ```
-2. 计算 5 的 2 次方：
-   ```sql
-   SELECT POW(5, 2); -- 结果为 25.0
-   ```
-3. 计算 3 的 0.5 次方（即求平方根）：
-   ```sql
-   SELECT POW(3, 0.5); -- 结果为 1.7320508075688772
-   ```
-4. 计算 10 的 5 次方除以 2 的 3 次方：
-   ```sql
-   SELECT POW(10, 5) / POW(2, 3); -- 结果为 12500.0 
-   ```
-
-#### 注意事项
-* 当 `expr2` 为负数时，表示求解 `expr1` 的负指数幂。例如，`POW(2, -3)` 计算的是 1/(2³)。
-* 当 `expr2` 为 0 时，对于任何非零的 `expr1`，结果都是 1。如果 `expr1` 为 0，则结果未定义。
-* 当 `expr1` 为负数且 `expr2` 为非整数时，结果可能是一个复数。在某些数据库系统中，这可能导致错误或返回特定的复数表示。请根据所使用的数据库系统查阅相关文档以确保正确处理。
-

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

@@ -1,30 +0,0 @@
-### 弧度函数
-```sql
-radians(expr)
-```
-#### 功能描述
-`radians` 函数用于将角度值转换为对应的弧度值。在数学中，角度和弧度是两种度量圆周的方式，其中弧度是更通用的度量单位。该函数可以确保计算的准确性和一致性。
-
-#### 参数说明
-- `expr`：要转换的角度值，类型为 `double`。
-
-#### 返回结果
-返回转换后的弧度值，类型为 `double`。
-
-#### 使用示例
-1. 将 90 度转换为弧度：
-```sql
-SELECT radians(90);
--- 返回结果：1.5707963267948966
-```
-2. 将 180 度转换为弧度：
-```sql
-SELECT radians(180);
--- 返回结果：3.141592653589793
-```
-3. 将 360 度转换为弧度：
-```sql
-SELECT radians(360);
--- 返回结果：6.283185307179586
-```
-

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

@@ -1,39 +0,0 @@
-### 随机数生成函数：RAND
-
-```sql
-RAND()
-```
-
-#### 功能描述
-
-`RAND()` 函数是一个非确定性函数，用于生成一个在 \[0,1) 区间内的随机数。每次调用该函数时，都会返回一个均匀分布的随机浮点数，范围从0（包含）到1（不包含）。
-
-#### 返回类型
-
-该函数返回的结果类型为双精度浮点数（double）。
-
-#### 使用示例
-
-1. 生成一个随机数并显示：
-   ```sql
-   SELECT RAND();
-   ```
-   结果可能类似于：
-   ```
-   0.1234567890123456
-   ```
-
-2. 在一个表中为每个记录生成一个随机权重：
-   假设有一个名为 `products` 的表，包含以下列：`id`（产品ID）、`name`（产品名称）和 `weight`（产品重量）。可以使用 `RAND()` 函数为每个产品生成一个随机权重：
-   ```sql
-   SELECT id, name, RAND() * 100 AS random_weight
-   FROM products;
-   ```
-   结果可能类似于：
-   ```
-   1   iPhone 52.34567890
-   2   Samsung 76.78901234
-   3   Huawei 23.45678901
-   ```
-
-^

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

@@ -1,26 +0,0 @@
-### 函数名称
-RANDN 函数
-
-### 功能描述
-RANDN 函数是一个非确定性函数，用于生成遵循标准正态分布（均值为 0，标准差为 1）的随机数。该函数在模拟数据、数值分析和统计测试等各种场景下具有广泛的应用。
-
-### 返回类型
-该函数返回一个 double 类型的值。
-
-### 使用示例
-1. 生成一个标准的正态分布随机数：
-   ```sql
-   SELECT RANDN();
-   ```
-   结果可能类似于：`0.635793277734877`
-
-2. 生成多个正态分布随机数并计算平均值：
-   ```sql
-   SELECT AVG RANDN() FROM (SELECT NULL) AS x;
-   ```
-   结果可能类似于：`0.0`
-   在这个例子中，我们通过生成随机数并计算其平均值，可以看到结果趋近于 0，符合标准正态分布的均值特性。
-
-
-### 结论
-RANDN 函数是一个简单而强大的工具，可以帮助用户在 SQL 查询中生成符合正态分布的随机数。通过灵活运用此函数，用户可以在数据分析和处理中实现更多的可能性。