@clickzetta/cz-cli-linux-x64 0.3.4 → 0.3.5

package/bin/skills/clickzetta-vcluster-manager/SKILL.md

@@ -1,212 +0,0 @@
----
-name: clickzetta-vcluster-manager
-description: |
-  管理 ClickZetta Lakehouse 计算集群（VCluster）的完整生命周期。
-  覆盖创建（通用型/分析型/同步型）、启动/停止、规格调整、弹性扩缩容、
-  缓存配置（PRELOAD_TABLES）、查看集群状态等操作。
-  当用户说"创建集群"、"计算集群"、"VCluster"、"启动集群"、"停止集群"、
-  "调整集群规格"、"集群扩容"、"集群缩容"、"自动停止"、"自动启动"、
-  "预加载缓存"、"PRELOAD"、"集群类型"、"GP集群"、"AP集群"、"分析型集群"、
-  "通用型集群"、"同步型集群"时触发。
-  Keywords: VCluster, compute cluster, create, suspend, resume, resize, auto-scale
----
-
-# ClickZetta 计算集群管理
-
-阅读 [references/vcluster-ddl.md](references/vcluster-ddl.md) 了解完整语法。
-
-## 集群类型选择
-
-| 类型 | 关键字 | 适用场景 | 扩缩容方式 |
-|---|---|---|---|
-| 通用型（GP） | `GENERAL` | 离线 ETL、数据摄取、综合场景 | 纵向（规格大小） |
-| 分析型（AP） | `ANALYTICS` | 高并发在线查询、BI 报表、Ad-Hoc | 横向（副本数） |
-| 同步型 | `INTEGRATION` | 数据集成同步任务 | 纵向（规格大小） |
-
-**规格单位**：CRU（Compute Resource Unit）
-- 通用型/同步型：1-256 CRU，步长 1（同步型额外支持 0.25、0.5）
-- 分析型：1-256 CRU，须为 2 的 n 次幂（1、2、4、8、16...）
-
----
-
-## 创建集群
-
-```sql
--- 通用型：离线 ETL，8 CRU，作业完成后 60 秒自动停止
-CREATE VCLUSTER IF NOT EXISTS etl_vc
-  VCLUSTER_TYPE = GENERAL
-  VCLUSTER_SIZE = 8
-  AUTO_SUSPEND_IN_SECOND = 60
-  AUTO_RESUME = TRUE
-  COMMENT '离线ETL专用集群';
-
--- 通用型：弹性规格（1-16 CRU）
-CREATE VCLUSTER IF NOT EXISTS etl_elastic_vc
-  VCLUSTER_TYPE = GENERAL
-  MIN_VCLUSTER_SIZE = 1
-  MAX_VCLUSTER_SIZE = 16
-  AUTO_SUSPEND_IN_SECOND = 300;
-
--- 分析型：BI 报表，4 CRU，1-10 副本，最大 80 并发
-CREATE VCLUSTER IF NOT EXISTS bi_vc
-  VCLUSTER_TYPE = ANALYTICS
-  VCLUSTER_SIZE = 4
-  MIN_REPLICAS = 1
-  MAX_REPLICAS = 10
-  MAX_CONCURRENCY = 8
-  AUTO_SUSPEND_IN_SECOND = 1800
-  AUTO_RESUME = TRUE
-  COMMENT 'BI报表在线查询集群';
-
--- 同步型：数据集成任务
-CREATE VCLUSTER IF NOT EXISTS sync_vc
-  VCLUSTER_TYPE = INTEGRATION
-  VCLUSTER_SIZE = 1
-  AUTO_RESUME = TRUE;
-```
-
----
-
-## 启动 / 停止
-
-```sql
--- 启动集群
-ALTER VCLUSTER IF EXISTS etl_vc RESUME;
-
--- 正常停止（等待当前作业完成）
-ALTER VCLUSTER IF EXISTS etl_vc SUSPEND;
-
--- 强制停止（立即中断所有作业）
-ALTER VCLUSTER IF EXISTS etl_vc SUSPEND FORCE;
-
--- 取消集群中所有作业
-ALTER VCLUSTER IF EXISTS etl_vc CANCEL ALL JOBS;
-```
-
----
-
-## 修改集群属性
-
-```sql
--- 调整规格
-ALTER VCLUSTER IF EXISTS etl_vc SET VCLUSTER_SIZE = 16;
-
--- 修改自动停止时间
-ALTER VCLUSTER IF EXISTS etl_vc SET AUTO_SUSPEND_IN_SECOND = 300;
-
--- 分析型：调整副本数和并发
-ALTER VCLUSTER IF EXISTS bi_vc SET
-  MIN_REPLICAS = 2
-  MAX_REPLICAS = 5
-  MAX_CONCURRENCY = 16;
-
--- 修改注释
-ALTER VCLUSTER IF EXISTS etl_vc SET COMMENT '新注释';
-```
-
----
-
-## 缓存配置（仅分析型）
-
-阅读 [references/vc-cache.md](references/vc-cache.md) 了解缓存详情。
-
-```sql
--- 设置预加载表（覆盖写，需带上所有已有表）
-ALTER VCLUSTER bi_vc SET PRELOAD_TABLES = "public.orders,public.customers";
-
--- 查看当前集群缓存状态
-SHOW PRELOAD CACHED STATUS;
-
--- 查看指定集群缓存状态
-SHOW VCLUSTER bi_vc PRELOAD CACHED STATUS;
-```
-
----
-
-## 查看集群信息
-
-```sql
--- 列出所有集群
-SHOW VCLUSTERS;
-
--- 按类型过滤
-SHOW VCLUSTERS WHERE vcluster_type = 'ANALYTICS';
-SHOW VCLUSTERS WHERE state = 'SUSPENDED';
-
--- 按名称模糊匹配
-SHOW VCLUSTERS LIKE 'etl%';
-
--- 查看集群详情
-DESC VCLUSTER etl_vc;
-DESC VCLUSTER EXTENDED bi_vc;
-```
-
----
-
-## 删除集群
-
-```sql
--- 等待当前作业完成后删除
-DROP VCLUSTER IF EXISTS etl_vc;
-
--- 立即强制删除（中断正在运行的作业）
-DROP VCLUSTER IF EXISTS etl_vc FORCE;
-```
-
----
-
-## 切换当前会话集群
-
-```sql
-USE VCLUSTER bi_vc;
-```
-
----
-
-## 典型场景
-
-### 场景 1：离线 ETL 集群
-
-```sql
-CREATE VCLUSTER IF NOT EXISTS etl_daily
-  VCLUSTER_TYPE = GENERAL
-  VCLUSTER_SIZE = 8
-  AUTO_SUSPEND_IN_SECOND = 60
-  AUTO_RESUME = TRUE
-  COMMENT '每日ETL作业，完成后1分钟自动停止';
-```
-
-### 场景 2：在线 BI 报表集群（高并发）
-
-```sql
-CREATE VCLUSTER IF NOT EXISTS bi_online
-  VCLUSTER_TYPE = ANALYTICS
-  VCLUSTER_SIZE = 4
-  MIN_REPLICAS = 1
-  MAX_REPLICAS = 10
-  MAX_CONCURRENCY = 8
-  AUTO_SUSPEND_IN_SECOND = 1800
-  AUTO_RESUME = TRUE
-  COMMENT 'BI在线查询，最大支持80并发';
-```
-
-### 场景 3：数据集成同步集群
-
-```sql
-CREATE VCLUSTER IF NOT EXISTS cdc_sync
-  VCLUSTER_TYPE = INTEGRATION
-  VCLUSTER_SIZE = 0.5
-  AUTO_RESUME = TRUE
-  COMMENT '轻量CDC同步任务';
-```
-
----
-
-## 常见问题
-
-| 问题 | 原因 | 解决方案 |
-|---|---|---|
-| 分析型集群规格报错 | 规格须为 2 的 n 次幂 | 使用 1、2、4、8、16、32... |
-| PRELOAD_TABLES 不生效 | 仅 AP 型集群支持 | 确认集群类型为 ANALYTICS |
-| 添加预加载表后原有表消失 | PRELOAD_TABLES 是覆盖写 | 设置时带上所有已有表 |
-| 集群停止后缓存丢失 | 本地缓存随集群停止释放 | 重启后自动重新加载 PRELOAD 表 |

package/bin/skills/clickzetta-vcluster-manager/references/vc-cache.md

@@ -1,54 +0,0 @@
-# 计算集群缓存参考
-
-> 来源：https://www.yunqi.tech/documents/vc_cache
-
-## 缓存类型
-
-Lakehouse 提供三种缓存：
-1. **查询结果缓存（ResultCache）** - 服务层，工作空间内共享
-2. **元数据缓存（MetadataCache）** - 服务层，工作空间内共享
-3. **计算集群本地缓存（Local Disk Cache）** - 保存在集群本地节点，仅使用指定集群时可用
-
-## 主动缓存（PRELOAD_TABLES）
-
-仅适用于**分析型（AP）**集群。集群每次启动时自动加载预缓存表的最新数据/分区。
-
-```sql
--- 设置预加载表（覆盖写，需带上所有已有表）
-ALTER VCLUSTER default SET PRELOAD_TABLES = "schema1.table1,schema2.table2";
-
--- 添加新表时，必须包含原有表，否则会覆盖
-ALTER VCLUSTER default SET PRELOAD_TABLES = "schema1.table1,schema2.table2,schema3.table3";
-
--- 支持通配符
-ALTER VCLUSTER bi_vc SET PRELOAD_TABLES = "sales.*,public.dim_date";
-```
-
-⚠️ 注意：执行缓存命令后，只有新写入的数据才会被缓存。
-
-## 被动缓存
-
-首次查询时自动缓存读取的文件，后续相同查询直接命中缓存。支持 GP 型和 AP 型集群。
-
-## 查看缓存状态
-
-```sql
--- 显示当前集群的预加载表/分区状态
-SHOW PRELOAD CACHED STATUS;
-
--- 显示指定集群的预加载状态
-SHOW VCLUSTER <vc_name> PRELOAD CACHED STATUS;
-
--- 按表名过滤
-SHOW VCLUSTER <vc_name> PRELOAD CACHED STATUS WHERE table LIKE '%table_name%';
-
--- 显示预加载缓存汇总信息
-SHOW EXTENDED PRELOAD CACHED STATUS;
-```
-
-## 注意事项
-
-- 集群停止时，本地缓存自动释放
-- AP 型集群重启时只缓存最新写入的数据或分区
-- `SHOW PRELOAD` 状态更新可能有约 10 分钟延迟，但缓存实际已生效
-- PRELOAD_TABLES 是覆盖写，添加新表时需带上所有已有表

package/bin/skills/clickzetta-vcluster-manager/references/vcluster-ddl.md

@@ -1,150 +0,0 @@
-# CREATE / ALTER / DROP VCLUSTER 参考
-
-> 来源：https://www.yunqi.tech/documents/create_cluster 和 alter-vcluster 和 drop-vcluster
-
----
-
-## 集群类型选择
-
-| 类型 | 关键字 | 适用场景 | 扩缩容方式 |
-|---|---|---|---|
-| 通用型（GP） | `GENERAL` | 离线 ETL、数据摄取、综合场景 | 纵向（规格大小） |
-| 分析型（AP） | `ANALYTICS` | 高并发在线查询、BI 报表、Ad-Hoc | 横向（副本数） |
-| 同步型 | `INTEGRATION` | 数据集成同步任务 | 纵向（规格大小） |
-
-**规格单位**：CRU（Compute Resource Unit）
-- 通用型/同步型：1-256 CRU，步长 1（同步型额外支持 0.25、0.5）
-- 分析型：1-256 CRU，须为 2 的 n 次幂（1、2、4、8、16...）
-
----
-
-## CREATE VCLUSTER
-
-```sql
-CREATE VCLUSTER [IF NOT EXISTS] <name>
-  VCLUSTER_TYPE = GENERAL | ANALYTICS | INTEGRATION
-  VCLUSTER_SIZE = num                    -- 固定规格
-  -- 或弹性规格（通用型/同步型）
-  MIN_VCLUSTER_SIZE = num
-  MAX_VCLUSTER_SIZE = num
-  AUTO_SUSPEND_IN_SECOND = num           -- 空闲自动停止秒数，-1 表示不停止，默认 600
-  AUTO_RESUME = TRUE | FALSE             -- 是否自动启动，默认 TRUE
-  QUERY_RUNTIME_LIMIT_IN_SECOND = num    -- 单作业最大执行时长（秒），默认 86400
-  [COMMENT '']
-```
-
-### 分析型专有参数
-
-```sql
-  MIN_REPLICAS = num          -- 最小实例数（1-10），默认 1
-  MAX_REPLICAS = num          -- 最大实例数（1-10），默认 1
-  MAX_CONCURRENCY = num       -- 每实例最大并发数（1-32），默认 8
-  PRELOAD_TABLES = "schema.table1,schema.table2"  -- 预加载缓存表
-```
-
-### 示例
-
-```sql
--- 通用型：离线 ETL，8 CRU，作业完成后 60 秒自动停止
-CREATE VCLUSTER IF NOT EXISTS etl_vc
-  VCLUSTER_TYPE = GENERAL
-  VCLUSTER_SIZE = 8
-  AUTO_SUSPEND_IN_SECOND = 60
-  AUTO_RESUME = TRUE
-  COMMENT '离线ETL专用集群';
-
--- 通用型：弹性规格（1-16 CRU）
-CREATE VCLUSTER IF NOT EXISTS etl_elastic_vc
-  VCLUSTER_TYPE = GENERAL
-  MIN_VCLUSTER_SIZE = 1
-  MAX_VCLUSTER_SIZE = 16
-  AUTO_SUSPEND_IN_SECOND = 300;
-
--- 分析型：BI 报表，4 CRU，1-10 副本，最大 80 并发
-CREATE VCLUSTER IF NOT EXISTS bi_vc
-  VCLUSTER_TYPE = ANALYTICS
-  VCLUSTER_SIZE = 4
-  MIN_REPLICAS = 1
-  MAX_REPLICAS = 10
-  MAX_CONCURRENCY = 8
-  AUTO_SUSPEND_IN_SECOND = 1800
-  AUTO_RESUME = TRUE
-  COMMENT 'BI报表在线查询集群';
-
--- 同步型：数据集成任务
-CREATE VCLUSTER IF NOT EXISTS sync_vc
-  VCLUSTER_TYPE = INTEGRATION
-  VCLUSTER_SIZE = 1
-  AUTO_RESUME = TRUE;
-```
-
----
-
-## ALTER VCLUSTER
-
-```sql
--- 启动集群
-ALTER VCLUSTER [IF EXISTS] <name> RESUME;
-
--- 停止集群
-ALTER VCLUSTER [IF EXISTS] <name> SUSPEND [FORCE];
-
--- 取消集群中所有作业
-ALTER VCLUSTER [IF EXISTS] <name> CANCEL ALL JOBS;
-
--- 修改属性
-ALTER VCLUSTER [IF EXISTS] <name> SET
-  VCLUSTER_SIZE = num
-  AUTO_SUSPEND_IN_SECOND = num
-  AUTO_RESUME = TRUE | FALSE
-  MAX_CONCURRENCY = num          -- 仅分析型
-  MIN_REPLICAS = num             -- 仅分析型
-  MAX_REPLICAS = num             -- 仅分析型
-  PRELOAD_TABLES = "schema.table";
-
--- 修改注释
-ALTER VCLUSTER [IF EXISTS] <name> SET COMMENT '新注释';
-```
-
----
-
-## DROP VCLUSTER
-
-```sql
--- 等待当前作业完成后删除
-DROP VCLUSTER [IF EXISTS] <name>;
-
--- 立即强制删除（中断正在运行的作业）
-DROP VCLUSTER [IF EXISTS] <name> FORCE;
-```
-
----
-
-## DESC / SHOW VCLUSTER
-
-```sql
--- 查看集群基本信息
-DESC VCLUSTER <name>;
-
--- 查看扩展信息
-DESC VCLUSTER EXTENDED <name>;
-
--- 列出所有集群
-SHOW VCLUSTERS;
-
--- 按类型过滤
-SHOW VCLUSTERS WHERE vcluster_type = 'GENERAL';
-SHOW VCLUSTERS WHERE state = 'SUSPENDED';
-SHOW VCLUSTERS WHERE vcluster_type = 'ANALYTICS';
-
--- 按名称模糊匹配
-SHOW VCLUSTERS LIKE 'etl%';
-```
-
----
-
-## USE VCLUSTER（切换当前会话集群）
-
-```sql
-USE VCLUSTER <name>;
-```

package/bin/skills/clickzetta-volume-manager/SKILL.md

@@ -1,292 +0,0 @@
----
-name: clickzetta-volume-manager
-description: |
-  管理 ClickZetta Lakehouse Volume 对象，实现对象存储（OSS/COS/S3）的挂载、
-  文件查询与数据导入导出。覆盖外部 Volume 创建（OSS/COS/S3）、内部 User Volume
-  文件操作（PUT/GET/REMOVE）、SELECT FROM VOLUME 直接查询文件、
-  COPY INTO TABLE 导入、COPY INTO VOLUME 导出等完整工作流。
-  当用户说"创建Volume"、"挂载OSS"、"挂载S3"、"挂载COS"、"Volume管理"、
-  "查询OSS文件"、"查询S3文件"、"上传文件到Volume"、"PUT文件"、"GET文件"、
-  "从Volume导入数据"、"导出到Volume"、"COPY INTO VOLUME"、"SELECT FROM VOLUME"、
-  "User Volume"、"数据湖文件"、"数据导出"、"导出数据"、"导出CSV"、"导出Parquet"、
-  "COPY OVERWRITE INTO"时触发。
-  Keywords: Volume, OSS, COS, S3, mount, file query, COPY INTO, external storage
----
-
-# ClickZetta Volume 管理
-
-阅读 [references/volume-ddl.md](references/volume-ddl.md) 了解完整语法。
-
-## Volume 类型
-
-| 类型 | 说明 | 典型用途 |
-|---|---|---|
-| 外部 Volume | 挂载 OSS/COS/S3 路径 | 访问已有对象存储数据 |
-| User Volume | 用户专属内部存储 | 临时文件上传、本地文件导入 |
-| Table Volume | 表关联内部存储 | 表数据文件管理 |
-
----
-
-## 创建外部 Volume
-
-前提：先创建 STORAGE CONNECTION（对象存储认证配置）
-
-> ⚠️ **跨云限制**：Storage Connection 必须与 Lakehouse 实例在同一云厂商。阿里云实例不能创建 COS/S3 Connection，腾讯云实例不能创建 OSS Connection。
-
-> ⚠️ **阿里云 OSS 参数名**：
-> - 小写形式：`access_id` / `access_key`（推荐）
-> - 大写形式：`ACCESS_KEY_ID` / `ACCESS_KEY_SECRET`（也可以）
-> - ⚠️ `ACCESS_KEY` / `SECRET_KEY` 会报错（缺少 `_ID` / `_SECRET` 后缀）
-
-```sql
--- 阿里云 OSS
-CREATE STORAGE CONNECTION IF NOT EXISTS my_oss_conn
-  TYPE OSS
-  access_id = 'LTAIxxxxxxxxxxxx'
-  access_key = 'T8Gexxxxxxmtxxxxxx'
-  ENDPOINT = 'oss-cn-hangzhou-internal.aliyuncs.com';
-
--- 腾讯云 COS
-CREATE STORAGE CONNECTION IF NOT EXISTS my_cos_conn
-  TYPE COS
-  ACCESS_KEY = '<access_key>'
-  SECRET_KEY = '<secret_key>'
-  REGION = 'ap-shanghai'
-  APP_ID = '1310000503';
-
--- AWS S3
-CREATE STORAGE CONNECTION IF NOT EXISTS my_s3_conn
-  TYPE S3
-  ACCESS_KEY = '<access_key>'
-  SECRET_KEY = '<secret_key>'
-  REGION = 'us-east-1';
-```
-
-```sql
--- 挂载阿里云 OSS
-CREATE EXTERNAL VOLUME my_oss_volume
-  LOCATION 'oss://my-bucket/data-path/'
-  USING CONNECTION my_oss_conn
-  DIRECTORY = (ENABLE = TRUE, AUTO_REFRESH = TRUE)
-  RECURSIVE = TRUE;
-
--- 挂载腾讯云 COS
-CREATE EXTERNAL VOLUME my_cos_volume
-  LOCATION 'cos://my-bucket/data-path/'
-  USING CONNECTION my_cos_conn
-  DIRECTORY = (ENABLE = TRUE)
-  RECURSIVE = TRUE;
-
--- 挂载 AWS S3
-CREATE EXTERNAL VOLUME my_s3_volume
-  LOCATION 's3://my-bucket/data-path/'
-  USING CONNECTION my_s3_conn
-  DIRECTORY = (ENABLE = TRUE)
-  RECURSIVE = TRUE;
-```
-
----
-
-## 查看 Volume
-
-```sql
--- 列出所有 Volume
-SHOW VOLUMES;
-
--- 过滤外部 Volume（SHOW VOLUMES 不支持 WHERE 过滤，使用 information_schema）
-SELECT volume_name, volume_type, volume_region, volume_creator
-FROM information_schema.volumes
-WHERE volume_type = 'EXTERNAL';
-
--- 查看详情
-DESC VOLUME my_oss_volume;
-
--- 查看目录下的文件
-SHOW VOLUME DIRECTORY my_oss_volume;
-
--- 刷新目录元数据后查询（上传新文件后可能需要手动刷新）
-ALTER VOLUME my_oss_volume REFRESH;
-SELECT * FROM DIRECTORY(VOLUME my_oss_volume);
-```
-
-> ⚠️ **目录刷新注意**：上传文件到对象存储后，`SHOW VOLUME DIRECTORY` 可能不会立即显示新文件。
-> 如果启用了 `AUTO_REFRESH = TRUE`，系统会定期自动刷新；否则需要手动执行 `ALTER VOLUME name REFRESH`。
-
----
-
-## 直接查询 Volume 中的文件
-
-> ⚠️ **语法限制**：ClickZetta 不支持 `@volume_name` 简写（Snowflake Stage 语法），必须使用 `FROM VOLUME name USING format` 完整语法。
-> ⚠️ **多格式文件处理**：如果 Volume 中包含多种格式的文件（如 .csv 和 .json 混合），不指定 `FILES()` 或 `SUBDIRECTORY` 时会尝试读取所有文件，可能因格式不匹配而报错。建议使用 `FILES('xxx.csv')` 指定文件或 `SUBDIRECTORY 'csv_data/'` 指定子目录。
-> ⚠️ **JSON 嵌套字段访问**：使用 `data['key']` 语法（不是 Snowflake 的 `data:key` 语法）。
-
-```sql
--- 查询 CSV 文件（自动推断 schema）
-SELECT * FROM VOLUME my_oss_volume
-USING CSV
-OPTIONS('header' = 'true', 'sep' = ',')
-SUBDIRECTORY 'orders/2024/'
-LIMIT 100;
-
--- 查询 Parquet 文件
-SELECT * FROM VOLUME my_oss_volume
-USING PARQUET
-REGEXP '.*2024-0[1-6].parquet';
-
--- 查询指定文件（推荐，避免多格式冲突）
-SELECT * FROM VOLUME my_oss_volume
-USING JSON
-FILES('user_events.json');
-
--- 查询 JSON 嵌套字段
-SELECT
-  data['event_id'] AS event_id,
-  data['properties']['device'] AS device
-FROM VOLUME my_oss_volume
-USING JSON
-FILES('events.json');
-
--- 查询 User Volume 文件
-SELECT * FROM USER VOLUME
-USING CSV
-OPTIONS('header' = 'true')
-FILES('upload.csv');
-```
-
----
-
-## User Volume 文件操作
-
-```sql
--- 查看文件列表
-SHOW USER VOLUME DIRECTORY;
-
--- 上传本地文件
-PUT '/local/path/data.csv' TO USER VOLUME;
-PUT '/local/path/data.csv' TO USER VOLUME FILE 'subdir/data.csv';
-
--- 下载文件
-GET USER VOLUME FILE 'subdir/data.csv' TO '/local/output/';
-
--- 删除文件
-REMOVE USER VOLUME FILE 'subdir/data.csv';
-```
-
----
-
-## 数据导入导出
-
-### 从 Volume 导入到表
-
-```sql
--- CSV 导入
-COPY INTO my_table
-FROM VOLUME my_oss_volume
-USING CSV
-OPTIONS('header' = 'true')
-SUBDIRECTORY 'data/';
-
--- 指定文件导入
-COPY INTO my_table
-FROM VOLUME my_oss_volume
-USING PARQUET
-FILES('data_2024.parquet');
-
--- 正则匹配文件导入
-COPY INTO my_table
-FROM VOLUME my_oss_volume
-USING PARQUET
-REGEXP '.*2024-0[1-6].parquet';
-
--- 覆盖写入（清空表后导入）
-COPY OVERWRITE INTO my_table
-FROM VOLUME my_oss_volume
-USING CSV
-OPTIONS('header' = 'true');
-```
-
-### 导出表到 Volume
-
-```sql
--- 导出整张表为 Parquet（到 External Volume）
-COPY INTO VOLUME my_oss_volume
-SUBDIRECTORY 'export/'
-FROM TABLE my_table
-FILE_FORMAT = (TYPE = PARQUET);
-
--- 导出查询结果为 CSV（带压缩）
-COPY INTO VOLUME my_oss_volume
-SUBDIRECTORY 'export/2024/'
-FROM (SELECT * FROM orders WHERE year = 2024)
-FILE_FORMAT = (TYPE = CSV COMPRESSION = 'GZIP');
-
--- 导出到 User Volume
-COPY INTO USER VOLUME
-SUBDIRECTORY 'my_export/'
-FROM TABLE my_table
-FILE_FORMAT = (TYPE = CSV);
-
--- 导出到 Table Volume
-COPY INTO TABLE VOLUME my_table
-SUBDIRECTORY 'backup/'
-FROM TABLE my_table
-FILE_FORMAT = (TYPE = PARQUET);
-```
-
-> ⚠️ `COPY INTO VOLUME` 导出使用 `FILE_FORMAT = (TYPE = CSV/PARQUET)`，不是 `USING CSV`。
-> `USING` 关键字仅用于 `SELECT FROM VOLUME` 查询文件。
-
-### 导出到本地（GET 命令）
-
-```sql
--- 从 Volume 下载文件到本地
-GET VOLUME my_oss_volume FILE 'export/data.csv' TO '/local/output/';
-
--- 从 User Volume 下载
-GET USER VOLUME FILE 'my_export/data.csv' TO '/local/output/';
-```
-
-### 通过 Studio 导出
-
-在 Lakehouse Studio 中：
-- 执行 SQL 查询后，点击结果区域的「导出」按钮，可导出为 CSV 或 Excel 文件
-- 支持导出最多 10 万行查询结果
-
----
-
-## 删除 Volume
-
-```sql
-DROP VOLUME IF EXISTS my_oss_volume;
-```
-
----
-
-## 常见问题
-
-| 问题 | 原因 | 解决方案 |
-|---|---|---|
-| SHOW VOLUME DIRECTORY 无文件 | 目录未刷新 | 执行 `ALTER VOLUME name REFRESH` |
-| SELECT FROM VOLUME 报错 | 格式不匹配 | 确认 USING 后的格式与实际文件格式一致；使用 `FILES()` 指定文件 |
-| COPY INTO 读取多格式文件失败 | Volume 中有混合格式文件 | 使用 `FILES('xxx.csv')` 指定文件或 `SUBDIRECTORY` 指定子目录 |
-| PUT 命令失败 | 本地路径不存在 | 确认本地文件路径正确 |
-| COPY INTO 报错 | 权限不足 | 检查 STORAGE CONNECTION 的访问密钥权限 |
-| `@volume` 语法报错 | ClickZetta 不支持 | 使用 `FROM VOLUME name USING format` 完整语法 |
-| `data:key` 语法报错 | Snowflake JSON 语法不适用 | 使用 `data['key']` 语法访问 JSON 嵌套字段 |
-| `METADATA$FILENAME` 报错 | ClickZetta 不支持此元数据字段 | 使用字符串字面量或在 INSERT 时手动添加文件路径列 |
-
----
-
-## Snowflake 迁移对照
-
-| Snowflake 语法 | ClickZetta 等价语法 | 说明 |
-|---|---|---|
-| `@my_stage` | `VOLUME my_volume` | Stage → Volume |
-| `SELECT * FROM @stage/path` | `SELECT * FROM VOLUME vol USING CSV SUBDIRECTORY 'path/'` | 必须指定 USING 格式 |
-| `data:key::STRING` | `data['key']` | JSON 字段访问 |
-| `data:nested.key` | `data['nested']['key']` | 嵌套 JSON 访问 |
-| `METADATA$FILENAME` | 不支持 | 需手动添加文件路径列 |
-| `METADATA$FILE_ROW_NUMBER` | 不支持 | 无等价功能 |
-| `FILE_FORMAT = (TYPE = CSV)` | `USING CSV OPTIONS(...)` | 导入时用 USING，导出时用 FILE_FORMAT |
-| `COPY INTO table FROM @stage` | `COPY INTO table FROM VOLUME vol USING format` | 导入语法 |
-| `COPY INTO @stage FROM table` | `COPY INTO VOLUME vol SUBDIRECTORY '/' FROM TABLE t FILE_FORMAT=(...)` | 导出语法 |