SuperAPI AI 工具集

mongodb-schema-design

数据与分析

查看项目

更新于 10-16 03:47

技能介绍

用途:这是 MongoDB 官方维护的 Schema 设计技能,用于设计新数据模型、从 SQL 迁移、审查现有模型、排查慢查询与文档膨胀,以及在嵌入与引用之间做决策。核心原则是“一起访问的数据应存储在一起”,围绕查询而非实体设计 Schema。

主要能力:包含三类规则。反模式 3 条:不必要的多集合拆分、过度规范化与频繁 $lookup、冗余或未被使用的索引。基础 4 条:嵌入与引用选择、文档模型基础、Schema 校验、16MB 文档上限。设计模式 11 条:近似计数、归档、属性模式、分桶、预计算、文档版本化、扩展引用、离群值、多态、Schema 版本化、原生时间序列集合。

使用方式:先评估环境(新设计还是已有生产库、是否在 Atlas 及层级),再判断负载类型(读多、写多或均衡,可用 db.serverStatus().opcounters 验证),然后与用户共同选择数据来源:查询统计、Atlas 慢查询日志、代码库或自然语言描述。查询统计仅覆盖读操作且需 Atlas M10+;慢查询日志覆盖读写,同样需 M10+。优先优化既频繁又慢的查询。

MCP 集成:连接 MongoDB MCP Server 后可自动执行校验,如 mcp__mongodb__collection-schema 推断结构、mcp__mongodb__aggregate 测量文档与数组大小、mcp__mongodb__db-stats 查看集合统计。建议使用 --readOnly。写操作与破坏性操作必须经用户明确确认后才执行。

跨客户端:可用于 GitHub Copilot、Claude Code 与 Codex;Codex 需同步到 $CODEX_HOME/skills/mongodb-schema-design 并重启。无 MCP 时使用官方文档、驱动、Atlas UI 或本地只读数据作为回退,不得请求或提交连接串与密钥。

限制:嵌入与引用建议为粗略指引,需结合实际负载验证;16MB 为硬限制;部分数据来源有 Atlas 层级要求。