mongosh

MongoDB 现代命令行 Shell

补充说明

mongosh 是 MongoDB 官方的新一代 Shell，替代旧的 mongo。它支持连接字符串、JavaScript 语法、自动补全，并能在脚本中用 --eval 执行。

常用示例

mongosh "mongodb://app@127.0.0.1:27017/appdb?authSource=admin"
mongosh "mongodb+srv://app@cluster.example.com/appdb"
mongosh --host rs0/host1:27017,host2:27017 -u app --authenticationDatabase admin
mongosh --quiet --eval 'db.runCommand({ ping: 1 })'
mongosh appdb --eval 'db.orders.countDocuments({})'
mongosh --tls --tlsCAFile ca.pem "mongodb://app@db:27017/appdb"

常用交互命令：

show dbs
show collections
db.orders.find({ status: "paid" }).limit(5)
db.orders.createIndex({ createdAt: 1 })
db.orders.explain("executionStats").find({ status: "paid" }).limit(5)
rs.status()
db.currentOp()

易错点与排错

• 认证库由 authSource 决定；用户建在 admin 却连业务库时会认证失败。
• mongodb+srv:// 依赖 DNS SRV 记录；内网或 DNS 受限时改用完整主机列表。
• --eval 里的引号容易被 shell 吃掉；复杂脚本写到文件再 load()。
• find() 默认返回游标，Shell 会打印前 20 条；脚本里要显式遍历或 toArray()。
• 读写关注和读偏好会影响看到的数据；主从延迟场景先确认 readPreference。
• 大结果集不要在 Shell 里一次性拉取；加 limit、投影和索引。
• mongosh 与旧 mongo 的语法有差异；老脚本迁移要先验证。
• TLS、副本集名称和直接连接模式要匹配；directConnection=true 只适合单节点排查。

相关命令

• mongodump — 逻辑备份
• mongorestore — 恢复备份