@clickzetta/cz-cli-darwin-x64 0.3.1

package/bin/skills/lakehouse-doc/references/sql_functions/scalar_functions/string_functions/position.md

@@ -0,0 +1,35 @@
+### 定位函数：POSITION
+```sql
+POSITION(substr, str [, pos])
+```
+#### 功能描述
+POSITION 函数用于在一个字符串（str）中查找另一个子字符串（substr）的位置。它返回 substr 在 str 中从 pos 位置开始第一次出现的位置。如果 pos 未提供，则默认从字符串起始位置（即位置 1）开始在整个 str 中进行搜索。该函数在处理文本数据时非常有用，尤其是在需要确定特定字符或子字符串在文本中的位置时。
+
+#### 参数说明
+* substr (string): 需要查找的子字符串。
+* str (string): 被搜索的原始字符串。
+* pos (bigint, 可选): 开始搜索的位置。默认值为 1。如果 pos 小于 1，函数将返回 0。
+
+#### 返回结果
+返回一个 bigint 类型的数值，表示 substr 在 str 中第一次出现的位置。位置计数从 1 开始。如果 substr 未在 str 中找到，返回 0。
+
+#### 使用示例
+```sql
+-- 例子 1：查找子字符串 "World" 在 "HelloWorldWorld" 中的位置
+SELECT POSITION('World', 'HelloWorldWorld'); -- 结果为 6
+
+-- 例子 2：在 "HelloWorldWorld" 中从第 7 个字符开始查找 "World"
+SELECT POSITION('World', 'HelloWorldWorld', 7); -- 结果为 11
+
+-- 例子 3：在 "HelloWorld" 中查找 "World"（注意：pos 未提供，将在整个字符串中搜索）
+SELECT POSITION('World', 'HelloWorld'); -- 结果为 6
+
+-- 例子 4：查找 "a" 在 "banana" 中的位置，并从第 3 个字符开始搜索
+SELECT POSITION('a', 'banana', 3); -- 结果为 4
+
+-- 例子 5：查找 "apple" 在 "I love apples" 中的位置，注意大小写敏感
+SELECT POSITION('apple', 'I love apples'); -- 结果为 8
+
+-- 例子 6：查找 "Apple" 在 "I love apples" 中的位置，由于大小写敏感，返回 0
+SELECT POSITION('Apple', 'I love apples'); -- 结果为 0
+```

package/bin/skills/lakehouse-doc/references/sql_functions/scalar_functions/string_functions/regexp_count.md

@@ -0,0 +1,115 @@
+## REGEXP\_COUNT
+
+### 函数描述
+
+`REGEXP_COUNT` 函数用于计算字符串中与指定正则表达式模式匹配的子字符串出现的次数。该函数返回一个整数，表示匹配的总数。如果字符串为空或不存在匹配项，则返回 0。
+
+### 语法
+
+sql
+
+```sql
+REGEXP_COUNT(string_expression, pattern_expression)
+```
+
+### 参数说明
+
+- string\_expression:STRING,待搜索的字符串表达式
+- pattern\_expression:STRING,Java 正则表达式模式。详见[正则表达式支持的函数列表](../../../regexp-statement.md)
+
+### 返回值
+
+返回类型：`INTEGER`
+
+返回指定正则表达式在字符串中匹配的次数。如果模式不匹配，返回 0。
+
+### 使用示例
+
+**示例 1：计数简单字符串匹配**
+
+统计字符串中 `hello` 出现的次数：
+
+```sql
+SELECT REGEXP_COUNT('hello world hello', 'hello') as count_result;
+```
+
+执行结果：
+
+```
+count_result2
+```
+
+**示例 2：计数数字匹配**
+
+统计日期字符串中数字的个数：
+
+```sql
+SELECT REGEXP_COUNT('2024-10-28', '\\d+') as test2;
+```
+
+执行结果：
+
+```
+test23
+```
+
+这个示例中，日期字符串 `2024-10-28` 包含 3 个数字序列：`2024`、`10` 和 `28`。
+
+**示例 3：计数字符类模式**
+
+统计字符串中单个数字字符的个数：
+
+sql
+
+```sql
+SELECT REGEXP_COUNT('hello123world456', '[0-9]') as test3;
+```
+
+执行结果：
+
+```
+test36
+```
+
+字符串 `hello123world456` 中包含 6 个数字字符（1、2、3、4、5、6）。
+
+**示例 4：复杂模式匹配**
+
+在多个字符串上应用不同的模式：
+
+```sql
+SELECT  REGEXP_COUNT('apple apple apple', 'apple') as apple_count,  REGEXP_COUNT('The quick brown fox', '[aeiou]') as vowel_count,  REGEXP_COUNT('123-456-7890', '[0-9]') as digit_count;
+```
+
+执行结果：
+
+```
+apple_count	vowel_count	digit_count3	5	10
+```
+
+* `apple` 在字符串中出现 3 次
+* 元音字母在 "The quick brown fox" 中出现 5 次
+* 数字字符在电话号码中出现 10 次
+
+**示例 5：边界情况处理**
+
+测试空字符串和不匹配的模式：
+
+```sql
+SELECT  REGEXP_COUNT('', 'a') as empty_string,  REGEXP_COUNT('hello', 'xyz') as no_match,  REGEXP_COUNT('aaa', 'a+') as pattern_match;
+```
+
+执行结果：
+
+```
+| apple_count | vowel_count | digit_count |
+| ----------- | ----------- | ----------- |
+| 3           | 5           | 10          |
+
+```
+
+* 空字符串返回 0
+* 不存在的模式返回 0
+* 贪心量词 `a+` 将连续的 `aaa` 视为一个匹配项，返回 1
+
+^

package/bin/skills/lakehouse-doc/references/sql_functions/scalar_functions/string_functions/regexp_extract.md

@@ -0,0 +1,37 @@
+### REGEXP_EXTRACT 函数
+```sql
+regexp_extract(str, regexp [, idx])
+```
+#### 功能描述
+REGEXP_EXTRACT 函数利用指定的正则表达式（regexp）从输入字符串（str）中提取匹配的文本。该函数使用 [re2](https://github.com/google/re2) 正则表达式引擎进行匹配。
+
+#### 参数说明
+* str (string)：待匹配的输入字符串。
+* regexp (string)：用于匹配的正则表达式字符串。
+* idx (int, 可选)：要抽取的分组（group）索引。索引从 1 开始，默认值为 1，表示提取第一个分组。若指定值为 0，则表示匹配整个正则表达式。
+
+#### 返回值
+返回一个字符串（string），包含匹配的文本。
+
+#### 使用示例
+```sql
+-- 示例 1：提取字符串中的数字
+> SELECT regexp_extract('价格为：100-500元', r'(\d+)-(\d+)', 1);
+'100'
+
+-- 示例 2：提取特定字符前的文本
+> SELECT regexp_extract('abc123def', r'^(.*)\d', 1);
+'abc12'
+
+-- 示例 3：提取括号内的文本
+> SELECT regexp_extract('（这里是示例）', r'（(.*)）', 1);
+'这里是示例'
+
+-- 示例 4：使用 idx 参数提取第二个分组
+> SELECT regexp_extract('纽约-美国', r'(.*)-(.*)', 2);
+'美国'
+
+-- 示例 5：匹配整个正则表达式
+> SELECT regexp_extract('需要匹配的文本', r'^(.*)$', 0);
+'需要匹配的文本'
+```

package/bin/skills/lakehouse-doc/references/sql_functions/scalar_functions/string_functions/regexp_extract_all.md

@@ -0,0 +1,31 @@
+## 功能描述
+
+`REGEXP_EXTRACT_ALL` 函数用于从字符串中提取与正则表达式匹配的所有子串。
+
+## 语法
+
+```SQL
+REGEXP_EXTRACT_ALL(string, pattern)
+```
+
+## 参数说明
+
+* **string**: 要搜索的原始字符串。
+* **pattern**: 用于匹配的正则表达式。
+
+## 返回结果
+
+返回一个数组，包含所有匹配的子串。
+
+## 示例
+
+```SQL
+SELECT regexp_extract_all('100-200, 300-400',r'(\d+)-(\d+)', 1);
++---------------+
+|      res      |
++---------------+
+| ["100","300"] |
++---------------+
+```
+
+

package/bin/skills/lakehouse-doc/references/sql_functions/scalar_functions/string_functions/regexp_instr.md

@@ -0,0 +1,152 @@
+## REGEXP\_INSTR
+
+### 函数描述
+
+`REGEXP_INSTR` 函数用于返回与指定正则表达式模式相匹配的子字符串在源字符串中首次出现的位置。位置从 1 开始计数。如果未找到匹配项，则返回 0。
+
+### 语法
+
+sql
+
+```sql
+REGEXP_INSTR(string_expression, pattern_expression)
+```
+
+### 参数说明
+- string\_expression:STRING,待搜索的字符串表达式
+- pattern\_expression:STRING,Java 正则表达式模式。详见[正则表达式支持的函数列表](../../../regexp-statement.md)
+
+
+### 返回值
+
+返回类型：`INTEGER`
+
+返回与指定模式相匹配的首个子字符串的起始位置（从 1 开始）。如果没有找到匹配项，返回 0。
+
+### 使用示例
+
+**示例 1：查找特定字符位置**
+
+查找 `@` 符号在邮箱地址中的位置：
+
+
+
+```sql
+SELECT REGEXP_INSTR('email@example.com', '@') as position;
+```
+
+执行结果：
+
+```
+position6
+```
+
+字符 `@` 在邮箱地址中位置为 6（即第 6 个字符）。
+
+**示例 2：查找字符串首次出现的位置**
+
+在含有重复字符串的文本中查找首次出现的位置：
+
+
+```sql
+SELECT REGEXP_INSTR('hello world hello', 'hello') as first_position;
+```
+
+执行结果：
+
+```
+first_position1
+```
+
+`hello` 在字符串中首次出现的位置是 1。
+
+**示例 3：使用字符类查找匹配位置**
+
+查找第一个数字字符的位置：
+
+
+```sql
+SELECT REGEXP_INSTR('abc123def456ghi', '[0-9]') as first_digit_position;
+```
+
+执行结果：
+
+```
+first_digit_position4
+```
+
+第一个数字 `1` 位于字符串中的第 4 个位置。
+
+**示例 4：多个字符串的并行查找**
+
+在多个字符串上查找不同模式的位置：
+
+
+```sql
+SELECT  REGEXP_INSTR('email@example.com', '@') as at_position,  REGEXP_INSTR('hello world hello', 'hello') as hello_position,  REGEXP_INSTR('test string', ' ') as space_position;
+```
+
+执行结果：
+
+```
+at_position	hello_position	space_position6	1	5
+```
+
+* `@` 符号位于第 6 位
+* 首个 `hello` 位于第 1 位
+* 空格位于第 5 位
+
+**示例 5：使用复杂模式匹配**
+
+使用字符类和单词边界等高级模式：
+
+
+```sql
+SELECT  REGEXP_INSTR('user@example.com', '[a-z]+') as letters_position,  REGEXP_INSTR('file_123_backup.txt', '[0-9]') as digit_position,  REGEXP_INSTR('www.example.com', '\\w+') as word_position;
+```
+
+执行结果：
+
+```
+letters_position	digit_position	word_position1	6	1
+```
+
+* 小写字母序列从第 1 位开始
+* 第一个数字在第 6 位
+* 单词字符从第 1 位开始
+
+**示例 6：处理无匹配的情况**
+
+测试不存在匹配项的场景：
+
+
+```sql
+SELECT  REGEXP_INSTR('', 'a') as empty_result,  REGEXP_INSTR('hello', 'xyz') as no_match_result;
+```
+
+执行结果：
+
+```
+empty_result	no_match_result0	0
+```
+
+* 空字符串返回 0
+* 不存在的模式返回 0
+
+### 应用场景
+
+* **邮箱地址解析**：快速定位 `@` 符号以分割用户名和域名部分
+* **数据清洗**：在混合格式的字符串中定位特定模式以进行分割或提取
+* **文件路径处理**：查找文件扩展名开始位置（`.` 的位置）
+* **电话号码格式化**：定位数字序列的开始位置以进行格式转换
+* **URL 解析**：快速定位 `://` 或其他协议分隔符的位置
+
+### 注意事项
+
+* 返回的位置从 1 开始计数，不是 0
+* 使用反斜杠作为转义字符时，需要在 SQL 字符串中使用双反斜杠 `\\` 表示单个 `\`
+* 函数返回的是首个匹配项的位置，如需查找后续匹配项，需要结合其他字符串函数（如 `SUBSTR`）使用
+* 正则表达式引擎使用 RE2 规范
+* 模式匹配是区分大小写的。
+
+

package/bin/skills/lakehouse-doc/references/sql_functions/scalar_functions/string_functions/regexp_replace.md

@@ -0,0 +1,34 @@
+### REGEXP_REPLACE 函数
+```sql
+regexp_replace(str, regexp, rep [, position])
+```
+#### 功能描述
+REGEXP_REPLACE 函数用于在字符串 str 中查找所有匹配正则表达式 regexp 的子字符串，并将它们替换为指定的字符串 rep。
+
+#### 参数说明
+* str (string) ：待处理的字符串。
+* regexp (string) ：正则表达式字符串。当前使用的正则表达式引擎为 [re2](https://github.com/google/re2)。
+* rep (string) ：用于替换匹配到的子字符串的字符串。
+* position (int, 可选) ：开始匹配的位置，大于等于 0。默认值为 1，表示从 str 的开头进行匹配。如果 position 超过 str 的长度，结果将返回 str。
+
+#### 返回结果
+返回处理后的字符串。
+
+#### 使用示例
+```sql
+-- 示例 1: 将字符串中的数字替换为 "digit"
+> SELECT regexp_replace('100-500',r'(\d+)', 'digit');
+-- 返回结果：digit-digit
+
+-- 示例 2: 替换字符串中的特定字符
+> SELECT regexp_replace('a1b2c3', r'(\d)', 'x');
+-- 返回结果：axbxcx
+
+-- 示例 3: 使用正则表达式匹配并替换字符串中的子字符串
+> SELECT regexp_replace('hello world', r'(\w{5})', '$1!');
+-- 返回结果：hello! world!
+
+-- 示例 4: 指定开始匹配的位置
+> SELECT regexp_replace('abcdef', '(b.)', 'x', 2);
+-- 返回结果：axdef
+

package/bin/skills/lakehouse-doc/references/sql_functions/scalar_functions/string_functions/repeat.md

@@ -0,0 +1,44 @@
+### REPEAT 函数
+
+#### 功能描述
+`REPEAT` 函数用于将一个字符串 `str` 重复 `times` 次，并返回生成的字符串。
+
+#### 参数说明
+- `str` (string类型)：需要重复的字符串。
+- `times` (int类型)：字符串 `str` 需要重复的次数。
+
+#### 返回类型
+返回一个字符串，该字符串是将 `str` 重复 `times` 次后的结果。
+
+#### 使用示例
+1.  重复单个字符：
+    ```sql
+SELECT REPEAT('a', 3);
+```
+    结果：
+    ```
+aaa
+```
+2.  重复一个单词：
+    ```sql
+SELECT REPEAT('hello', 2);
+```
+    结果：
+    ```
+hellohello
+```
+3.  与其他函数结合使用，例如拼接字符串：
+    ```sql
+SELECT CONCAT('The word " ', REPEAT('repeat', 2), ' " appears multiple times.');
+```
+    结果：
+    ```
+The word " repeatrepeat " appears multiple times.
+```
+
+#### 注意事项
+- 确保 `times` 参数为正整数，否则函数将返回空字符串。
+- 当 `times` 为 0 时，函数返回空字符串。
+- 如果 `str` 或 `times` 参数不是预期类型，函数可能返回错误或空字符串。
+
+通过使用 `REPEAT` 函数，您可以轻松地创建重复模式的字符串，例如在生成测试数据或填充字符串时非常有用。

package/bin/skills/lakehouse-doc/references/sql_functions/scalar_functions/string_functions/replace.md

@@ -0,0 +1,37 @@
+### 替换函数 (REPLACE)
+```sql
+replace(str, search [, replace])
+```
+#### 功能描述
+该函数用于在字符串 `str` 中查找子字符串 `search` 并将找到的内容替换为 `replace` 字符串。如果没有提供 `replace` 参数，则默认将 `search` 替换为空字符串。
+
+#### 参数说明
+- `str` (string): 需要进行操作的原始字符串。
+- `search` (string): 需要在 `str` 中查找并替换的子字符串。
+- `replace` (string, 可选): 用于替换找到的 `search` 子字符串的目标字符串。如果未提供该参数，则默认删除 `search` 子字符串。
+
+#### 返回结果
+返回一个新的字符串，其中 `str` 中的 `search` 子字符串已被替换为 `replace` 字符串，或者如果未提供 `replace` 参数，则删除 `search` 子字符串。
+
+#### 使用示例
+1. 将字符串 "Hello World" 中的 "World" 替换为 "Java"：
+```sql
+> SELECT replace('Hello World', 'World', 'Java');
+'Hello Java'
+```
+2. 删除字符串 "100-500" 中的 "100"：
+```sql
+> SELECT replace('100-500', '100');
+'-500'
+```
+3. 将字符串 "12345" 中的所有 "3" 替换为 "X"：
+```sql
+> SELECT replace('12345', '3', 'X');
+'12X45'
+```
+4. 将字符串 "data-science" 中的所有短横线（"-"）替换为下划线（"_"）：
+```sql
+> SELECT replace('data-science', '-', '_');
+'data_science'
+```
+通过这些示例，您可以看到 `replace` 函数在处理字符串时非常灵活且易于使用。您可以根据需要轻松地替换或删除字符串中的特定内容。

package/bin/skills/lakehouse-doc/references/sql_functions/scalar_functions/string_functions/reverse.md

@@ -0,0 +1,70 @@
+### 反转函数
+
+#### 概述
+反转函数用于将输入的字符串或数组的元素顺序颠倒。该函数可以处理不同类型的数据，非常灵活且实用。
+
+#### 语法
+```
+reverse(str)
+reverse(array)
+```
+
+#### 参数
+- `str` (字符串类型)：需要反转的字符串。
+- `array` (数组类型)：需要反转的数组。
+
+#### 返回值
+- 返回与输入参数相同类型的数据，但元素顺序相反。
+
+#### 使用示例
+
+1. 反转字符串：
+```sql
+SELECT reverse("hello");
+```
+输出：
+```
+olleh
+```
+
+2. 反转字符串（包含特殊字符和空格）：
+```sql
+SELECT reverse("a b c!@#");
+```
+结果：
+```
+#@! c b a
+```
+
+3. 反转数组：
+```sql
+SELECT reverse(array(1, 2, 3));
+```
+结果：
+```
+[3, 2, 1]
+```
+
+4. 反转数组（包含负数和零）：
+```sql
+SELECT reverse(array(-1, 0, 2, -3));
+```
+结果：
+```
+[-3, 2, 0, -1]
+```
+
+5. 反转字符串并结合其他函数进行操作：
+```sql
+SELECT upper(reverse("hello"));
+```
+结果：
+```
+OLLEH
+```
+
+#### 注意事项
+- 反转函数不会修改原始数据，而是返回一个新的、元素顺序相反的数据副本。
+- 当处理大量数据时，反转操作可能会消耗较多的计算资源和时间。
+
+通过以上示例和说明，您可以更轻松地使用反转函数处理各种数据。请根据实际需求进行调整和应用。

package/bin/skills/lakehouse-doc/references/sql_functions/scalar_functions/string_functions/right.md

@@ -0,0 +1,34 @@
+### RIGHT
+```sql
+right(str, len)
+```
+
+#### 功能
+返回字符串 str 右边的 len 个字符。
+
+#### 参数
+* `str`: string 类型
+* `len`: int 类型，要返回的字符数量
+
+#### 返回结果
+* string 类型，返回字符串右边的 len 个字符。
+* 如果 `len` 小于等于 0，返回空字符串
+* 如果 `len` 大于字符串长度，返回完整字符串
+
+#### 举例
+```sql
+> SELECT right('hello-world', 7);
+o-world
+
+> SELECT right('hello-world', 0);
+
+
+> SELECT right('hello-world', 99);
+hello-world
+
+> SELECT right('hell你好world', 7);
+你好world
+```
+
+#### 说明
+* 支持 Unicode 字符，按字符（而非字节）计数

package/bin/skills/lakehouse-doc/references/sql_functions/scalar_functions/string_functions/rlike.md

@@ -0,0 +1,64 @@
+### RLIKE 函数
+#### 概述
+RLIKE 函数用于检查一个字符串（str）是否符合给定的正则表达式（regex）。如果符合，则返回 true，否则返回 false。该函数使用 [re2](https://github.com/google/re2) 正则表达式引擎进行匹配。
+
+#### 语法
+```
+str [not] rlike regex
+
+rlike(str, regex)
+```
+#### 参数
+* str (string)：待匹配的字符串。
+* regex (string)：正则表达式。请注意，由于 SQL 解析器会对字符串常量进行转义，因此在使用常量指定正则表达式时需要使用双反斜杠（例如：'^\\\\abc$'）。
+
+#### 返回结果
+返回一个布尔值（boolean），表示 str 是否符合 regex。
+
+#### 使用示例
+1. 检查字符串 "100-500" 是否符合正则表达式 `\d+-\d+`（数字加短横线加数字）：
+```sql
+SELECT '100-500' RLIKE '\d+-\d+';
+```
+结果：
+```
+true
+```
+
+2. 使用函数形式检查字符串 "100-500" 是否符合正则表达式 `\d+-\d+`：
+```sql
+SELECT RLIKE('100-500', '\d+-\d+');
+```
+结果：
+```
+true
+```
+
+3. 检查字符串 "\\abc" 是否符合正则表达式 `^\\\\abc$`（匹配以 "abc" 开头和结尾的字符串，正则表达式本身可能包含反斜杠进行转义）：
+```sql
+SELECT RLIKE('\\abc', '^\\\\abc$');
+```
+结果：
+```
+true
+```
+
+4. 检查字符串 "abc" 是否**不符合**正则表达式 `^\\d+$`（以数字开头和结尾的字符串）：
+```sql
+SELECT 'abc' RLIKE '^\\d+$';
+```
+结果：
+```
+false
+```
+
+5. 使用 "not" 关键字检查字符串 "123" 是否**不符合**正则表达式 `\d+`（包含数字的字符串）：
+```sql
+SELECT '123' NOT RLIKE '\d+';
+```
+结果：
+```
+false
+```
+
+通过以上示例，您可以更好地理解 RLIKE 函数的用法和功能。在实际应用中，您可以根据需要使用不同的正则表达式来匹配和验证字符串。