@clickzetta/cz-cli-linux-x64 0.3.0 → 0.3.1

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

@@ -0,0 +1,172 @@
+---
+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

@@ -0,0 +1,350 @@
+# 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 天