database-query-optimization

データベースクエリの最適化

目次

• 概要
• 使用する場面
• クイックスタート
• リファレンスガイド
• ベストプラクティス

概要

データベースクエリの遅さは、よくあるパフォーマンスのボトルネックです。インデックスの作成、効率的なクエリ、キャッシュによって最適化すると、アプリケーションのパフォーマンスが大幅に向上します。

使用する場面

• 応答時間が遅い場合
• データベースの CPU 使用率が高い場合
• パフォーマンスが低下した場合
• 新機能をデプロイする場合
• 定期的なメンテナンスを行う場合

クイックスタート

最小限の動作例：

-- Analyze query performance

EXPLAIN ANALYZE
SELECT users.id, users.name, COUNT(orders.id) as order_count
FROM users
LEFT JOIN orders ON users.id = orders.user_id
WHERE users.created_at > '2024-01-01'
GROUP BY users.id, users.name
ORDER BY order_count DESC;

-- Results show:
-- - Seq Scan (slow) vs Index Scan (fast)
-- - Rows: actual vs planned (high variance = bad)
-- - Execution time (milliseconds)

-- Key metrics:
-- - Sequential Scan: Full table read (slow)
-- - Index Scan: Uses index (fast)
-- - Nested Loop: Joins with loops
-- - Sort: In-memory or disk sort

リファレンスガイド

詳細な実装については、references/ ディレクトリを参照してください。

ガイド	内容
クエリ分析	クエリ分析
インデックス戦略	インデックス戦略
クエリ最適化の手法	クエリ最適化の手法
最適化チェックリスト	最適化チェックリスト

ベストプラクティス

✅ 推奨事項

• 確立されたパターンと規約に従う
• クリーンで保守しやすいコードを書く
• 適切なドキュメントを追加する
• デプロイ前に十分にテストする

❌ 禁止事項

• テストや検証を省略する
• エラー処理を無視する
• 設定値をハードコードする