@clickzetta/cz-cli-darwin-arm64 0.3.76 → 0.3.80

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

@@ -1,25 +0,0 @@
-# AI 函数
-
-## 概述
-
-在云器 Lakehouse 中，AI 函数的实现**依托于**外部函数（External Function）的框架。外部函数（亦称远程函数，Remote Function）是一种特殊的自定义函数（UDF），它允许用户通过 Python 或 Java 语言定义函数逻辑，但其核心计算任务会被\*\*卸载（offload）\*\*到外部的远程服务执行（支持的远程服务包括：阿里云的函数计算 FC、腾讯云的云函数 SCF）。在执行过程中可调用：
-
-* **在线服务**：以 API 形式对外提供的在线服务，如 AI 在线模型服务（例如大语言模型 API、云平台提供的在线 AI API 服务）。
-* **离线服务**：将特定功能函数代码、依赖库、模型和数据等文件打包成的离线服务包，如从 Hugging Face 下载的图像识别模型等。
-
-云器 Lakehouse 通过创建 API 连接（API CONNECTION），在元数据中保存外部函数计算服务的连接和访问信息。外部函数通过 HTTP 协议调用外部函数计算服务，实现数据处理并返回结果。
-![](.topwrite/assets/a7546df1-be39-41e9-9c80-e0e90ce3d353.svg)
-Lakehouse 平台在获得用户预先授权后，于创建外部函数时，将自动在客户账号下的函数计算服务中部署该函数。当用户在 SQL 查询中使用外部函数时，由外部函数实现与外部计算服务的安全连接、数据处理并返回查询结果。
-
-## 外部函数创建主要流程
-
-请参考：[使用流程: External Function](RemoteFunctionBestPractice.md)
-
-## 使用外部函数开发 AI 函数
-
-请参考以下开发指南：
-
-* [External Function(Python3)](RemoteFunctionDevGuidePython3.md)
-* [External Function(Java)](ExternalFunctionDevGuideJava.md)
-
-^

package/bin/skills/lakehouse-doc/references/ALTER-EXTERNAL-TABLE.md

@@ -1,78 +0,0 @@
-# 修改表属性
-
-## 1. 重命名表
-
-功能：通过 ALTER TABLE 命令，您可以将现有的表重命名为新的表名。
-
-语法：
-
-```SQL
-ALTER  TABLE name RENAME TO new_table_name;
-```
-
-示例：
-
-```SQL
-ALTER TABLE old_table_name RENAME TO new_table_name;
-```
-
-## 2. 修改表注释
-
-功能：通过 ALTER TABLE 命令，您可以为外部表添加或修改注释。
-
-语法：
-
-```SQL
-ALTER TABLE tbname SET COMMENT '';
-```
-
-示例：
-
-```SQL
-ALTER TABLE new_pepole_delta SET COMMENT 'new_pepole_delta';
-```
-
-执行上述命令后，您可以使用DESC EXTENDED命令查看表的详细信息，包括注释：
-
-```SQL
-DESC EXTENDED new_pepole_delta;
-+------------------------------+--------------------------------------------------------+---------+
-|         column_name          |                       data_type                        | comment |
-+------------------------------+--------------------------------------------------------+---------+
-| id                           | int                                                    |         |
-| name                         | string                                                 |         |
-| dt                           | string                                                 |         |
-| # Partition Information      |                                                        |         |
-| # col_name                   | data_type                                              | comment |
-| dt                           | string                                                 |         |
-|                              |                                                        |         |
-| # detailed table information |                                                        |         |
-| schema                       | public                                                 |         |
-| name                         | new_pepole_delta                                       |         |
-| creator                      | UAT_TEST                                               |         |
-| created_time                 | 2024-05-24 14:04:17.517                                |         |
-| last_modified_time           | 2024-12-30 11:47:32.806                                |         |
-| comment                      | new_pepole_delta                                       |         |
-| properties                   | ()                                                     |         |
-| external                     | true                                                   |         |
-| type                         | TABLE                                                  |         |
-| clustered_keys               | RANGE (__dt)                                           |         |
-| bucket_count                 | 0                                                      |         |
-| format                       | delta                                                  |         |
-| location                     | "oss://function-compute-my1/delta-format/uploaddelta/" |         |
-| connection                   | ql_ws.oss_delta                                        |         |
-| statistics                   | NULL rows NULL bytes                                   |         |
-+------------------------------+--------------------------------------------------------+---------+
-```
-
-## 3. 修改表的属性
-
-功能：通过 ALTER TABLE 命令，您可以为外部表设置或修改属性。目前为保留参数。
-
-语法：
-
-```
-ALTER TABLE table_name SET PROPERTIES("key"="value");
-```
-
-^

package/bin/skills/lakehouse-doc/references/ALTER-SCHEMA.md

@@ -1,85 +0,0 @@
-## 功能描述
-
-`ALTER SCHEMA` 语句用于调整指定 schema 的名称、属性和注释。通过该语句，用户可以更新 schema 的注释（comment）和属性（properties），以适应数据处理需求和组织结构的变化。
-
-## 修改 Schema 的名称
-
-语法：
-
-```SQL
-ALTER SCHEMA schema_name RENAME TO new_name;
-```
-
-## 修改 Schema 注释
-
-要修改 schema 的注释，可使用以下语法：
-
-```SQL
-ALTER SCHEMA schema_name SET COMMENT  'new_comment';
-```
-
-### 示例
-
-1. 修改 `rc4_l` schema 的注释为 `rc7`：
-
-   ```SQL
-   ALTER SCHEMA rc4_l SET COMMENT 'rc7';
-   ```
-
-   执行该语句后，使用 `DESC` 命令验证注释是否修改成功：
-
-   ```SQL
-   DESC SCHEMA rc4_l;
-   ```
-
-   预期输出结果：
-
-   ```
-   +--------------------+-------------------------+
-   |     info_name      |       info_value        |
-   +--------------------+-------------------------+
-   | name               | rc4_l                   |
-   | creator            | UAT_TEST                |
-   | created_time       | 2023-12-15 20:38:14.126 |
-   | last_modified_time | 2023-12-20 14:54:59.826 |
-   | comment            | rc7                     |
-   +--------------------+-------------------------+
-   ```
-
-## 修改 Schema 属性
-
-除了修改注释，还可以为 schema 设置或更新属性。使用以下语法：
-
-```SQL
-ALTER SCHEMA schema_name SET PROPERTIES (key1 = 'value1', key2 = 'value2', ...);
-```
-
-### 示例
-
-1. 为 `rc4_l` schema 设置属性 `custom_property` 为 `true`：
-
-   ```SQL
-   ALTER SCHEMA rc4_l SET PROPERTIES (custom_property = 'true');
-   ```
-
-   查看 schema 属性是否设置成功：
-
-   ```SQL
-   DESC SCHEMA rc4_l;
-   ```
-
-   预期输出结果中的 properties 部分应包含新设置的属性：
-
-   ```
-   +--------------------+-------------------------+
-   |     info_name      |       info_value        |
-   +--------------------+-------------------------+
-   | ...                 | ...                      |
-   | properties          | {custom_property='true'} |
-   +--------------------+-------------------------+
-   ```
-
-## 权限要求
-
-执行 `ALTER SCHEMA` 语句的用户必须拥有对应 schema 的 ALTER 权限。如果没有相应权限，操作将被拒绝。
-

package/bin/skills/lakehouse-doc/references/ALTER-TABLE-COLUMN.md

@@ -1,223 +0,0 @@
-# 功能描述
-
-本功能允许用户通过 ALTER 语句对表中的列进行修改，包括添加列、修改列、删除列以及重命名列。同时支持复杂类型的变化，如 struct、array 和 map 等。
-
-# 添加字段
-
-## 语法
-
-```sql
--- 添加列
-ALTER TABLE table_name ADD COLUMN
-      column1_name_identifier data_type [COMMENT comment]
-      [FIRST | AFTER column1_name_identifier | BEFORE column1_name_identifier ]  ,....
-
-column_name_identifier :==
-    -- 普通字段
-    column_name
-    -- 复杂类型struct表示方法
-    -- struct类型struct,<x: double, y: double>
-    column_name.struct_column_name  
-    -- array类型嵌套struct表示方法
-    -- 添加字段,array<struct<x: double, y: double>>
-    column_name.ELEMENT.struct_column_name
-    --map类型嵌套struct表示方法
-    --map key 添加字段
-    column_name.KEY.struct_column_name 
-    --map value添加字段
-    column_name.VALUE.struct_column_name    
-```
-
-## 参数说明
-
-* **column_name_identifier**：字段标识符，用于指定添加、删除或重命名的字段名。
-* **FIRST | AFTER column_name_identifier**：指定字段添加的位置，可以添加到字段之前或之后。
-
-## 使用示例
-
-1. 添加普通字段：
-
-   ```sql
-   ALTER TABLE my_table ADD COLUMN new_column INT;
-   ```
-
-2. 添加复杂类型字段：
-
-   ```sql
-   CREATE TABLE my_complex_table (
-       point STRUCT<x: INT, y: DOUBLE>,
-       points ARRAY<STRUCT<x: DOUBLE, y: DOUBLE>>,
-       points_map MAP<STRUCT<x: INT>, STRUCT<a: INT>>
-   );
-
-   -- 在struct中添加字段
-   ALTER TABLE my_complex_table ADD COLUMN point.z DOUBLE;
-
-   --map value中struct添加字段
-   ALTER TABLE my_complex_table ADD COLUMN points_map.value.b INT;
-
-   --map key中struct添加字段
-   ALTER TABLE my_complex_table ADD COLUMN points_map.key.y INT;
-
-   --array中struct添加字段
-   ALTER TABLE my_complex_table ADD COLUMN points.element.z DOUBLE;
-   --添加多个字段同时指定位置
-    CREATE TABLE test (a string);
-    ALTER TABLE test  ADD COLUMN b string, c string, CHANGE COLUMN a AFTER c;
-
-   ```
-
-# 删除字段
-
-## 语法
-
-```sql
-ALTER TABLE table_name DROP COLUMN column_name_identifier [, column_name_identifier ... ]
-```
-
-## 使用示例
-
-1. 删除普通字段：
-
-   ```sql
-   ALTER TABLE my_table DROP COLUMN old_column;
-   ```
-
-2. 删除复杂类型字段：
-
-   ```sql
-   ALTER TABLE my_complex_table DROP COLUMN point.z;
-   ALTER TABLE my_complex_table DROP COLUMN points.element.y;
-   ALTER TABLE my_complex_table DROP COLUMN points_map.key.x;
-   ```
-
-# 重命名字段
-
-## 语法
-
-```sql
-ALTER TABLE table_name RENAME COLUMN column_name_identifier TO new_column_name_identifier;
-```
-
-## 使用示例
-
-1. 重命名普通字段：
-
-   ```sql
-   ALTER TABLE my_table RENAME COLUMN old_name TO new_name;
-   ```
-
-2. 重命名复杂类型字段：
-
-   ```sql
-   ALTER TABLE my_complex_table RENAME COLUMN point.x TO xx;
-   ALTER TABLE my_complex_table RENAME COLUMN points.element.x TO xx;
-   ALTER TABLE my_complex_table RENAME COLUMN points_map.key.x TO xx;
-   ```
-
-# 修改字段
-
-## 语法
-
-```sql
--- 修改字段位置
-ALTER TABLE table_name CHANGE COLUMN column_name_identifier { FIRST | AFTER column_identifier }
-
--- 修改字段类型
-ALTER TABLE table_name CHANGE COLUMN column_name_identifier TYPE data_type
-
--- 修改字段注释
-ALTER TABLE table_name CHANGE COLUMN column_name_identifier COMMENT 'comment'
-```
-
-DECIMAL 类型转换**只支持精度（整数位）和小数位同时增大**的场景。
-
-**DECIMAL 类型的两个参数**
-
-```
-DECIMAL(P, S)  ├─ P（Precision）：总位数（整数位 + 小数位）  └─ S（Scale）：小数位数
-```
-
-例如：`DECIMAL(10, 2)` 表示
-
-* 总共 10 位数字
-* 其中 2 位是小数位
-
-**场景 1：两个参数都增大**
-
-```sql
--- 源表定义
-CREATE TABLE test_alter(a DECIMAL(10,2));
--- ✅ 正确：整数位和小数位都增大
-ALTER TABLE test_alter CHANGE COLUMN a TYPE DECIMAL(12,2);
--- 说明：从 10 位增加到 12 位，小数位不变
-ALTER TABLE test_alter CHANGE COLUMN a TYPE DECIMAL(13,3);
--- 说明：从 10 位增加到 13 位，小数位从 2 增加到 3
-```
-
-**场景 2：只增大整数位，小数位不变**
-
-```sql
-ALTER TABLE test_alter CHANGE COLUMN a TYPE DECIMAL(15,2);
--- 从 DECIMAL(10,2) 转为 DECIMAL(15,2)
--- 整数位：从 8 位（10-2）增加到 13 位（15-2）
-```
-
-**场景 3：同时增大整数位和小数位**
-
-```sql
-ALTER TABLE test_alter CHANGE COLUMN a TYPE DECIMAL(20,5);
--- 从 DECIMAL(10,2) 转为 DECIMAL(20,5)
--- 整数位增大，小数位也增大
--- 这是最安全的转换方式
-```
-
-❌ 错误的类型转换
-
-**错误 1：整数位不变，只增大小数位**
-
-```sql
--- ❌ 错误
-ALTER TABLE test_alter CHANGE COLUMN a TYPE DECIMAL(10,3);
--- 原因：总位数不变，只是改变了小数位比例
--- 结果：系统会报错或数据可能丢失
-```
-
-**错误 2：减少任一参数**
-
-```sql
--- ❌ 错误：减少总位数
-ALTER TABLE test_alter CHANGE COLUMN a TYPE DECIMAL(8,2);
--- ❌ 错误：减少小数位
-ALTER TABLE test_alter CHANGE COLUMN a TYPE DECIMAL(12,1);
--- ❌ 错误：两个都减少
-ALTER TABLE test_alter CHANGE COLUMN a TYPE DECIMAL(8,1);
-```
-
-**错误 3：只增大小数位**
-
-```sql
--- ❌ 错误
-ALTER TABLE test_alter CHANGE COLUMN a TYPE DECIMAL(10,3);
--- 问题：总位数从 10 不变为 10，但小数位从 2 增加到 3
--- 结果：整数位从 8 减少到 7，可能导致数据溢出或精度丢失
-```
-
-## 当前支持的类型转换
-
-|          |          |     |        |       |        |                                                    |      |         |        |        |
-| -------- | -------- | --- | ------ | ----- | ------ | -------------------------------------------------- | ---- | ------- | ------ | ------ |
-| from \\ to | smallint | int | bigint | float | double | decimal                                            | date | varchar | char   | string |
-| tinyint  | ☑️       | ☑️  | ☑️     |       |        |                                                    |      |         |        |        |
-| smallint | ☑️       | ☑️  | ☑️     |       |        |                                                    |      |         |        |        |
-| int      |          | ☑️  | ☑️     |       |        |                                                    |      |         |        |        |
-| bigint   |          |     | ☑️     |       |        |                                                    |      |         |        |        |
-| float    |          |     |        | ☑️    | ☑️     |                                                    |      |         |        |        |
-| double   |          |     |        |       | ☑️     |                                                    |      |         |        |        |
-| decimal  |          |     |        |       |        | DECIMAL 类型转换满足以下条件时支持：P' ≥ P 且 (P' - S') ≥ (P - S) |      |         |        |        |
-| Date     |          |     |        |       |        |                                                    | ☑️   |         |        |        |
-| Varchar  |          |     |        |       |        |                                                    |      | 允许变得更长 |        | ☑️     |
-| Char     |          |     |        |       |        |                                                    |      |         | 允许变得更长 | ☑️     |
-| String   |          |     |        |       |        |                                                    |      |         |        |        |
-
-^

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

@@ -1,92 +0,0 @@
-# 修改表属性
-
-## 1. 重命名表
-
-功能：通过 ALTER TABLE 命令，您可以将现有的表重命名为新的表名。
-
-语法：
-
-```SQL
-ALTER  TABLE name RENAME TO new_table_name;
-```
-
-示例：
-
-```SQL
-ALTER TABLE old_table_name RENAME TO new_table_name;
-```
-
-## 2. 修改表注释
-
-功能：通过 ALTER TABLE 命令，您可以为外部表添加或修改注释。
-
-语法：
-
-```SQL
-ALTER TABLE tbname SET COMMENT '';
-```
-
-示例：
-
-```SQL
-ALTER TABLE new_pepole_delta SET COMMENT 'new_pepole_delta';
-```
-
-执行上述命令后，您可以使用DESC EXTENDED命令查看表的详细信息，包括注释：
-
-```SQL
-DESC EXTENDED new_pepole_delta;
-+------------------------------+--------------------------------------------------------+---------+
-|         column_name          |                       data_type                        | comment |
-+------------------------------+--------------------------------------------------------+---------+
-| id                           | int                                                    |         |
-| name                         | string                                                 |         |
-| dt                           | string                                                 |         |
-| # Partition Information      |                                                        |         |
-| # col_name                   | data_type                                              | comment |
-| dt                           | string                                                 |         |
-|                              |                                                        |         |
-| # detailed table information |                                                        |         |
-| schema                       | public                                                 |         |
-| name                         | new_pepole_delta                                       |         |
-| creator                      | UAT_TEST                                               |         |
-| created_time                 | 2024-05-24 14:04:17.517                                |         |
-| last_modified_time           | 2024-12-30 11:47:32.806                                |         |
-| comment                      | new_pepole_delta                                       |         |
-| properties                   | ()                                                     |         |
-| external                     | true                                                   |         |
-| type                         | TABLE                                                  |         |
-| clustered_keys               | RANGE (__dt)                                           |         |
-| bucket_count                 | 0                                                      |         |
-| format                       | delta                                                  |         |
-| location                     | "oss://function-compute-my1/delta-format/uploaddelta/" |         |
-| connection                   | ql_ws.oss_delta                                        |         |
-| statistics                   | NULL rows NULL bytes                                   |         |
-+------------------------------+--------------------------------------------------------+---------+
-```
-
-## 3. 修改表的属性
-
-功能：通过 ALTER TABLE 命令，您可以为外部表设置或修改属性。目前为保留参数。
-
-语法：
-
-```
-ALTER TABLE table_name SET PROPERTIES("key"="value");
-```
-
-
-**表支持的参数**
-
-以下表格列出了系统属性及其描述和取值范围：
-
-| 参数名称                  | 描述                                                                                            | 取值范围                                                                      |
-| --------------------- | --------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------- |
-| data\_lifecycle       | 数据生命周期                                                                                        | 大于0的正整数值，取值为-1代表未开启生命周期                                                   |
-| data\_retention\_days | 设置 Time Travel 保留期限，Time Travel 保留期限决定了您可以访问多久以前的数据，包括使用 UNDROP、TABLE STREAM、RESTORE 访问历史数据和恢复历史数据 | 您可以为每个表设置不同的数据保留周期，以满足不同的业务需求。num 的设置范围为 0-90，Lakehouse 将单独对 Time Travel 收取存储费用 |
-
-要查看 Table 属性，请使用以下语法：
-
-```sql
-SHOW PROPERTIES IN TABLE tbname
-```

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

@@ -1,99 +0,0 @@
-# ARRAY
-`ARRAY`是一种数据类型，用于表示由同一种类型的元素序列构成的值。这种数据类型可以存储一系列具有相同数据类型的元素，方便进行统一管理和操作。
-
-## 语法
-
-```sql
-ARRAY <elementType>
-```
-- `elementType`：指定数组中元素的数据类型。
-
-## ARRAY常量格式
-```
-select [1,3,4];
-```
-这种格式表示一个数组常量。请确保在定义数组常量时**不使用引号**，因为引号会使其被识别为字符串类型，而字符串类型的`'[1,3,4]'`不能直接被使用 `CAST` 转化成`array<int>`类型。
-
-## 示例
-
-1. 创建一个整数数组：
-
-```sql
-SELECT ARRAY(1, 2, 3);
-```
-执行结果：
-| result    |
-| --------- |
-| [1, 2, 3] |
-
-2. 将整数数组转换为字符串数组：
-
-```sql
-SELECT CAST(ARRAY(1, 2, 3) AS ARRAY<STRING>);
-```
-执行结果：
-| result          |
-| --------------- |
-| ["1", "2", "3"] |
-
-3. 获取数组元素的数据类型：
-
-```sql
-SELECT typeof(ARRAY(1.2, 1.4, 1.8));
-```
-执行结果：
-| result              |
-| ------------------- |
-| array<decimal(2,1)> |
-
-4. 创建一个嵌套数组（数组中包含其他数组）：
-
-```sql
-SELECT CAST(ARRAY(ARRAY(10, 20), ARRAY(30, 40)) AS ARRAY<ARRAY<DECIMAL(10,2)>>);
-```
-执行结果：
-| result                           |
-| -------------------------------- |
-| [[10.00, 20.00], [30.00, 40.00]] |
-
-5. 获取数组中的特定元素：
-
-```sql
-SELECT a[0] FROM VALUES(ARRAY(10, 20, 30)) AS T(a);
-```
-执行结果：
-| result |
-| ------ |
-| 10     |
-
-6. 使用`ARRY_CONTAINS`检查数组中是否存在特定元素：
-
-```sql
-SELECT array_contains(ARRAY(1, 2, 3),3);
-```
-执行结果：
-| Result |
-| ------ |
-| true   |
-
-7. 对数组进行排序：
-
-```sql
-SELECT ARRAY_SORT(array(2, 1, 3));
-```
-执行结果：
-| result    |
-| --------- |
-| [1, 2, 3] |
-
-8. 合并两个数组：
-
-```sql
-SELECT array_union(array(2, 1, 3, 3), array(3, 5));
-```
-执行结果：
-| result    |
-| --------- |
-| [2,1,3,5] |
-
-

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

@@ -1,2 +0,0 @@
-## 账户管理
-[实名认证](<authentication.md>)

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

@@ -1 +0,0 @@
-^