@clickzetta/cz-cli-darwin-x64 0.3.1

package/bin/skills/lakehouse-doc/references/show-functions.md

@@ -0,0 +1,44 @@
+## 功能描述
+本命令用于展示当前工作空间（workspace）内所有可用的函数，包括内置函数和外部函数。通过该命令，用户可以快速了解并选择所需的函数进行数据查询和处理。
+
+## 语法格式
+```SQL
+SHOW FUNCTIONS [ LIKE 'pattern' ]
+```
+
+## 参数说明
+- **LIKE 'pattern'**：该参数用于根据函数名称进行过滤，只展示与指定模式匹配的函数。支持使用 SQL 通配符，包括百分号（%）表示任意数量的字符，下划线（_）表示任意单个字符。
+
+## 使用示例
+
+1. 查看所有函数：
+   ```SQL
+   SHOW FUNCTIONS;
+   ```
+
+2. 根据函数名称部分关键词过滤结果，例如查找包含 "ABS" 的所有函数：
+   ```SQL
+   SHOW FUNCTIONS LIKE '%ABS%';
+   ```
+
+3. 查找特定的函数，例如查找名为 "SQRT" 的函数：
+   ```SQL
+   SHOW FUNCTIONS LIKE 'SQRT';
+   ```
+
+4. 使用通配符查找以 "DATE" 开头的所有函数：
+   ```SQL
+   SHOW FUNCTIONS LIKE 'DATE%';
+   ```
+
+5. 组合使用通配符进行更精确的查找，例如查找包含 "DATE" 并且以 "DIFF" 结尾的函数：
+   ```SQL
+   SHOW FUNCTIONS LIKE 'DATE%DIFF';
+   ```
+
+## 注意事项
+- 当不指定 LIKE 子句时，将展示所有可用的函数。
+- 使用通配符时，请确保它们紧跟在 LIKE 关键字之后，且前面不要有空格。
+- 在使用 SQL 通配符时，请注意避免使用过多的通配符，以免影响查询性能。
+
+通过以上示例和说明，用户可以更加方便地查找和使用所需的函数，从而提高数据处理和分析的效率。

package/bin/skills/lakehouse-doc/references/show-grants-user.md

@@ -0,0 +1,41 @@
+## 功能
+
+此命令用于查询指定用户在当前数据库中拥有的权限，帮助用户了解其在数据库中的访问和操作权限。
+
+## 语法
+
+```SQL
+-- 查询指定用户拥有的权限
+SHOW GRANTS TO USER user_name;
+```
+
+**参数说明：**
+
+- `user_name`：需要查询权限的用户名称。该用户必须存在于当前数据库空间下。
+
+## 示例
+
+1. 查询当前登录用户的权限：
+
+   ```SQL
+   SHOW GRANTS TO USER user_name;
+   ```
+
+2. 查询指定用户 "john_doe" 拥有的权限：
+
+   ```SQL
+   SHOW GRANTS TO USER john_doe;
+   ```
+
+## 注意事项
+
+- 执行此命令的用户需要具备查询权限。
+- 在查询其他用户的权限时，请确保使用正确的用户名。
+- 请谨慎对待权限管理，避免泄露敏感信息或误操作。
+
+## 常见问题
+
+**Q: 如何查询当前登录用户？**
+
+A: 使用 `CURRENT_USER()` 函数代替 `user_name` 参数
+

package/bin/skills/lakehouse-doc/references/show-jobs.md

@@ -0,0 +1,48 @@
+## 功能描述
+
+本命令用于展示用户所拥有的作业信息，包括已完成和正在运行的作业。默认情况下，会显示最近7天内提交的任务记录，最多可查询10000条记录。用户可以根据需要查看指定计算资源下的作业信息。
+
+## 语法格式
+
+```SQL
+SHOW JOBS [IN VCLUSTER vc_name] [LIKE 'pattern' ]  [WHERE <expr>]  [LIMIT num];
+```
+
+## 参数说明
+
+- `IN VCLUSTER vc_name`：（可选）指定计算资源名称，用于筛选特定计算资源下的作业信息。
+- ` WHERE <expr>`:WHERE <expr>:(可选)支持用户根据`SHOW JOBS`命令显示的字段进行筛选。用户可以通过表达式对结果进行过滤，以便更精确地查找所需的数据。
+- `LIMIT num`：（可选）限制返回的作业记录数量，范围为1-10000。
+- LIKE 'pattern': （可选）使用通配符模式匹配job_id（支持`%`和`_`）
+
+## 使用示例
+
+1. 查看在test计算资源下大于2分钟的作业：
+
+```
+SHOW JOBS IN VCLUSTER test WHERE execution_time >interval 2 minute;
+```
+
+2. 查看计算资源“my_vc”下的所有作业记录：
+
+```
+SHOW JOBS IN VCLUSTER my_vc;
+```
+
+3. 限制返回的作业记录数量为100条：
+
+```
+SHOW JOBS LIMIT 100;
+```
+
+4. 查看计算资源“my_vc”下最近7天内提交的50条作业记录：
+
+```
+SHOW JOBS IN VCLUSTER my_vc LIMIT 50;
+```
+
+## 注意事项
+
+- 请确保在执行命令时，正确填写计算资源名称和限制数量。
+- 如果未指定计算资源名称，系统将默认展示所有计算资源下的作业信息。
+- 请根据实际需求合理设置查询时间范围和记录数量，以便快速获取所需信息。

package/bin/skills/lakehouse-doc/references/show-materialized-view.md

@@ -0,0 +1,42 @@
+## 功能介绍
+本命令用于查看指定数据库schema下的所有物化视图。物化视图是一种特殊的数据库对象，它可以预先计算并存储查询结果，以提高查询性能。此命令的功能与SQL语句`SHOW TABLES`相似，但更加灵活，允许用户根据条件进行筛选。
+
+有关更多详细信息，请参阅[物化视图](<MATERIALIZEDVIEW.md>)。
+
+## 语法格式
+```SQL
+SHOW TABLES [IN schema_name] [LIKE 'pattern' | WHERE expr]  [LIMIT num]
+```
+
+## 参数说明
+1. `LIKE pattern`：可选参数，用于按对象名称进行过滤。该过滤器使用不区分大小写的模式匹配，并支持SQL通配符`%`（表示任意数量的字符）和`_`（表示单个字符）。例如：`LIKE '%testing%'`。请注意，此参数不支持与`WHERE`条件同时使用。
+
+2. `IN schema_name`：可选参数，用于指定schema名称。通过此参数，用户可以查看指定schema下的所有物化视图。
+
+3. `WHERE expr`：可选参数，允许用户根据`SHOW TABLES`命令显示的字段进行筛选。此参数提供了更灵活的查询方式，可以根据实际需求进行筛选。
+
+## 使用示例
+
+**示例1：查看默认schema下的所有物化视图**
+```SQL
+SHOW TABLES WHERE is_materialized_view = true;
+```
+
+**示例2：查看指定schema下的所有物化视图**
+```SQL
+SHOW TABLES IN my_schema WHERE is_materialized_view = true;
+```
+
+**示例3：查看所有包含"test"字样的物化视图**
+```SQL
+SHOW TABLES LIKE '%test%' WHERE is_materialized_view = true;
+```
+
+**示例4：结合使用`IN`和`LIKE`参数**
+```SQL
+SHOW TABLES IN my_schema LIKE '%test%' WHERE is_materialized_view = true;
+```
+
+## 注意事项
+1. 在使用`LIKE`和`WHERE`参数时，请确保过滤条件正确无误，以免返回空结果。
+2. 请根据实际需求选择合适的参数进行查询，以提高查询效率。

package/bin/skills/lakehouse-doc/references/show-schemas.md

@@ -0,0 +1,41 @@
+## 功能概述
+
+`SHOW SCHEMAS` 语句旨在展示当前工作空间（WORKSPACE）中所有模式（SCHEMA）的列表。用户可以通过灵活的过滤条件，根据特定的模式或条件来查看相关的 SCHEMA。此外，使用 `EXTENDED` 关键字可以获取每个 SCHEMA 的更多详细信息，例如其类型（MANAGED 或 EXTERNAL）。
+
+## 语法结构
+
+```Plain
+SHOW SCHEMAS [EXTENDED] [LIKE 'pattern' | WHERE expr];
+```
+
+## 参数详解
+
+* `LIKE pattern`: 此参数支持通过模式匹配来筛选输出结果。匹配方式不区分大小写，并支持使用 SQL 通配符 `%`（表示任意数量的字符）和 `_`（表示任意单个字符）。例如，`LIKE '%report%'` 会筛选出所有包含 "report" 字符串的 SCHEMA 名称。需要注意的是，`LIKE` 子句与 `WHERE` 子句互斥，不能同时使用。
+* `EXTENDED`: 当使用此关键字时，命令将返回包含额外信息的附加列，例如显示 SCHEMA 类型的 `type` 列，
+* `WHERE expr`: 此参数允许用户根据 `SHOW SCHEMAS` 命令展示的字段进行更细致的筛选，以便查找符合特定条件的 SCHEMA。
+
+## 使用示例
+
+以下是 `SHOW SCHEMAS` 命令的几个使用示例：
+
+1. 查看当前工作空间下的所有 SCHEMA：
+
+   ```SQL
+   SHOW SCHEMAS;
+   ```
+
+2. 获取所有 MANAGED 类型的 SCHEMA 及其详细信息：
+
+   ```SQL
+   SHOW SCHEMAS EXTENDED WHERE type='managed';
+   ```
+
+3. 若需要查找特定的 SCHEMA 名称，可以使用 `WHERE` 子句通过 SCHEMA 名称进行筛选：
+
+   ```SQL
+   SHOW SCHEMAS WHERE SCHEMA_NAME='your_schema_name';
+   ```
+
+## 权限要求
+
+为了执行 `SHOW SCHEMAS` 命令，用户必须具备对应 SCHEMA 的读取元数据（READ METADATA）权限。

package/bin/skills/lakehouse-doc/references/show-shares.md

@@ -0,0 +1,94 @@
+# 查看分享列表
+
+## 功能
+
+查看分享列表用于查询当前实例下所有的分享对象（share对象），帮助用户了解当前服务实例与其他服务实例之间的数据共享情况。
+
+## 语法
+
+```SQL
+SHOW SHARES  [LIKE 'pattern' | WHERE expr] [LIMIT num]
+```
+
+## 参数说明
+
+1. `LIKE pattern`：此选项为可选参数，用于按对象名称进行过滤。支持不区分大小写的模式匹配，并可使用SQL通配符`%`（表示任意数量的字符）和`_`（表示单个字符）。示例：`LIKE '%testing%'`。需要注意的是，此过滤器不支持与`WHERE`条件同时使用。
+
+2. `WHERE expr`：此选项为可选参数，支持用户根据`SHOW SHARES`命令显示的字段进行筛选。如：provider、provider\_instance、provider\_workspace、scope、to\_instance、kind
+
+## 返回说明
+
+* **provider**：share提供者的租户名，表示分享数据的来源。
+* **provider\_instance**：share提供者的服务实例名，表示分享数据的服务实例。
+* **provider\_workspace**：share所属的工作空间，表示share对象所在的工作空间。
+* **scope**：share的分享范围，当前仅支持PRIVATE——指定instance分享。表示share对象仅在指定的服务实例之间共享。
+* **to\_instance**：该share对象指定被分享至的服务实例名称，多个服务实例名称之间用英文逗号(,)分隔。表示当前share对象被分享给了哪些服务实例。
+* **kind**：share的类型，OUTBOUND为当前服务实例分享出的数据，INBOUND为其他服务实例分享至当前服务服务实例的数据。表示当前share对象是分享数据的来源还是接收数据的目的地。
+
+## 使用示例
+
+1. 查询当前服务实例下的所有分享对象：
+
+   ```SQL
+   SHOW SHARES ;
+   ```
+
+   假设返回结果如下：
+
+   ```
+   share_name |provider| provider_instance | provider_workspace | scope | to_instance | kind 
+   -----------------------+-------------------+--------------------+-------+---------------+-----
+   sample_data |my_tenant | my_service_instance | my_workspace       | PRIVATE | other_instance | OUTBOUND
+   another_demo |another_tenant | another_service_instance | another_workspace  | PRIVATE | my_service_instance | INBOUND
+   ```
+
+   在这个例子中，我们可以看到当前服务实例有两个分享对象。第一个对象是当前服务实例分享给名为other\_instance的服务实例的，分享范围为PRIVATE。第二个对象是来自另一个服务实例的分享，当前服务实例作为接收方。
+
+2. 使用**Like**参数过滤特定名称的分享对象：
+
+   ```SQL
+   SHOW SHARES LIKE '%data';
+   ```
+
+   假设返回结果如下：
+
+   ```
+   share_name |provider| provider_instance | provider_workspace | scope | to_instance | kind 
+   -----------------------+-------------------+--------------------+-------+---------------+-----
+   sample_data |my_tenant | my_service_instance | my_workspace       | PRIVATE | other_instance | OUTBOUND
+
+   ```
+
+3. 使用**WHERE**参数过滤输出结果，查询当前服务实例**分享出**的分享对象：
+
+   ```SQL
+   SHOW SHARES WHERE kind = 'OUTBOUND';
+   ```
+
+   假设返回结果如下：
+
+   ```
+   share_name | provider | provider_instance | provider_workspace | scope | to_instance | kind 
+   -----------------------+-------------------+--------------------+-------+---------------+-----
+   sample_outbound_share |my_tenant | my_service_instance | my_workspace| PRIVATE | other_instance | OUTBOUND
+   ```
+
+   可以看到，当前服务实例分享给了名为other\_instance的服务实例一个名为sample\_outbount\_share 的分享对象。
+
+4. 使用**WHERE**参数过滤输出结果，查询当前服务实例**被分享**的分享对象：
+
+```SQL
+   SHOW SHARES WHERE kind = 'INBOUND';
+```
+
+      假设返回结果如下：
+
+```
+share_name | provider | provider_instance | provider_workspace | scope | to_instance | kind 
+-----------------------+-------------------+--------------------+-------+---------------+-----
+sample_inbound_share |other_tenant | other_instance | demo_workspace| PRIVATE | current_instance | INBOUND
+```
+
+可以看到，当前服务实例被分享了名为sample\_inbound\_share 的，来自于实例名称为other\_instance分享对象。
+
+通过以上示例，您可以更轻松地查看和管理当前服务实例下的所有分享对象。

package/bin/skills/lakehouse-doc/references/show-synonyms.md

@@ -0,0 +1,29 @@
+## 功能
+
+列出schema下的同义词
+
+## 语法
+
+```SQL
+SHOW SYNONYMS [IN SCHEMA scname ] [LIKE 'pattern' | WHERE expr]  [LIMIT num]
+```
+
+1. `IN schema_name`：可选参数，用于指定 schema 名称。通过此参数，用户可以查看指定 schema 下的所有同义词。
+
+2. `WHERE expr`：可选参数，允许用户根据 `SHOW SYNONYMS` 命令显示的字段进行筛选。此参数提供了更灵活的查询方式。
+
+## 案例
+
+1. 根据同义词名称过滤
+
+```SQL
+SHOW SYNONYMS WHERE     synonym_name = 'students_sy';
+```
+
+2. 查看指定 schema 下的同义词
+
+```SQL
+  SHOW SYNONYMS IN public;
+```
+
+

package/bin/skills/lakehouse-doc/references/show-table-streams.md

@@ -0,0 +1,53 @@
+## 功能
+
+本命令用于查看当前数据库 schema 下所有的表流（Table Streams）信息。表流是一种实时数据流，可以让您对表中的数据进行实时分析和处理。
+
+## 语法
+
+```SQL
+SHOW TABLE STREAMS [IN schema_name] [LIKE 'pattern' | WHERE expr] [LIMIT num]
+```
+
+## 参数说明
+1. `LIKE pattern`：此选项为可选参数，用于按对象名称进行过滤。支持不区分大小写的模式匹配，并可使用SQL通配符`%`（表示任意数量的字符）和`_`（表示单个字符）。示例：`LIKE '%testing%'`。需要注意的是，此过滤器不支持与 `WHERE` 条件同时使用。
+
+2. `IN schema_name`：此选项为可选参数，允许用户指定特定的schema名称，从而列举出该schema下的所有数据库对象。
+
+3. `WHERE expr`：此选项为可选参数，支持用户根据 `SHOW TABLES` 命令显示的字段进行筛选。
+
+
+## 示例
+
+1. 查看当前 schema 下所有的表流：
+
+   ```
+   SHOW TABLE STREAMS;
+   ```
+
+   结果：
+
+   ```
+   +-------------------------+-------------+--------------+------------+-------------+---------+
+   |       create_time       | schema_name |     name     | table_name |    mode     | comment |
+   +-------------------------+-------------+--------------+------------+-------------+---------+
+   | 2023-11-24 21:44:07.261 | public      | event_stream | event      | APPEND_ONLY |         |
+   +-------------------------+-------------+--------------+------------+-------------+---------+
+   ```
+
+2. 查看指定 schema 下所有的表流：
+
+   ```
+   SHOW TABLE STREAMS IN my_schema;
+   ```
+
+3. 查看当前 schema 下名称中包含 "test" 的表流：
+
+   ```
+   SHOW TABLE STREAMS LIKE '%test%';
+   ```
+
+4. 结合 WHERE 子句查看满足特定条件的表流：
+
+   ```
+   SHOW TABLE STREAMS WHERE mode = 'APPEND_ONLY';
+   ```

package/bin/skills/lakehouse-doc/references/show-tables-history.md

@@ -0,0 +1,91 @@
+## 功能描述
+
+`SHOW TABLES HISTORY` 命令用于查看表的历史记录，包括已删除表的删除时间。对于未删除的表，删除时间将显示为 null。此功能特别适用于通过 UNDROP 恢复误删的表。
+
+## 语法格式
+
+```
+SHOW TABLES HISTORY [IN schema_name] [LIKE 'pattern' ] [WHERE <expression>]
+```
+
+## 参数说明
+
+* `LIKE pattern`: 可选参数，用于按照对象名称进行过滤。支持不区分大小写的模式匹配，可以使用 SQL 通配符 `%` 和 `_`。注意，此参数不支持与 WHERE 子句同时使用。
+* `IN schema_name`: 可选参数，用于指定 schema 名称，从而列举指定 schema 下的表历史记录。
+* `WHERE <expression>`（可选，与LIKE二选一）：支持根据命令显示的字段进行筛选，可以使用表达式对结果进行复杂过滤
+
+## 使用示例
+
+**示例 1：查看表历史记录**
+
+```SQL
+SHOW TABLES HISTORY;
++-------------+------------------------------------------+-------------------------+-------------+----------+------------+---------+----------------+-------------------------+
+| schema_name |                table_name                |       create_time       |   creator   |   rows   |   bytes    | comment | retention_time |       delete_time       |
++-------------+------------------------------------------+-------------------------+-------------+----------+------------+---------+----------------+-------------------------+
+| public      | mv                                       | 2024-12-13 09:34:26.683 | UAT_TEST    | 4        | 2467       |         | 1              |                         |
+| public      | mv_base_a                                | 2024-12-13 09:34:05.076 | UAT_TEST    | 4        | 1970       |         | 1              |                         |
+| public      | mv_base_a                                | 2023-09-22 03:41:28.011 | UAT_TEST    | 5        | 1406       |         | 1              | 2024-12-13 09:34:04.946 |
++-------------+------------------------------------------+-------------------------+-------------+----------+------------+---------+----------------+-------------------------+
+```
+
+执行该命令将列出当前数据库中所有表的历史记录。
+
+**示例 2：按照 schema 查看表历史记录**
+
+```SQL
+SHOW TABLES HISTORY IN my_schema;
+```
+
+该命令将只显示 `my_schema` schema 下的表历史记录。
+
+**示例 3：过滤特定模式的表历史记录**
+
+```SQL
+SHOW TABLES HISTORY LIKE '%test%';
+```
+
+此命令将列出名称中包含 "test" 的表历史记录。
+
+**示例 4：恢复误删的表**
+
+```SQL
+-- 创建表并插入数据
+CREATE TABLE mytable (id INT, name STRING);
+INSERT INTO mytable VALUES (1, 'aaa');
+
+-- 删除表
+DROP TABLE mytable;
+
+-- 查看表删除记录
+SHOW TABLES HISTORY;
+
+-- 恢复表
+UNDROP TABLE mytable;
+```
+
+**示例 5：删除表后创建同名的表并尝试恢复**
+
+```SQL
+-- 创建表并插入数据
+CREATE TABLE mytable (id INT, name STRING);
+INSERT INTO mytable VALUES (1, 'aaa');
+
+-- 删除表
+DROP TABLE mytable;
+
+-- 查看表删除记录
+SHOW TABLES HISTORY;
+
+-- 重复建表
+CREATE TABLE mytable (col1 INT, col12 STRING);
+
+-- 查看表删除记录，未删除的表 delete_time 是 null
+SHOW TABLES HISTORY;
+
+-- 重命名未删除的表
+ALTER TABLE mytable RENAME TO mytable_back;
+
+-- 恢复表
+UNDROP TABLE mytable;
+```

package/bin/skills/lakehouse-doc/references/show-tables.md

@@ -0,0 +1,50 @@
+## 功能描述
+本命令用于查询当前数据库 schema 下的所有表。执行后，将列出所有非视图（view）和非物化视图（materialized view）的表。
+
+## 语法结构
+```SQL
+SHOW TABLES [IN schema_name] [LIKE 'pattern' | WHERE expr]
+```
+
+## 参数详解
+
+1. `IN schema_name`：（可选）指定要查询的 schema 名称。如果未指定，则默认查询当前用户的默认 schema 下的表。
+2. `LIKE 'pattern'`：（可选）使用通配符进行模式匹配，只返回匹配指定模式的表名。支持的通配符包括 `%`（匹配任意字符序列）和 `_`（匹配任意单个字符）。注意：`LIKE` 子句不支持与 `WHERE` 子句同时使用。
+3. `WHERE expr`：（可选）根据 `SHOW TABLES` 命令显示的字段进行筛选。可以使用字段名和相应的条件表达式进行筛选。
+
+## 使用示例
+
+1.  查询当前 schema 下的所有表：
+    ```SQL
+   SHOW TABLES;
+   ```
+
+2.  查询指定 schema 下的所有表：
+    ```SQL
+   SHOW TABLES IN my_schema;
+   ```
+
+3.  查询当前 schema 下名称中包含 "test" 的表：
+    ```SQL
+   SHOW TABLES LIKE '%test%';
+   ```
+
+4.  查询当前 schema 下的所有非视图表：
+    ```SQL
+   SHOW TABLES WHERE is_view = false;
+   ```
+
+5.  查询当前 schema 下的所有非物化视图表：
+    ```SQL
+   SHOW TABLES WHERE is_materialized_view = false;
+   ```
+
+6.  查询当前 schema 下既不是视图也不是物化视图的表：
+    ```SQL
+   SHOW TABLES WHERE is_view = false AND is_materialized_view = false AND ;
+   ```
+
+## 注意事项
+- 当同时使用 `LIKE` 和 `WHERE` 子句时，请确保它们之间的逻辑关系正确。
+- 在使用 `LIKE` 子句时，请注意 SQL 通配符的使用规则。
+- 在查询指定 schema 时，请确保该 schema 名称的正确性。

package/bin/skills/lakehouse-doc/references/show-users.md

@@ -0,0 +1,46 @@
+## 功能
+
+`SHOW USERS` 命令用于查询当前数据库空间下的所有用户信息。通过该命令，用户可以快速了解当前空间中的用户列表，便于进行用户管理和权限控制。
+
+## 语法
+
+```SQL
+SHOW USERS [LIKE pattern];
+```
+
+**参数说明**
+
+- `LIKE pattern`（可选）: 通过对象名称过滤命令输出。该过滤器使用不区分大小写的模式匹配，支持 SQL 通配符（`%` 和 `_`）。例如，`LIKE '%test%'` 将只显示包含 "test" 文本的用户名称。
+
+## 使用示例
+
+### 示例 1: 查询当前空间下的所有用户
+
+```SQL
+SHOW USERS;
+```
+
+执行该命令后，将列出当前空间下的所有用户信息。
+
+### 示例 2: 根据用户名关键字查询用户
+
+```SQL
+SHOW USERS LIKE '%admin%';
+```
+
+执行该命令后，将列出当前空间下用户名中包含 "admin" 的所有用户信息。
+
+### 示例 3: 查询当前空间下特定前缀的用户
+
+```SQL
+SHOW USERS LIKE 'user_%';
+```
+
+执行该命令后，将列出当前空间下用户名以 "user_" 为前缀的所有用户信息。
+
+## 注意事项
+
+- 使用 `LIKE` 子句时，请注意避免使用过多的通配符，以免影响查询性能。
+- 请确保在执行命令时，当前用户具有足够的权限来查询其他用户信息。
+
+通过以上示例和说明，您应该能够熟练地使用 `SHOW USERS` 命令来查询和管理当前空间下的用户信息。如有疑问，请随时联系我们的技术支持团队。

package/bin/skills/lakehouse-doc/references/show-vclusters.md

@@ -0,0 +1,59 @@
+## 功能
+
+本命令用于查询当前工作空间下所有计算集群的详细信息。
+
+## 语法
+
+```SQL
+SHOW VCLUSTERS [LIKE PATTERN | WHERE expr] [LIMIT num]
+```
+
+## 参数说明
+
+1. `LIKE PATTERN`（可选）：通过对象名称进行过滤。可以使用 SQL 通配符 `%` 和 `_`。例如，`LIKE '%testing%'`。注意，`LIKE` 子句不能与 `WHERE` 子句同时使用。
+
+2. `WHERE expr`（可选）：根据特定属性对计算集群进行条件过滤，支持以下属性：
+
+- `vcluster_size`：计算集群规格代码，如 `XSMALL`、`SMALL` 等，使用大写字母。
+- `vcluster_type`：计算集群类型，如 `ANALYTICS`、`GENERAL`，使用大写字母。
+- `max_concurrency`：根据并发数进行过滤，输入数字。
+- `state`：计算集群状态，如 `RESUMING`、`SUSPENDED` 等，使用大写字母。
+- `creator`：创建计算集群的用户名称，使用小写字母。
+- `create_time`：创建时间，格式为 `"yyyy-MM-dd HH:mm:ss"`，以字符串方式存储，支持比较运算符。
+- `min_replicas`：计算实例的最小数量，输入数字。
+- `max_replicas`：计算实例的最大数量，输入数字。
+- `preload_table`：缓存中的表名称列表，以字符串方式存储，可以使用 `LIKE` 子句匹配特定表名。
+- `current_replicas`：计算集群当前的计算实例数量，输入数字。
+- `auto_suspend_in_second`：计算集群自动暂停的秒数，输入数字。
+
+## 使用示例
+
+1. 查询当前工作空间下的所有计算集群：
+
+   ```SQL
+   SHOW VCLUSTERS;
+   ```
+
+2. 查询当前工作空间下，名称前两个字母为“CZ”的计算集群：
+
+   ```SQL
+   SHOW VCLUSTERS LIKE 'CZ%';
+   ```
+
+3. 使用 WHERE 子句过滤计算集群结果列表：
+
+   ```SQL
+   SHOW VCLUSTERS WHERE vcluster_type = 'GENERAL';
+   SHOW VCLUSTERS WHERE vcluster_size = 'SMALL';
+   SHOW VCLUSTERS WHERE max_concurrency = 8;
+   SHOW VCLUSTERS WHERE state = 'SUSPENDED';
+   SHOW VCLUSTERS WHERE createor = 'demo_project';
+   SHOW VCLUSTERS WHERE create_time > '2024-01-25';
+   SHOW VCLUSTERS WHERE min_replicas = 1;
+   SHOW VCLUSTERS WHERE max_replicas = 2;
+   SHOW VCLUSTERS WHERE preload_tables LIKE '%sample_schema.sample_table%';
+   SHOW VCLUSTERS WHERE current_replicas = 3;
+   SHOW VCLUSTERS WHERE auto_suspend_in_second = 600;
+   ```
+
+通过以上示例，您可以根据需要灵活地查询和过滤计算集群信息。请确保在使用 `WHERE` 子句时，正确使用大小写和运算符，以获得准确的查询结果。

package/bin/skills/lakehouse-doc/references/show-views.md

@@ -0,0 +1,31 @@
+## 功能
+
+本语句用于查看指定 schema 下所有的视图（view）。与 `SHOW TABLES` 语句相似，但通过 WHERE 条件限定，只展示视图。这有助于用户快速了解特定 schema 中的视图结构和信息。
+
+## 语法
+
+```SQL
+SHOW TABLES [IN schema_name] [LIKE 'pattern' | WHERE expr]  [LIMIT num]
+```
+
+## 参数说明
+
+1. `LIKE pattern`（可选）：按对象名称进行过滤，使用不区分大小写的模式匹配。支持 SQL 通配符 `%`（表示任意字符出现 0 次或多次）和 `_`（表示任意单个字符）。例如：`LIKE '%testing%'`。注意，`LIKE` 子句不能与 `WHERE` 子句同时使用。
+
+2. `IN schema_name`（可选）：指定 schema 名称，用于列举指定 schema 下的视图。如果未指定 schema_name，则展示当前用户的默认 schema 中的视图。
+
+3. `WHERE expr`（可选）：根据 `SHOW TABLES` 语句显示的字段进行筛选。用户可以根据实际需求，使用字段名和相应的条件进行筛选。`LIKE` 和 `WHERE` 不能同时使用。
+
+## 使用示例
+
+1. 查看当前 schema 下所有的视图：
+
+   ```SQL
+   SHOW TABLES WHERE is_view=true;
+   ```
+
+2. 查看指定 schema（例如：`my_schema`）下所有的视图：
+
+   ```SQL
+   SHOW TABLES IN my_schema WHERE is_view=true;
+   ```