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

package/bin/skills/clickzetta-sql-pipeline-manager/SKILL.md

@@ -0,0 +1,353 @@
+---
+name: clickzetta-sql-pipeline-manager
+description: >
+  管理 ClickZetta Lakehouse 的 SQL 数据管道对象，包括动态表（Dynamic Table）、
+  物化视图（Materialized View）、表流（Table Stream）和 Pipe。
+  覆盖创建、修改、暂停/恢复、删除、查看状态等完整生命周期操作。
+  仅涉及 SQL 命令操作，不涉及 Lakehouse Studio 图形化界面。
+
+  当用户说"创建动态表"、"创建物化视图"、"创建 Pipe"、"创建表流"、
+  "暂停/恢复动态表"、"查看刷新历史"、"修改刷新频率"、"接入 Kafka"、
+  "从对象存储持续导入"、"CDC 变更捕获"、"增量计算"、"实时 ETL"、
+  "数据管道"、"pipeline"、"流式处理"、"动态表刷新失败"、
+  "帮我设计 ETL"、"构建数据管道"、"数据接入方案"、
+  "Medallion Architecture"、"Bronze Silver Gold"、"奖章架构"、
+  "湖仓分层"、"Bronze 层"、"Silver 层"、"Gold 层"时触发。
+  Keywords: SQL pipeline, dynamic table, materialized view, table stream, Pipe, data pipeline
+---
+
+# ClickZetta SQL 数据管道管理
+
+## ⚠️ ClickZetta 与标准 SQL / Snowflake 的关键语法差异
+
+这些是最容易写错的地方，必须使用 ClickZetta 特有语法：
+
+| 功能 | ❌ 错误写法（Snowflake/标准SQL） | ✅ ClickZetta 正确写法 |
+|---|---|---|
+| 动态表计算集群 | `WAREHOUSE = compute_wh` | `VCLUSTER default`（直接跟名称，不带等号） |
+| 动态表刷新调度 | `TARGET_LAG = '1 minutes'` | `REFRESH INTERVAL 1 MINUTE vcluster default` |
+| Kafka 读取函数 | `KAFKA_SOURCE(...)` | `READ_KAFKA(KAFKA_BROKER => ..., KAFKA_DATA_FORMAT => 'json')` |
+| 物化视图定时刷新 | `REFRESH EVERY 1 HOUR` | `REFRESH INTERVAL 60 MINUTE vcluster default`（与动态表语法相同） |
+| 物化视图手动刷新 | `REFRESH MATERIALIZED VIEW` 放在 CREATE 里 | 单独执行 `REFRESH MATERIALIZED VIEW <name>;` |
+| 修改动态表 SQL | `ALTER DYNAMIC TABLE ... AS ...` | `CREATE OR REPLACE DYNAMIC TABLE ...`（ALTER 不支持修改 AS 子句） |
+
+---
+
+## Pipeline Wizard（管道设计向导）
+
+当用户想设计或构建一个完整的数据管道时，这是最高优先级的模式。触发词包括：
+"帮我设计/构建 ETL"、"完整的数据管道"、"从 Kafka/OSS 接入数据"、"ODS→DWD→DWS"、"端到端 pipeline"、
+"Medallion Architecture"、"Bronze/Silver/Gold"、"奖章架构"、"湖仓分层"。
+
+### 层次命名约定
+
+用户可能使用不同的分层命名，含义相同，按用户偏好保留原始命名：
+
+| 用户说的 | 含义 | Schema 命名建议 |
+|---|---|---|
+| Bronze / Silver / Gold | Medallion Architecture | `bronze` / `silver` / `gold` |
+| ODS / DWD / DWS | 国内数仓分层惯例 | `ods` / `dwd` / `dws` |
+| Raw / Cleansed / Aggregated | 通用英文描述 | `raw` / `cleansed` / `agg` |
+
+**不要把 Bronze 映射成 ODS、Silver 映射成 DWD 等——保留用户选择的命名，在 SQL 中直接使用对应的 schema 和表名前缀。**
+
+**Schema 命名必须加业务/项目前缀，避免与其他项目冲突。** 如果用户未提供前缀，询问项目名称或业务域名称，然后生成带前缀的 Schema 名：
+
+```sql
+-- ❌ 容易重名，不要这样生成
+CREATE SCHEMA IF NOT EXISTS bronze;
+
+-- ✅ 加项目前缀
+CREATE SCHEMA IF NOT EXISTS ecommerce_bronze;
+CREATE SCHEMA IF NOT EXISTS ecommerce_silver;
+CREATE SCHEMA IF NOT EXISTS ecommerce_gold;
+```
+
+### 需求收集
+
+**如果用户已经提供了足够信息（数据来源、字段、层次需求、项目前缀），直接生成完整 SQL，不要再问。**
+
+如果信息不完整，一次性问清楚以下 5 点（合并成一个问题，不要逐一追问）：
+
+> 为了生成完整的 pipeline SQL，需要确认几个信息：
+> 1. **项目/业务前缀**：Schema 名称的前缀是什么（如 `ecommerce`、`risk`、`ads`）？多个项目共用 Workspace 时必须加前缀避免冲突。
+> 2. **数据来源**：Kafka（broker/topic）/ 对象存储（Volume 路径/格式）/ 已有表（是否有 UPDATE/DELETE）？
+> 3. **字段结构**：目标表的字段名和类型？
+> 4. **层次需求**：需要几层？每层做什么处理（清洗/聚合/维度建模）？
+> 5. **刷新频率**：实时（秒级）/ 近实时（分钟级）/ 低频（小时/天）？
+
+### 生成完整 SQL
+
+收到回答后，生成完整的端到端 SQL，包含以下所有部分：
+
+```
+1. Schema 创建（CREATE SCHEMA IF NOT EXISTS，使用用户指定的层次名称）
+2. 入口层建表（如果是外部摄入）
+3. 数据入口（Pipe 或 Table Stream，根据来源选择）
+4. 中间层动态表（清洗/过滤，REFRESH interval N MINUTE VCLUSTER name）
+5. 服务层动态表（聚合/维度，REFRESH interval N MINUTE VCLUSTER name）
+6. 验证命令（SHOW + REFRESH HISTORY）
+7. 运维操作（SUSPEND/RESUME）
+```
+
+**来源 → 入口对象的选择规则：**
+- Kafka → `CREATE PIPE ... AS INSERT INTO ... FROM TABLE(READ_KAFKA(...))`
+- 对象存储（OSS/S3/COS）→ `CREATE PIPE ... VIRTUAL_CLUSTER = name INGEST_MODE = LIST_PURGE AS COPY INTO ... FROM VOLUME <volume_name> USING <format>`
+- 已有表 + 有 UPDATE/DELETE → `CREATE TABLE STREAM ... WITH PROPERTIES ('TABLE_STREAM_MODE' = 'STANDARD')`，中间层过滤 `__change_type IN ('INSERT', 'UPDATE_AFTER', 'DELETE')`
+- 已有表 + 仅 INSERT → Dynamic Table 直接 `FROM` 源表
+
+**刷新频率规则：**
+- 第一个转换层（Bronze→Silver 或 ODS→DWD）设置用户指定的刷新频率（如 `REFRESH interval 1 MINUTE VCLUSTER default`）
+- 下游层根据业务需求设置各自的刷新频率（如 `REFRESH interval 5 MINUTE VCLUSTER default`）
+
+---
+
+## 对象类型速查
+
+| 对象 | 适用场景 | 核心特点 |
+|---|---|---|
+| **Dynamic Table** | 实时/近实时增量 ETL | SQL 定义，自动增量刷新，秒/分钟级延迟 |
+| **Materialized View** | 固定聚合加速查询 | 预计算存储，手动或定时全量刷新 |
+| **Table Stream** | CDC 变更数据捕获 | 捕获 INSERT/UPDATE/DELETE，配合 Dynamic Table 消费 |
+| **Pipe** | 持续数据摄入 | 从 Kafka 或对象存储自动持续导入，无需调度 |
+
+## 决策树
+
+```
+用户需求
+├── 持续从外部摄入数据（Kafka / OSS / S3）
+│   └── → Pipe
+├── 对已有表做实时/增量转换
+│   ├── 需要感知 UPDATE/DELETE → Table Stream + Dynamic Table
+│   └── 只需 INSERT 追加 → Dynamic Table（直接查源表）
+├── 固定聚合，不要求实时
+│   └── → Materialized View
+└── 多层 ETL（ODS→DWD→DWS 或 Bronze→Silver→Gold）
+    └── → 多个 Dynamic Table 级联（各层设置独立 REFRESH interval）
+```
+
+## 步骤 0：确认连接
+
+操作前先确认已连接到 ClickZetta Lakehouse。参考 `clickzetta-lakehouse-connect` skill 获取连接参数。
+
+## 步骤 1：选择对象类型
+
+根据决策树选择对象类型，阅读对应参考文件：
+
+| 对象 | 参考文件 |
+|---|---|
+| Dynamic Table | [references/dynamic-table.md](references/dynamic-table.md) |
+| Materialized View | [references/materialized-view.md](references/materialized-view.md) |
+| Table Stream | [references/table-stream.md](references/table-stream.md) |
+| Pipe | [references/pipe.md](references/pipe.md) |
+
+## 步骤 2：生成并执行 SQL
+
+阅读对应参考文件后，根据用户提供的参数生成完整可运行 SQL。
+
+**必填参数检查：**
+- Dynamic Table：`REFRESH interval N MINUTE VCLUSTER name`、AS 查询
+- Table Stream：源表名、MODE（STANDARD 或 APPEND_ONLY）
+- Pipe（Kafka）：`KAFKA_BROKER`、`KAFKA_TOPIC`、`KAFKA_GROUP_ID`、目标表
+- Pipe（对象存储）：Volume 路径、文件格式、目标表
+
+若用户未提供 VCLUSTER，默认使用 `default`。
+
+## 步骤 3：验证
+
+```sql
+-- 验证动态表
+SHOW TABLES WHERE is_dynamic = true;
+SHOW DYNAMIC TABLE REFRESH HISTORY <name> LIMIT 5;
+
+-- 验证物化视图
+SHOW TABLES WHERE is_materialized_view = true;
+
+-- 验证 Table Stream
+SHOW TABLE STREAMS;
+SELECT COUNT(*) FROM <stream_name>;  -- 查看待消费变更数
+
+-- 验证 Pipe
+SHOW PIPES;
+```
+
+---
+
+## 典型场景示例
+
+### 场景 A：Kafka → 动态表（实时 ETL）
+
+```sql
+-- Step 1: 创建 Pipe 持续摄入 Kafka 数据到 ODS 层
+CREATE OR REPLACE PIPE kafka_orders_pipe AS
+INSERT INTO ods.orders (order_id, user_id, amount, status, created_at)
+SELECT
+  $1:order_id::STRING,
+  $1:user_id::STRING,
+  $1:amount::DECIMAL(10,2),
+  $1:status::STRING,
+  $1:created_at::TIMESTAMP
+FROM TABLE(
+  READ_KAFKA(
+    KAFKA_BROKER => 'kafka.example.com:9092',
+    KAFKA_TOPIC  => 'orders',
+    KAFKA_GROUP_ID => 'lakehouse_ingest',
+    KAFKA_OFFSET => 'latest',
+    KAFKA_DATA_FORMAT => 'json'
+  )
+);
+
+-- Step 2: 动态表做 DWD 层清洗（每分钟增量刷新）
+CREATE OR REPLACE DYNAMIC TABLE dwd.orders_clean
+  REFRESH interval 1 MINUTE
+  VCLUSTER default
+AS
+SELECT
+  order_id,
+  user_id,
+  amount,
+  UPPER(status) AS status,
+  created_at,
+  DATE(created_at) AS dt
+FROM ods.orders
+WHERE amount > 0;
+
+-- Step 3: 动态表做 DWS 层聚合（每 5 分钟刷新）
+CREATE OR REPLACE DYNAMIC TABLE dws.order_hourly
+  REFRESH interval 5 MINUTE
+  VCLUSTER default
+AS
+SELECT
+  DATE_TRUNC('hour', created_at) AS hour,
+  status,
+  COUNT(*) AS order_cnt,
+  SUM(amount) AS total_amount
+FROM dwd.orders_clean
+GROUP BY 1, 2;
+```
+
+### 场景 B：Table Stream + Dynamic Table（CDC UPSERT）
+
+```sql
+-- Step 1: 在源表上创建 Stream 捕获变更
+CREATE TABLE STREAM ods.orders_stream
+  ON TABLE ods.orders
+  WITH PROPERTIES ('TABLE_STREAM_MODE' = 'STANDARD');
+
+-- Step 2: 动态表消费 Stream，过滤出最新状态
+CREATE OR REPLACE DYNAMIC TABLE dwd.orders_latest
+  REFRESH interval 2 MINUTE
+  VCLUSTER default
+AS
+SELECT order_id, user_id, amount, status, created_at
+FROM ods.orders_stream
+WHERE __change_type IN ('INSERT', 'UPDATE_AFTER', 'DELETE');
+```
+
+### 场景 C：物化视图加速 BI 查询
+
+```sql
+-- 创建每小时刷新的物化视图
+CREATE OR REPLACE MATERIALIZED VIEW dws.mv_daily_revenue
+  COMMENT '每日收入汇总，供 BI 工具查询'
+  REFRESH INTERVAL 60 MINUTE vcluster default
+AS
+SELECT
+  DATE(created_at) AS day,
+  region,
+  SUM(amount) AS revenue,
+  COUNT(DISTINCT user_id) AS uv
+FROM dwd.orders_clean
+GROUP BY 1, 2;
+
+-- 手动触发刷新
+REFRESH MATERIALIZED VIEW dws.mv_daily_revenue;
+```
+
+### 场景 D：运维操作
+
+```sql
+-- 暂停动态表（如集群维护）
+ALTER DYNAMIC TABLE dwd.orders_clean SUSPEND;
+
+-- 恢复
+ALTER DYNAMIC TABLE dwd.orders_clean RESUME;
+
+-- 查看刷新历史排查失败
+SHOW DYNAMIC TABLE REFRESH HISTORY dwd.orders_clean LIMIT 10;
+
+-- 暂停 Pipe
+ALTER PIPE kafka_orders_pipe SET PIPE_EXECUTION_PAUSED = true;
+
+-- 恢复 Pipe
+ALTER PIPE kafka_orders_pipe SET PIPE_EXECUTION_PAUSED = false;
+```
+
+### 场景 E：参数化动态表（按分区刷新）
+
+通过 `SESSION_CONFIGS()` 函数定义参数化查询，在刷新时传入分区值控制全量或增量刷新范围：
+
+```sql
+-- 创建参数化动态表（使用 SESSION_CONFIGS 定义参数）
+CREATE OR REPLACE DYNAMIC TABLE dwd.orders_partitioned
+  REFRESH interval 30 MINUTE
+  VCLUSTER default
+AS
+SELECT order_id, user_id, amount, status, created_at, DATE(created_at) AS dt
+FROM ods.orders
+WHERE dt = SESSION_CONFIGS('target_date', CAST(CURRENT_DATE() AS STRING));
+
+-- 手动触发刷新并传入参数
+REFRESH DYNAMIC TABLE dwd.orders_partitioned
+  WITH PROPERTIES ('target_date' = '2024-06-15');
+```
+
+> **适用场景**：传统按天/按小时全量 ETL 任务改造为增量任务时，用 SESSION_CONFIGS 替换调度变量（如 `${bizdate}`），实现参数化分区刷新。
+
+### 场景 F：动态表 DML 操作（手动修正数据）
+
+动态表默认不支持 DML，需先通过 SET 命令开启，**且每次执行 DML 前都需要重新 SET**：
+
+```sql
+-- ⚠️ 必须在同一会话/批次中先执行 SET，再执行 DML
+SET cz.sql.dt.allow.dml = true;
+
+-- 手动插入补数据
+INSERT INTO dwd.orders_clean VALUES (999, 'manual_user', 100.00, 'COMPLETED', DATE('2024-06-15'), '2024-06-15');
+
+-- 手动删除错误数据
+SET cz.sql.dt.allow.dml = true;
+DELETE FROM dwd.orders_clean WHERE order_id = 999;
+```
+
+> ⚠️ **注意**：
+> - `SET cz.sql.dt.allow.dml = true` 必须与 DML 语句在同一执行批次中，不能分开执行
+> - 对动态表执行 DML 后，下一次自动刷新会触发**全量刷新**（而非增量），可能耗时较长
+> - **UPDATE 操作有限制**：动态表 UPDATE 可能因内部隐藏列（`MV__KEY`）报错，建议改用 DELETE + INSERT 或 MERGE INTO 替代
+> - 仅在数据修正等特殊场景使用 DML
+
+---
+
+## 常见错误
+
+| 错误 | 原因 | 解决方案 |
+|---|---|---|
+| `VCluster not available` | 计算集群未启动或名称错误 | 确认 VCLUSTER 名称，检查集群状态 |
+| 动态表刷新失败 | SQL 查询报错或源表结构变更 | `SHOW DYNAMIC TABLE REFRESH HISTORY` 查看错误详情 |
+| Stream 数据为空 | 已被消费或超出保留周期 | 检查源表 `data_retention_days`，确认是否已消费 |
+| Pipe 停止摄入 | Kafka offset 问题或连接断开 | `DESC PIPE` 查看状态，检查 Kafka 连接 |
+| `Cannot ALTER AS clause` | 尝试用 ALTER 修改动态表 SQL | 改用 `CREATE OR REPLACE DYNAMIC TABLE` |
+| 动态表 UPDATE 报错 `Not support hidden column :MV__KEY` | 动态表内部实现限制 | 改用 `DELETE + INSERT` 或 `MERGE INTO` 替代 UPDATE |
+| 动态表 DML 报错 `not allowed` | 未设置 DML 开关 | 在同一批次先执行 `SET cz.sql.dt.allow.dml = true;` |
+
+---
+
+## 参考文档
+
+- [增量计算概述](https://www.yunqi.tech/documents/streaming_data_pipeline_overview)
+- [Dynamic Table](https://www.yunqi.tech/documents/dynamic-table)
+- [Table Stream 变化数据捕获](https://www.yunqi.tech/documents/table_stream)
+- [物化视图](https://www.yunqi.tech/documents/materialized_ddl)
+- [Pipe 简介](https://www.yunqi.tech/documents/pipe-summary)
+- [使用 Dynamic Table 开展实时 ETL](https://www.yunqi.tech/documents/tutorials-streaming-data-pipeline-with_dynamic-table)
+- [LLM 全量文档索引](https://yunqi.tech/llms-full.txt)

package/bin/skills/clickzetta-sql-pipeline-manager/evals/evals.json

@@ -0,0 +1,166 @@
+{
+  "skill_name": "clickzetta-sql-pipeline-manager",
+  "evals": [
+    {
+      "id": 1,
+      "prompt": "帮我创建一个动态表 dwd.orders_clean，每分钟刷新一次，从 ods.orders 表过滤 amount > 0 的数据，计算集群用 default_ap。",
+      "expected_output": "生成 CREATE OR REPLACE DYNAMIC TABLE dwd.orders_clean，包含 TARGET_LAG = '1 minutes'、VCLUSTER = default_ap、AS SELECT ... FROM ods.orders WHERE amount > 0",
+      "files": [],
+      "assertions": [
+        {"text": "包含 CREATE DYNAMIC TABLE 或 CREATE OR REPLACE DYNAMIC TABLE"},
+        {"text": "包含 dwd.orders_clean 作为表名"},
+        {"text": "包含 TARGET_LAG = '1 minutes' 或等效写法"},
+        {"text": "包含 VCLUSTER = default_ap"},
+        {"text": "包含 WHERE amount > 0 过滤条件"},
+        {"text": "包含 FROM ods.orders"}
+      ]
+    },
+    {
+      "id": 2,
+      "prompt": "我有一个动态表 dws.order_hourly 刷新失败了，怎么排查？",
+      "expected_output": "使用 SHOW DYNAMIC TABLE REFRESH HISTORY dws.order_hourly 查看失败详情，说明常见原因（SQL 报错、源表结构变更、集群不可用），提供排查步骤",
+      "files": [],
+      "assertions": [
+        {"text": "包含 SHOW DYNAMIC TABLE REFRESH HISTORY 命令"},
+        {"text": "包含 dws.order_hourly 表名"},
+        {"text": "提到至少一种常见失败原因（SQL报错/源表变更/集群不可用）"},
+        {"text": "提供具体的排查步骤或命令"}
+      ]
+    },
+    {
+      "id": 3,
+      "prompt": "我想从 Kafka 持续导入订单数据到 ods.orders 表，broker 是 kafka.prod.com:9092，topic 是 orders，数据是 JSON 格式。",
+      "expected_output": "生成 CREATE OR REPLACE PIPE 语句，使用 READ_KAFKA 函数，包含 KAFKA_BROKER、KAFKA_TOPIC、KAFKA_GROUP_ID、KAFKA_DATA_FORMAT = 'json'，以及 INSERT INTO ods.orders 的字段映射",
+      "files": [],
+      "assertions": [
+        {"text": "包含 CREATE PIPE 语句"},
+        {"text": "包含 READ_KAFKA 函数"},
+        {"text": "包含 kafka.prod.com:9092 作为 broker 地址"},
+        {"text": "包含 KAFKA_TOPIC 设置为 orders"},
+        {"text": "包含 KAFKA_DATA_FORMAT = 'json' 或等效写法"},
+        {"text": "包含 INSERT INTO ods.orders"}
+      ]
+    },
+    {
+      "id": 4,
+      "prompt": "我需要捕获 ods.orders 表的 UPDATE 和 DELETE 变更，然后同步到 dwd.orders_dim 表，怎么做？",
+      "expected_output": "先 CREATE TABLE STREAM ON TABLE ods.orders MODE = STANDARD，再创建 Dynamic Table 或用 MERGE INTO 消费 stream，说明 _change_type 字段含义（update_postimage / delete）",
+      "files": [],
+      "assertions": [
+        {"text": "包含 CREATE TABLE STREAM"},
+        {"text": "包含 ON TABLE ods.orders"},
+        {"text": "包含 MODE = STANDARD 或说明标准模式"},
+        {"text": "提到 _change_type 字段"},
+        {"text": "提到 update_postimage 或 delete 变更类型"},
+        {"text": "提供消费 stream 的方案（MERGE INTO 或 Dynamic Table）"}
+      ]
+    },
+    {
+      "id": 5,
+      "prompt": "帮我创建一个物化视图 dws.mv_daily_revenue，每小时自动刷新，统计每天每个 region 的 revenue 总和，数据来自 dwd.orders_clean。",
+      "expected_output": "生成 CREATE OR REPLACE MATERIALIZED VIEW，包含 REFRESH AUTO EVERY '1 hours'、VCLUSTER、AS SELECT DATE(created_at), region, SUM(amount) FROM dwd.orders_clean GROUP BY 1,2",
+      "files": [],
+      "assertions": [
+        {"text": "包含 CREATE MATERIALIZED VIEW"},
+        {"text": "包含 dws.mv_daily_revenue 作为视图名"},
+        {"text": "包含 REFRESH AUTO EVERY '1 hours' 或等效写法"},
+        {"text": "包含 FROM dwd.orders_clean"},
+        {"text": "包含 SUM 聚合 revenue 或 amount"},
+        {"text": "包含 GROUP BY 包括日期和 region"}
+      ]
+    },
+    {
+      "id": 6,
+      "prompt": "我要做一个三层 ETL：ODS 原始层 → DWD 清洗层 → DWS 聚合层，都用动态表，希望 DWD 每分钟刷新，DWS 跟着 DWD 刷新。怎么设计？",
+      "expected_output": "DWD 动态表设置 TARGET_LAG = '1 minutes'，DWS 动态表设置 TARGET_LAG = DOWNSTREAM，给出完整的两层 CREATE DYNAMIC TABLE 示例，说明 DOWNSTREAM 的含义",
+      "files": [],
+      "assertions": [
+        {"text": "包含两个 CREATE DYNAMIC TABLE 语句（DWD 和 DWS 层）"},
+        {"text": "DWD 层包含 TARGET_LAG = '1 minutes'"},
+        {"text": "DWS 层包含 TARGET_LAG = DOWNSTREAM"},
+        {"text": "解释 DOWNSTREAM 的含义（跟随上游刷新）"},
+        {"text": "DWS 层查询来自 DWD 层表"}
+      ]
+    },
+    {
+      "id": 7,
+      "prompt": "我需要暂停所有动态表的刷新，明天维护结束后再恢复，怎么操作？",
+      "expected_output": "使用 ALTER DYNAMIC TABLE <name> SUSPEND 暂停，ALTER DYNAMIC TABLE <name> RESUME 恢复，提示可先用 SHOW TABLES WHERE is_dynamic=true 列出所有动态表",
+      "files": [],
+      "assertions": [
+        {"text": "包含 ALTER DYNAMIC TABLE ... SUSPEND"},
+        {"text": "包含 ALTER DYNAMIC TABLE ... RESUME"},
+        {"text": "提到 SHOW TABLES WHERE is_dynamic=true 或等效方式列出动态表"}
+      ]
+    },
+    {
+      "id": 8,
+      "prompt": "动态表和物化视图有什么区别？我的场景是每天凌晨跑一次聚合报表，用哪个更合适？",
+      "expected_output": "说明动态表适合实时/增量场景，物化视图适合低频全量刷新；对于每天一次的报表场景推荐物化视图（REFRESH MANUAL 或 AUTO EVERY '1 days'），成本更低",
+      "files": [],
+      "assertions": [
+        {"text": "说明动态表适合实时或增量计算场景"},
+        {"text": "说明物化视图适合低频或手动刷新场景"},
+        {"text": "明确推荐物化视图用于每天一次的报表场景"},
+        {"text": "提到 REFRESH MANUAL 或 REFRESH AUTO EVERY '1 days' 等具体语法"}
+      ]
+    },
+    {
+      "id": 9,
+      "prompt": "帮我设计一个完整的数据管道：从 Kafka（broker: kafka.prod.com:9092，topic: user_events，JSON 格式）接入用户行为数据，字段有 user_id、event_type、page_id、ts（时间戳）。需要做到三层：ODS 原始层、DWD 清洗层（过滤无效 event_type）、DWS 聚合层（按天统计每个 page 的 UV 和 PV）。DWD 每 2 分钟刷新，DWS 跟随 DWD。",
+      "expected_output": "生成完整的端到端 SQL：1) ODS 建表，2) Kafka Pipe（使用 READ_KAFKA），3) DWD 动态表（TARGET_LAG='2 minutes'，VCLUSTER，过滤无效 event_type），4) DWS 动态表（TARGET_LAG=DOWNSTREAM，按天+page_id 聚合 UV/PV）",
+      "files": [],
+      "assertions": [
+        {"text": "包含 ODS 层建表语句（CREATE TABLE）"},
+        {"text": "包含 CREATE PIPE 使用 READ_KAFKA 从 kafka.prod.com:9092 摄入数据"},
+        {"text": "包含 DWD 层 CREATE DYNAMIC TABLE，TARGET_LAG = '2 minutes'，VCLUSTER"},
+        {"text": "包含 DWS 层 CREATE DYNAMIC TABLE，TARGET_LAG = DOWNSTREAM"},
+        {"text": "DWS 层包含 COUNT(DISTINCT user_id) 统计 UV 或 COUNT(*) 统计 PV"},
+        {"text": "DWS 层按日期和 page_id 分组（GROUP BY）"},
+        {"text": "包含验证命令（SHOW 或 DESC）"}
+      ]
+    },
+    {
+      "id": 10,
+      "prompt": "我有一个业务数据库的订单表会持续有 INSERT 和 UPDATE，已经同步到了 ClickZetta 的 ods.orders 表（字段：order_id, customer_id, amount, status, updated_at）。我需要构建一个完整的数仓管道：DWD 层保留最新状态的订单，DWS 层按天统计每个 status 的订单数和金额。要求近实时，延迟在 1 分钟以内。",
+      "expected_output": "使用 Table Stream（MODE=STANDARD）捕获 UPDATE 变更，DWD 动态表消费 stream 过滤 update_postimage，TARGET_LAG='1 minutes'，DWS 动态表 TARGET_LAG=DOWNSTREAM 做聚合",
+      "files": [],
+      "assertions": [
+        {"text": "包含 CREATE TABLE STREAM ON TABLE ods.orders，MODE = STANDARD"},
+        {"text": "DWD 层动态表消费 stream，过滤 _change_type IN ('insert', 'update_postimage')"},
+        {"text": "DWD 层包含 TARGET_LAG = '1 minutes'，VCLUSTER"},
+        {"text": "DWS 层包含 TARGET_LAG = DOWNSTREAM"},
+        {"text": "DWS 层按日期和 status 分组，包含 COUNT 和 SUM 聚合"},
+        {"text": "包含验证命令（SHOW DYNAMIC TABLE REFRESH HISTORY 或 SHOW TABLE STREAMS）"}
+      ]
+    },
+    {
+      "id": 12,
+      "prompt": "我想在 ClickZetta 上实现 Medallion Architecture，数据来自 S3（Volume 名称 s3_raw_vol，路径 /events/，JSON 格式），字段有 event_id、user_id、event_name、properties（JSON 嵌套）、created_at。Bronze 层直接落地原始数据，Silver 层做清洗（过滤 event_name 为空的记录，展开 properties 里的 page_url 和 referrer 字段），Gold 层按天统计每个 event_name 的次数和独立用户数。Silver 每 5 分钟刷新，Gold 跟随 Silver。",
+      "expected_output": "使用 bronze/silver/gold schema 命名（不映射到 ODS/DWD/DWS），生成完整 SQL：Bronze 建表 + OSS Pipe（COPY INTO FROM '@s3_raw_vol/events/'），Silver 动态表（TARGET_LAG='5 minutes'，过滤 event_name IS NULL，展开 properties:page_url 和 properties:referrer），Gold 动态表（TARGET_LAG=DOWNSTREAM，按天+event_name 聚合 COUNT 和 COUNT DISTINCT user_id）",
+      "files": [],
+      "assertions": [
+        {"text": "使用 bronze/silver/gold schema 命名（不使用 ods/dwd/dws）"},
+        {"text": "包含 CREATE PIPE 使用 COPY INTO FROM '@s3_raw_vol/events/'，FILE_FORMAT TYPE = 'json'"},
+        {"text": "Silver 层包含 CREATE DYNAMIC TABLE，TARGET_LAG = '5 minutes'，VCLUSTER，过滤 event_name IS NULL"},
+        {"text": "Silver 层展开 JSON 嵌套字段（properties:page_url 或 $1:page_url 等语法）"},
+        {"text": "Gold 层包含 CREATE DYNAMIC TABLE，TARGET_LAG = DOWNSTREAM"},
+        {"text": "Gold 层包含 COUNT(DISTINCT user_id) 和 COUNT(*) 或 COUNT(event_id)，按日期和 event_name 分组"}
+      ]
+    },
+    {
+      "id": 11,
+      "prompt": "我们有日志文件每小时上传到 OSS（Volume 名称 my_oss_vol，路径 /logs/app/，Parquet 格式），字段是 log_id、user_id、action、duration_ms、log_time。帮我构建完整的数据管道：自动导入到 ODS，然后做 DWD 清洗（过滤 duration_ms <= 0），最后做 DWS 层按天统计每个 action 的平均耗时和次数。不需要实时，每小时刷新一次就够。",
+      "expected_output": "使用对象存储 Pipe（COPY INTO from @my_oss_vol/logs/app/，TYPE=parquet），DWD 动态表 TARGET_LAG='1 hours'，DWS 动态表 TARGET_LAG=DOWNSTREAM，DWS 聚合 AVG(duration_ms) 和 COUNT(*)",
+      "files": [],
+      "assertions": [
+        {"text": "包含 CREATE PIPE 使用 COPY INTO FROM '@my_oss_vol/logs/app/'"},
+        {"text": "包含 FILE_FORMAT = (TYPE = 'parquet') 或等效写法"},
+        {"text": "DWD 层包含 CREATE DYNAMIC TABLE，TARGET_LAG = '1 hours'，VCLUSTER，过滤 duration_ms <= 0"},
+        {"text": "DWS 层包含 TARGET_LAG = DOWNSTREAM"},
+        {"text": "DWS 层包含 AVG(duration_ms) 统计平均耗时"},
+        {"text": "DWS 层按日期和 action 分组"}
+      ]
+    }
+  ]
+}