supabase-postgres-best-practices について
Supabaseが管理するPostgres性能最適化ガイドです。SQL作成やスキーマ設計、性能調査に使え、8カテゴリのルールを影響度順に示し、誤りと修正例を掲載します。
主な機能
- 018カテゴリの最適化ルールを収録
- 02影響度に基づいて優先順位を整理
- 03誤ったSQLと修正例を掲載
- 04インデックス、接続プーリング、RLSを扱う
- 05PostgresとSupabaseの参考資料を掲載
活用シーン
- 01クエリ作成やスキーマ設計
- 02データベース性能の調査と最適化
- 03インデックス、プーリング、RLS設定のレビュー
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ fcakyon/ claude-codex-settings --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 対応