alibabacloud-odps-sql-generation

MaxCompute SQL エンジン構文スキル

text2sql のシナリオ向けに、MaxCompute SQL エンジンの構文ガイダンスを提供します。MaxCompute は Hive SQL の拡張をベースとしており、ANSI 標準 SQL とは大きく異なります。

使用方法

質問の種類に応じて、対応するリファレンスファイルを読み込みます（組み合わせて使用できます）。load 列は、予算の見積もりを目的とした相対的な読み込み量を示します（heavy ≈ 大、medium ≈ 中）。正確なトークン数ではありません。各ファイルの冒頭の段落で、そのファイルの対象範囲を説明しています。

トリガー条件	ファイル	load
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

関係：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／データスキューの発生経路は分析しません
• クラスター側／プラットフォーム側の障害：ワーカーのクラッシュ、リソーススケジューリングの失敗、MetaStore トランザクションの競合、ストレージ層の読み取り／書き込みエラー — SQL の問題ではなく、サポートチケットで対応する問題です