MongoDB：mongo Shell 快速参考

Mongo Shell命令历史记录

您可以使用向上和向下箭头键来检索以前在mongo shell中发出的命令。命令历史记录存储在~/.dbshell文件中。有关详细信息，请参见.dbshell。

命令行选项

具体请参考：Mongo Shell页面。

下表显示了Mongo的一些常见选项：

Option	描述
–help / -h	返回有关Mongo选项和使用的信息
–nodb	不连接任何数据库的打开一个新连接
–shell	启用shell接口。如果调用mongo命令并指定一个javascript文件作为参数，或者使用–eval在命令行上指定javascript，则–shell选项在文件执行完毕后为用户提供shell提示。具体请参考执行JaveScript脚本

命令行帮助

命令	描述
help	显示帮助
db.help()	列出db对象上的常用方法。
db.< collection>.help()	显示collection方法的帮助，collection可以存在也可以不存在
show dbs / show databases	显示可用的数据库，类似命令listDatabases
use < db>	切换数据库
show collections	显示当前数据库中可用对象
show users	打印当前数据库的用户列表
show roles	打印当前数据库的所有角色（用户定义的和内置的）列表
show profile	打印最近5次操作，耗时1毫秒或更长时间。具体请参考profile。
load()	执行JaveScript脚本，具体请参考为Mongo Shell编写脚本

基本shell javascript操作

mongo shell为数据库操作提供了一个javascript API。

在mongo shell中，db是引用当前数据库的变量。变量将自动设置为默认数据库测试，或者在使用切换当前数据库时设置。

下表显示了一些常见的javascript操作：

api	描述
db.auth()	如果在安全模式下运行，则对用户进行身份验证
coll = db.< collection>	coll = db.myCollection; – coll.find();
db.collection.find()	查找集合或视图中的文档，并将光标返回到所选文档，参考
db.collection.insertOne()	插入一个新的对象到集合中
db.collection.insertMany()	插入多个新对象到集合中
db.collection.updateOne()	更新集合中一个已经存在的对象
db.collection.updateMany()	更新集合种多个已经存在的对象
db.collection.save()	插入新文档或更新集合中的现有文档
db.collection.deleteOne()	删除集合中的一个对象
db.collection.deleteMany()	删除集合中多个对象
db.collection.drop()	完全删除集合
db.collection.createIndex()	如果索引不存在，那么创建索引；如果索引存在就不起占用
db.getSiblingDB()	使用相同的连接返回对另一个数据库的引用，而不显式切换当前数据库。这允许跨数据库查询。

更多请参考

• MongoDB CRUD Operations
• mongo Shell Methods

快捷键

Keystroke	Function
Up-arrow	历史命令切换
Down-arrow	历史命令切换

查询

在mongo shell中，使用find（）和findone（）方法执行读取操作。

find（）方法返回一个光标对象，mongo shell迭代该对象以在屏幕上打印文档。默认情况下，mongo打印前20个。MongoShell将提示用户“Type it”以继续迭代接下来的20个结果。

下表提供了mongo shell中的一些常见读取操作：

• db.collection.find(< query>)
  如果< query > 为空，查询所有；否则返回满足要求的。
  具体：Specify Equality Condition.

 coll = db.users; 
 coll.find( { name: "Joe" });

• db.collection.find(< query>, < projection>)
  查找符合< query>条件的文档，并仅返回< projection>中的特定字段。
  对于< projection>, 请参考Project Fields to Return from Query.
  备注：对于_id，除非显示指定不反悔，否则一定会返回

coll = db.users;
coll.find( { }, { name: true } );

• db.collection.find().sort(< sort order>)
  按照指定顺序返回，-1表示降序

coll = db.users;
coll.find().sort( { name: 1 } );

• db.collection.find(< query>).sort(< sort order>)
  返回与指定的<排序顺序>中的<查询>条件匹配的文档。
• db.collection.find( … ).limit( )
  将结果限制为< n>行
• db.collection.find( … ).skip( )
  跳过< n>结果
• db.collection.find(< query>).count()
  返回与查询匹配的文档总数。
  count（）忽略limit（）和skip（）。例如，如果100条记录匹配，但限制为10，则count（）将返回100。这比迭代自己快，但仍需要时间。
• db.collection.findOne()
  查找并返回单个文档。如果找不到，则返回null。
  内部实现： findOne() = find()+ limit(1).

coll = db.users;
coll.findOne( { name: "Joe" } );

错误检查方法

Changed in version 2.6.

mongo shell write方法现在直接将写问题集成到方法执行中，而不是与单独的db.getLastError（）方法集成。因此，write方法现在返回一个writeResult（）对象，该对象包含操作的结果，包括任何写入错误和写入问题错误。

以前的版本使用db.getLastError（）和db.getLastErrorObj（）方法返回错误信息。

管理命令帮助程序

下表列出了一些支持数据库管理的常用方法：

方法	描述
db.cloneDatabase(< host>)	从指定的< host>克隆当前数据库。< host>数据库实例必须处于noauth模式。
db.copyDatabase(< from>, < to>, < host>)	将< from>数据库从< host>复制到当前服务器上的< to>数据库。< host>数据库实例必须处于noauth模式。
db.fromColl.renameCollection(< toColl>)	将集合从fromcoll重命名为< tocoll>
db.getCollectionNames()	获取当前数据库中所有集合的列表。
db.dropDatabase()	删除数据库

更多请参考 administrative database methods

创建新的链接

在mongo shel中可以创建新的链接

• 打开一个新的链接

db = connect("< host><:port>/< dbname>")

• new Mongo().打开新链接，getDB选择数据库

conn = new Mongo()
db = conn.getDB("dbname")

更多请参考：为Mongo Shell编写脚本

其他

• Object.bsonsize()
  打印的bson大小（字节）

js的全部方法请参考 MongoDB JavaScript API Documentation

其他资源

请考虑以下介绍Mongo Shell及其接口的参考资料：

• mongo
• Mongo Shell方法
• 数据库命令
• 聚合引用
• 入门指南

此外，MongoDB源代码存储库还包含一个JSTESTS目录，其中包含许多MongoShell脚本。