alibabacloud-odps-sql-generation — скилл для Claude Code
Скилл alibabacloud-odps-sql-generation генерирует диалект MaxCompute SQL по текстовым описаниям и помогает исправлять ошибки ODPS-0xxx. Пригодится при составлении аналитических запросов и миграции с ANSI SQL.
Apache-2.0 210 установок ★ 300 обновлён 2026-10-23
npx skills add aliyun/alibabacloud-aiops-skills --skill alibabacloud-odps-sql-generation -a claude-codeЧто делает alibabacloud-odps-sql-generation
Скилл обучает ассистента особенностям диалекта MaxCompute (ODPS), который основан на расширениях Hive SQL и заметно отличается от стандарта ANSI. База знаний разбита на четыре файла справок: принципы text2sql, руководство по синтаксису DQL, шаблоны частых паттернов и каталог ошибок исполнения ODPS-0xxx.
В справочниках собраны шаблоны для выборки Top N, PIVOT, развёртки массивов через LATERAL VIEW и EXPLODE, извлечения JSON через GET_JSON_OBJECT и расчёта скользящих итогов. Для оптимизации ассистент использует типовые параметры SET и подсказки оптимизатора (hints).
Скилл работает строго с SQL. Интерфейсы PyODPS DataFrame API, Tunnel, MapReduce, а также распределение квот и сбои кластера Fuxi намеренно исключены из области действия.
Какие задачи решает
- составить аналитический запрос на диалекте MaxCompute по описанию задачи
- адаптировать запросы с ANSI SQL под расширения Hive SQL
- распарсить JSON и развернуть массивы через
LATERAL VIEW - расшифровать код ошибки
ODPS-0xxxи исправить текст запроса
Примеры запросов агенту
- Напиши запрос в MaxCompute для расчёта удержания пользователей по дням с оконными функциями
- Разверни массив тегов в отдельные строки таблицы через EXPLODE и LATERAL VIEW
- Запрос упал с ошибкой ODPS-0130071, объясни причину и исправь синтаксис
Как установить alibabacloud-odps-sql-generation
1Через Skills CLI (Vercel)
npx skills add aliyun/alibabacloud-aiops-skills --skill alibabacloud-odps-sql-generation -a claude-code2Вручную: положить файлы
~/.claude/skills/alibabacloud-odps-sql-generation/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/alibabacloud-odps-sql-generation/
1Через Skills CLI (Vercel)
npx skills add aliyun/alibabacloud-aiops-skills --skill alibabacloud-odps-sql-generation -a codex2Вручную: положить файлы
.agents/skills/alibabacloud-odps-sql-generation/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add aliyun/alibabacloud-aiops-skills --skill alibabacloud-odps-sql-generation -a cursor2Вручную: положить файлы
.cursor/skills/alibabacloud-odps-sql-generation/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install aliyun/alibabacloud-aiops-skills skills/analyticscomputing/odps/alibabacloud-odps-sql-generation2Вручную: положить файлы
.github/skills/alibabacloud-odps-sql-generation/SKILL.md1Через Skills CLI (Vercel)
npx skills add aliyun/alibabacloud-aiops-skills --skill alibabacloud-odps-sql-generation -a gemini-cli2Командой платформы
gemini skills install https://github.com/aliyun/alibabacloud-aiops-skills --path skills/analyticscomputing/odps/alibabacloud-odps-sql-generationВручную: положить файлы
.devin/skills/alibabacloud-odps-sql-generation/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add aliyun/alibabacloud-aiops-skills --skill alibabacloud-odps-sql-generation -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы об alibabacloud-odps-sql-generation
Как установить alibabacloud-odps-sql-generation в Claude Code?
Выполните команду npx skills add aliyun/alibabacloud-aiops-skills --skill alibabacloud-odps-sql-generation -a claude-code.
Что делает alibabacloud-odps-sql-generation?
Скилл передаёт ассистенту правила диалекта MaxCompute SQL, готовые шаблоны аналитических выборок и справочник кодов ошибок ODPS.
Поддерживает ли скилл PyODPS или MapReduce?
Нет, скилл сфокусирован только на составлении и отладке SQL-запросов. Интерфейсы PyODPS DataFrame API, SDK и MapReduce вынесены за рамки.
Исходный текст
SKILL.md · Apache-2.0
--- name: alibabacloud-odps-sql-generation description: "Provides MaxCompute SQL intelligent generation capabilities for AI agents, covering text2sql conversion principles, dialect syntax differences (DQL/DDL/DML), common query pattern templates (Top N, PIVOT, window functions, etc.), and ODPS error code diagnostics. Use when generating, debugging, or migrating MaxCompute / ODPS SQL." license: Apache-2.0 metadata: domain: coding owner: MaxCompute contact: [email protected], [email protected] version: 1.0.0 --- # MaxCompute SQL Engine Syntax Skill Provides MaxCompute SQL engine syntax guidance for text2sql scenarios. MaxCompute is based on Hive SQL extensions and has significant differences from ANSI standard SQL. ## Usage Load corresponding reference files based on question type (can be combined). The `load` column indicates relative loading weight (heavy ≈ large, medium ≈ moderate), for budget estimation, not exact token counts. Each file's opening paragraph describes its own scope. | Trigger condition | File | load | |---|---|---| | NL→SELECT generation / text2sql (determine intent, granularity, table-column mapping, output format first) | `references/text2sql_principles.md` | light | | Generate MaxCompute SELECT queries (dialect rules, DQL default must-read) | `references/maxcompute_select_guide.md` | heavy | | Match query pattern keywords: Top N / top-N per group / year-over-year / month-over-month / consecutive N days / retention / row-to-column / column-to-row / PIVOT / UNPIVOT / array expansion / LATERAL VIEW / EXPLODE / JSON extraction / GET_JSON_OBJECT / cumulative / running total / Range Join / GROUPING SETS / CUBE / ROLLUP / pagination / paging | `references/sql_query_patterns.md` | medium | | SQL execution failure requiring diagnosis and recovery (including `ODPS-0xxx` error codes)| `references/sql_common_errors.md` | medium | > Relationship: `text2sql_principles.md` provides engine-independent NL→SELECT generation principles; `maxcompute_select_guide.md` is the **single authoritative source** for MaxCompute DQL dialect rules (unsupported syntax/functions/partitioning/types/SET parameters). `sql_query_patterns.md` provides **query template snippets** only, without duplicating rules. ## Out of Scope The following scenarios exceed this skill's scope: - **MaxCompute non-SQL interfaces**: Tunnel / MapReduce / Graph / PyODPS DataFrame API, SDK invocation methods - **Console and permission management**: Quota requests, IAM / RAM roles, project owner operations — use Aliyun console or support tickets - **Execution plan-level deep tuning**: Only lists common SET parameters and hints; does not analyze specific plan nodes / Fuxi DAG / data skew formation paths - **Cluster-side / platform-side failures**: Worker crashes, resource scheduling failures, MetaStore transaction conflicts, storage layer read/write errors — these are support ticket issues, not SQL issues
© aliyun · Apache-2.0 · aliyun/alibabacloud-aiops-skills