supabase-postgres-best-practices について
Supabase Postgres Best Practicesは、Supabaseが管理するクエリ最適化とデータベース設計のリファレンススキルです。優先度付きのルールで、性能、接続、セキュリティ、スキーマなどを扱い、個別の推奨事項にSQL例を示します。
主な機能
- 01Postgresに関する8カテゴリの指針
- 02影響度順に並ぶルール
- 03各ルールのSQL例
- 04RLSとコネクションプーリングの解説
- 05クエリとVACUUMの診断
活用シーン
- 01遅いSQLクエリの最適化
- 02インデックスとスキーマの設計
- 03RLSとデータベースセキュリティの確認
- 04接続やVACUUMの問題調査
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ laguagu/ claude-code-nextjs-skills --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)を扱う
クイック判断ツリー
Problem?
├─ Slow query → query-missing-indexes, query-composite-indexes, monitor-explain-analyze
├─ Connection errors / timeouts → conn-pooling, conn-limits, conn-idle-timeout
├─ Deadlocks / long transactions → lock-short-transactions, lock-deadlock-prevention
├─ Bulk load slow → data-batch-inserts, data-upsert
├─ Table bloat / VACUUM issues → monitor-vacuum-analyze
├─ JSONB queries slow → advanced-jsonb-indexing
├─ FTS / search quality → advanced-full-text-search (pair with /postgres-semantic-search for BM25 + vector)
└─ Security / multi-tenant → security-* rules, RLS
関連スキル
/postgres-semantic-search— ベクトル検索(pgvector)、ハイブリッド BM25 + セマンティック検索、ParadeDB/nextjs-chatbot— チャットボットのオーケストレーション、セッション DB、フィードバック、HITL/ai-sdk— バックエンド統合向けの AI SDK パターン
優先度別のルールカテゴリ
| 優先度 | カテゴリ | 影響度 | 接頭辞 |
|---|---|---|---|
| 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 固有の注意事項(該当する場合)
参考資料
コメント
Markdown 対応