本文更新于2022-04-21,使用MongoDB 4.4.5。
bsondump
BSON查看工具。
bsondump BSONFILENAME
mongo
JavaScript shell。
mongo [OPTION] [DB_NAME|HOST[:PORT][/DB_NAME]|MONGODB_URI] [JS_FILENAME[ ...]]
OPTION可为:
- --nodb:启动shell时不连接到任何mongod。
- --norc:启动shell时不加载用户主目录下的.mongorc.js。默认会加载。
- --password|-p [PASSWORD]:指定密码。如不指定PASSWORD,则于交互界面提示输入密码。
- --quiet:不打印连接成功后的提示信息。
- --username|-u USERNAME:指定用户名。
如不指定DB_NAME或HOST[:PORT][/DB_NAME或MONGODB_URI,默认连接到localhost:27017/test。
MONGODB_URI的格式为:mongodb://[USERNAME[:PASSWORD]@]HOST[:PORT][,...,HOST1[:PORT1]][/[DB_NAME]][?NAME=VALUE[&...&NAME1=VALUE1]]
。NAME=VALUE可为:
- replicaSet=REPLSET_NAME:副本集名字。如使用此参数,可指定任意个(并不需要所有)HOST[:PORT],会自动选择主节点连接。
如指定JS_FILENAME,则依次执行脚本文件然后退出(相对路径根据shell运行目录)。否则,以交互方式使用shell。
mongod
MongoDB服务器。
mongod [OPTION]
mongod --replSet REPLSET_NAME
mongod --repair [--repairpath DST_DIR] [--dbpath DIR]
OPTION可为:
- -v:日志级别。不使用该选项则为最低值0;-vvvvv为最高值5(记录几乎所有操作,包括每一个请求处理的内容)。
- --auth:启用身份验证。
- --bind_ip:监听的IP。
- --dbpath DIR:数据目录。默认为/data/db(Windows为当前驱动器)。
- --config|-f FILENAME:配置文件。命令行指定的选项可覆盖配置文件中的值。
- --configsvr:作为配置服务器启动。默认端口为27019,默认数据目录为/data/configdb。
- --fork:创建后台运行的子进程。需同时使用--logpath。
- --directoryperdb:每个数据库存放在单独的目录种。
- --help:查看帮助。
- --journalCommitInterval MICROSECONDS:日记系统进行提交的时间间隔。单位为毫秒,最小为2,最大为500。
- --logappend:以追加方式写入日志文件。需同时使用--logpath。
- --logpath FILENAME:日志输出文件。如不指定则输出至标准输出。
- --noprealloc:禁止预分配数据文件。
- --noscripting:禁止执行JavaScript脚本。注意,某些shell辅助函数依赖于JavaScript脚本。
- --nounixsocket:不监听UNIX套接字。
- --port PORT:监听的端口。默认为27017。
- --profile LEVEL:设置系统分析器等级。0为关闭系统分析器,1为只记录慢查询,2为记录所有操作。
- --quiet:不输出日志。
- --repair:修复数据。不会监听端口,但会输出日志。
- --repairpath DST_DIR:指定修复时复制文件的目标目录。
- --replSet REPLSET_NAME:指定副本集名称,作为副本集节点启动。不使用此选项,则以单机模式启动。
- --shardsvr:作为分片启动。默认端口为27018,
- --slowms MICROSECONDS:设置系统分析器的慢查询阈值。单位为毫秒。
- --syncdelay SECONDS:将脏页刷新到磁盘的时间间隔。单位为秒。
配置文件的格式如下:
#
后面的内容作为注释忽略。- 指定参数的语法为
OPTION = VALUE
。OPTION为命令行参数去掉--
,如命令行参数为不需指定值的开关选项则VALUE设置为true
。
mongodump
数据备份工具。备份过程中会继续执行写入操作。
mongodump [OPTION]
OPTION可为:
- --gzip:将.bson数据文件和.metadata.json元数据文件使用gzip压缩。
- --help:查看帮助。
- --oplog:同时转储备份过程中的操作日志oplog,以获得备份时间点的快照。如备份副本集,必需使用此选项。
- --out|-o DUMPDIR:输出目录。默认为dump。输出目录中包含若干个名字为数据库名的目录,每个目录中包含若干个集合名开头的.bson数据文件和.metadata.json元数据文件。
- --port PORT:服务器的端口。
- --version:查看版本。
如连接至副本集,则会自动选择一个备份节点执行备份操作。
如连接至mongos,则会备份所有分片。
mongofiles
GridFS工具。
mongofiles [OPTION] COMMAND [ARG]
OPTION可为:
- --db|-d DBNAME:指定数据库。
- --help:查看帮助。
- --local|-l LOCALFILENAME:本地文件名,只用于
put
和get
子命令。
COMMAND [ARG]可为(FILENAME可为文件路径):
- delete FILENAME:从GridFS中删除文件。
- get FILENAME:将GridFS中的文件下载到文件系统中。
- list [PREFIX]:列出GridFS中的文件。以前缀匹配查找。如不指定前缀,则列出所有文件。
- put FILENAME:将文件系统中的文件上传到GridFS。
- search SUBSTRING:在GridFS中搜索文件。搜索子串。
mongorestore
数据恢复工具。
mongorestore [OPTION] [DUMPDIR|BSONFILENAME]
OPTION可为:
- --collection|-c COLLECTIONNAME:只恢复指定的集合。
- --db|-d DBNAME:只恢复指定的数据库。
- --dir DUMPDIR:需恢复的备份数据目录。默认为dump。
- --drop:进行数据替换,在恢复集合前先删除之。
- --gzip:从使用gzip压缩方式备份的数据中恢复。
- --oplogReplay:重放操作日志oplog,以获得备份时间点的快照。
- --port PORT:服务器的端口。
- --version:查看版本。
如连接至mongos,则会恢复所有分片。
mongos
分片路由。
mongos [OPTION]
mongos --configdb CONFIG
OPTION可为:
- --configdb CONFIG:指定配置服务器,格式为REPLSET_NAME/HSOT_PORT<,...,HSOT_PORT>。
- --maxConns N:指定最大连接数量。
- --nosplit:关闭块的拆分。
- --port PORT:指定监听端口。默认为27017。
mongostat
状态统计工具。每隔一段时间输出一次,统计自上一次输出以来的信息。可连接至副本集和分片集群。
mongostat [OPTION] [INTERVAL_SECONDS]
OPTION可为:
- --discover:寻找副本集或分片集群的所有节点,针对每个节点也输出一行信息。
输出包含以下字段:
- host:主机地址。
- insert:插入的次数。
- query:查询的次数。
- update:更新的次数。
- delete:删除的次数。
- getmore:查询游标时获取更多数据的次数。
- command:执行命令的次数。
- dirty:
- used:
- flushes:数据刷新至磁盘的次数。
- mapped:映射的内存大小。通常约等于数据目录的大小。
- vsize:正在使用的虚拟内存大小。通常为数据目录的2倍(一次用于映射文件,一次用于日记系统)。
- res:正在使用的内存大小。通常应尽量接近机器的内存大小。
- faults:
- qrw:读写操作的队列大小。即被阻塞的读写操作的数量。读和写以“|”分隔。
- arw:读写的活跃客户端数量。即正在进行读写的客户端的数量。读和写以“|”分隔。
- net_in:通过网络传输进来的字节数。不必和操作系统的统计相等。
- net_out:通过网络传输出去的字节数。不必和操作系统的统计相等。
- conn:打开的连接数。包括输入和输出连接。
- set:副本集名称。
- repl:副本集的节点状态。
- time:统计的时间点。
mongotop
集合实时监控工具。每隔一段时间输出一次。
mongotop [OPTION] [INTERVAL_SECONDS]
OPTION可为:
- --locks:查看每个数据库的锁状态。