@clickzetta/cz-cli-darwin-x64 0.3.1

package/bin/skills/lakehouse-doc/references/restore-dynamic-table.md

@@ -0,0 +1,126 @@
+## 功能概述
+
+**历史版本恢复**：
+使用本命令，您可以将未删除的表或动态表恢复到指定的历史版本。借助时间旅行功能，您可以轻松地将表状态回滚到过去的某个时刻，以便在需要时恢复数据。
+
+**数据保留周期**：
+对象的历史恢复能力取决于数据的保留周期。当前预览版本的数据保留周期默认为7天，未来将调整为1天。您可以通过执行[ALTER命令](TIMETRAVEL.md)来调整保留周期。请注意，修改保留周期可能会增加存储成本。本功能支持表（TABLE）和动态表（DYNAMIC TABLE），不支持物化视图。
+
+## 语法示例
+
+```SQL
+RESTORE TABLE table_name TO time_travel_version;
+time_travel_version ::= 
+    TIMESTAMP AS OF timestamp_expression;
+```
+
+## 参数说明
+
+1. **table\_name**：指定未删除的表名，可以是TABLE、DYNAMIC TABLE或MATERIALIZED VIEW。若表已被删除，请使用[UNDROP](UNDROP-TABLE.md)命令进行恢复。
+2. **time\_travel\_version**：指定要恢复的表版本。先使用 `DESC HISTORY table_name` 查看版本时间点，再通过`TIMESTAMP AS OF`子句来指定具体的时间点。`timestamp_expression` 是一个返回时间戳类型表达式的参数，例如：
+
+* `'2023-11-07 14:49:18'`，即可强制转换为时间戳的字符串。
+* `CAST('2023-11-07 14:49:18' AS TIMESTAMP)`。
+* `CURRENT_TIMESTAMP() - INTERVAL 12 HOURS`：12小时之前的版本。
+* 任何本身是时间戳类型或可强制转换为时间戳的表达式。
+
+## 使用案例
+
+**案例 1：使用 RESTORE 命令恢复普通表到指定版本**
+
+```SQL
+-- 查看表的变更历史
+DESC HISTORY json_table;
+
+-- 使用 RESTORE 命令恢复到指定版本
+RESTORE TABLE json_table TO TIMESTAMP AS OF '2024-01-26 17:44:45.349';
+SELECT * FROM json_table;
+
+-- 查询结果
++----------------------------------+
+|                j                 |
++----------------------------------+
+| {"id":1,"value":"200"}           |
+| {"id":2,"value":"300"}           |
+| {"extra":1,"id":3,"value":"400"} |
+| {"value":"100"}                  |
++----------------------------------+
+```
+
+**案例 2：使用 RESTORE 命令恢复动态表到指定版本**
+
+*   需要注意的是，如果动态表依赖的表数据没有变化，下次动态表刷新又会恢复成原来的结果。
+
+```
+DROP TABLE  IF EXISTS dy_base_a;
+CREATE TABLE dy_base_a (i int, j int);
+INSERT INTO dy_base_a VALUES
+(1,10),
+(2,20),
+(3,30),
+(4,40);
+--使用dynamic table进行加工
+DROP DYNAMIC TABLE  IF EXISTS change_table;
+CREATE  DYNAMIC TABLE change_table
+(i,j)
+AS select * from dy_base_a;
+--刷新dynamic table
+refresh DYNAMIC TABLE change_table;
+--查询表数据
+SELECT    *
+FROM      change_table;
++---+----+
+| i | j  |
++---+----+
+| 1 | 10 |
+| 2 | 20 |
+| 3 | 30 |
+| 4 | 40 |
++---+----+
+--向基表中插入数据
+INSERT INTO dy_base_a VALUES(5,10);
+--刷新dynamic table
+refresh DYNAMIC TABLE change_table;
+--查询表数据
+SELECT    *
+FROM      change_table;
++---+----+
+| i | j  |
++---+----+
+| 1 | 10 |
+| 2 | 20 |
+| 3 | 30 |
+| 4 | 40 |
+| 5 | 10 |
++---+----+
+--恢复最初的版本
+DESC HISTORY change_table;
++---------+-------------------------+------------+-------------+----------+-----------+-------------------------------+------------------------------------------------------------------------------------+
+| version |          time           | total_rows | total_bytes |   user   | operation |            job_id             |                                                       source_tables                |
++---------+-------------------------+------------+-------------+----------+-----------+-------------------------------+------------------------------------------------------------------------------------+
+| 3       | 2024-12-27 12:04:20.738 | 5          | 4950        | UAT_TEST | REFRESH   | 2024122712042034961pl5i9617jc | [{"table_name":"dy_base_a","workspace":"qingyun","schema":"public","version":"3"," |
+| 2       | 2024-12-27 12:01:33.349 | 4          | 2501        | UAT_TEST | REFRESH   | 2024122712013303061pl5i9617dk | [{"table_name":"dy_base_a","workspace":"qingyun","schema":"public","version":"2"," |
+| 1       | 2024-12-27 12:01:33.078 | 0          | 0           | UAT_TEST | CREATE    | 2024122712013279961pl5i9616do | [{"table_name":"dy_base_a","workspace":"qingyun","schema":"public"}]               |
++---------+-------------------------+------------+-------------+----------+-----------+-------------------------------+------------------------------------------------------------------------------------+
+--恢复至指定版本
+RESTORE TABLE change_table TO TIMESTAMP AS OF '2024-12-27 12:01:33.349';
+--查询数据
+SELECT    *
+FROM      change_table;
++---+----+
+| i | j  |
++---+----+
+| 1 | 10 |
+| 2 | 20 |
+| 3 | 30 |
+| 4 | 40 |
++---+----+
+```
+
+# 注意事项
+
+1.  请确保在执行 `RESTORE` 命令时，指定的时间点在表的保留期内。
+2.  执行 `RESTORE` 命令后，表的数据将被还原到指定的历史版本，但不会删除后续的历史版本。
+3.  请谨慎使用 `RESTORE` 命令，以避免数据丢失或不一致的风险。在执行此操作之前，建议先备份相关数据。
+
+

package/bin/skills/lakehouse-doc/references/restore.md

@@ -0,0 +1,127 @@
+## 功能概述
+
+**历史版本恢复**：
+使用本命令，您可以将未删除的表或动态表恢复到指定的历史版本。借助时间旅行功能，您可以轻松地将表状态回滚到过去的某个时刻，以便在需要时恢复数据。
+
+**数据保留周期**：
+对象的历史恢复能力取决于数据的保留周期。当前预览版本的数据保留周期默认为 7 天，未来将调整为 1 天。您可以通过执行 [ALTER TABLE...SET PROPERTIES](timetravel-summary.md) 来调整保留周期。请注意，修改保留周期可能会增加存储成本。该功能支持表（TABLE）和动态表（DYNAMIC TABLE），不支持物化视图。
+
+
+## 语法示例
+
+```SQL
+RESTORE TABLE table_name TO time_travel_version;
+time_travel_version ::= 
+    TIMESTAMP AS OF timestamp_expression;
+```
+
+## 参数说明
+
+1. **table_name**：指定未删除的表名，可以是 TABLE 或 DYNAMIC TABLE。若表已被删除，请使用 [UNDROP](UNDROP-TABLE.md) 命令进行恢复。
+2. **time_travel_version**：指定要恢复的表版本。先使用 `DESC HISTORY table_name` 查看版本时间点，再在 `TIMESTAMP AS OF` 子句中指定具体的时间点。`timestamp_expression` 是一个返回时间戳类型表达式的参数，例如：
+
+* `'2023-11-07 14:49:18'`，即可强制转换为时间戳的字符串。
+* `CAST('2023-11-07 14:49:18' AS TIMESTAMP)`。
+* `CURRENT_TIMESTAMP() - INTERVAL 12 HOURS`，即 12 小时之前的版本。
+* 任何本身是时间戳类型或可强制转换为时间戳的表达式。
+
+## 使用案例
+
+**案例 1：使用 RESTORE 命令恢复普通表到指定版本**
+
+```SQL
+-- 查看表的变更历史
+DESC HISTORY json_table;
+
+-- 使用 RESTORE 命令恢复到指定版本
+RESTORE TABLE json_table TO TIMESTAMP AS OF '2024-01-26 17:44:45.349';
+SELECT * FROM json_table;
+
+-- 查询结果
++----------------------------------+
+|                j                 |
++----------------------------------+
+| {"id":1,"value":"200"}           |
+| {"id":2,"value":"300"}           |
+| {"extra":1,"id":3,"value":"400"} |
+| {"value":"100"}                  |
++----------------------------------+
+```
+
+**案例 2：使用 RESTORE 命令恢复动态表到指定版本**
+
+需要注意的是，如果动态表依赖的表数据没有变化，下次动态表刷新又会恢复成原来的结果。
+
+```sql
+DROP TABLE IF EXISTS dy_base_a;
+CREATE TABLE dy_base_a (i int, j int);
+INSERT INTO dy_base_a VALUES
+(1, 10),
+(2, 20),
+(3, 30),
+(4, 40);
+-- 使用 dynamic table 进行加工
+DROP DYNAMIC TABLE IF EXISTS change_table;
+CREATE DYNAMIC TABLE change_table
+(i, j)
+AS SELECT * FROM dy_base_a;
+-- 刷新 dynamic table
+REFRESH DYNAMIC TABLE change_table;
+-- 查询表数据
+SELECT    *
+FROM      change_table;
++---+----+
+| i | j  |
++---+----+
+| 1 | 10 |
+| 2 | 20 |
+| 3 | 30 |
+| 4 | 40 |
++---+----+
+-- 向基表中插入数据
+INSERT INTO dy_base_a VALUES(5, 10);
+-- 刷新 dynamic table
+REFRESH DYNAMIC TABLE change_table;
+-- 查询表数据
+SELECT    *
+FROM      change_table;
++---+----+
+| i | j  |
++---+----+
+| 1 | 10 |
+| 2 | 20 |
+| 3 | 30 |
+| 4 | 40 |
+| 5 | 10 |
++---+----+
+-- 恢复最初的版本
+DESC HISTORY change_table;
++---------+-------------------------+------------+-------------+----------+-----------+-------------------------------+------------------------------------------------------------------------------------+
+| version |          time           | total_rows | total_bytes |   user   | operation |            job_id             |                                                       source_tables                |
++---------+-------------------------+------------+-------------+----------+-----------+-------------------------------+------------------------------------------------------------------------------------+
+| 3       | 2024-12-27 12:04:20.738 | 5          | 4950        | UAT_TEST | REFRESH   | 2024122712042034961pl5i9617jc | [{"table_name":"dy_base_a","workspace":"qingyun","schema":"public","version":"3"," |
+| 2       | 2024-12-27 12:01:33.349 | 4          | 2501        | UAT_TEST | REFRESH   | 2024122712013303061pl5i9617dk | [{"table_name":"dy_base_a","workspace":"qingyun","schema":"public","version":"2"," |
+| 1       | 2024-12-27 12:01:33.078 | 0          | 0           | UAT_TEST | CREATE    | 2024122712013279961pl5i9616do | [{"table_name":"dy_base_a","workspace":"qingyun","schema":"public"}]               |
++---------+-------------------------+------------+-------------+----------+-----------+-------------------------------+------------------------------------------------------------------------------------+
+-- 恢复至指定版本
+RESTORE TABLE change_table TO TIMESTAMP AS OF '2024-12-27 12:01:33.349';
+-- 查询数据
+SELECT    *
+FROM      change_table;
++---+----+
+| i | j  |
++---+----+
+| 1 | 10 |
+| 2 | 20 |
+| 3 | 30 |
+| 4 | 40 |
++---+----+
+```
+
+# 注意事项
+
+1. 请确保在执行 RESTORE 命令时，指定的时间点在表的保留期内。
+2. 执行 RESTORE 命令后，表的数据将被还原到指定的历史版本，但不会删除后续的历史版本。
+3. 请谨慎使用 RESTORE 命令，以避免数据丢失或不一致的风险。在执行此操作之前，建议先备份相关数据。
+
+

package/bin/skills/lakehouse-doc/references/result_cache.md

@@ -0,0 +1,102 @@
+# 了解和使用Result Cache
+
+## 简介
+
+云器 Lakehouse 使用缓存技术来提升查询性能和效率。平台提供了三种类型的缓存来提高查询性能：
+
+1. 查询结果缓存（Result Cache）
+2. 元数据缓存（Metadata Cache）
+3. 虚拟集群本地缓存（Virtual Cluster Local Disk Cache）
+
+    ![](.topwrite/assets/image_1713780513737.png)
+
+其中：
+
+* 元数据缓存和查询结果缓存服务从属于服务层，可在工作空间内共享。
+* 虚拟集群本地缓存保存在集群本地节点，仅在使用指定虚拟集群时才能使用其本地缓存。
+
+本文将介绍查询结果缓存的工作原理及其使用方式。
+
+## 结果缓存
+
+在云器 Lakehouse 中执行查询时，符合一定条件的查询结果会自动保留一段时间，并在该时间段结束后被清除。这部分临时存储的查询结果称为查询结果缓存。
+
+查询结果缓存（Result Cache）需要满足以下条件才能被复用：
+
+* 查询中使用的表的基础数据未发生改变。如果查询中使用的任何表中的数据发生更改，则无法复用结果缓存；
+* 查询中没有包含对视图的引用。如果查询对象中包含视图，则不支持保留查询结果缓存；
+* 新发起的 SQL 查询语句在语法上能够和先前执行过的查询精确匹配；
+* 查询中不包含非确定性函数（例如：CURRENT_TIMESTAMP()）或用户定义函数 (UDF)；
+* 先前的Result Cache未过期删除。
+
+## 结果缓存的过期周期
+
+结果缓存成功后，默认保留周期为24小时。
+
+在 24 小时内，若有后续查询复用了该结果缓存，则其过期时间将额外延长 24 小时。否则，24 小时后，该查询结果缓存将被清除。
+
+## 启用与禁用结果缓存
+
+使用 `cz.sql.enable.shortcut.result.cache` 参数在 SESSION 级别启用或禁用，如下所示。
+
+```Python
+--开启结果缓存
+set cz.sql.enable.shortcut.result.cache=true;
+
+--关闭结果缓存
+set cz.sql.enable.shortcut.result.cache=false;
+```
+
+注：当前（2024 年 04 月）Lakehouse 版本的查询结果缓存（Result Cache）功能处于公测阶段，默认未开启，后续版本将默认开启。
+
+## 约束与限制
+
+缓存保留周期：24小时。
+
+单个工作空间支持缓存的作业数量上限：10万。
+
+结果缓存大小限制：无限制。小于等于10MB的结果将缓存在管控层内存Cache，超过10MB的结果将持久化在存储层（对象存储文件）。
+
+不支持包含非确定性函数、UDF 的查询结果缓存。
+
+## 结果缓存演示
+
+为了演示查询结果缓存，首先启用结果缓存并在云器 Lakehouse 中执行一个 SQL 查询。然后重新运行相同的查询，以验证新查询是否通过重用结果缓存实现了加速。
+
+```Sql
+ --开启结果缓存
+set cz.sql.enable.shortcut.result.cache=true;
+
+ select
+        l_returnflag,
+        l_linestatus,
+        sum(l_quantity) as sum_qty,
+        sum(l_extendedprice) as sum_base_price,
+        sum(l_extendedprice * (1 - l_discount)) as sum_disc_price,
+        sum(l_extendedprice * (1 - l_discount) * (1 + l_tax)) as sum_charge,
+        avg(l_quantity) as avg_qty,
+        avg(l_extendedprice) as avg_price,
+        avg(l_discount) as avg_disc,
+        count(*) as count_order
+from
+        tpch_100g_new.lineitem
+where
+        l_shipdate <= date '1998-12-01' - interval '85' day
+group by
+        l_returnflag,
+        l_linestatus
+order by
+        l_returnflag,
+        l_linestatus
+;
+```
+
+第一次执行花费了12.1秒。通过Job Profile查看作业运行信息，作业从磁盘读取了大量数据。
+
+![](.topwrite/assets/4590d8b1-4fd3-45b6-abd2-816d8ca58242.png)
+
+第二次执行该查询时，作业复用了上次查询的结果缓存，在 15 ms 内返回了结果。
+![](.topwrite/assets/result_cache_query_output.png)
+![](.topwrite/assets/383621f0-27c0-4f17-b217-0c0ad3bbc686.png)
+查看作业的 Job Profile 时，可在诊断页面的执行计划图中看到作业使用了“JOB RESULT REUSE”，说明作业直接查询了结果数据。
+![](.topwrite/assets/image_1713780060450.png)

package/bin/skills/lakehouse-doc/references/revoke-from-share.md

@@ -0,0 +1,48 @@
+# REVOKE FROM SHARE 语句
+
+## 功能描述
+
+`REVOKE FROM SHARE` 语句用于取消已分享的表（table）或视图（view）的权限。通过执行该语句，可以撤销其他用户或角色对分享对象的访问权限。
+
+仅支持修改类型（kind属性）为'OUTBOUND'（对外分享）的分享对象。其他服务实例分享进入的分享对象（share）不可移除数据对象。
+
+## 语法格式
+
+```SQL
+REVOKE [PERMISSIONS] ON {TABLE table_name | VIEW view_name} FROM SHARE share_name;
+```
+
+**参数说明**
+
+* `PERMISSIONS`：指定要撤销的权限，可选值为 `select`（用于查询数据）和 `read metadata`（用于查看表或视图的元数据）。
+* `TABLE table_name`：指定要撤销权限的表名。
+* `VIEW view_name`：指定要撤销权限的视图名。
+* `share_name`：指定要操作的分享名称。
+
+## 使用示例
+
+1. 撤销用户对分享表的查询权限和元数据查看权限：
+
+   ```SQL
+   REVOKE select, read metadata ON TABLE share_demo_table FROM SHARE share_demo;
+   ```
+
+2. 仅撤销用户对分享视图的查询权限：
+
+   ```SQL
+   REVOKE select ON VIEW share_demo_view FROM SHARE share_demo;
+   ```
+
+3. 撤销用户对分享表的元数据查看权限，但保留查询权限：
+
+   ```SQL
+   REVOKE read metadata ON TABLE share_demo_table FROM SHARE share_demo;
+   ```
+
+## 注意事项
+
+* 执行 `REVOKE FROM SHARE` 语句前，请确保您具有足够的权限来撤销分享对象的权限。
+* 被撤销权限的用户或角色将无法再访问指定的表或视图。
+* 如果需要重新授予权限，可使用 `GRANT` 语句进行操作。
+
+通过以上内容，您可以更好地理解和使用 `REVOKE FROM SHARE` 语句来管理分享对象的权限。

package/bin/skills/lakehouse-doc/references/revoke-user-privileges.md

@@ -0,0 +1,91 @@
+## 功能描述
+
+本命令用于回收指定用户或角色的权限。您可以根据需要从用户或角色中回收各种类型的权限，包括但不限于对工作空间、模式（Schema）和工作空间对象的权限。
+
+## 语法详解
+
+```SQL
+REVOKE [GRANT OPTION FOR]
+
+workspacePriveleges ON WORKSPACE workspace_name
+| workspaceObjectPriveleges ON { ROLE | SCHEMA | VCLUSTER | FUNCTION } workspace_object_name
+| schemaPrivileges ON SCHEMA schema_name
+| schemaObjectPriveleges ON { TABLE | VIEW | MATERIALIZED VIEW } schema_object_name
+FROM USER user_name
+
+-- 参数解释
+workspacePriveleges ::=
+    CREATE { SCHEMA | VCLUSTER }
+
+-- 工作空间下对象授权
+workspaceObjectPriveleges ::=
+    -- SCHEMA
+    ALTER | DROP | READ METADATA | ALL [PRIVILEGES]
+    -- VCLUSTER
+    ALTER | DROP | USE | READ METADATA | ALL [PRIVILEGES]
+    --job
+    ALTER | CANCEL | READ METADATA | ALL [PRIVILEGES]
+
+--schema授权下创建对象授权
+schemaPrivileges ::=
+    CREATE { TABLE | VIEW | MATERIALIZED VIEW } | ALL
+
+--schema下的对象授权
+schemaObjectPriveleges ::=
+    -- table
+    ALTER | DROP | SELECT | INSERT | READ METADATA | ALL
+    -- view
+    ALTER | DROP | SELECT | ALL
+    -- MATERIALIZED VIEW
+    ALTER | DROP | SELECT | ALL
+```
+
+## 参数说明
+
+1. `workspacePriveleges`：授予在工作空间下创建对象的权限，例如创建模式（Schema）和虚拟集群（VCLUSTER）。
+
+2. `workspaceObjectPriveleges`：授予对工作空间下对象的修改和查看元数据的权限。
+
+3. `schemaPrivileges`：授予在模式（Schema）下创建对象的权限，例如创建表、视图和物化视图。
+
+4. `schemaObjectPriveleges`：授予对模式（Schema）下对象的修改、删除、查询等操作的权限。
+
+## 使用示例
+
+1. 回收用户 `uat_demo` 在 `lakehouse_public` 工作空间下创建虚拟集群的权限：
+
+   ```SQL
+   REVOKE CREATE VCLUSTER ON WORKSPACE lakehouse_public FROM USER uat_demo;
+   ```
+
+2. 回收用户 `uat_demo` 修改名为 `default` 的虚拟集群的权限：
+
+   ```SQL
+   REVOKE ALTER VCLUSTER ON VCLUSTER default FROM USER uat_demo;
+   ```
+
+3. 回收用户 `uat_demo` 在 `public` 模式下创建表和视图的权限：
+
+   ```SQL
+   REVOKE CREATE VIEW, CREATE TABLE ON SCHEMA public FROM USER uat_demo;
+   ```
+
+4. 回收用户 `uat_demo` 查询名为 `my_table` 的表的权限：
+
+   ```SQL
+   REVOKE SELECT ON TABLE public.my_table FROM USER uat_demo;
+   ```
+
+5. 回收角色 `reporting_role` 在 `sales` 模式下创建视图的权限：
+
+   ```SQL
+   REVOKE CREATE VIEW ON SCHEMA sales FROM ROLE reporting_role;
+   ```
+
+6. 回收用户 `data_engineer` 在 `lakehouse_public` 工作空间下的所有权限：
+
+   ```SQL
+   REVOKE ALL PRIVILEGES ON WORKSPACE lakehouse_public FROM USER data_engineer;
+   ```
+
+请根据您的实际需求选择合适的权限类型和对象进行操作。在执行此命令前，请确保您自身具有足够的权限来回收其他用户或角色的权限。

package/bin/skills/lakehouse-doc/references/right.md

@@ -0,0 +1,84 @@
+## RIGHT 函数：从字符串右侧提取指定长度的字符
+
+RIGHT 函数用于从给定字符串的右侧开始提取指定数量的字符。这个函数在处理文本数据时非常有用，尤其是在需要根据特定规则截取字符串的场景下。
+
+### 函数语法
+
+```sql
+RIGHT(string, length)
+```
+
+- `string`：要提取字符的原始字符串。
+- `length`：要提取的字符数量，必须是一个大于或等于零的整数。
+
+### 函数行为说明
+
+- 如果 `length` 等于 0，函数返回一个空字符串。
+- 如果 `length` 大于 `string` 的长度，函数返回 `string` 本身。
+- 如果 `length` 小于 0，函数返回 NULL。
+- 如果 `string` 为 NULL，函数返回 NULL。
+
+### 实际应用案例
+
+**案例 1：提取学生姓名的后两个字符**
+
+假设有一个名为 `student` 的表，其中包含学生的姓名（name）和性别（gender），如下所示：
+
+| id | name  | gender |
+|----|-------|--------|
+| 1  | Alice | F      |
+| 2  | Bob   | M      |
+| 3  | Cathy | F      |
+| 4  | David | M      |
+
+现在，我们想要查询每个学生姓名的后两个字符，可以使用以下 SQL 语句：
+
+```sql
+SELECT name, RIGHT(name, 2) AS suffix FROM student;
+```
+
+查询结果如下：
+
+| name  | suffix |
+|-------|--------|
+| Alice | ce     |
+| Bob   | ob     |
+| Cathy | hy     |
+| David | id     |
+
+**案例 2：提取文件名的扩展名**
+
+假设我们有一个包含文件名的字符串，现在需要提取其扩展名（即文件名中最后一个点号之后的部分）。例如，字符串 `"report.xls"` 的扩展名是 `"xls"`。
+
+```sql
+SELECT RIGHT('report.xls', 4) AS file_extension;
+```
+
+查询结果为：
+
+| file_extension |
+|----------------|
+| xls            |
+
+**案例 3：处理长度不足的情况**
+
+假设我们需要提取字符串末尾的若干字符，但字符串本身的长度可能小于要提取的字符数。例如，处理以下字符串：
+
+- `"这是一个示例文本"`（长度为 9）
+- `"示例"`（长度为 2）
+
+使用 RIGHT 函数提取最后 3 个字符：
+
+```sql
+SELECT RIGHT('这是一个示例文本', 3) AS last_three_chars;
+SELECT RIGHT('示例', 3) AS last_three_chars;
+```
+
+结果如下：
+
+| last_three_chars |
+|------------------|
+| 例文本           |
+| 示例             |
+
+

package/bin/skills/lakehouse-doc/references/rlike.md

@@ -0,0 +1,78 @@
+# 函数名称：RLIKE
+
+## 功能描述
+`RLIKE` 函数用于检查一个字符串是否符合指定的正则表达式模式。它既可以作为操作符使用，也可以作为函数调用，提供灵活的字符串匹配能力。
+
+## 语法
+- 作为操作符使用：
+  ```sql
+  str [NOT] RLIKE regex
+  ```
+- 作为函数使用：
+  ```sql
+  RLIKE(str, regex)
+  ```
+
+## 参数
+- `str`：要检查的字符串。
+- `regex`：用于匹配的正则表达式。
+
+## 返回值
+- 返回布尔值，如果字符串符合正则表达式模式，则返回 `TRUE`；否则返回 `FALSE`。
+- 如果使用 `[NOT] RLIKE` 作为操作符，返回值相反，即不符合模式时返回 `TRUE`。
+
+
+## 使用示例
+
+以下是 RLIKE 函数的使用示例：
+
+1. 匹配字符串开头：
+
+   ```sql
+   select rlike('aabb', r'^a');
+   -- 结果为true，因为字符串'aabb'的开头是'a'
+   ```
+
+2. 匹配字符串开头和结尾：
+
+   ```sql
+   select rlike('aabb', r'^a.*b$');
+   -- 结果为true，因为字符串'aabb'的开头是'a'，结尾是'b'
+   ```
+
+3. 使用通配符匹配任意字符：
+
+   ```sql
+   select rlike('footerbar', r'foo(.*?)(bar)');
+   -- 结果为true，因为正则表达式中的'.*?'可以匹配任意长度的任意字符
+   ```
+
+4. 匹配邮箱地址：
+
+   ```sql
+   select rlike('user@example.com', r'^[a-zA-Z0-9._%-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,4}$');
+   -- 结果为true，因为该正则表达式可以匹配大多数有效的电子邮箱地址
+   ```
+
+5. 匹配电话号码：
+
+   ```sql
+   select rlike('123-4567-8900', r'\d{3}-\d{4}-\d{4}');
+   -- 结果为true，因为该正则表达式可以匹配特定格式的电话号码
+   ```
+6. 使用 NOT RLIKE
+    ```sql
+    -- 使用作为函数
+    SELECT RLIKE('hello world', 'hello.*world') AS result;
+    -- 返回 TRUE
+    
+    -- 使用作为操作符
+    SELECT 'hello world' RLIKE r'hello.*world' AS result;
+    -- 返回 TRUE
+    
+    -- 使用 NOT 操作符
+    SELECT 'hello world' NOT RLIKE r'hello.*world' AS result;
+    -- 返回 FALSE
+    ```
+
+