mcpField
P
postgres-best-practices

postgres-best-practices

github.com/neondatabaseデータ・データベース531.9k 回インストール9 週間前に更新
リポジトリ

postgres-best-practices について

postgres-best-practicesは、PostgreSQL利用者向けの実践ガイドで、バージョン14から18を扱います。テーマ別のリファレンスで、データベース設計、クエリ性能、運用、セキュリティ、移行を解説します。

主な機能

  1. 01PostgreSQL 14〜18に対応
  2. 02スキーマ設計とインデックスの指針
  3. 03クエリ最適化と一般的なパターン
  4. 04性能診断とコネクションプーリング
  5. 05レプリケーション、バックアップ、復旧
  6. 06セキュリティ、アップグレード、一括ロード

活用シーン

  1. 01テーブル、データ型、パーティションの設計
  2. 02EXPLAIN ANALYZEによるボトルネックの診断
  3. 03論理レプリケーションやメジャーアップグレードの計画
  4. 04権限、バックアップ、コネクションプーリングの設定

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/neondatabase/postgres-skills --skill postgres-best-practices

インストール後、Claude Code で/postgres-best-practicesを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

references/
backup-restore.md
bulk-loading.md
connection-pooling.md
hot-standby.md
indexing.md
logical-replication.md
major-version-upgrades.md
performance-diagnostics.md
query-optimization.md
query-patterns.md
schema-design.md
security-roles.md
transaction-isolation.md

詳細

Postgres のベストプラクティス

Postgres を使用する際のガイドラインとベストプラクティスです。スキーマ設計、インデックス作成、クエリ最適化、よくある落とし穴を取り上げます。

サポート対象バージョン

このスキルでは PostgreSQL 14 から 18 を対象としています。バージョン固有の機能にはタグ（例：[PG15+]）が付いています。環境に依存する例では、必要な権限、拡張機能、またはマルチノード構成を明記しています。

PostgreSQL のメジャーバージョンは、それぞれ 5 年間サポートされます。常に最新のマイナーリリースを使用してください。

バージョン初回リリースサポート終了
182025 年 9 月2030 年 11 月
172024 年 9 月2029 年 11 月
162023 年 9 月2028 年 11 月
152022 年 10 月2027 年 11 月
142021 年 9 月2026 年 11 月

出典：postgresql.org/support/versioning

参考資料

領域リソース使用する場面
スキーマ設計references/schema-design.mdテーブルの設計、データ型の選択、正規化、パーティショニング
インデックス作成references/indexing.mdインデックス型、複合インデックス、部分インデックス／カバリングインデックスの選択
クエリ最適化references/query-optimization.mdEXPLAIN ANALYZE の読み取り、ボトルネックの解消、プランナーの調整
クエリパターンreferences/query-patterns.mdCTE、ウィンドウ関数、LATERAL JOIN、UPSERT、JSONB、アンチパターン
パフォーマンス診断references/performance-diagnostics.mdpg_stat ビュー、ロック分析、VACUUM、接続管理
論理レプリケーションreferences/logical-replication.mdパブリッシュ／サブスクライブ型レプリケーション、ライブマイグレーション、CDC
ホットスタンバイreferences/hot-standby.mdストリーミングレプリケーション、読み取りレプリカ、フェイルオーバー
トランザクション分離references/transaction-isolation.md分離レベル、更新の消失、シリアライゼーション失敗、再試行ロジック
バックアップとリストアreferences/backup-restore.mdpg_dump/pg_restore、pg_basebackup、PITR、リカバリ
セキュリティとロールreferences/security-roles.md権限、RLS、pg_hba.conf、認証、SSL
大量データのロードreferences/bulk-loading.mdCOPY のパターン、ETL ステージング、大量ロードの最適化、バッチ処理
コネクションプーリングreferences/connection-pooling.mdPgBouncer の設定、プールモード、プリペアドステートメント、サイジング
メジャーバージョンアップグレードreferences/major-version-upgrades.mdpg_upgrade、論理レプリケーションによる移行、移行前後のチェックリスト

コメント

Markdown 対応