supabase-postgres-best-practices について
Supabase が保守する、Postgres のパフォーマンスと設計に関するガイドです。影響度順の 8 分野に整理され、クエリやスキーマの最適化、接続やセキュリティの課題に役立ちます。
主な機能
- 01優先度別の 8 分野のルール
- 02クエリとインデックスの最適化
- 03接続と並行処理の指針
- 04セキュリティと RLS の実践
- 05スキーマとデータアクセス設計
- 06モニタリングと診断
活用シーン
- 01SQL クエリとインデックスの最適化
- 02Postgres の性能問題の調査
- 03スキーマとアクセス方式の設計
- 04コネクションプーリングと RLS の設定
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ openai/ plugins --skill supabase-postgres-best-practicesインストール後、Claude Code で/supabase-postgres-best-practicesを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
CHANGELOG.mdreferences/_contributing.md_sections.md_template.mdadvanced-full-text-search.mdadvanced-jsonb-indexing.mdconn-idle-timeout.mdconn-limits.mdconn-pooling.mdconn-prepared-statements.mddata-batch-inserts.mddata-n-plus-one.mddata-pagination.mddata-upsert.mdlock-advisory.mdlock-deadlock-prevention.mdlock-short-transactions.mdlock-skip-locked.mdmonitor-explain-analyze.mdmonitor-pg-stat-statements.mdmonitor-vacuum-analyze.mdquery-composite-indexes.mdquery-covering-indexes.mdquery-index-types.mdquery-missing-indexes.mdquery-partial-indexes.mdschema-constraints.mdschema-data-types.mdschema-foreign-key-indexes.mdschema-lowercase-identifiers.md詳細
Supabase Postgres のベストプラクティス
Supabase が管理する、Postgres の包括的なパフォーマンス最適化ガイドです。8 つのカテゴリにわたるルールを収録し、影響度に基づいて優先順位を付けることで、自動クエリ最適化とスキーマ設計の指針となります。
適用するタイミング
以下の場合に、このガイドラインを参照してください。
- SQL クエリを記述するとき、またはスキーマを設計するとき
- インデックスの実装やクエリの最適化を行うとき
- データベースのパフォーマンスに関する問題を調査するとき
- コネクションプーリングやスケーリングを設定するとき
- Postgres 固有の機能向けに最適化するとき
- 行レベルセキュリティ(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 固有の注記(該当する場合)
参考資料
コメント
Markdown 対応