@clickzetta/cz-cli-darwin-x64 0.3.1

package/bin/skills/lakehouse-doc/references/instance-informaiton-schema.md

@@ -0,0 +1,278 @@
+#### WORKSPACES视图
+
+记录了WORKSPACE的详细信息
+
+| COLUMN NAME            | DATA TYPE           | DESCRIPTION                         |
+| ---------------------- | ------------------- | ----------------------------------- |
+| WORKSPACE\_ID          | STRING              | 工作空间ID                              |
+| WORKSPACE\_NAME        | STRING              | 工作空间的名字                             |
+| WORKSPACE\_CREATOR     | STRING              | 工作空间的所有者                            |
+| WORKSPACE\_CREATOR\_ID | STRING              | 工作空间的所有者的帐号ID                       |
+| WORKSPACE\_STORAGE     | BIGINT              | 工作空间存储情况，外部表和外部数据湖不计入，统计内部数据湖和表存储情况 |
+| CREATE\_TIME           | TIMESTAMP           | 工作空间创建时间                            |
+| LAST\_MODIFY\_TIME     | TIMESTAMP           | 工作空间修改时间                             |
+| COMMENT                | STRING              | 工作空间注释信息                            |
+| DELETE\_TIME           | TIMESTAMP           | 工作空间删除时间                            |
+| PROPERTIES             | MAP\<STRING,STRING> | 设置的PROPERTIES都会记录在此参数中              |
+
+#### SCHEMAS 视图
+
+记录了 SCHEMA 的详细信息
+
+**字段详细信息**
+
+| COLUMN NAME         | DATA TYPE           | DESCRIPTION            |
+| ------------------- | ------------------- | ---------------------- |
+| CATALOG\_NAME       | STRING              | 当前WORKSPACE的名字         |
+| SCHEMA\_ID          | STRING              | SCHEMA的ID                  |
+| SCHEMA\_NAME        | STRING              | SCHEMA的名字                 |
+| TYPE                | STRING              | 枚举值EXTERNAL 、MANAGED   |
+| SCHEMA\_CREATOR     | STRING              | 数据库的所有者的帐号名字           |
+| SCHEMA\_CREATOR\_ID | STRING              | 数据库的所有者的帐号ID           |
+| CREATE\_TIME        | TIMESTAMP           | 数据库创建时间                |
+| LAST\_MODIFY\_TIME  | TIMESTAMP           | 数据库修改时间                |
+| COMMENT             | STRING              | 创建数据库时注释信息             |
+| DELETE\_TIME        | TIMESTAMP           | 数据库删除时间                |
+| PROPERTIES          | MAP\<STRING,STRING> | 设置的PROPERTIES都会记录在此参数中 |
+
+
+#### TABLES 视图
+
+当前 WORKSPACE 下，每个表显示一行
+
+
+| COLUMN NAME        | DATA TYPE           | DESCRIPTION                                                                                                                                                                                                                                                                                                                        |
+| ------ | --- | ------------ |
+| TABLE\_CATALOG     | STRING              | 当前WORKSPACE的名称                                                                                                                                                                                                                                                                                                                     |
+| TABLE\_CATALOG\_ID | STRING              | WORKSPACE的ID                                                                                                                                                                                                                                                                                                                       |
+| TABLE\_SCHEMA      | STRING              | 当前TABLE所属的SCHEMA                                                                                                                                                                                                                                                                                                                   |
+| TABLE\_SCHEMA\_ID  | STRING              | 表对应数据库的ID                                                                                                                                                                                                                                                                                                                          |
+| TABLE\_NAME        | STRING              | 表名字                                                                                                                                                                                                                                                                                                                                |
+| TABLE\_ID          | STRING              | 表ID                                                                                                                                                                                                                                                                                                                                |
+| TABLE\_CREATOR     | STRING              | 表的所有者                                                                                                                                                                                                                                                                                                                              |
+| TABLE\_CREATOR\_ID | STRING              | 表创建者ID                                                                                                                                                                                                                                                                                                                             |
+| TABLE\_TYPE        | STRING              | EXTERNAL TABLE：外部表 VIRTUAL\_VIEW：视图 MATERIALIIZED VIEW：物化视图 MANAGED\_TABLE：标准表                                                                                                                                                                                                                                                     |
+| ROW\_COUNT         | BIGINT              | 条数,此处可能显示的为估计值，，显示估计值统计的情况包含&#XA;1.通过实时写入的数据包含PRIMARY KEY表，由于数据一直在变动存在MEMORY TABLE的数据无法准确统计&#XA;2.通常大部分UPDATE和DELETE操作是可以统计，但是实时写过的分区表，然后做UPDATE/DELETE 可能统计不准确,因为在执行删除提交时，请求没有携带文件删除多少条信息暂时无法记录&#XA;3.删除分区INSERT OVERWRITE PARTITION和TRUNCATE PARTITION，请求没有携带文件删除多少条信息可能统计不准确 |
+| BYTES              | BIGINT              | 占用空间大小, 条数,此处可能显示的为估计值，，显示估计值统计的情况包含&#XA;1.通过实时写入的数据包含PRIMARY KEY表，由于数据一直在变动存在MEMORY TABLE的数据无法准确统计&#XA;2.通常大部分UPDATE和DELETE操作是可以统计，但是实时写过的分区表，然后做UPDATE/DELETE 可能统计不准确,因为在执行删除提交时，请求没有携带文件删除文件信息暂时无法记录&#XA;3.删除分区INSERT OVERWRITE PARTITION和TRUNCATE PARTITION，请求没有携带文件删除大小信息可能统计不准确                                                                                                                                                                                                                                                         |
+| CREATE\_TIME       | TIMESTAMP           | 表创建时间                                                                                                                                                                                                                                                                                                                              |
+| LAST\_MODIFY\_TIME | TIMESTAMP           | 表修改时间                                                                                                                                                                                                                                                                                                                              |
+| DATA\_LIFECYCLE    | BIGINT              | 生命周期                                                                                                                                                                                                                                                                                                                               |
+| IS\_PARTITIONED    | BOOLEAN             | 是否是分区表                                                                                                                                                                                                                                                                                                                             |
+| IS\_CLUSTERED      | BOOLEAN             | 是否是分桶表                                                                                                                                                                                                                                                                                                                             |
+| COMMENT            | STRING              | 表注释信息                                                                                                                                                                                                                                                                                                                              |
+| DELETE\_TIME       | TIMESTAMP           | 删除时间，没有删除为NULL                                                                                                                                                                                                                                                                                                                     |
+| DATA\_LIFECYCLE    | INT                 | 设置的生命周期，如果未设置显示为NULL代表永久，设置则会显示相应时间                                                                                                                                                                                                                                                                                                |
+| PROPERTIES         | MAP\<STRING,STRING> | 设置的PROPERTIES都会记录在此参数中                                                                                                                                                                                                                                                                                                             |
+
+
+#### COLUMNS 视图
+
+查询结果包含表中每个字段为一行
+
+
+| COLUMN NAME              | DATA TYPE | DESCRIPTION      |
+| ------------------------ | --------- | ---------------- |
+| TABLE\_CATALOG           | STRING    | 当前WORKSPACE的名称   |
+| TABLE\_CATALOG\_ID       | STRING    | WORKSPACE的ID     |
+| TABLE\_SCHEMA            | STRING    | 当前TABLE所属的SCHEMA |
+| TABLE\_SCHEMA\_ID        | STRING    | 表对应数据库的ID        |
+| TABLE\_NAME              | STRING    | 表名字              |
+| TABLE\_ID                | STRING    | 表ID              |
+| COLUMN\_NAME             | STRING    | 字段的名字            |
+| COLUMN\_ID               | STRING    | 字段ID             |
+| COLUMN\_DEFAULT          | STRING    | 字段默认值,当前保留值      |
+| IS\_NULLABLE             | BOOLEAN   | 是否可以为NULL        |
+| DATA\_TYPE               | STRING    | 字段类型             |
+| IS\_PARTITIONING\_COLUMN | BOOLEAN  | 是否是分区字段          |
+| IS\_CLUSTERING\_COLUMN   | BOOLEAN  | 是否是 CLUSTER 字段      |
+| IS\_PRIMARY\_KEY         | BOOLEAN  | 是否是主键            |
+| COMMENT                  | STRING    | 字段的注释信息          |
+| DELETE\_TIME             | TIMESTAMP | 删除时间，没有删除为NULL   |
+
+
+​
+
+
+#### VIEWS 视图
+
+
+每个视图显示一行，包含当前 INSTANCE 下所有的视图
+
+
+| COLUMN NAME        | DATA TYPE | DESCRIPTION     |
+| ------------------ | --------- | --------------- |
+| TABLE\_CATALOG     | STRING    | 当前WORKSPACE的名称  |
+| TABLE\_CATALOG\_ID | STRING    | WORKSPACE的ID    |
+| TABLE\_SCHEMA      | STRING    | 当前VIEW所属的SCHEMA |
+| TABLE\_SCHEMA\_ID  | STRING    | 视图对应数据库的ID      |
+| TABLE\_NAME        | STRING    | 视图名字            |
+| TABLE\_ID          | STRING    | 视图ID            |
+| TABLE\_CREATOR     | STRING    | 视图所有者的帐号名字      |
+| TABLE\_CREATOR\_ID | STRING    | 视图所有者的帐号ID      |
+| VIEW\_DEFINITION   | STRING    | 创建视图的语句         |
+| CREATE\_TIME       | TIMESTAMP | 视图创建时间          |
+| LAST\_MODIFY\_TIME | TIMESTAMP | 视图修改时间          |
+| COMMENT            | STRING    | 视图的注释信息         |
+| DELETE\_TIME       | TIMESTAMP | 删除时间，没有删除为NULL  |
+
+#### USERS视图
+
+
+每个用户和空间显示一行，包含当前ACCOUNT所有的用户
+
+
+| COLUMN NAME          | DATA TYPE           | DESCRIPTION                        |
+| -------------------- | ------------------- | ---------------------------------- |
+| WORKSPACE\_NAME       | STRING              | 用户所在的工作空间                          |
+| WORKSPACE\_ID         | STRING              | 用户所在的空间ID                          |
+| USER\_ID             | STRING              | 系统根据用户生成的用户ID,                     |
+| USER\_NAME           | STRING              | 用户名称，使用WORKSPACE NAME和USER NAME 拼接 |
+| ROLE\_NAME           | STRING              | 当前用户拥有的角色，多个角色使用逗号分隔               |
+| ADD\_TIME            | TIEMSTAMP           | 用户创建时间                             |
+| EMAIL                | STRING              | 用户邮箱                               |
+| TELEPHONE             | STRING              | 用户电话                               |
+| LAST\_SUCCESS\_LOGIN | TIMESTAMP           | 上次登录时间                             |
+| COMMENT              | STRING              | 描述用户信息                             |
+| DELETE\_TIME         | TIMESTAMP           | 删除时间，没有删除为NULL                     |
+| PROPERTIES           | MAP\<STRING,STRING> | 设置的PROPERTIES都会记录在此参数中             |
+
+#### ROLES视图
+
+每个角色和空间显示一行，包含当前ACCOUNT所有的角色
+
+| COLUMN NAME    | DATA TYPE | DESCRIPTION                         |
+| -------------- | --------- | ----------------------------------- |
+| WORKSPACE\_NAME | STRING    | 当前空间的名字                             |
+| WORKSPACE\_ID   | STRING    | 角色所在的空间ID                           |
+| ROLE\_NAME     | STRING    | 角色名称,                               |
+| ROLE\_ID       | STRING    | ROLE ID                             |
+| USER\_NAME     | STRING    | 被授予该角色的用户名称，多个用户使用逗号分隔符。ROLE对应用户有哪些 |
+| USER\_ID       | STRING    | 被授予该角色的用户ID                         |
+| COMMENT        | STRING    | 描述用户信息                              |
+| DELETE\_TIME   | TIMESTAMP | 删除时间，没有删除为NULL                      |
+
+#### JOB_HISTORY视图
+
+所有空间下的运行信息
+
+| COLUMN NAME          | DATA TYPE     | DESCRIPTION                                                                                                                                                                                                           |
+| ------ | --- | ------------ |
+| WORKSPACE\_NAME       | STRING        | 运行JOB所在的空间                                                                                                                                                                                                            |
+| WORKSPACE\_ID        | STRING        |                                                                                                                                                                                                                       |
+| JOB\_ID              | STRING        | 作业ID                                                                                                                                                                                                                  |
+| JOB\_NAME            | STRING        | 作业名称                                                                                                                                                                                                                  |
+| JOB\_CREATOR\_ID     | STRING        | 运行作业的用户ID                                                                                                                                                                                                             |
+| JOB\_CREATOR         | STRING        | 运行作业的用户                                                                                                                                                                                                               |
+| STATUS               | STRING        | SETUP RESUMING\_CLUSTER QUEUED RUNNING SUCCESS FAILED CANCELED                                                                                                                                                        |
+| CRU                  | DECIMAL(38,5) | 用户消耗的计算资源                                                                                                                                                                                                   |
+| ERROR\_MESSAGE       | STRING        | 如果运行出错会有此信息                                                                                                                                                                                                           |
+| JOB\_TYPE            | STRING        | 作业类型  SQL                                                                                                                                                                                                             |
+| JOB\_TEXT            | STRING        | 执行JOB的语句                                                                                                                                                                                                              |
+| START\_TIME          | TIMESTAMP     | JOB运行开始时间                                                                                                                                                                                                             |
+| END\_TIME            | TIMESTAMP     | JOB运行结束时间                                                                                                                                                                                                             |
+| EXECUTION\_TIME      | DOUBLE        | 执行时间，单位为秒                                                                                                                                                                                                             |
+| INPUT\_BYTES         | BIGINT        | 实际扫描的数据量。                                                                                                                                                                                                             |
+| CACHE\_HIT           | BIGINT        | 从缓存中读取的数据                                                                                                                                                                                                             |
+| OUTPUT\_BYTES        | BIGINT        | 输出字节数。                                                                                                                                                                                                                |
+| INPUT\_OBJECTS       | STRING        | 输入的表名格式为\[SCHEMA].\[TABLE]多个以，分隔                                                                                                                                                                                      |
+| OUTPUT\_OBJECTS      | STRING        | 输出的表名格式为\[SCHEMA].\[TABLE]                                                                                                                                                                                            |
+| CLIENT\_INFO         | STRING        | 客户端信息，来自于JDBC、客户端、WEB页面、JAVA SDK                                                                                                                                                                                      |
+| VIRTUAL\_CLUSTER     | STRING        | 使用的计算资源                                                                                                                                                                                                               |
+| VIRTUAL\_CLUSTER\_ID | BIGINT        |                                                                                                                                                                                                                       |
+| ROWS\_PRODUCED       | BIGINT        | 处理的总记录数，输入的数据                                                                                                                                                                                                         |
+| ROWS\_INSERTED       | BIGINT        | 如果是插入行为应该有值                                                                                                                                                                                                           |
+| ROWS\_UPDATED        | BIGINT        | 如果是更新行为应该有值                                                                                                                                                                                                           |
+| ROWS\_DELETED        | BIGINT        | 如果是删除行为应该有值                                                                                                                                                                                                           |
+| JOB\_CONFIG          | STRING        | 提交作业时设置的参数信息                                                                                                                                                                                                          |
+| JOB\_PRIORITY        | STRING        | 作业优先级                                                                                                                                                                                                                 |
+| INPUT\_TABLES        | STRING        | JSON格式数组 INPUT\_TABLES:{\[{TABLE:WORKSAPCE\_NAME.SCHEMA.TABLENAME1, SIZE:0,RECORD:0,CACHESIZE:0,PARTITIONS:\[]},{TABLE:WORKSAPCE\_NAME.SCHEMA.TABLENAME2 SIZE:0,RECORD:0,CACHESIZE:0,PARTITIONS:\[]}......]}         |
+| OUTPUT\_TABLES       | STRING        | 输出的对象名称|
+| QUERY\_TAG          | STRING        | 用户可以在客户给JOB打标签                                                                                                                                                                                                        |
+| ERROR\_MESSAGE       | STRING        | 错误信息                                                                                                                                                                                                                  |
+
+
+#### MATERIALIZED VIEW刷新视图(MATERIALIZED\_VIEW\_REFRESH\_HISTORY)
+
+| COLUMN\_NAME             | DATA\_TYPE   | DESCRIPTION                          |
+| ------------------------ | ------------ | ------------------------------------ |
+| WORKSPACE\_ID            | BIGINT       | 项目空间ID                               |
+| WORKSPACE\_NAME          | STIRNG       | 项目空间名字                               |
+| SCHEMA\_ID               | BIGINT       | SCHEMA ID                            |
+| SCHEMA\_NAME             | STRING       | SCHEMA名字                             |
+| MATERIALIZED\_VIEW\_ID   | BIGINT       | 物化视图                               |
+| MATERIALIZED\_VIEW\_NAME | STRING       | 物化视图名字                               |
+| CREDITS\_USED            | DECIMAL      | 刷新物化视图使用的计费                          |
+| VIRTUAL\_CLUSER\_ID      | BIGINT       | 物化视图ID                               |
+| VIRTUAL\_CLUSTER         | STRING       | 物化视图名字，自动刷新会有此信息                     |
+| STATUS                   | STRING       | PENDING\RUNNING\FINISHED\FAILED       |
+| REFRESH\_MODE            | STRING       | 枚举值INCREMETAL FULL\_REFRESH NO\_DATA |
+| STATISTICS               | STRING       | 记录增量刷多少条                             |
+| SCHEDULE\_START\_TIME    | TIMESTAMP_LTZ | 计划刷新时间                               |
+| START\_TIME              | TIMESTAMP_LTZ | 物化视图开始时间                             |
+| END\_TIME                | TIMESTAMP_LTZ | 物化视图结束时间                             |
+| ERROR\_MESSAGE           | STRING       | 刷新失败的信息，如果失败则会在这里有                   |
+
+
+#### VOLUMES视图
+
+
+| column\_name        | data\_type          | description                                           |
+| ------------------- | ------------------- | ----------------------------------------------------- |
+| VOLUME\_CATALOG     | STRING              | 所属 Workspace 名称                                       |
+| VOLUME\_CATALOG\_ID | STRING              | 所属 Workspace 的ID                                      |
+| VOLUME\_SCHEMA      | STRING              | 所属 Schema 名称                                          |
+| VOLUME\_SCHEMA\_ID  | STRING              | Volume对应数schema的ID                                    |
+| VOLUME\_NAME        | STRING              | Volume 名称                                             |
+| VOLUME\_ID          | STRING              | Volume的ID                                             |
+| VOLUME\_URL         | STRING              | Volume 绑定的URL                                         |
+| VOLUME\_REGION      | STRING              | Volume 所属区域                                           |
+| VOLUME\_TYPE        | STRING              | Volume 类型(internal指创建volumn时不用指定第三方云厂商地址，或者 external) |
+| VOLUME\_CREATOR     | STRING              | Volume 的 owner                                        |
+| CONNECTION\_NAME    | STRING              | 引用的connection名称                                       |
+| CONNECTION\_ID      | STRING              | 引用的connection的ID                                      |
+| PROPERTIES          | map\<string,string> |                                                       |
+| COMMENT             | STRING              | 注释                                                    |
+| CREATE\_TIME        | TIMESTAMP           | 创建时间                                                  |
+| LAST\_MODIFY\_TIME  | TIMESTAMP           | 修改时间                                                  |
+
+#### CONNECTIONS视图
+
+
+| column_name     | data type           | description                                                                   |
+| ---------------- | ------------------- | ----------------------------------------------------------------------------- |
+| WORKSPACE\_NAME  | STRING              | 对象所在的空间                                                                       |
+| WORKSPACE\_ID    | STRING              |                                                                               |
+| CONNECTION\_NAME | STRING              | 连接对象名称                                                                   |
+| CONNECTION\_ID   | STRING              |                                                                               |
+| CONNECTION\_KIND | STRING              | 枚举值支持的connection种类，STORAGE CONNECTION、 API CONNECTION                         |
+| TYPE             | STRING              | 指定连接数据源的类型 storage connection支持 FILE\_SYSTEM api connection支持 CLOUD\_FUNCTION |
+| PROVIDER         | STRING              | TYPE 为 FILE\_SYSTEM 时为 OSS / COS TYPE 为 CLOUD\_FUNCTION 时为 aliyun / tencent   |
+| REGION           | STRING              | connection 连接的region，比如 ap-shanghai / cn-beijing                              |
+| SOURCE\_CREATOR  | STRING              | 创建者                                                                           |
+| CREATED\_TIME    | TIMESTAMP           | 创建时间                                                                          |
+| COMMENT          | STRING              | 注释信息                                                                          |
+| PROPERTIES       | map\<string,string> |                                                                               |
+
+
+
+
+
+
+
+#### OBJECT_PRIVILEGES视图
+
+
+| Column Name         | Data Type      | Description                                 |
+| ------------------- | -------------- | ------------------------------------------- |
+| GRANTOR             | TEXT           | 授出权限的USER                                   |
+| GRANTEE             | TEXT           | 被授予权限的user\_name 或 role\_name               |
+| GRANTED\_TO         | TEXT           | USER/ROLE                                   |
+| OBJECT\_CATALOG     | TEXT           | 被授予对象所在的工作空间或catalog名称                      |
+| OBJECT\_SCHEMA      | TEXT           | 被授予对象所在的schema，如果对象不在schema下则为空             |
+| OBJECT\_NAME        | TEXT           | 被授权的对象名称。直接显示名称，不用workspace.schema.name的方式。 |
+| OBJECT\_TYPE        | TEXT           | 被授权的对象的类型                                   |
+| SUB\_OBJECT\_TYPE   | TEXT           |                                             |
+| PRIVILEGE\_TYPE     | TEXT           | 被授予的具体角色                                    |
+| IS\_GRANTABLE       | TEXT           | 授权时是否有 WITH GRANT OPTION                    |
+| AUTHORIZATION\_TIME | TIMESTAMP\_LTZ | 权限授予时间                                      |
+

package/bin/skills/lakehouse-doc/references/instance-information_schema.md

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

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

@@ -0,0 +1,271 @@
+# 使用内部 Volume
+
+内部 Volume（Internal Volume）是系统提供的默认文件存储区域，用于临时存放待处理或待加载的数据文件。
+
+* 对于没有云存储的用户，可以直接上传文件到内部 Volume 作为数据文件的主要存储区域，系统提供完全托管的存储服务。
+* 而已使用云对象存储的用户，则可以选择使用外部 Volume（External Volume），通过直接挂载云存储路径进行访问，无需额外的数据迁移和复制。
+
+系统目前支持三种类型的内部 Volume：User Volume、Table Volume 和命名 Volume。
+
+### 使用User Volume
+
+User Volume 是用户专属的个人存储空间，类似于操作系统中用户的默认工作目录，在 Lakehouse 中这个目录不可删除。用户默认对 User Volume 具备读写权限。
+
+| **用户对 USER VOLUME 的操作** |
+| :------------------------- |
+| SHOW USER VOLUME DIRECTORY |
+| SELECT FROM VOLUME         |
+| PUT                        |
+| GET                        |
+| LIST USER VOLUME           |
+| REMOVE                     |
+
+* 查看User Volume下文件
+
+```SQL
+--查看user volume
+SHOW USER VOLUME DIRECTORY;
+
+relative_path                            url                                                                                                                                              size   last_modified_time  
+---------------------------------------- ------------------------------------------------------------------------------------------------------------------------------------------------ ------ ------------------- 
+images/image-2024-05-22-11-25-23-519.png oss://lakehouse-hz/86/workspaces/ql_ws_8133192700078175627/internal_volume/user_4371011337311368544/images/image-2024-05-22-11-25-23-519.png 200494 2024-05-28 23:30:27 
+images/image.png                         oss://lakehouse-hz/86/workspaces/ql_ws_8133192700078175627/internal_volume/user_4371011337311368544/images/image.png                         513894 2024-05-28 23:30:27 
+taxi_zone_lookup.csv                     oss://lakehouse-hz/86/workspaces/ql_ws_8133192700078175627/internal_volume/user_4371011337311368544/taxi_zone_lookup.csv                     12331  2024-05-28 23:04:54 
+tmp/taxi_zone_lookup.csv                 oss://lakehouse-hz/86/workspaces/ql_ws_8133192700078175627/internal_volume/user_4371011337311368544/tmp/taxi_zone_lookup.csv                 12331  2024-05-28 23:05:54 
+tmp/taxi_zone_lookup_02.csv              oss://lakehouse-hz/86/workspaces/ql_ws_8133192700078175627/internal_volume/user_4371011337311368544/tmp/taxi_zone_lookup_02.csv              12331  2024-05-28 23:34:24 
+```
+
+* 上传、下载与删除文件
+
+```SQL
+--上传文件至user volume根目录
+PUT '/Users/Downloads/taxi_zone_lookup.csv' TO USER VOLUME;
+
+--上传文件并保存为user volume指定目录下指定文件名称
+PUT '/Users/Downloads/taxi_zone_lookup.csv' TO USER VOLUME FILE 'tmp/taxi_zone_lookup_02.csv';
+
+--通过通配符上传多个文件到Volume子目录
+PUT '/Users/Downloads/images/*' TO USER VOLUME SUBDIRECTORY 'images/';
+
+--从User Volume下载文件
+GET USER VOLUME FILE 'images/image-2024-05-22-11-25-23-519.png' TO '/Users/Downloads/output/' ;
+
+--删除User Volume下指定文件
+REMOVE USER VOLUME FILE 'images/image-2024-05-22-11-25-23-519.png'
+
+--删除User Volume下指定路径下所有文件
+REMOVE USER VOLUME SUBDIRECTORY '/'
+```
+
+* 通过SQL查询User Volume下文件
+
+```SQL
+--通过SQL查询User Volume下指定文件
+SELECT * FROM USER VOLUME 
+USING CSV
+OPTIONS(
+        'header'='true'
+)
+FILES( 'taxi_zone_lookup.csv')
+LIMIT 5;
+
+LocationID Borough       Zone                    service_zone 
+---------- ------------- ----------------------- ------------ 
+1          EWR           Newark Airport          EWR          
+2          Queens        Jamaica Bay             Boro Zone    
+3          Bronx         Allerton/Pelham Gardens Boro Zone    
+4          Manhattan     Alphabet City           Yellow Zone  
+5          Staten Island Arden Heights           Boro Zone    
+
+
+--通过SQL查询User Volume指定路径下所有文件
+SELECT * FROM USER VOLUME using csv subdirectory '/tmp/';
+```
+
+* 使用 `get_presigned_url` 函数，获取 Volume 下文件在对象存储的待临时签名的真实访问路径。
+
+```SQL
+--获取presign url, 获取oss内网url
+SELECT get_presigned_url(USER VOLUME , 'images/image.png' , 60) as url;
+
+--获取presign url,获取对外url
+set cz.sql.function.get.presigned.url.force.external=true;
+SELECT get_presigned_url(USER VOLUME , 'images/image.png' , 60) as url;
+```
+
+### 使用Table Volume
+
+每个Lakehouse 表默认关联一个存储空间，我们称之为Table Volume。用户对指定表的 Table Volume 进行操作时需要具备以下权限：
+
+| **TABLE VOLUME 操作**                         | **对应 TABLE 权限需求**        |
+| :----------------------------------------- | :--------------------- |
+| SHOW TABLE VOLUME DIRECTORY \<table\_name> | SELECT                 |
+| SELECT FROM VOLUME \<table\_name>          | SELECT                 |
+| PUT                                        | INSERT,UPDATE,DELETE   |
+| GET                                        | SELECT                 |
+| LIST                                       | SCHEMA READ            |
+| REMOVE                                     | INSERT, UPDATE, DELETE |
+
+以下通过示例说明 Table Volume 的操作使用。
+
+```SQL
+--创建表
+CREATE TABLE t_copy_from_volume(id int, name string);
+
+--查看指定表的Table volume
+SHOW TABLE VOLUME DIRECTORY t_copy_from_volume;
+```
+
+上传文件至目标表的TABLE VOLUME，要求访问用户具有目标表的写入权限。
+
+```SQL
+--上传文件至table volume，不指定存储路径默认保存在根路径下
+PUT '/Users/Downloads/data.csv' TO TABLE VOLUME t_copy_from_volume FILE 'data.csv';
+
+source                           target   source_size target_size status  
+-------------------------------- -------- ----------- ----------- ------- 
+/Users/Downloads/data.csv data.csv 34          34          SUCCEED 
+```
+
+使用SQL探查上传至TABLE VOLUME下文件数据。
+
+```SQL
+--查询
+SELECT * FROM TABLE VOLUME t_copy_from_volume
+USING CSV
+OPTIONS(
+        'header'='true',
+        'lineSep'='\n'
+)
+
+id name  
+-- ----- 
+1  hello 
+2  world 
+3  !     
+```
+
+使用COPY INTO命令导入文件数据到目标表。
+
+```SQL
+COPY INTO t_copy_from_volume FROM TABLE VOLUME t_copy_from_volume(id int, name string)  USING csv  
+OPTIONS(
+        'header'='true',
+        'lineSep'='\n'
+)
+FILES ('data.csv')
+--删除volume中的文件，节省存储
+PURGE=TRUE;
+```
+
+查询目标表，验证导入结果。
+
+```SQL
+--查看导入结果
+SELECT * FROM t_copy_from_volume;
+
+id name  
+-- ----- 
+1  hello 
+2  world 
+3  !     
+```
+
+删除TABLE VOLUME下文件。
+
+```SQL
+--删除Table Volume下指定文件
+REMOVE TABLE VOLUME t_copy_from_volume  FILE 'data.csv'
+--删除Table Volume下指定路径下所有文件
+REMOVE TABLE VOLUME t_copy_from_volume subdirectory '/'
+```
+
+### 使用命名Volume
+
+命名 Volume 是用户显式创建的，创建后存储在 Lakehouse 管理的内部存储中，无需额外云存储配置。它提供了比自动生成的用户级（User Volume）和表级（Table Volume）更精细的控制能力。
+
+#### 语法说明
+
+##### 创建命名 Volume
+
+```SQL
+CREATE VOLUME [ IF NOT EXISTS ] <volume_name>
+    DIRECTORY = (
+        enable =  true,    
+        auto_refresh = true
+    )
+    RECURSIVE = true          -- 是否递归扫描子目录（默认false）
+```
+
+^
+
+#### 删除Volume
+
+```SQL
+DROP VOLUME [ IF EXISTS ] <volume_name>
+```
+
+#### 使用具体案例
+
+上传和下载数据
+
+```sql
+--创建volume
+CREATE  VOLUME my_volume
+    DIRECTORY = (
+        enable=true,
+        auto_refresh=true
+    )
+    RECURSIVE=true;
+SHOW VOLUME DIRECTORY my_volume;
+
+COPY INTO VOLUME my_volume  SUBDIRECTORY 'dau_unload/'
+FROM TABLE public.students01
+file_format = (
+    type= CSV
+    writebom=true
+);
+SHOW VOLUME DIRECTORY my_volume;
+--本地上传下载测试
+GET VOLUME my_volume FILE 'dau_unload/part00001.csv' TO '/tmp';
++---------------+--------------------+-------------+-------------+---------+
+|    source     |       target       | source_size | target_size | status  |
++---------------+--------------------+-------------+-------------+---------+
+| part00001.csv | /tmp/part00001.csv | 1472        | 1472        | SUCCEED |
++---------------+--------------------+-------------+-------------+---------+
+
+ PUT '/tmp/part00001.csv' to volume my_volume file 'my.csv';
++--------------------+--------+-------------+-------------+---------+
+|       source       | target | source_size | target_size | status  |
++--------------------+--------+-------------+-------------+---------+
+| /tmp/part00001.csv | my.csv | 1472        | 1472        | SUCCEED |
++--------------------+--------+-------------+-------------+---------+
+
+```
+
+## 数据操作协议
+
+| 协议类型         | 地址格式                             | 典型场景     |
+| ------------ | -------------------------------- | -------- |
+| User Volume  | volume\:user://\~/filename       | 用户私有资源   |
+| Table Volume | volume\:table://table\_name/file | 表关联 ETL 文件 |
+| Named Volume | volume://volume\_name/path       | 跨团队共享资源  |
+
+* **User Volume 格式地址**: `volume:user://~/upper.jar`
+
+  * `user` 表示使用 User Volume 协议。
+  * `~` 表示当前用户，为固定值。
+  * `upper.jar` 表示目标文件名。
+
+* **Table Volume 格式地址**: `volume:table://table_name/upper.jar`
+
+  * `table` 表示使用 Table Volume 协议。
+  * `table_name` 表示表名，需根据实际情况填写。
+  * `upper.jar` 表示目标文件名。
+
+* **Named Volume 格式地址**: `volume://volume_name/upper.jar`
+
+  * `volume_name`：创建的 Volume 名称
+  * `upper.jar` 表示目标文件名。
+
+^

package/bin/skills/lakehouse-doc/references/intro-supported-features.md

@@ -0,0 +1,48 @@
+# Clickzetta Lakehouse：高性能的在离线一体化服务
+
+## 概述
+
+Clickzetta Lakehouse 是一款高性能的离线一体化数据管理平台，旨在简化企业数据管理架构。通过实时离线导入、加工、分析等功能，用户可以轻松处理和分析大规模数据。此外，Clickzetta Lakehouse 采用云原生架构，具备智能化、开放性等特点，为用户提供丰富的接口和完整的产品解决方案。
+
+## 实时离线一体化
+
+Clickzetta Lakehouse 支持实时离线一体化，使用户能够在同一个平台上处理实时数据和离线数据。以下是一些使用场景：
+
+1. **实时数据导入**：用户可以将实时数据流导入到 Clickzetta Lakehouse 中，并进行实时分析。例如，电商平台可以实时监控订单数据，以便快速响应市场变化。
+2. **离线批量导入**：用户可以将历史数据批量导入到 Clickzetta Lakehouse 中，以便进行离线分析。例如，金融机构可以导入历史交易数据，用于风险管理和合规报告。
+3. **实时数据加工**：Clickzetta Lakehouse 支持基于物化视图的实时数据加工能力，用户可以实时生成报表和仪表盘。例如，物流公司可以实时追踪货物状态，生成实时报表供管理层决策。
+4. **离线分析**：用户可以对离线数据进行高性能在线分析，无需移动数据。例如，零售商可以分析历史销售数据，以制定更有效的营销策略。
+
+## 云原生架构
+
+Clickzetta Lakehouse 采用云原生架构，具备以下特点：
+
+1. **Serverless**：无服务器架构，按需使用和释放计算资源，按量付费。用户无需关心底层资源管理和维护，可以专注于数据分析和业务创新。
+2. **存算分离**：以对象存储作为持久化存储层，计算独立伸缩。用户可以根据业务需求灵活调整计算资源，降低成本。
+3. **Multi-Cluster架构**：支持多虚拟计算资源的急速创建/自动暂停/销毁/根据负载弹性伸缩，避免不同业务的资源争抢；支持单个虚拟计算资源的纵向与横向伸缩，满足单作业算力提升、多并发保障等不同场景的资源需求。
+
+## 智能化功能
+
+Clickzetta Lakehouse 提供以下智能化功能：
+
+1. **实时写入服务**：独立的实时写入服务，根据业务负载自动伸缩资源，无需用户管理。
+2. **自动存储优化**：自动进行数据整理合并、索引优化、Cache优化，提高数据存储效率和查询性能。
+3. **智能优化**：使用算法分析作业运行特征并进行智能优化，持续优化性能与成本。
+4. **自动驾驶**：弹性计算资源感知负载进行自动启停、弹性并发，可降低资源使用成本，同时保障关键业务并发下查询质量。
+
+## 开放性
+
+Clickzetta Lakehouse 具备以下开放性特点：
+
+1. **丰富的用户接口**：提供 JDBC、SDK、CLI 等工具，与广泛的生态工具对接，方便用户集成现有环境。
+2. **生态引擎对接**：支持用户以开源生态标准的存储格式、元数据访问接口，使用开源计算引擎（如 Spark）安全访问 Clickzetta Lakehouse 数据，支撑数据准备、算法分析等场景。
+
+## 完整的产品解决方案
+
+Clickzetta Lakehouse 原生集成数据集成、数据开发与运维、数据资产管理工具，无需复杂的集成工作即可通过 Clickzetta Lakehouse 开展数据应用开发。用户可以通过以下方式使用 Clickzetta Lakehouse：
+
+1. **数据集成**：使用 Clickzetta Lakehouse 提供的数据集成工具，将数据从各种数据源导入到平台中。
+2. **数据开发与运维**：利用 Clickzetta Lakehouse 的计算能力，开发数据处理和分析任务，实现数据的加工、转换和分析。
+3. **数据资产管理**：通过 Clickzetta Lakehouse 提供的数据资产管理工具，实现数据的元数据管理、数据质量管理和数据生命周期管理。
+
+总之，Clickzetta Lakehouse 为用户提供了一个高性能、易用、灵活的离线一体化数据管理平台，帮助用户轻松应对各种数据处理和分析需求。