supabase-postgres-best-practices

Supabase Postgres ベストプラクティス

Supabase が管理する、Postgres 向けの包括的なパフォーマンス最適化ガイドです。8 つのカテゴリにわたるルールを、影響度の順に優先順位付けして収録しており、自動化されたクエリ最適化とスキーマ設計を支援します。

適用するタイミング

以下の場合に、これらのガイドラインを参照してください:

• SQL クエリを作成する、またはスキーマを設計する場合
• インデックスを実装する、またはクエリを最適化する場合
• データベースのパフォーマンス問題をレビューする場合
• コネクションプーリングやスケーリングを設定する場合
• Postgres 固有の機能を活用するために最適化する場合
• Row-Level Security (RLS) を扱う場合

優先度別のルールカテゴリ

優先度	カテゴリ	影響度	プレフィックス
1	Query Performance	CRITICAL	query-
2	Connection Management	CRITICAL	conn-
3	Security & RLS	CRITICAL	security-
4	Schema Design	HIGH	schema-
5	Concurrency & Locking	MEDIUM-HIGH	lock-
6	Data Access Patterns	MEDIUM	data-
7	Monitoring & Diagnostics	LOW-MEDIUM	monitor-
8	Advanced Features	LOW	advanced-

使い方

各ルールの詳細な説明と SQL の例については、個別のルールファイルを読んでください:

rules/query-missing-indexes.md
rules/schema-partial-indexes.md
rules/_sections.md

各ルールファイルには以下が含まれます:

• そのルールが重要な理由の簡単な説明
• 誤った SQL の例と解説
• 正しい SQL の例と解説
• 任意の EXPLAIN 出力またはメトリクス
• 追加のコンテキストと参考資料
• Supabase 固有の注意点（該当する場合）

全ルールをまとめたドキュメント

すべてのルールを展開した完全なガイドは AGENTS.md を参照してください。