supabase-postgres-best-practices

Supabase Postgres のベストプラクティス

使用する場面

Supabase の Postgres パフォーマンス最適化とベストプラクティスが必要な場合に、このスキルを使用します。Postgres のクエリ、スキーマ設計、データベース設定を作成、レビュー、最適化する場合に使用してください。

Supabase が管理する、Postgres の包括的なパフォーマンス最適化ガイドです。8 つのカテゴリにわたるルールが含まれており、影響度の高い順に並べることで、自動クエリ最適化とスキーマ設計の指針となります。

適用する場面

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

• SQL クエリの作成やスキーマの設計
• インデックスの実装やクエリの最適化
• データベースのパフォーマンス問題のレビュー
• コネクションプーリングやスケーリングの設定
• Postgres 固有の機能向けの最適化
• 行レベルセキュリティ（RLS）の使用

実行とエビデンスに関する境界

SQL は説明用であり、稼働中のデータベースを変更する指示ではありません。DDL/DML、グローバル設定、リセット、拡張機能の変更を行う前に、対象、権限、ロック、バックアップ、ロールバックを確認してください。EXPLAIN ANALYZE は対象の文を実行するため、SELECT であっても副作用を引き起こす可能性があります。事前に内容を確認し、必要に応じて使い捨ての環境を使用してください。ここに記載されている速度向上、行数、メモリの推定値、実行計画の出力はすべて例であり、実測に基づく保証ではありません。同等のワークロードでベンチマークを行い、最適化の際も RLS のセマンティクスを維持してください。

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

優先度	カテゴリ	影響度	プレフィックス
1	クエリパフォーマンス	CRITICAL	query-
2	コネクション管理	CRITICAL	conn-
3	セキュリティと RLS	CRITICAL	security-
4	スキーマ設計	HIGH	schema-
5	同時実行とロック	MEDIUM-HIGH	lock-
6	データアクセスパターン	MEDIUM	data-
7	モニタリングと診断	LOW-MEDIUM	monitor-
8	高度な機能	LOW	advanced-

使用方法

詳しい説明と SQL の例については、個々のルールファイルを参照してください。

references/query-missing-indexes.md
references/query-partial-indexes.md
references/_sections.md

各ルールファイルには、以下が含まれています。

• 重要である理由の簡単な説明
• 誤った SQL の例とその説明
• 正しい SQL の例とその説明
• 任意の EXPLAIN 出力またはメトリクス
• 追加の背景情報と参考資料
• Supabase 固有の注意事項（該当する場合）

参考資料

• https://www.postgresql.org/docs/current/
• https://supabase.com/docs
• https://wiki.postgresql.org/wiki/Performance_Optimization
• https://supabase.com/docs/guides/database/overview
• https://supabase.com/docs/guides/auth/row-level-security

制限事項

• タスクが上流の製品または API の対象範囲に明確に該当する場合にのみ、このスキルを使用してください。
• 変更を行う前に、コマンド、API の動作、価格、クォータ、認証情報、デプロイによる影響を、最新の公式ドキュメントで確認してください。
• 生成された例を、環境固有のテスト、セキュリティレビュー、破壊的または高コストな操作に対するユーザーの承認の代わりとして扱わないでください。