クエリライティングスキル

シンプルなクエリのワークフロー

単一テーブルに関する直感的な質問の場合:

1. テーブルを特定する - どのテーブルにデータがあるか?
2. スキーマを取得する - sql_db_schema を使ってカラムを確認
3. クエリを作成する - WHERE/LIMIT/ORDER BY を含む SELECT を作成
4. 実行する - sql_db_query で実行
5. 結果をフォーマットする - 結果を明確に提示

複雑なクエリのワークフロー

複数のテーブルが必要な質問の場合:

1. アプローチを計画する

write_todos を使ってタスクを分解:

• 必要なテーブルをすべて特定
• 関係性をマップ (外部キー)
• JOIN 構造を計画
• 集計方法を決定

2. スキーマを確認する

各テーブルに対して sql_db_schema を使って、JOIN カラムと必要なフィールドを見つけます。

3. クエリを構築する

• SELECT - カラムと集計関数
• FROM/JOIN - FK = PK でテーブルを接続
• WHERE - 集計前のフィルタ
• GROUP BY - すべての非集計カラム
• ORDER BY - 意味のあるソート
• LIMIT - デフォルト 5 行

4. 検証と実行

すべての JOIN に条件があることを確認し、GROUP BY が正しいことを確認してからクエリを実行します。

例: 国別の収益

SELECT
    c.Country,
    ROUND(SUM(i.Total), 2) as TotalRevenue
FROM Invoice i
INNER JOIN Customer c ON i.CustomerId = c.CustomerId
GROUP BY c.Country
ORDER BY TotalRevenue DESC
LIMIT 5;

エラーリカバリー

クエリが失敗するか予期しない結果が返される場合:

1. 空の結果 — スキーマに照らしてカラム名と WHERE 条件を確認。大文字小文字の違いや NULL 値をチェック
2. 構文エラー — JOIN、GROUP BY の完全性、エイリアス参照を再検討
3. タイムアウト — WHERE フィルタを厳しくするか LIMIT を追加して結果セットを削減してから改善

品質ガイドライン

• 関連するカラムのみをクエリ (SELECT * は使用禁止)
• 常に LIMIT を適用 (デフォルト 5)
• テーブルエイリアスを使って可読性を向上
• 複雑なクエリの場合: write_todos を使って計画
• DML ステートメント (INSERT, UPDATE, DELETE, DROP) は使用禁止