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

package/bin/skills/clickzetta-sql-syntax-guide/SKILL.md

@@ -1,172 +0,0 @@
----
-name: clickzetta-sql-syntax-guide
-description: |
-  ClickZetta Lakehouse SQL 语法完整参考，以及从 Snowflake、Databricks、Spark SQL 迁移的
-  全面兼容性指南。覆盖 DDL/DML/DQL 完整语法、隐式类型转换规则、迁移陷阱速查。
-  帮助从 Snowflake 或 Databricks 迁移的用户快速找到正确语法，避免常见错误。
-  当用户说"Snowflake 迁移"、"Databricks 迁移"、"Spark SQL 迁移"、"语法差异"、
-  "ClickZetta 怎么写"、"TARGET_LAG"、"QUALIFY"、"VARIANT"、"METADATA$ACTION"、
-  "CREATE OR REPLACE"、"LISTAGG"、"IFF"、"DATEADD"、"FLATTEN"、"PIVOT"、
-  "SQL 语法参考"、"数据类型"、"DATEDIFF"、"CHARINDEX"、"ZEROIFNULL"、
-  "OBJECT_CONSTRUCT"、"ARRAY_SIZE"、"APPLY CHANGES INTO"、"ZORDER"、
-  "WHEN NOT MATCHED BY SOURCE"、"WITH RECURSIVE"、"BEGIN TRANSACTION"、
-  "隐式转换"、"implicit cast"、"日期写入"、"BOOLEAN 写入"、"UNION"、"INTERSECT"、
-  "EXCEPT"、"集合运算"、"STRUCT AS"、"named_struct"、"JSON"、"半结构化"、
-  "大宽表"、"VARIANT"、"JSON 字段"、"灵活 Schema"、"客户案例"时触发。
-  Keywords: SQL syntax, DDL, DML, DQL, migration, Snowflake, Databricks, Spark SQL, compatibility
----
-
-# ClickZetta Lakehouse SQL 语法指南
-
-## 参考文档索引
-
-| 文档 | 内容 |
-|---|---|
-| [Snowflake 迁移指南](references/migration-snowflake.md) | 对象映射、类型转换、语法差异、函数对照（完整） |
-| [Databricks 迁移指南](references/migration-databricks.md) | Delta Lake 差异、APPLY CHANGES、ZORDER 替代方案 |
-| [DDL 参考](references/ddl-reference.md) | Schema/Table/View/Index/Time Travel 完整语法 |
-| [DML 参考](references/dml-reference.md) | INSERT/UPDATE/DELETE/MERGE/COPY INTO + 类型转换规则 |
-| [DQL 参考](references/dql-reference.md) | SELECT/JOIN/窗口函数/CTE/JSON/ARRAY/LATERAL VIEW |
-| [函数参考](references/functions-reference.md) | 数值/字符串/日期/条件/聚合/向量函数完整列表 |
-| [vs Snowflake](references/vs-snowflake.md) | 差异汇总（含隐式转换规则表） |
-| [vs Spark SQL](references/vs-spark.md) | 数据类型映射 + 语法差异汇总 |
-| [JSON 实战指南](references/json-use-cases.md) | JSON 字段代替大宽表客户案例与最佳实践 |
-
----
-
-## ⚠️ 最常见迁移陷阱（速查）
-
-| 场景 | Snowflake / Spark | ClickZetta 正确写法 |
-|---|---|---|
-| 替换普通表 | `CREATE OR REPLACE TABLE t` | `CREATE TABLE IF NOT EXISTS t`（普通表不支持 OR REPLACE；Dynamic Table / View / MV 支持） |
-| OR REPLACE + IF NOT EXISTS | `CREATE OR REPLACE TABLE IF NOT EXISTS t` | ❌ 两者不能同时使用，会报错 |
-| 动态表刷新 | `TARGET_LAG = '1 hour'` (SF) | `PROPERTIES ('target_lag' = '1 hour', 'warehouse' = 'vc')` |
-| Stream 元数据 | `METADATA$ACTION` | `__change_type` |
-| 对象存储导入 | `COPY INTO t FROM @stage` | `COPY INTO t FROM VOLUME v USING CSV` |
-| 窗口过滤 | `QUALIFY ROW_NUMBER() = 1` | `QUALIFY ROW_NUMBER() = 1` ✅ ClickZetta 也支持！ |
-| 数组展开 | `LATERAL FLATTEN(input => arr)` (SF) | `LATERAL VIEW EXPLODE(arr)` |
-| 半结构化访问 | `data:key` (SF) | `data['key']` |
-| 列表聚合 | `LISTAGG(col, ',')` (SF) | `GROUP_CONCAT(col SEPARATOR ',')` |
-| 条件函数 | `IFF(cond, a, b)` (SF) | `IF(cond, a, b)` |
-| 日期加减 | `DATEADD(day, 7, dt)` (SF) | `DATEADD(day, 7, dt)` ✅ 也支持；或用 `DATE_ADD(dt, 7)` |
-| DATEDIFF 顺序 | `DATEDIFF(day, start, end)` (SF) | `DATEDIFF(day, start, end)` ✅ 三参数形式也支持；或 `DATEDIFF(end, start)` 两参数形式（返回天数） |
-| 查找子串位置 | `CHARINDEX(sub, s)` (SF) | `INSTR(s, sub)` ← 参数顺序相反！ |
-| 不区分大小写匹配 | `ILIKE` (SF) | `ILIKE` ✅ ClickZetta 也支持！ |
-| 差集运算 | `MINUS` (Oracle/DB2) | `MINUS` ✅ ClickZetta 也支持！ |
-| 递归 CTE | `WITH RECURSIVE` (SF/Databricks) | ❌ 不支持，需用 Python/ZettaPark 替代 |
-| **⚠️ 时间戳字符串写入** | `INSERT INTO t VALUES (1, '2026-05-01 10:00:00')` | ❌ **报错**：必须显式转换 `CAST('2026-05-01 10:00:00' AS TIMESTAMP)` 或 `TIMESTAMP '2026-05-01 10:00:00'` |
-| 集合运算 | `UNION` / `UNION ALL` / `INTERSECT` / `EXCEPT` | ✅ 全部支持 |
-| 事务 | `BEGIN; COMMIT; ROLLBACK;` | ❌ 不支持，用 MERGE 实现原子操作 |
-| MERGE 不匹配删除 | `WHEN NOT MATCHED BY SOURCE THEN DELETE` | ❌ 不支持，需两步：MERGE + DELETE |
-| Delta ZORDER | `OPTIMIZE t ZORDER BY (col)` | `OPTIMIZE t`（只做小文件合并，无 ZORDER） |
-| STRUCT 命名字段 | `STRUCT(1 AS id, 'Alice' AS name)` | `named_struct('id', 1, 'name', 'Alice')` ✅ |
-| SEQUENCE 对象 | `CREATE SEQUENCE seq` | ❌ 不支持，用 `IDENTITY(1)` 列替代 |
-| IDENTITY 列类型 | `id INT IDENTITY` | `id BIGINT IDENTITY`（IDENTITY 只支持 BIGINT，INT/SMALLINT 会报错） |
-| 当前时间函数 | `NOW()` | `NOW()` ✅ ClickZetta 也支持！也可用 `CURRENT_TIMESTAMP()` |
-| 布尔类型名称 | `BOOL` | `BOOLEAN`（ClickZetta 不支持 BOOL 简写） |
-| 字符串类型 | `VARCHAR(n)` | 推荐用 `STRING`（无长度限制，最大 16MB）；`VARCHAR(n)` 也支持但不推荐 |
-| 数值类型 | `NUMBER(p,s)` (SF) | `DECIMAL(p,s)` |
-| 半结构化类型 | `VARIANT` (SF) | `JSON` |
-| 行数限制 | `SELECT TOP 10` (SF) | `SELECT ... LIMIT 10` |
-| NULL转0 | `ZEROIFNULL(x)` (SF) | `COALESCE(x, 0)` |
-| 0转NULL | `NULLIFZERO(x)` (SF) | `NULLIF(x, 0)` |
-| 对象聚合 | `OBJECT_AGG(k, v)` (SF) | `MAP_AGG(k, v)` |
-| 数组大小 | `ARRAY_SIZE(arr)` (SF) | `SIZE(arr)` |
-| PIVOT | 原生 PIVOT 语法 (SF) | `CASE WHEN` 手动实现 |
-| 临时表 | `CREATE TEMPORARY TABLE` (SF) | 不支持，用 CTE 替代 |
-| 日期字符串写入 | `INSERT ... VALUES (..., '2024-01-15', ...)` | `CAST('2024-01-15' AS DATE)` 或 `DATE '2024-01-15'` 或 `TO_DATE(...)` |
-| 时间字符串写入 | `INSERT ... VALUES (..., '2024-01-15 12:00:00', ...)` | `CAST(... AS TIMESTAMP)` 或 `TIMESTAMP '...'` 或 `TO_TIMESTAMP(...)` |
-| BOOLEAN 写入 | `INSERT ... VALUES (..., 'true', ...)` 或 `..., 1, ...` | `TRUE` / `FALSE` 或 `CAST(1 AS BOOLEAN)` |
-| JSON 写入 | `INSERT ... VALUES (..., '{"k":1}', ...)` | `PARSE_JSON('{"k":1}')` 或 `CAST(... AS JSON)` |
-| 字符串写入数字列 | `INSERT ... VALUES (..., '123', ...)` | `CAST('123' AS INT)` |
-| UPDATE 同样限制 | `UPDATE t SET dt = '2024-01-01'` | `UPDATE t SET dt = CAST('2024-01-01' AS DATE)` |
-| WHERE 中可以 | 不适用 | `WHERE dt = '2024-01-01'` ✅ WHERE 中字符串可隐式比较 |
-| 索引语法关键字 | `USING BLOOM_FILTER` | `BLOOMFILTER`（无 USING）；向量/倒排建表内联时用 `USING VECTOR` / `USING INVERTED` |
-| DROP INDEX | `DROP INDEX idx ON table` | `DROP INDEX idx`（无 ON table） |
-| TRUNCATE IF EXISTS | `TRUNCATE TABLE IF EXISTS t` | `TRUNCATE TABLE IF EXISTS t` ✅ ClickZetta 也支持！ |
-| MERGE 多 MATCHED 顺序 | DELETE 可在 UPDATE 前 | UPDATE 必须在 DELETE 之前 |
-| 同义词 | `CREATE SYNONYM s FOR t` (Oracle) | `CREATE SYNONYM s FOR TABLE t` ✅ 支持 TABLE/VOLUME/FUNCTION 三种对象 |
-
----
-
-## 数据类型速查
-
-```sql
--- 数值
-TINYINT / SMALLINT / INT / BIGINT
-FLOAT / DOUBLE
-DECIMAL(p, s)          -- 精确数值（Snowflake 用 NUMBER）
-
--- 字符串
-STRING                 -- 推荐，无长度限制
-VARCHAR(n)             -- 最大 65533 字符
-CHAR(n)                -- 定长，1-255
-
--- 时间
-DATE                   -- YYYY-MM-DD
-TIMESTAMP              -- 带本地时区（≈ Snowflake TIMESTAMP_LTZ）
-TIMESTAMP_NTZ          -- 无时区（同 Snowflake TIMESTAMP_NTZ）
-
--- 布尔 / 二进制
-BOOLEAN / BINARY
-
--- 半结构化
-JSON                   -- 替代 Snowflake VARIANT
-ARRAY<T>               -- 需指定元素类型，如 ARRAY<INT>
-MAP<K, V>              -- 如 MAP<STRING, INT>
-STRUCT<f1:T1, f2:T2>   -- 结构体
-
--- AI 专用
-VECTOR(FLOAT, 1024)    -- 向量类型（ClickZetta 特有）
-```
-
----
-
-## ClickZetta 特有对象（Snowflake/Spark 无对应）
-
-```sql
--- 计算集群
-CREATE VCLUSTER my_vc VCLUSTER_TYPE = ANALYTICS VCLUSTER_SIZE = 4;
-USE VCLUSTER my_vc;
-
--- 动态表（增量计算）
-CREATE DYNAMIC TABLE sales_daily
-    REFRESH INTERVAL 5 MINUTE VCLUSTER default_ap
-AS SELECT DATE(created_at) AS dt, SUM(amount) AS total FROM orders GROUP BY 1;
-
--- Table Stream（CDC）
-CREATE TABLE STREAM orders_stream ON TABLE orders
-    WITH PROPERTIES ('TABLE_STREAM_MODE' = 'STANDARD');
--- 元数据字段：__change_type（INSERT/UPDATE_BEFORE/UPDATE_AFTER/DELETE）
-
--- Pipe（持续导入）
-CREATE PIPE oss_pipe
-    AS COPY INTO orders FROM VOLUME my_volume USING CSV OPTIONS('header'='true');
-
--- Volume（对象存储）
-CREATE EXTERNAL VOLUME my_vol
-    LOCATION 'oss://bucket/path'
-    USING CONNECTION my_oss_conn;
-
--- Share（跨实例数据共享）
-CREATE SHARE my_share;
-GRANT SELECT, READ METADATA ON TABLE public.orders TO SHARE my_share;
-
--- Synonym（同义词，为对象创建别名）
-CREATE SYNONYM my_orders FOR TABLE other_schema.orders;
-CREATE SYNONYM my_vol FOR VOLUME other_schema.data_volume;
-CREATE SYNONYM my_func FOR FUNCTION other_schema.udf_name;
-DROP SYNONYM my_orders FOR TABLE;
-SHOW SYNONYMS;
-
--- Time Travel
-SELECT * FROM orders TIMESTAMP AS OF '2024-01-01 00:00:00';
-RESTORE TABLE orders TO TIMESTAMP AS OF '2024-01-01 00:00:00';
-UNDROP TABLE orders;
-
--- 向量检索
-CREATE TABLE docs (id INT, vec VECTOR(FLOAT, 1024),
-    INDEX vec_idx (vec) USING VECTOR PROPERTIES ("distance.function"="cosine_distance"));
-SELECT id, cosine_distance(vec, CAST('[0.1,0.2,...]' AS VECTOR(1024))) AS dist
-FROM docs ORDER BY dist LIMIT 10;
-```

package/bin/skills/clickzetta-sql-syntax-guide/references/ddl-reference.md

@@ -1,350 +0,0 @@
-# DDL 完整语法参考
-
-> 基于 ClickZetta Lakehouse 产品文档整理，含与 Snowflake / Spark SQL 的差异标注
-
----
-
-## SCHEMA 操作
-
-```sql
--- 创建
-CREATE SCHEMA IF NOT EXISTS my_schema COMMENT '说明';
-
--- 修改
-ALTER SCHEMA my_schema RENAME TO new_schema;
-ALTER SCHEMA my_schema SET COMMENT '新注释';
-
--- 删除（级联删除所有对象）
-DROP SCHEMA IF EXISTS my_schema;
-
--- 查看
-SHOW SCHEMAS;
-SHOW SCHEMAS EXTENDED;                          -- 含 type 列（MANAGED/EXTERNAL）
-SHOW SCHEMAS LIKE 'sales%';
-SHOW SCHEMAS WHERE schema_name = 'public';
-
--- 切换
-USE SCHEMA my_schema;
-USE my_schema;                                  -- SCHEMA 关键字可省略
-```
-
-**与 Snowflake 差异：**
-- Snowflake 用 `USE DATABASE` + `USE SCHEMA`；ClickZetta 无 DATABASE 层，直接 `USE SCHEMA`
-- Snowflake 支持 `CREATE OR REPLACE SCHEMA`；ClickZetta 不支持，用 `IF NOT EXISTS`
-
----
-
-## TABLE 操作
-
-### CREATE TABLE
-
-```sql
--- 基本建表
-CREATE TABLE IF NOT EXISTS orders (
-    id          BIGINT,
-    customer_id INT,
-    amount      DECIMAL(18, 2)  NOT NULL,
-    status      STRING          DEFAULT 'pending',
-    created_at  TIMESTAMP,
-    tags        ARRAY<STRING>,
-    meta        JSON,
-    COMMENT '订单表'
-);
-
--- 主键表（ENABLE VALIDATE RELY：SQL写入也去重）
-CREATE TABLE pk_orders (
-    id     BIGINT PRIMARY KEY,
-    amount DECIMAL(18, 2)
-);
-
--- 主键表（DISABLE NOVALIDATE RELY：仅实时写入去重，SQL写入不去重）
-CREATE TABLE cdc_orders (
-    id     BIGINT PRIMARY KEY DISABLE NOVALIDATE RELY,
-    amount DECIMAL(18, 2)
-);
-
--- 自增列（仅 BIGINT，不保证连续）
-CREATE TABLE auto_id_table (
-    id  BIGINT IDENTITY(1),    -- 从1开始
-    col STRING
-);
-
--- 生成列（确定性表达式，不可手动插入）
-CREATE TABLE orders_with_year (
-    id         BIGINT,
-    created_at TIMESTAMP,
-    year       INT GENERATED ALWAYS AS (YEAR(created_at))
-);
-
--- 默认值（支持非确定性函数）
-CREATE TABLE t_default (
-    id         INT,
-    created_at TIMESTAMP DEFAULT current_timestamp(),
-    status     STRING    DEFAULT 'active',
-    score      DOUBLE    DEFAULT random()
-);
-
--- 分区表（Iceberg 隐藏分区）
-CREATE TABLE orders_partitioned (
-    id         BIGINT,
-    amount     DECIMAL(18, 2),
-    created_at TIMESTAMP
-)
-PARTITIONED BY (days(created_at));             -- 按天分区
-
--- 分区转换函数
--- years(col)   months(col)   days(col)   hours(col)
--- bucket(N, col)   truncate(col, W)
-
--- 分桶表
-CREATE TABLE orders_bucketed (
-    id         BIGINT,
-    customer_id INT,
-    amount     DECIMAL(18, 2)
-)
-CLUSTERED BY (customer_id)
-SORTED BY (id ASC)
-INTO 16 BUCKETS;
-
--- 数据保留周期
-CREATE TABLE orders (id BIGINT)
-PROPERTIES ('data_lifecycle' = '30');          -- 保留30天
-
--- CTAS（从查询建表）
-CREATE TABLE orders_copy AS
-SELECT * FROM orders WHERE status = 'completed';
-
--- 外部表（映射对象存储）
-CREATE EXTERNAL TABLE ext_orders (
-    id     BIGINT,
-    amount DECIMAL(18, 2)
-)
-LOCATION 'oss://bucket/orders/'
-STORED AS PARQUET;
-```
-
-**与 Snowflake 差异：**
-- Snowflake `CREATE OR REPLACE TABLE` → ClickZetta `CREATE TABLE IF NOT EXISTS`
-- Snowflake `CLUSTER BY (col)` → ClickZetta `CLUSTERED BY (col) INTO N BUCKETS`
-- Snowflake `AUTOINCREMENT` → ClickZetta `IDENTITY[(seed)]`
-- Snowflake `TRANSIENT TABLE` → ClickZetta 无对应（用 `data_lifecycle` 控制保留期）
-- Snowflake `TEMPORARY TABLE` → ClickZetta 无临时表概念
-- Snowflake `COPY GRANTS` → ClickZetta 不支持
-
-**与 Spark SQL 差异：**
-- Spark `USING PARQUET` → ClickZetta 不需要（默认 Parquet）
-- Spark `TBLPROPERTIES` → ClickZetta `PROPERTIES`
-- Spark `LOCATION` 外部表语法基本相同
-
-### ALTER TABLE
-
-```sql
--- 重命名
-ALTER TABLE orders RENAME TO orders_v2;
-
--- 注释
-ALTER TABLE orders SET COMMENT '新注释';
-
--- 数据保留周期
-ALTER TABLE orders SET PROPERTIES ('data_retention_days' = '7');
-
--- 添加列
-ALTER TABLE orders ADD COLUMN region STRING AFTER status;
-ALTER TABLE orders ADD COLUMN region STRING FIRST;
-
--- 添加复杂类型嵌套字段
-ALTER TABLE t ADD COLUMN address.zip STRING;           -- STRUCT 嵌套
-ALTER TABLE t ADD COLUMN items.ELEMENT.price DOUBLE;   -- ARRAY<STRUCT> 嵌套
-
--- 修改列类型（有限制）
-ALTER TABLE orders ALTER COLUMN amount TYPE DOUBLE;
-
--- 重命名列
-ALTER TABLE orders RENAME COLUMN old_col TO new_col;
-
--- 删除列
-ALTER TABLE orders DROP COLUMN unnecessary_col;
-
--- 修改列注释
-ALTER TABLE orders ALTER COLUMN amount COMMENT '订单金额';
-
--- 添加索引（含 ARRAY/JSON 列的表必须单独添加）
--- ⚠️ 索引语法：BLOOMFILTER（不是 USING BLOOM_FILTER）
-CREATE BLOOMFILTER INDEX IF NOT EXISTS id_bf ON TABLE orders(id);
-CREATE BLOOMFILTER INDEX IF NOT EXISTS name_bf ON TABLE orders(name)
-    PROPERTIES ('analyzer' = 'ngram', 'n' = '3');  -- ngram 分词
-
--- 倒排索引
-CREATE INVERTED INDEX IF NOT EXISTS content_inv ON TABLE articles(content);
-
--- 向量索引（建表时内联）
--- 见 CREATE TABLE 示例
-
--- 删除索引（⚠️ 不需要 ON table_name）
-DROP INDEX IF EXISTS id_bf;
-DROP INDEX id_bf;
-```
-
-**与 Snowflake 差异：**
-- Snowflake `ALTER TABLE ... ADD COLUMN` 只能加到末尾；ClickZetta 支持 `FIRST/AFTER/BEFORE`
-- Snowflake 不支持 `DROP COLUMN`（需重建表）；ClickZetta 支持
-- Snowflake 无 BLOOM_FILTER/INVERTED/VECTOR 索引
-
-### DROP / TRUNCATE TABLE
-
-```sql
--- 删除表（可 UNDROP 恢复）
-DROP TABLE IF EXISTS orders;
-DROP TABLE my_schema.orders;
-
--- 清空表（保留结构）
-TRUNCATE TABLE orders;
-TRUNCATE TABLE IF EXISTS orders;               -- ✅ 支持 IF EXISTS
-
--- 清空指定分区
-TRUNCATE TABLE orders PARTITION (dt = '2024-01-01');
-TRUNCATE TABLE orders PARTITION (dt > '2024-01-01');
-TRUNCATE TABLE orders PARTITION (dt >= '2024-01-01' AND dt < '2024-02-01');
-```
-
-**与 Snowflake 差异：**
-- Snowflake `TRUNCATE TABLE` 不支持分区条件；ClickZetta 支持
-- Snowflake `DROP TABLE ... PURGE` 立即删除；ClickZetta 删除后在保留期内可 UNDROP
-
----
-
-## VIEW 操作
-
-```sql
--- 创建视图
-CREATE VIEW IF NOT EXISTS order_summary AS
-SELECT customer_id, COUNT(*) AS cnt, SUM(amount) AS total
-FROM orders GROUP BY customer_id;
-
--- 替换视图（ClickZetta 支持 OR REPLACE，与 Snowflake 相同）
-CREATE OR REPLACE VIEW order_summary AS
-SELECT customer_id, SUM(amount) AS total FROM orders GROUP BY customer_id;
-
--- 带列别名和注释
-CREATE VIEW order_summary (cust_id COMMENT '客户ID', total COMMENT '总金额')
-COMMENT '订单汇总视图'
-AS SELECT customer_id, SUM(amount) FROM orders GROUP BY 1;
-
--- 删除
-DROP VIEW IF EXISTS order_summary;
-
--- 查看
-SHOW TABLES WHERE is_view = true;
-SHOW TABLES IN my_schema WHERE is_view = true;
-```
-
-**注意：** ClickZetta 的 `CREATE OR REPLACE VIEW` 与 Snowflake 相同，但 `CREATE OR REPLACE TABLE` 不支持。
-
----
-
-## INDEX 操作
-
-```sql
--- 查看索引
-SHOW INDEX FROM table_name;
-SHOW INDEX FROM my_schema.table_name;
-
--- 查看索引详情
-DESC INDEX index_name;
-DESC INDEX EXTENDED index_name;
-
--- 构建存量数据索引（仅向量索引和倒排索引，不支持 Bloom Filter）
-BUILD INDEX index_name ON table_name;
-BUILD INDEX index_name ON table_name WHERE partition_col = '2024-01-01';
-```
-
----
-
-## 查看对象信息
-
-```sql
--- 表结构
-DESC table_name;
-DESC EXTENDED table_name;                      -- 含大小、记录数等扩展信息
-DESCRIBE TABLE table_name;                     -- 同 DESC
-
--- 列信息
-SHOW COLUMNS IN table_name;
-SHOW COLUMNS FROM table_name IN schema_name;
-
--- 建表语句
-SHOW CREATE TABLE table_name;
-
--- 表列表
-SHOW TABLES;
-SHOW TABLES IN my_schema;
-SHOW TABLES LIKE 'order%';
-SHOW TABLES WHERE is_view = false AND is_materialized_view = false;
-SHOW TABLES WHERE is_dynamic = true;
-SHOW TABLES WHERE is_external = true;
-
--- 分区信息
-SHOW PARTITIONS table_name;
-SHOW PARTITIONS EXTENDED table_name;           -- 含文件数、大小、修改时间
-SHOW PARTITIONS table_name PARTITION (dt = '2024-01-01');
-SHOW PARTITIONS table_name WHERE total_rows > 1000;
-
--- 历史版本
-DESC HISTORY table_name;
-SHOW TABLES HISTORY;                           -- 含已删除的表
-```
-
----
-
-## SYNONYM（同义词）操作
-
-```sql
--- 为表创建同义词（跨 Schema 访问）
-CREATE SYNONYM my_orders FOR TABLE other_schema.orders;
-
--- 为 Volume 创建同义词
-CREATE SYNONYM my_vol FOR VOLUME other_schema.data_volume;
-
--- 为函数创建同义词
-CREATE SYNONYM my_func FOR FUNCTION other_schema.udf_name;
-
--- 查看同义词
-SHOW SYNONYMS;
-SHOW SYNONYMS IN my_schema;
-SHOW SYNONYMS LIKE 'my_%';
-
--- 删除同义词（需指定对象类型）
-DROP SYNONYM my_orders FOR TABLE;
-DROP SYNONYM my_vol FOR VOLUME;
-DROP SYNONYM my_func FOR FUNCTION;
-```
-
-> 同义词支持的对象类型：TABLE（含普通表、Table Stream、物化视图、动态表）、VOLUME、FUNCTION。
-> 使用场景：跨 Schema 访问、数据一致性维护、应用层解耦。
-
----
-
-## Time Travel & 数据恢复
-
-```sql
--- 查询历史版本
-SELECT * FROM orders TIMESTAMP AS OF '2024-01-01 00:00:00';
-SELECT * FROM orders TIMESTAMP AS OF CURRENT_TIMESTAMP() - INTERVAL 12 HOURS;
-SELECT * FROM orders TIMESTAMP AS OF CAST('2024-01-01' AS TIMESTAMP);
-
--- 恢复表到历史版本（表未删除）
-RESTORE TABLE orders TO TIMESTAMP AS OF '2024-01-01 00:00:00';
-
--- 恢复已删除的表
-UNDROP TABLE orders;
-UNDROP TABLE my_schema.orders;
-
--- 设置保留周期（0-90天，默认1天）
-ALTER TABLE orders SET PROPERTIES ('data_retention_days' = '7');
-```
-
-**与 Snowflake 差异：**
-- Snowflake `AT (TIMESTAMP => ...)` → ClickZetta `TIMESTAMP AS OF ...`
-- Snowflake `BEFORE (STATEMENT => ...)` → ClickZetta 不支持按 statement_id 回溯
-- Snowflake `UNDROP TABLE` → ClickZetta 相同
-- Snowflake 默认保留 1 天（Enterprise 90 天）；ClickZetta 默认 1 天，最长 90 天