数据库目录 / MongoDB
MongoDB 官方文档目录
文档型 NoSQL 数据库,使用 BSON 存储灵活结构,支持副本集、分片集群与聚合管道。
文档章节
- 文档总览 — 手册、Atlas 与驱动文档入口。
- 安装与配置 — 自建部署、配置文件与连接串。
- CRUD 与聚合 — 查询、更新、聚合管道与事务。
- 索引 — 单列、复合、文本、地理与通配索引。
- 复制与分片 — 副本集选举、分片键与均衡器。
- 备份恢复 — mongodump、文件系统快照与 Atlas 备份。
- 性能调优 — 执行计划、Profiler 与服务器参数。
- 常见问题 · 版本升级 — 升级前先读目标版本发行说明与不兼容变更,完成备份和回滚演练,再按“测试库→从库→主库”的顺序灰度执行。 必须逐个主版本升级,Feature Compatibility Version 最后再提升。
- 常见问题 · 连接与网络 — 按“客户端→DNS→网络→端口→认证→权限”的顺序逐层验证,先用 telnet/nc 确认端口可达,再查服务端监听与认证日志。 副本集连接串需带 replicaSet 参数,分片集群需连接 mongos 而非直接连分片。
- 常见问题 · 账号与权限 — 按最小权限原则拆分管理账号、应用账号与只读账号,禁止应用使用超级用户;权限问题先确认认证方式,再查对象级授权与角色继承。 内置角色之外应自定义最小权限角色,并开启认证与审计。
- 常见问题 · 高可用与故障转移 — 高可用方案要先明确故障检测、选主规则与数据一致性边界,再考虑自动切换;切换必须配合客户端重连、读写分离与回切演练。 副本集自动选主,需保证多数派存活;跨机房部署注意选举优先级。
- 常见问题 · 锁与死锁 — 先找到持锁会话与等待链,再判断是长事务、缺失索引导致锁范围扩大,还是 DDL 与业务事务冲突;优先缩短事务,终止会话只作为最后手段。 db.currentOp() 找长时间操作,关注 WiredTiger 写冲突与事务锁。
- 常见问题 · 事务与隔离级别 — 隔离级别越高一致性越强但并发越低;先确认业务能接受的异常(脏读、不可重复读、幻读),再选择级别并用锁等待与死锁指标验证。 MongoDB 的具体命令与视图请以官方文档对应章节为准。
- 常见问题 · 表空间与磁盘空间 — 先确认是数据增长、日志膨胀、临时文件还是删除后未回收;再选择归档、清理、重建或扩容,避免在业务高峰做高 IO 操作。 MongoDB 的具体命令与视图请以官方文档对应章节为准。
- 常见问题 · 内存与缓存 — 先区分数据缓存、连接内存、排序/临时内存与内存泄漏,再结合命中率与换页情况判断是容量不足还是参数不合理。 WiredTiger 缓存默认占物理内存一半,需为文件系统与其他进程预留。
- 常见问题 · 连接数治理 — 连接数打满先看活跃连接与空闲连接比例,再定位连接池配置、慢查询占用与连接泄漏;盲目调大上限可能压垮数据库。 db.serverStatus().connections 查看当前与可用连接,应用侧连接池大小要匹配。
- 常见问题 · 字符集与排序规则 — 乱码通常来自客户端、连接、库表与存储四层字符集不一致;先确认全链路编码,再决定转换或重建,避免直接修改生产表字符集。 MongoDB 的具体命令与视图请以官方文档对应章节为准。
- 常见问题 · 分区与数据归档 — 先按时间或业务维度评估查询与清理模式,再选择分区、归档表或冷热分离;清理必须可回滚、可审计,并避免大事务与长时间锁表。 时间序列集合或分片键设计决定归档效率,避免大范围删除造成复制压力。
- 常见问题 · 监控与告警 — 监控要覆盖可用性、连接、容量、复制、锁等待、慢查询与错误日志;告警必须有阈值、分级、抑制与处置手册,避免告警疲劳。 mongodb_exporter 关注副本集状态、oplog 窗口、连接与 WiredTiger 缓存。
- 常见问题 · 数据迁移 — 迁移分为结构、存量数据、增量同步与割接四步;先做兼容性评估与试迁移,再用校验和/抽样比对保证一致,最后准备回滚方案。 mongodump/mongorestore 或 Atlas Live Migration,注意索引与分片键。
- 常见问题 · 安全加固 — 安全加固从网络边界、认证授权、传输加密、静态加密、审计与补丁六方面入手,优先消除公网暴露、弱口令与过度授权。 启用认证、TLS、字段级加密与审计,避免默认无认证启动。
- 常见问题 · 错误码速查 — 报错先记录完整错误码、SQLSTATE 与上下文,再按官方错误手册定位;不要只看最后一层报错,应用、驱动与代理层都可能改写错误。 错误码与 codeName 配合日志组件过滤,分片场景注意 mongos 聚合错误。
- 常见问题 · 性能压测 — 压测要模拟真实读写比例、数据量与并发,逐步加压倒拐点;关注 P95/P99 延迟、错误率与资源瓶颈,而不是只看峰值 TPS。 使用 YCSB 或 mongoperf,关注 WiredTiger 缓存与读写关注级别。
- 常见问题 · 统计信息与执行计划 — 优化器依赖统计信息估算行数,统计过期或分布倾斜会导致计划突变;大表变更后及时收集统计信息,并对关键 SQL 固定或监控执行计划。 用 collStats 与 explain 查看计划选择,索引基数变化后重建索引并观察 plans 缓存。
- 常见问题 · 分区表与冷热分离 — 分区用于管理大表与历史数据,不必然提升查询性能;按时间或业务维度分区,并确保查询条件能命中分区裁剪,冷数据及时归档或降冷存储。 分片集群按分片键切分数据,注意分片键选择与数据倾斜。
- 常见问题 · 账号权限与最小授权 — 按角色分配权限,应用账号只授予必要对象的 DML 权限,禁止使用超级账号连接业务;定期回收闲置账号与过高权限,并保留变更记录。 启用认证并按内置角色或自定义角色授权,禁止应用使用 root。
- 常见问题 · 审计日志与合规 — 审计要明确目标:登录、DDL、敏感数据访问与权限变更;只审计必要范围,日志独立存储并设置留存周期,避免审计表写满业务表空间。 使用数据库审计或 mongod 日志过滤,企业版支持 auditLog 配置。
- 常见问题 · 在线 DDL 与大表变更 — 大表变更先确认是否支持 Online DDL、是否会锁表与重建表;优先在低峰执行,必要时使用 gh-ost、pt-online-schema-change 或原生在线变更工具。 4.4+ 支持部分在线索引构建,分片集群变更需评估各分片影响。
- 常见问题 · 主从与副本延迟 — 复制延迟先区分网络、主库写入压力、从库回放能力与锁冲突;优先解决大事务与无主键批量更新,再考虑并行复制与硬件升级。 用 rs.status() 查看 optime 与 lag,关注从节点回放与大事务。
- 常见问题 · 容量规划与磁盘治理 — 容量规划按数据增长、日志增长与备份保留三部分测算;保持磁盘水位低于 70%,对日志与临时空间单独监控,预留扩容与归档时间窗。 监控 dbStats 与磁盘水位,oplog 大小按写入量规划,预留 compact 空间。
- 常见问题 · 数据归档与清理 — 归档按业务保留策略执行,优先用分区切换或分批删除,避免一次性大事务;归档前校验一致性,归档后保留可追溯的校验与恢复手段。 用 TTL 索引自动过期,或按时间分批删除并关注 oplog 与磁盘。
- 常见问题 · 连接池与短连接 — 连接池大小按数据库并发处理能力与单条 SQL 耗时估算,不是越大越好;短连接会放大握手与认证开销,应用侧必须复用连接并设置合理的最大连接与空闲回收。 驱动连接池 maxPoolSize 需与 mongod 连接上限匹配,避免连接风暴。
- 常见问题 · 数据导入导出与迁移 — 迁移先确认字符集、类型映射与自增/序列策略,使用一致性快照导出;导入时关闭非必要约束与索引、分批提交,最后做行数与校验和比对。 mongodump/mongorestore 配合 --oplog 保证一致性,分片集群需通过 mongos 导出。
相关知识条目
- MongoDB 索引如何设计与优化?按等值、排序、范围的顺序设计复合索引,用执行计划核对扫描文档数与是否命中索引。
- MongoDB 分片集群热点与均衡问题如何排查?从分片键选择、chunk 分布、jumbo chunk 与均衡器状态判断热点来源,再决定拆分或重建分片键。
- MongoDB 从节点延迟、oplog 窗口不足如何排查?先确认复制延迟与 oplog 窗口,再检查从节点资源、写压力与长事务;窗口过小会导致从节点无法追赶而进入全量同步。
- MongoDB 分片集群 chunk 迁移卡住或均衡失败怎么办?先确认 balancer 状态与迁移会话,再检查目标分片磁盘、网络与写入压力,避免频繁手动 moveChunk 造成抖动。
- MongoDB 连接数暴涨或 WiredTiger 缓存不足如何判断?连接暴涨多来自驱动连接池与副本集发现异常;缓存不足会表现为大量 eviction 与读延迟上升,需要分别处理。