アーカイブ / LLM
自然文からSQLとGraphQLを生成するtext2ql――共通の問い合わせ表現と信頼度
text2ql
text2qlの原論文から掲載した図です。細部はクリックして拡大できます。
原論文の図の説明を読む
Figure 1: text2ql in action. Natural language input is converted into QueryIR and rendered as equivalent GraphQL and SQL queries.
概要
- QueryIRを介して、自然文の質問からSQLとGraphQLを生成する。各結果には検証情報などに基づく信頼度が付く。
- 著者の各50問の評価では、LLMモードの実行精度はSpiderで84.0%、BIRDで90.0%、決定論モードは両方で100.0%だった。
- 評価標本は小さく、GraphQLの正解文との比較と、人による質問意図との照合は行われていない。
補足：編集した模式図で仕組みを確認する
VISUAL EXPLAINER
図でつかむ、text2qlの仕組み
- 01自然文の質問
- 02対象・条件の検出
- 03QueryIRと検証
- 04SQL・GraphQL
原論文の説明をもとにした模式図です。処理の細部は省略しています。
研究の背景
text2qlは、自然文の質問からデータへの問い合わせ文を作り、SQLとGraphQLの両方を出力対象とする。SQLは表形式のデータベース、GraphQLはAPIへの問い合わせに用いられる。
業務では、問い合わせ文が実行できても、選んだ表や条件が違えば求める答えにはならない。著者は出力先の切り替えに加え、毎回の大規模言語モデル呼び出しを避ける方式と、生成結果を実行前に確認するための信頼度を組み合わせた。
手法
決定論モードは、設定済みの表名・列名・別名を使って、対象、取得項目、絞り込み、集計、表間の関係、並び順を順に検出する。例えば「有効な口座の件数」では、設定に「有効」と保存値「ACTIVE」の対応があれば、状態で絞って件数を数える問い合わせを組み立てる。この対応の妥当性は導入先の設定に依存する。
検出結果はQueryIRという、出力言語に変換する前の共通の構造に保存する。列名や値の型などを設定と照合し、検出の手掛かりと問題点から信頼度を計算した後、専用の生成器がSQLまたはGraphQLを出力する。別のモードでは質問とスキーマ設定を大規模言語モデルに渡し、生成結果を検証する。
新規性
著者の主張する進歩は、質問の解釈結果をQueryIRにまとめ、SQLとGraphQLの生成器で使い分ける構成にある。新しい出力先を追加する際も、質問を読み取る処理は共通で使う設計だ。
大規模言語モデルを呼ばない決定論モードも備え、各結果に検出内容と検証上の問題から計算した信頼度を付ける。この値は正答確率として校正されたものではなく、実行前の確認や生成方式の切り替えに使う信号である。
従来手法との違い
通常の自然文からSQLへの変換と比べ、text2qlは質問をいったんQueryIRに変え、同じ表現からSQLまたはGraphQLを出力する。GraphQLは、APIに取得したい項目を指定する問い合わせ言語だ。論文が挙げる既存手法との主な違いは、この二つの出力先と、モデルを呼ばない方式、実行時の信頼度である。
著者の評価では、決定論モードの正解文との完全一致率はSpider、BIRDとも0.0%、実行精度は各50件で100.0%だった。著者は明示的な列指定など、正解文との書き方の違いを一致率低下の理由に挙げる。ただし実行精度だけでは質問者の意図との一致は分からない。
実験結果
著者はSpiderとBIRDから無作為に各50問を取り、SQLの正解文との完全一致率と実行精度などを測った。gpt-4o-miniを使うLLMモードは、Spiderで完全一致率62.0%、実行精度84.0%、BIRDで70.0%、90.0%だった。決定論モードの実行精度は両方で100.0%、構文解析上のエラーは計100問で0件と報告する。
LLMに質問だけを渡す条件と、別名などを含む完全なスキーマ設定を渡す条件の完全一致率の差は、両データセットで18.4ポイントだった。著者は標本が小さく結果は暫定的としている。SpiderとBIRDにはGraphQLの正解文がないため、これらの数値はGraphQL出力の意味的な正しさを示さない。
応用の可能性
編集上の応用案 · 論文が実証した用途とは区別しています。
編集上の応用案：社内の受注データについて、担当者が「先月の顧客別受注件数」と入力し、生成されたSQLの対象表、集計対象、期間条件と信頼度を確認してから実行する画面を試す。出力は問い合わせ文と確認用の内訳であり、正しい集計が自動的に得られると見込む段階ではない。
元データには受注・顧客の表と列の定義、両表の関係が必要だ。業務用語と列名の対応、期間の解釈を設定し、期待結果を付けた質問を用意する。新しいセンサーや追加学習用データはこの案では想定せず、社内の言い回しに合わせた別名の調整を行う。
導入時の検証
導入時の検証案 · 対象データでの再評価が必要です。
導入時の検証案：受注データの一部について、表・列・型・表間の関係と業務用語の別名を設定する。担当者の実際の質問を集め、期待する取得結果と対象表・条件を正解ラベルとして記録する。決定論モードを基準とし、LLMモードも試すなら同じ質問群で比べる。新しいセンサーと追加学習用データは、この検証では想定しない。
生成された表、列、条件を人が点検し、期待結果との一致、実行エラー数、応答時間、低信頼度で保留した件数を測る。誤りを見て別名や表間の関係を修正し、同じ質問群で再測定する。自動実行の信頼度境界は、業務データで確認した誤り方に基づいて決める。
限界と課題
著者が明記する制約は、SpiderとBIRDで各50件という小規模評価、GraphQLの正解クエリによる評価の欠如、スキーマ設定の作成負担、人による意図一致の評価がないことだ。決定論モードは、現在のQueryIRで表せない副問い合わせや相関条件を要する質問に対応できないとも述べる。
編集上の検証事項は、業務質問で信頼度が誤りの発見に役立つか、別名や表間の関係が足りないときにどの対象が選ばれるかである。報告された実行精度を業務上の正答率と読み替えず、担当者による意図の確認を含めて評価する必要がある。
出典
元のタイトル・要旨を確認する（英語）
text2ql: Multi-Target Natural Language Querying via a Language-Agnostic Intermediate Representation
Natural language interfaces to databases have traditionally suffered from three structural limitations: exclusive targeting of relational SQL, unconditional dependence on large language model (LLM) inference at query time, and absence of any runtime signal when generated queries are semantically incorrect. This paper presents text2ql, an open-source Python framework that addresses all three limitations through a language-agnostic Intermediate Representation (QueryIR) and a pluggable renderer architecture. A single seven-stage detection pipeline serves both SQL and GraphQL targets; a zero-LLM deterministic mode delivers 100% execution accuracy at a median latency of 3.2 ms with no API cost; and every generated query carries a runtime confidence score in [0.15, 0.97] computed from an additive signal model. Evaluated on 50-query random samples from the Spider and BIRD benchmarks (indicative results; full-set evaluation is planned), the LLM-backed mode achieves 62-70% exact match and 84-91% execution accuracy; the deterministic mode achieves 100% execution accuracy with zero parse errors across all 100 test cases. An ablation study isolates schema-aware prompting as the dominant accuracy lever, contributing +18.4 percentage points of exact-match gain over the schema-free baseline on both benchmarks. text2ql is publicly available at https://pypi.org/project/text2ql/ under the Apache 2.0 license.
論文本体の取得範囲に基づく解説。AIが作成した未校閲の記事です。性能の数値は著者の評価条件に依存します。応用例と検証計画は編集上の提案です。解説更新：2026-10-01