К основному содержанию
скилл CX Codex

alibabacloud-odps-sql-generation — скилл для Claude Code

Скилл alibabacloud-odps-sql-generation генерирует диалект MaxCompute SQL по текстовым описаниям и помогает исправлять ошибки ODPS-0xxx. Пригодится при составлении аналитических запросов и миграции с ANSI SQL.

Apache-2.0 210 установок ★ 300 обновлён 2026-10-23

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add aliyun/alibabacloud-aiops-skills --skill alibabacloud-odps-sql-generation -a claude-code
Открыть на GitHub

Что делает 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-code

2Вручную: положить файлы

~/.claude/skills/alibabacloud-odps-sql-generation/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/alibabacloud-odps-sql-generation/

По шагам, с командами для каждой платформы: Как установить скилл в 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

Похожие скиллы

Все скиллы по теме «Данные и базы» →
huawei-cloud-mrs-hive-sql-check huaweicloud Скилл huawei-cloud-mrs-hive-sql-check проверяет Hive SQL на синтаксис, соответствие правилам и риски перехвата тяжёлых запросов. Пригодится перед запуском SQL в кластере Huawei Cloud MRS. CX Codex +1 132установок sql-sp-generation официальный github Правило sql-sp-generation задаёт Copilot стиль для SQL: имена таблиц, ключи, транзакции, параметры и оформление хранимых процедур. CX Codex +1 ★ 41 430звёзд репо azure-sql-managed-instance MicrosoftDocs Подключает справочную архитектуру, устранение неполадок и правила настройки Azure SQL Managed Instance. CX Codex +1 189установок huawei-cloud-dws-sql-check huaweicloud Скилл huawei-cloud-dws-sql-check для Claude Code статически проверяет SQL для Huawei DWS: синтаксис по грамматике и оформление по гайду разработки. Для проверки кластер не нужен. CX Codex +1 183установок azure-sql-optimization JosiahSiegel Скилл azure-sql-optimization по оптимизации Azure SQL Database: помогает выбрать тариф, включить автоматическую настройку и разобраться с Hyperscale, Serverless и эластичными пулами. CX Codex +1 164установок microsoft-azure-sql-database membrane Скилл связывает агента с Microsoft Azure SQL Database через Membrane CLI для управления базой, записями и серверами. CX Codex +1 161установок

Из того же набора66

Весь набор →
alibabacloud-flink-workspace-ops Скилл alibabacloud-flink-workspace-ops для Claude Code управляет ресурсами Flink Console на уровне workspace: SQL-черновиками, деплоями и заданиями. Выполняет операции с Flink в Alibaba Cloud. CX Codex +1 221установок alibabacloud-polardb-ai-assistant Скилл alibabacloud-polardb-ai-assistant для анализа и управления кластерами Alibaba Cloud PolarDB. Помогает диагностировать производительность, проверять параметры, анализировать логи и планировать обновления без лишних обращений в консоль. CX Codex +1 216установок alibabacloud-ecs-reboot-or-crash-diagnosis Скилл alibabacloud-ecs-reboot-or-crash-diagnosis для Claude Code пошагово ищет причины внезапной перезагрузки, аварийного завершения или зависания инстансов Alibaba Cloud ECS. CX Codex +1 214установок alibabacloud-devops Скилл alibabacloud-devops превращает запросы на естественном языке в вызовы API платформы Alibaba Cloud Yunxiao: пайплайны, репозитории, спринты и релизы. CX Codex +1 212установок alibabacloud-ddos-security-monitor Скилл alibabacloud-ddos-security-monitor для Claude Code проверяет защиту Alibaba Cloud от DDoS-атак и ищет события и аномалии трафика для аудита подключённых продуктов и расследования подозрительных скачков. CX Codex +1 207установок alibabacloud-ack-cli Скилл alibabacloud-ack-cli для работы с Alibaba Cloud ACK из терминала: кластеры, пулы нод, аддоны, kubeconfig через aliyun cs. Полезен, когда kubectl не подключается или RAM отвечает Forbidden.RAM. CX Codex +1 196установок alibabacloud-sysom-diagnosis Скилл alibabacloud-sysom-diagnosis диагностирует проблемы производительности и стабильности Linux-серверов через SysOM и выдаёт рекомендации без автоматического исправления. CX Codex +1 191установок alibabacloud-odps-maxframe-coding Скилл alibabacloud-odps-maxframe-coding для работы с MaxFrame SDK на Alibaba Cloud MaxCompute: создаёт пайплайны обработки данных, читает и пишет таблицы ODPS, отлаживает задачи и собирает кастомные образы DPE. CX Codex +1 188установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой