sql-optimization-patterns

SQL 最適化パターン

クエリプランで遅い SQL を診断し、クエリ結果を保持し、代表的なデータに対してインデックスやクエリの変更を検証します。

このスキルを使用する場合

• 実行の遅いクエリをデバッグするとき
• パフォーマンスの高いデータベーススキーマを設計するとき
• アプリケーションの応答時間を最適化するとき
• データベースの負荷とコストを削減するとき
• 増大するデータセットに対するスケーラビリティを向上させるとき
• EXPLAIN クエリプランを分析するとき
• 効率的なインデックスを実装するとき
• N+1 クエリ問題を解決するとき

このスキルを使用しない場合

• タスクが SQL 最適化パターンと無関係である場合
• この範囲外の別のドメインやツールが必要な場合

手順

• データベースエンジンとバージョン、クエリパラメータ、想定される行数、データ分布、許可された環境を確認します。まず読み取り専用で開始し、DDL、データ変更、構成変更、メンテナンスの前には承認を取得します。
• パフォーマンスを比較する前に結果セットを比較します。EXPLAIN ANALYZE はステートメントを実行するため、承認された代表的なデータを使用し、関数やトリガーを考慮し、トランザクションのロールバックがすべての副作用を取り消すと想定しないでください。
• 観測されたプラン、タイミング条件、正確性のチェックを記録します。インデックスとクエリの書き換えは仮説であり、普遍的な速度向上ではありません。
• 詳細な例が必要な場合は、resources/implementation-playbook.md を開いてください。

リソース

• 詳細なパターンと例については、resources/implementation-playbook.md を参照してください。

制限事項

• このスキルは、タスクが上記の範囲に明確に一致する場合にのみ使用してください。
• 出力を、環境固有の検証、テスト、専門家によるレビューの代替として扱わないでください。
• 必要な入力、権限、安全境界、成功基準が欠けている場合は、停止して確認を求めてください。

実例

プレイブックには、バインド値と空入力の場合を扱う実行可能な SQLite のバッチ読み込みの例が含まれています。リポジトリのテストでは、ページネーションの同順位や集計の等価性とあわせてこれを検証します。SQLite の正確性チェックは、PostgreSQL のパフォーマンスや本番環境の安全性を保証するものではありません。