@clickzetta/cz-cli-darwin-x64 0.3.78 → 0.3.81

package/bin/skills/clickzetta-monitoring/SKILL.md

@@ -1,215 +0,0 @@
----
-name: clickzetta-monitoring
-description: |
-  监控和分析 ClickZetta Lakehouse 作业运行状态、性能和资源使用情况，
-  以及通过 INFORMATION_SCHEMA 查询元数据（表、列、Schema、工作空间等）。
-  覆盖 SHOW JOBS 实时查看作业、information_schema.job_history 历史分析、
-  慢查询识别、集群负载分析、缓存命中率统计、失败作业排查、
-  information_schema.tables/columns/schemas 元数据查询等完整监控与治理工作流。
-  当用户说"查看作业"、"作业历史"、"SHOW JOBS"、"慢查询"、"查询性能"、
-  "集群负载"、"作业失败"、"查询失败"、"监控"、"job history"、
-  "information_schema"、"缓存命中率"、"查询耗时"、"作业状态"、
-  "元数据查询"、"查看所有表"、"表大小"、"列信息"、"资产盘点"时触发。
-  Keywords: monitoring, job status, performance, resource usage, SHOW JOBS, slow query
----
-
-## 执行方式
-
-所有 SQL 通过 `cz-cli sql` 执行，无需 MCP 工具：
-
-```bash
-# 执行查询
-cz-cli sql "SHOW JOBS LIMIT 20" --sync -o table
-
-# 执行 information_schema 查询
-cz-cli sql "SELECT * FROM information_schema.job_history WHERE pt_date >= CAST(CURRENT_DATE - INTERVAL 1 DAY AS DATE) LIMIT 10" --sync -o table
-```
-
-注意：`--sync` 等待结果返回；`-o table` 输出为表格格式便于阅读。
-
----
-
-# ClickZetta 作业监控与分析
-
-阅读 [references/show-jobs.md](references/show-jobs.md) 了解 SHOW JOBS 语法。
-阅读 [references/job-history-analysis.md](references/job-history-analysis.md) 了解历史分析查询。
-
----
-
-## 实时查看作业（SHOW JOBS）
-
-```sql
--- 查看所有作业（最近7天）
-SHOW JOBS;
-
--- 查看指定集群的作业
-SHOW JOBS IN VCLUSTER default;
-
--- 查看执行时间超过2分钟的慢查询
-SHOW JOBS WHERE execution_time > INTERVAL 2 MINUTE;
-
--- 查看失败的作业
-SHOW JOBS WHERE status = 'FAILED';
-
--- 限制返回数量
-SHOW JOBS IN VCLUSTER default LIMIT 50;
-```
-
----
-
-## 历史作业分析（information_schema）
-
-### 集群负载分析
-
-```sql
-SELECT
-    virtual_cluster,
-    COUNT(*) AS job_count,
-    AVG(execution_time) AS avg_seconds,
-    ROUND(SUM(CASE WHEN status = 'SUCCEED' THEN 1 ELSE 0 END) * 100.0 / COUNT(*), 2) AS success_rate
-FROM sys.information_schema.job_history
-WHERE start_time >= CURRENT_DATE() - INTERVAL 7 DAY
-GROUP BY virtual_cluster
-ORDER BY job_count DESC;
-```
-
-### 慢查询 TOP 20
-
-```sql
-SELECT job_id, virtual_cluster, execution_time, status, start_time
-FROM sys.information_schema.job_history
-WHERE start_time >= CURRENT_DATE() - INTERVAL 7 DAY
-ORDER BY execution_time DESC
-LIMIT 20;
-```
-
-### 失败作业统计
-
-```sql
-SELECT
-    virtual_cluster,
-    COUNT(*) AS failed_count,
-    DATE(start_time) AS date
-FROM sys.information_schema.job_history
-WHERE status = 'FAILED'
-  AND start_time >= CURRENT_DATE() - INTERVAL 7 DAY
-GROUP BY virtual_cluster, DATE(start_time)
-ORDER BY date DESC;
-```
-
-### 高峰期识别
-
-```sql
-SELECT
-    HOUR(start_time) AS hour_of_day,
-    COUNT(*) AS job_count,
-    AVG(execution_time) AS avg_execution_time
-FROM sys.information_schema.job_history
-WHERE start_time >= CURRENT_DATE() - INTERVAL 7 DAY
-GROUP BY HOUR(start_time)
-ORDER BY hour_of_day;
-```
-
----
-
-## query_tag 标记与过滤
-
-给作业打标，便于按来源过滤：
-
-```sql
--- 在 SQL 中设置 query_tag
-SET query_tag = 'etl_daily';
-SELECT * FROM orders;
-
--- 按 query_tag 过滤作业历史
-SELECT job_id, execution_time, status
-FROM sys.information_schema.job_history
-WHERE start_time >= CURRENT_DATE() - INTERVAL 7 DAY
-  AND query_tag = 'etl_daily';
-```
-
-JDBC URL 中设置：
-```
-jdbc:clickzetta://instance.region.api.clickzetta.com/workspace?query_tag=my_app
-```
-
----
-
-## 常见问题排查
-
-| 现象 | 排查方向 |
-|---|---|
-| 作业长时间"等待执行" | 集群资源不足，考虑扩容 VCluster |
-| 作业长时间"集群启动中" | VCluster 冷启动慢，联系技术支持 |
-| 大量失败作业 | 查看 job_id 详情，检查 SQL 语法或权限 |
-| 平均执行时间突然变长 | 检查数据量变化、索引状态、缓存命中率 |
-
----
-
-## INFORMATION_SCHEMA 元数据查询
-
-除了 `job_history`，INFORMATION_SCHEMA 还提供丰富的元数据视图，用于资产盘点和治理。
-
-### 空间级视图（当前工作空间）
-
-```sql
--- 查看当前空间下所有 Schema
-SELECT * FROM information_schema.schemas;
-
--- 查看所有表及其大小、行数
-SELECT table_schema, table_name, table_type, row_count, bytes
-FROM information_schema.tables
-ORDER BY bytes DESC;
-
--- 查看所有列的详细信息（字段名、类型、是否可空、注释）
-SELECT table_schema, table_name, column_name, data_type, is_nullable, comment
-FROM information_schema.columns
-WHERE table_schema = 'public';
-
--- 查看排序列推荐
-SELECT * FROM information_schema.sortkey_candidates;
-```
-
-### 实例级视图（需要 instance_admin 权限，使用 sys 库）
-
-```sql
--- 查看实例下所有工作空间
-SELECT * FROM sys.information_schema.workspaces;
-
--- 查看实例下所有 Schema（跨工作空间）
-SELECT * FROM sys.information_schema.schemas;
-
--- 查看实例用量（费用分析）
-SELECT * FROM sys.information_schema.instance_usage
-WHERE start_time >= CURRENT_DATE() - INTERVAL 7 DAY;
-```
-
-### 常用元数据分析场景
-
-```sql
--- 找出最大的 10 张表
-SELECT table_schema, table_name, row_count, bytes
-FROM information_schema.tables
-WHERE table_type = 'TABLE'
-ORDER BY bytes DESC
-LIMIT 10;
-
--- 找出没有注释的表
-SELECT table_schema, table_name
-FROM information_schema.tables
-WHERE comment IS NULL OR comment = '';
-
--- 找出没有注释的字段
-SELECT table_schema, table_name, column_name
-FROM information_schema.columns
-WHERE (comment IS NULL OR comment = '')
-  AND table_schema NOT IN ('information_schema');
-
--- 统计各 Schema 下的表数量和总存储
-SELECT table_schema,
-       COUNT(*) AS table_count,
-       SUM(bytes) AS total_storage
-FROM information_schema.tables
-GROUP BY table_schema
-ORDER BY total_storage DESC;
-```

package/bin/skills/clickzetta-monitoring/eval_cases.jsonl

@@ -1,5 +0,0 @@
-{"case_id":"001","type":"should_call","user_input":"SHOW JOBS 的语法是什么？怎么过滤特定状态的作业？","expected_skill":"clickzetta-monitoring","expected_output_contains":["SHOW JOBS"]}
-{"case_id":"002","type":"should_call","user_input":"怎么查询失败的作业？用什么 SQL？","expected_skill":"clickzetta-monitoring","expected_output_contains":["FAILED"]}
-{"case_id":"003","type":"should_call","user_input":"过去 7 天各集群的作业执行情况怎么查？","expected_skill":"clickzetta-monitoring","expected_output_contains":["job_history","virtual_cluster"]}
-{"case_id":"004","type":"should_call","user_input":"怎么查看慢查询？执行超过 2 分钟的作业有哪些？","expected_skill":"clickzetta-monitoring","expected_output_contains":["execution_time"]}
-{"case_id":"005","type":"should_call","user_input":"怎么通过 information_schema 查看所有表的大小和行数？","expected_skill":"clickzetta-monitoring","expected_output_contains":["information_schema","tables"]}

package/bin/skills/clickzetta-monitoring/references/job-history-analysis.md

@@ -1,97 +0,0 @@
-# information_schema 作业历史分析参考
-
-> 来源：https://www.yunqi.tech/documents/job_history_analysis_with_information_schema
-
-## 数据源
-
-表名：`sys.information_schema.job_history`
-
-### 关键字段
-
-| 字段 | 类型 | 说明 |
-|---|---|---|
-| workspace_name | String | 工作空间名称 |
-| virtual_cluster | String | 计算集群名称 |
-| job_id | String | 作业唯一标识 |
-| execution_time | Float | 执行时长（秒） |
-| start_time | Timestamp | 开始时间 |
-| status | String | 状态（SUCCEED/FAILED/CANCELLED/...） |
-| input_tables | String | 输入表（JSON 格式） |
-| input_bytes | String | 读取字节数 |
-| cache_hit | String | 缓存命中字节数 |
-
----
-
-## 常用分析查询
-
-### 1. 集群负载分析（近 30 天）
-
-```sql
-SELECT
-    virtual_cluster,
-    COUNT(*) AS job_count,
-    SUM(execution_time) AS total_execution_time,
-    AVG(execution_time) AS avg_execution_time,
-    ROUND(SUM(CASE WHEN status = 'SUCCEED' THEN 1 ELSE 0 END) * 100.0 / COUNT(*), 2) AS success_rate
-FROM sys.information_schema.job_history
-WHERE start_time >= CURRENT_DATE() - INTERVAL 30 DAY
-GROUP BY virtual_cluster
-ORDER BY total_execution_time DESC;
-```
-
-### 2. 慢查询分析（执行时间 TOP 20）
-
-```sql
-SELECT
-    job_id,
-    virtual_cluster,
-    execution_time,
-    status,
-    start_time
-FROM sys.information_schema.job_history
-WHERE start_time >= CURRENT_DATE() - INTERVAL 7 DAY
-ORDER BY execution_time DESC
-LIMIT 20;
-```
-
-### 3. 失败作业分析
-
-```sql
-SELECT
-    virtual_cluster,
-    COUNT(*) AS failed_count,
-    DATE(start_time) AS date
-FROM sys.information_schema.job_history
-WHERE status = 'FAILED'
-  AND start_time >= CURRENT_DATE() - INTERVAL 7 DAY
-GROUP BY virtual_cluster, DATE(start_time)
-ORDER BY date DESC, failed_count DESC;
-```
-
-### 4. 缓存命中率分析
-
-```sql
-SELECT
-    virtual_cluster,
-    SUM(CAST(input_bytes AS BIGINT)) AS total_input_bytes,
-    SUM(CAST(cache_hit AS BIGINT)) AS total_cache_hit,
-    ROUND(SUM(CAST(cache_hit AS BIGINT)) * 100.0 /
-          NULLIF(SUM(CAST(input_bytes AS BIGINT)), 0), 2) AS cache_hit_rate
-FROM sys.information_schema.job_history
-WHERE start_time >= CURRENT_DATE() - INTERVAL 7 DAY
-  AND input_bytes IS NOT NULL
-GROUP BY virtual_cluster;
-```
-
-### 5. 按小时统计作业量（识别高峰期）
-
-```sql
-SELECT
-    HOUR(start_time) AS hour_of_day,
-    COUNT(*) AS job_count,
-    AVG(execution_time) AS avg_execution_time
-FROM sys.information_schema.job_history
-WHERE start_time >= CURRENT_DATE() - INTERVAL 7 DAY
-GROUP BY HOUR(start_time)
-ORDER BY hour_of_day;
-```

package/bin/skills/clickzetta-monitoring/references/show-jobs.md

@@ -1,48 +0,0 @@
-# SHOW JOBS 参考
-
-> 来源：https://www.yunqi.tech/documents/show-jobs
-
-## 语法
-
-```sql
-SHOW JOBS [IN VCLUSTER vc_name] [LIKE 'pattern'] [WHERE <expr>] [LIMIT num];
-```
-
-## 参数说明
-
-- `IN VCLUSTER vc_name`：（可选）指定计算集群，筛选该集群下的作业
-- `WHERE <expr>`：（可选）按字段过滤，支持 SHOW JOBS 显示的所有字段
-- `LIMIT num`：（可选）限制返回数量，范围 1-10000
-- `LIKE 'pattern'`：（可选）按 job_id 模式匹配（支持 `%` 和 `_`）
-
-默认显示最近 7 天内的作业，最多 10000 条。
-
-## 示例
-
-```sql
--- 查看所有作业（最近7天）
-SHOW JOBS;
-
--- 查看指定集群的作业
-SHOW JOBS IN VCLUSTER default;
-
--- 查看执行时间超过2分钟的作业
-SHOW JOBS IN VCLUSTER default WHERE execution_time > INTERVAL 2 MINUTE;
-
--- 限制返回100条
-SHOW JOBS LIMIT 100;
-
--- 按 job_id 模糊匹配
-SHOW JOBS LIKE '2024%';
-```
-
-## 作业状态说明
-
-| 状态 | 含义 |
-|---|---|
-| 初始化 | SQL 编译优化阶段 |
-| 集群启动中 | 等待 VCluster 启动 |
-| 等待执行 | 排队等待资源 |
-| 正在执行 | 正在处理数据 |
-| 执行成功 | 运行结束 |
-| 执行失败 | 运行失败 |

package/bin/skills/clickzetta-oss-ingest-pipeline/LICENSE

@@ -1,16 +0,0 @@
-ClickZetta Skills License
-© 2026 Yunqi Inc. All rights reserved.
-LICENSE: Use of these materials (including all code, prompts, assets, files, and other components of these skills (collectively, "Skills")) is governed by your agreement with ClickZetta for the Service. If no separate agreement exists, use is governed by ClickZetta's Terms of Service (available at: https://yunqi.tech/documents/user-aggrement).
-Your applicable agreement is referred to as the "Agreement." "Service" is as defined in the Agreement.
-ADDITIONAL RESTRICTIONS: Notwithstanding anything in the Agreement to the contrary, you may not:
-
-Extract from the Service or retain copies of the Skills outside use with the Service;
-Reproduce or copy the Skills, except for temporary copies created automatically during authorized use of the Service;
-Create derivative works based on the Skills;
-Distribute, sublicense, or transfer the Skills to any third party;
-Make, offer to sell, sell, or import any inventions embodied in the Skills; nor,
-Reverse engineer, decompile, or disassemble the Skills.
-
-The receipt, viewing, or possession of the Skills does not convey or imply any license or right beyond those expressly granted above.
-Yunqi retains all rights, title, and interest in the Skills, including all copyrights, trademarks, patents, and all other applicable intellectual property rights.
-THE SKILLS ARE PROVIDED "AS IS," WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SKILLS OR THE USE OR OTHER DEALINGS IN THE SKILLS.