SuperAPI AI 工具集

alibabacloud-odps-sql-generation

数据与分析

查看项目

更新于 10-15 19:54

技能介绍

用途:面向 text2sql 场景,为 AI 智能体提供 MaxCompute SQL 引擎语法指导。MaxCompute 基于 Hive SQL 扩展,与 ANSI 标准 SQL 差异较大,该技能用于在生成 SELECT 查询、匹配查询模式和处理执行报错时加载对应参考文件。

主要能力与使用方式:按问题类型加载参考文件,可组合使用。触发条件包括:NL→SELECT 生成/text2sql(先确定意图、粒度、表列映射与输出格式)时加载 references/text2sql_principles.md(light);生成 MaxCompute SELECT 查询(方言规则,DQL 默认必读)时加载 references/maxcompute_select_guide.md(heavy);匹配查询模式关键词如 Top N、每组 Top-N、同比、环比、连续 N 天、留存、行转列、列转行、PIVOT、UNPIVOT、数组展开、LATERAL VIEW、EXPLODE、JSON 提取、GET_JSON_OBJECT、累计/滑动合计、Range Join、GROUPING SETS、CUBE、ROLLUP、分页时加载 references/sql_query_patterns.md(medium);SQL 执行失败需诊断恢复(含 ODPS-0xxx 错误码)时加载 references/sql_common_errors.md(medium)。load 列表示相对加载权重(heavy≈大、medium≈中),用于预算估算而非精确 token 数,每个文件开头段落描述自身范围。

text2sql_principles.md 提供与引擎无关的生成原则;maxcompute_select_guide.md 是 MaxCompute DQL 方言规则(不支持的语法/函数/分区/类型/SET 参数)的唯一权威来源;sql_query_patterns.md 仅提供查询模板片段,不重复规则。

限制:超出范围包括 MaxCompute 非 SQL 接口(Tunnel/MapReduce/Graph/PyODPS DataFrame API、SDK 调用方式)、控制台与权限管理(Quota 申请、IAM/RAM 角色、项目负责人操作,需用阿里云控制台或工单)、执行计划级深度调优(仅列出常见 SET 参数与 hints,不分析具体计划节点/Fuxi DAG/数据倾斜形成路径)、集群侧或平台侧故障(Worker 崩溃、资源调度失败、MetaStore 事务冲突、存储层读写错误,属工单问题而非 SQL 问题)。未提供具体收费、价格与完整使用命令信息。