mcpField
P
postgres-best-practices

postgres-best-practices

github.com/neondatabase数据与数据库531.9k 次安装9 周前更新
代码仓库

关于 postgres-best-practices

postgres-best-practices 是面向 PostgreSQL 使用者的实践指南，覆盖版本 14 至 18。它通过按主题组织的参考资料，帮助处理数据库设计、查询性能、运维、安全与迁移等工作。

主要功能

  1. 01覆盖 PostgreSQL 14 至 18
  2. 02提供模式设计与索引指南
  3. 03涵盖查询优化和常见模式
  4. 04包含性能诊断与连接池
  5. 05说明复制、备份和恢复
  6. 06涵盖安全、升级与批量加载

适用场景

  1. 01设计表结构、数据类型和分区
  2. 02分析 EXPLAIN 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+]、[PG18+]）；依赖环境的示例会注明所需权限、扩展或多节点设置。

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.md阅读 EXPLAIN ANALYZE、解决瓶颈、调整规划器
查询模式references/query-patterns.mdCTE、窗口函数、LATERAL 联接、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