MongoDB 生态 - 官方命令行工具

布满荆棘的人生 2022-07-13 02:40 177阅读 0赞

## [Mongo shell][] ##

MongoDB 的命令行管理工具，也是 MongoDB 最常用的工具，功能非常丰富，比如常用的

*  show dbs / show tables / show users ...
 *  db.stats() 查看 db 的元数据信息
 *  db.colleciont.stats() 查看集合的元数据信息
 *  db.serverStatus() 查看数据库状态信息
 *  rs.conf() 查看复制集的配置信息
 *  rs.status() 查看复制集的状态信息
 *  rs.reconfig() 更改复制集的配置
 *  db.printSlaveReplicationInfo() 查看主备同步延时
 *  db.runCommand() 执行命令
 *  ...

值得一提的是，Mongo shell 还能直接执行js 脚本，对于单个语句没法完成的操作，可以写个简单的 js 脚本，然后通过 mongo shell 来调用，这个功能对于日常的管理、分析等非常方便。

mongo --host localhost:27017 do_something.js

mongo shell 还支持命令历史、命令补全等非常贴心的功能，用起来跟linux bash 的体验差不多。

## [mongostat][] ##

mongostat 也是很常用的工具，能查看MongoDB 实时的增删改查操作的 pqs、以及内存使用、网络吞吐的信息。

$mongostat --host localhost:27017
    insert query update delete getmore command % dirty % used flushes vsize  res qr|qw ar|aw netIn netOut conn                      time
     7803 93665 15601  7803      0 15604|0     6.1   79.7      0  1.8G 1.1G   0|0  14|2   17m    31m   0 2016-11-29T16:42:00+08:00
     7921 95062 15842  7922      0 15842|0     6.4   80.0      0  1.8G 1.1G   7|0  10|1   17m    32m   0 2016-11-29T16:42:01+08:00
     7996 95816 15985  7995      0 15978|0     6.5   79.6      0  1.8G 1.1G   2|0  17|1   17m    29m   0 2016-11-29T16:42:02+08:00
     7995 96038 16001  7995      0 16009|0     7.3   84.7      0  1.8G 1.1G   1|0  13|3   17m    30m   0 2016-11-29T16:42:03+08:00
     7836 93945 15672  7836      0 15665|0     7.3   84.5      0  1.8G 1.1G   0|0  13|1   17m    29m   0 2016-11-29T16:42:04+08:00

mongostat 也支持按复制集的方式去连接，可以同时查看复制集多个节点的实时性能数据。

如果使用的是MongoDB 3.2的最新版本，dirty持续超过20 或者 used 持续超过95，说明实例的访问已经超负荷了，可能 cpu 或 IO 资源已经不够用了，需要重点关注下。

## [mongotop][] ##

mongotop 能实时查看 MongoDB 在哪些集合上花的读写时间最多，能快速找出实例里的热点集合。

$mongotop --host localhost:27017
             ns    total    read    write    2016-11-29T16:52:54+08:00
    sb.sbtest30    673ms     0ms    673ms
    sb.sbtest32    666ms     0ms    666ms
    sb.sbtest56    665ms     0ms    665ms
    sb.sbtest36    660ms     0ms    660ms
    sb.sbtest38    651ms     0ms    651ms
    sb.sbtest29    648ms     0ms    648ms
    sb.sbtest21    647ms     0ms    647ms
     sb.sbtest5    647ms     0ms    647ms
    sb.sbtest53    647ms     0ms    647ms
    sb.sbtest28    644ms     0ms    644ms

## [mongoimport/mongoexport][mongoimport_mongoexport] ##

mongoexport 支持以 JSON 或者 CSV 的格式导出 MongoDB 存储的数据，然后使用 mongoimport 将其导入到其他的实例；mongoexport 支持导出单个集合的数据，并能指定查询条件来导出部分符合条件的数据。

mongoexport --db sales --collection contacts --query '{"field": 1}'

## [mongodump/mongorestore][mongodump_mongorestore] ##

mongodump 与 mongoexport 类似，可用于导出 MongoDB 的数据，不同的时，mongodump 导出的数据以 BSON 的格式存储（BSON 格式数据可以通过 [bsondump][] 工具来转换为 json），存储空间占用上比 JSON、CSV 更小，另外，mongodump 还支持对导出的数据进行压缩、归档，所以如果要对 MongoDB 的数据进行定期备份，推荐使用 mongodump 或 直接进行物理文件备份。

mongodump --archive=test.20150715.gz --gzip --db test

## [mongooplog][] ##

mongooplog 可以用于2个独立的 MongoDB 实例间的数据同步，它会不断的从源实例拉取 oplog（tailable cursor），然后重放到目标实例。

mongooplog  --from mongodb0.example.net --host mongodb1.example.net

## [mongofiles][] ##

mongofiles 是 gridfs 的命令行客户端，用于向 MongoDB 存储、读取文件，mongofiles 支持put、get、list等接口。

$mongofiles --host localhost:27017 put hello
    $mongofiles --host localhost:27017 get hello

## [mongosniff][] ##

mongosniff 是 MongoDB 的抓包工具，直接下载二进制包可能并不包含这个工具，需要下载源码编译出来，mongosniff 可以抓取某个 MongoDB 实例的所有请求及应答数据，对于 MongoDB driver 的开发者非常有帮助，也可以用于一些网络问题的定位。

$sudo mongosniff --source NET bond0 27017 | head -n 10
    sniffing... 27017
    10.1.2.3.3:31405  -->> 10.1.2.3.4:27017   172 bytes  id:165a40  1464896
     command: replSetHeartbeat database: admin metadata: { $replData: 1 } commandArgs: { replSetHeartbeat: "mongo-9554", configVersion: 23, from: "r101072137.sqa.zmf:9554", fromId: 0, term: 69 } inputDocs: [ ]
    10.1.2.3.4:27017  <<--  10.1.2.3.3:31405   445 bytes  id:133027 1257511
     commandReply: { ok: 1.0, state: 2, v: 23, hbmsg: "", set: "mongo-9554", syncingTo: "r101072137.sqa.zmf:9554", term: 69, primaryId: 0, durableOpTime: { ts: Timestamp 1480088534000|1, t: 69 }, opTime: { ts: Timestamp 1480088534000|1, t: 69 } } metadata: { $replData: { term: 69, lastOpCommitted: { ts: Timestamp 1480088534000|1, t: 69 }, lastOpVisible: { ts: Timestamp 1479887534000|1, t: 68 }, configVersion: 23, replicaSetId: ObjectId('000000000000000000000000'), primaryIndex: 0, syncSourceIndex: 0 } } outputDocs: [ ]

## [mongoperf][] ##

mongoperf 的名字很容易误导人，乍一看以为是 mongodb 的性能测试工具，实际上它是用来测试磁盘 IO 性能的工具。

echo "{nThreads:16,fileSizeMB:1000,r:true,w:true}" | mongoperf
    new thread, total running : 1
    read:1 write:1
    2958 ops/sec 11 MB/sec
    3022 ops/sec 11 MB/sec
    3023 ops/sec 11 MB/sec
    2832 ops/sec 11 MB/sec

[Mongo shell]: https://docs.mongodb.com/getting-started/shell/client/
[mongostat]: https://docs.mongodb.com/manual/reference/program/mongostat/
[mongotop]: https://docs.mongodb.com/manual/reference/program/mongotop/
[mongoimport_mongoexport]: https://docs.mongodb.com/manual/reference/program/mongoexport/
[mongodump_mongorestore]: https://docs.mongodb.com/manual/reference/program/mongodump/
[bsondump]: https://docs.mongodb.com/manual/reference/program/bsondump/
[mongooplog]: https://docs.mongodb.com/manual/reference/program/mongooplog/
[mongofiles]: https://docs.mongodb.com/manual/reference/program/mongofiles/
[mongosniff]: https://docs.mongodb.com/manual/reference/program/mongosniff/
[mongoperf]: https://docs.mongodb.com/manual/reference/program/mongoperf/