Supabase Postgres ベストプラクティス
Supabase が管理する Postgres 向け包括的なパフォーマンス最適化ガイド。8つのカテゴリにわたるルールで構成され、インパクトの優先順位に従って自動クエリ最適化とスキーマ設計をガイドします。
適用タイミング
以下のような場合にガイドラインを参照してください：
- SQL クエリの作成やスキーマ設計時
- インデックスの実装やクエリ最適化時
- データベースパフォーマンスの問題調査時
- コネクションプーリングやスケーリング設定時
- Postgres 固有機能の最適化時
- Row-Level Security（RLS）の実装時
ルールカテゴリ（優先度順）
| 優先度 | カテゴリ | 影響度 | プレフィックス |
|---|---|---|---|
| 1 | クエリパフォーマンス | 致命的 | query- |
| 2 | 接続管理 | 致命的 | conn- |
| 3 | セキュリティ / RLS | 致命的 | security- |
| 4 | スキーマ設計 | 高 | schema- |
| 5 | 並行性 / ロック | 中〜高 | lock- |
| 6 | データアクセスパターン | 中 | data- |
| 7 | 監視 / 診断 | 低〜中 | monitor- |
| 8 | 高度な機能 | 低 | advanced- |
使い方
詳細な説明と SQL 例については、個別のルールファイルを参照してください：
references/query-missing-indexes.md
references/query-partial-indexes.md
references/_sections.md
各ルールファイルには以下が含まれます：
- なぜ重要かについての簡潔な説明
- 誤った SQL 例とその解説
- 正しい SQL 例とその解説
- オプションの EXPLAIN 出力またはメトリクス
- 追加のコンテキストと参考情報
- Supabase 固有の注意点（該当する場合）