mcpField
A
alibabacloud-odps-sql-generation

alibabacloud-odps-sql-generation

github.com/aliyun数据与数据库281206 次安装1 天前更新
代码仓库

关于 alibabacloud-odps-sql-generation

为 MaxCompute SQL 提供语法指导，面向 text2sql 查询生成及 SQL 故障诊断。按问题类型加载方言规则、查询模式和错误参考。

主要功能

  1. 01指导自然语言生成 SELECT
  2. 02提供 MaxCompute DQL 方言规则
  3. 03涵盖常见查询模式模板
  4. 04诊断 SQL 错误并指导恢复

适用场景

  1. 01将业务问题转换为 MaxCompute SELECT
  2. 02编写分组排名或留存分析查询
  3. 03排查 ODPS-0xxx 执行错误

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/aliyun/alibabacloud-aiops-skills --skill alibabacloud-odps-sql-generation

安装后在 Claude Code 中输入/alibabacloud-odps-sql-generation确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

references/
maxcompute_select_guide.md
sql_common_errors.md
sql_query_patterns.md
text2sql_principles.md

详细介绍

MaxCompute SQL 引擎语法技能

为 text2sql 场景提供 MaxCompute SQL 引擎语法指导。MaxCompute 基于 Hive SQL 扩展，与 ANSI 标准 SQL 存在显著差异。

用法

根据问题类型加载相应的参考文件（可组合使用）。load 列表示相对加载权重（heavy ≈ 较大，medium ≈ 中等），用于预算估算，不代表精确的令牌数。每个文件的开篇段落都会说明其适用范围。

触发条件文件load
NL→SELECT 生成 / text2sql（先确定意图、粒度、表列映射和输出格式）references/text2sql_principles.mdlight
生成 MaxCompute SELECT 查询（方言规则，DQL 默认必须阅读）references/maxcompute_select_guide.mdheavy
匹配查询模式关键词：Top N / 每组 Top-N / 同比 / 环比 / 连续 N 天 / 留存 / 行转列 / 列转行 / PIVOT / UNPIVOT / 数组展开 / LATERAL VIEW / EXPLODE / JSON 提取 / GET_JSON_OBJECT / 累计 / 累计总和 / Range Join / GROUPING SETS / CUBE / ROLLUP / 分页references/sql_query_patterns.mdmedium
SQL 执行失败，需要诊断和恢复（包括 ODPS-0xxx 错误代码）references/sql_common_errors.mdmedium

关系：text2sql_principles.md 提供与引擎无关的 NL→SELECT 生成原则；maxcompute_select_guide.md 是 MaxCompute DQL 方言规则（不支持的语法、函数、分区、类型和 SET 参数）的唯一权威来源。sql_query_patterns.md 仅提供查询模板片段，不重复规则。

不适用范围

以下场景超出此技能的范围：

  • MaxCompute 非 SQL 接口：Tunnel / MapReduce / Graph / PyODPS DataFrame API、SDK 调用方法
  • 控制台和权限管理：配额申请、IAM / RAM 角色、项目所有者操作——请使用阿里云控制台或提交支持工单
  • 执行计划级深度调优：仅列出常见 SET 参数和提示，不分析具体计划节点 / Fuxi DAG / 数据倾斜形成路径
  • 集群侧 / 平台侧故障：Worker 崩溃、资源调度失败、MetaStore 事务冲突、存储层读写错误——这些问题应提交支持工单，而非 SQL 问题

评论

支持 Markdown