Alibabacloud Odps Sql Generation — 阿里云 ODPS SQL 生成

MaxCompute SQL Engine 语法技能提供 MaxCompute SQL 引擎语法指导，用于 text2sql 场景。MaxCompute 基于 Hive SQL 扩展，并且与 ANSI 标准 SQL 有显著差异。

使用方法 加载相应的参考文件，基于问题类型（可以组合）。加载列指示相对加载权重（heavy ≈ 大，medium ≈ 中等），用于预算估算，而不是确切的 token 数。每个文件的开头段落描述了其自身的范围。

触发条件 文件加载 NL→SELECT 生成 / text2sql（确定意图、粒度、表列映射、输出格式首先） references/text2sql_principles.md 轻量 生成 MaxCompute SELECT 查询（方言规则，DQL 默认必读） references/maxcompute_select_guide.md 重量 匹配查询模式关键字：Top N / top-N per group / year-over-year / month-over-month / 连续 N 天 / 保留 / 行到列 / 列到行 / PIVOT / UNPIVOT / 数组扩展 / LATERAL VIEW / EXPLODE / JSON 提取 / GET_JSON_OBJECT / 累积 / 运行总计 / Range Join / GROUPING SETS / CUBE / ROLLUP / 分页 / paging references/sql_query_patterns.md 中等 SQL 执行失败需要诊断和恢复（包括 ODPS-0xxx 错误代码） references/sql_common_errors.md 中等

关系 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 调用方法 控制台和权限管理：Quota 请求、IAM / RAM 角色、项目所有者操作 —— 使用 Aliyun 控制台或支持票 执行计划级别深度调优：仅列出常见的 SET 参数和提示；不分析特定的计划节点 / Fuxi DAG / 数据倾斜形成路径 集群侧/平台侧故障：Worker 崩溃、资源调度失败、MetaStore 事务冲突、存储层读/写错误 —— 这些是支持票问题，而不是 SQL 问题