SuperAPI AI 工具集

database-engineering

编程与开发

查看项目

更新于 10-26 20:22

技能介绍

用途

这是一个用于设计、优化和演进生产环境关系型数据库的纪律性框架,对 PostgreSQL 有明确倾向,但多数原则适用于任何 SQL 数据库。目标是帮助在每个决策点做出正确的取舍,而不只是给出语法参考。适用于设计数据库模式或需要规范化指导、创建与调优索引(复合、部分、覆盖)、理解或优化慢查询与 EXPLAIN 计划、规划迁移(加列、改名、删除、回填)、实现软删除/审计追踪/时态数据、配置连接池(PgBouncer、应用层池)、对大表按时间/哈希/范围分区、选择复制策略(只读副本、逻辑复制)、排查死锁/连接耗尽/锁竞争等场景。该技能明确不适用于 NoSQL/文档存储设计(MongoDB、DynamoDB),以及与底层 SQL 无关的 ORM 专属配置问题。

主要能力

技能围绕若干核心原则展开:先规范化,再在文档化理由支持下反规范化(默认第三范式,反规范化必须是基于实测性能需求的有意决定并写注释说明);按查询而非按表建索引(不服务查询的索引只是写开销和膨胀,加索引前写出其服务的查询并用 EXPLAIN ANALYZE 确认真被使用);迁移必须可逆(破坏性变更使用 expand-contract 模式:加新形态、迁数据、弃旧形态、后续版本删除);先测量后优化(以 EXPLAIN ANALYZE 为事实依据);在设计阶段就规划增长(考虑 100 倍行数、10 倍写入吞吐时哪些列需索引、哪些表需分区、哪些连接会变昂贵)。

内容覆盖:规范化形式(1NF 至 BCNF 及各自适用边界)、索引类型(B-tree、Hash、GIN、GiST、BRIN 的适用场景,复合索引的最左前缀规则)、ACID 与 WAL(MVCC、流式复制与逻辑复制)、连接池(每个 PostgreSQL 连接是 fork 的 OS 进程,约 5-10 MB 内存;PgBouncer 事务模式为常用方案,起点为每核 10-20 个服务器连接)、只读副本(复制延迟可能返回陈旧数据,需要写后一致性的读取不应发往副本)。

使用方式

技能激活时,首次回复以 🧢 emoji 开头。首次激活时会检查已安装的配套技能(运行 ls 命令列出若干技能目录),与 frontmatter 中的 recommended_skills 对比;缺失项会提示一次并可提供安装命令:npx skills add AbsolutelySkilled/AbsolutelySkilled --skill <name>。若推荐列表为空或配套技能均已安装则跳过。需要详细模式时可加载 references/query-optimization.md(EXPLAIN ANALYZE 深入、索引类型、连接策略、常见瓶颈),仅在任务需要时加载,因为文件较长会消耗上下文。

典型任务与示例

资料给出了具体任务示范:以电商领域为例设计 3NF 模式(customers、products、orders、order_items 及外键索引,并说明 unit_price_cents 有意从商品价格反规范化以记录成交价);创建复合索引(等值列在前、范围/排序列在后)、部分索引(仅索引实际查询的行)、覆盖索引(INCLUDE 非过滤列实现 index-only scan),并用 pg_stat_user_indexes 检查索引使用;使用 EXPLAIN (ANALYZE, BUFFERS) 读计划并据信号采取行动(大表 Seq Scan 加索引、行数估算偏差跑 ANALYZE、Hash Join 溢出调 work_mem、Nested Loop 大外表重写为哈希连接、高 shared read 考虑缓存或 BRIN);用 expand-contract 做零停机迁移(加可空列、分批回填并 pg_sleep 让出、最后加 NOT NULL 与默认值);软删除用 deleted_at 加部分索引,合规敏感数据优先硬删除加归档表;给出 PgBouncer 事务模式配置示例及预处理语句不跨连接持久的注意事项;按范围分区并可用 pg_partman 自动化,强调分区键须出现在 WHERE 中才能剪枝。

适用场景与限制

适用于以 PostgreSQL 为主的生产关系型数据库的设计、调优与运维决策。存在若干明确限制与陷阱:Postgres 11 之前 ALTER TABLE 加 NOT NULL 无常量默认值会以排他锁重写整表,11+ 常量默认值安全但运行时计算的默认值仍触发重写;复合索引严格遵循最左前缀;PgBouncer 事务模式会破坏预处理语句(JDBC 设 prepared_statement_cache_size=0 等);普通 VACUUM 不归还磁盘空间,VACUUM FULL 需排他锁,生产表可用 pg_repack;分区剪枝仅在分区键出现在 WHERE 时生效。资料未提供收费、价格、平台支持范围等信息,暂未提供。