MongoDB-CN-Manual
搜索文档…
The mongo Shell
在本页面
mongo shell是MongoDB的交互式JavaScript接口。您可以使用mongo shell查询和更新数据以及执行管理操作。 mongo shell作为MongoDB Server安装的一部分包含在内。 MongoDB还提供mongo shell作为独立软件包。如何下载独立的mongo shell软件包: 1.打开下载中心。对于mongo Enterprise Shell,选择MongoDB Enterprise Server选项卡。 2.从下拉列表中选择您的首选版本和操作系统。 3.选择要根据您的系统下载的安装包:
系统
下载包
Win
选择ZIP以下载包含mongo shell的安装包
Mac
选择TGZ以下载包含mongo shell的安装包
Linux
选择shell以下载包含mongo shell的安装包
安装并启动MongoDB之后,将mongo shell连接到正在运行的MongoDB实例。

启动mongo Shell并连接到MongoDB

前提条件
在尝试启动mongo shell之前,请确保MongoDB正在运行。
打开终端窗口(或Windows的命令提示符),然后转<mongodb安装目录>/bin 目录。
1
cd <mongodb安装目录>/bin
Copied!
[success] Note
<mongodb安装目录> / bin添加到PATH环境变量中,可以键入mongo,而不必转到<mongodb安装目录> / bin目录或指定二进制文件的完整路径。

默认端口上的本地MongoDB实例

您可以在不使用任何命令行选项的情况下运行mongo shell,以使用默认端口27017连接到在本地主机上运行的MongoDB实例:
1
mongo
Copied!

非默认端口上的本地MongoDB实例

要显式指定端口,请包括--port命令行选项。例如,要使用非默认端口28015连接到在localhost上运行的MongoDB实例,请执行以下操作:

非默认端口上的本地MongoDB实例

要显式指定端口,请包括--port命令行选项。例如,要使用非默认端口28015连接到在localhost上运行的MongoDB实例,请执行以下操作:
1
mongo --port 28015
Copied!

远程主机上的MongoDB实例

要明确指定主机名或端口:
  • 您可以指定一个连接字符串。例如:要连接到在远程主机上运行的MongoDB实例,请执行以下操作:
1
mongo "mongodb://mongodb0.example.com:28015"
Copied!
  • 您可以使用命令行选项--host <host>:<port>。例如,要连接到在远程主机上运行的MongoDB实例,请执行以下操作:
1
mongo --host mongodb0.example.com:28015
Copied!
您可以使用--host<host>--port <port> 命令行选项。例如,要连接到在远程主机上运行的MongoDB实例,请执行以下操作:
1
mongo --host mongodb0.example.com --port 28015
Copied!

具有身份验证的MongoDB实例

要连接到MongoDB实例,需要进行身份验证:
您可以在连接字符串中指定用户名,身份验证数据库以及可选的密码。例如:以alice用户身份连接并认证到远程MongoDB实例:
[success] Note
如果未在连接字符串中指定密码,则shell程序将提示您输入密码。
1
mongo "mongodb://[email protected]:28015/?authSource=admin"
Copied!
您可以使用--username<user>--password, --authenticationDatabase <db>命令行选项。 例如,以alice用户身份连接并认证到远程MongoDB实例:
[success] Note
如果您指定**--password**而不输入用户密码,则shell程序将提示您输入密码。
1
mongo --username alice --password --authenticationDatabase admin --host mongodb0.examples.com --port 28015
Copied!

连接到MongoDB复制集

要连接到复制集:
  • 您可以在连接字符串中指定复制集名称和成员
1
mongo "mongodb://mongodb0.example.com.local:27017,mongodb1.example.com.local:27017,mongodb2.example.com.local:27017/?replicaSet=replA"
Copied!
1
mongo "mongodb+srv://server.example.com/"
Copied!
[success] Note
对于连接,使用**+ srv**连接字符串修饰符会自动将ssl选项设置为true。
1
mongo --host replA/mongodb0.example.com.local:27017,mongodb1.example.com.local:27017,mongodb2.example.com.local:27017
Copied!

TLS/SSL 连接

关于TLS/SS连接:
1
mongo "mongodb://mongodb0.example.com.local:27017,mongodb1.example.com.local:27017,mongodb2.example.com.local:27017/?replicaSet=replA&ssl=true"
Copied!
1
mongo "mongodb+srv://server.example.com/"
Copied!
[success] Note
对于连接,使用**+srv**连接字符串修饰符会自动将ssl选项设置为true。
  • 您可以指定--ssl命令行选项。 例如,要连接到名为replA的复制集,请执行以下操作:
1
mongo --ssl --host replA/mongodb0.example.com.local:27017,mongodb1.example.com.local:27017,mongodb2.example.com.local:27017
Copied!
另:有关连接示例中使用的选项以及其他选项的更多信息,请参阅(mongo参考启动mongo的示例)。

使用mongoShell

要显示您正在使用的数据库,请键入db
1
db
Copied!
该操作应返回test 数据库名,这是默认数据库。 要切换数据库,请发出**use <db>**帮助器,如以下示例所示:
1
use <database>
Copied!
另请参见db.getSiblingDB()方法,以从当前数据库访问其他数据库,而无需切换当前数库上下文(即db)。 要列出用户可用的数据库,可使用:show dbs <显示用户列表里所有数据库>
您可以切换到不存在的数据库。首次将数据存储在数据库中(例如通过创建集合)时,MongoDB会创建数据库。 例如,以下代码在insertOne()操作期间创建数据库myNewDatabase集合 myCollection
1
use myNewDatabase
2
db.myCollection.insertOne( { x: 1 } );
Copied!
是mongo shell中可用的方法之一。
  • db是指当前数据库。
  • myCollection是集合的名称。
    如果mongo shell不接受集合的名称,则可以使用替代的 db.getCollection()语法。例如,如果集合名称包含空格或连字符,以数字开头或与内置函数冲突:
1
db.getCollection("3 test").find()
2
db.getCollection("3-test").find()
3
db.getCollection("stats").find()
Copied!
mongo shell提示符每行的限制为4095个字符(code points)。 如果您输入的行中包含4095个以上的字符(code points),则Shell将截断它。 有关mongo shell中MongoDB基本操作的更多文档,请参阅:
如果部署使用访问控制运行,则该操作将根据用户权限返回不同的值。 有关详细信息,请参见listDatabases Behavior

格式化打印结果

db.collection.find()方法是用于从集合中检索文档的JavaScript方法。 db.collection.find()方法将游标返回到结果。 但是,在mongo shell中,如果未使用var关键字将返回的游标分配给变量,则该游标会自动迭代最多20次,来打印与查询匹配的前20个文档。 mongo shell将提示 输入it以使其再次迭代20次。
要格式化打印结果,可以将.pretty()添加到操作中,如下所示:
1
db.myCollection.find().pretty()
Copied!
此外,您可以在mongo shell中使用以下显式打印方法:
  • print() to print without formatting
  • print(tojson()) to print with JSON formatting and equivalent to printjson()
  • printjson() to print with JSON formatting and equivalent to print(tojson())
有关在mongo shell中处理光标的更多信息和示例,请参阅terate a Cursor in the mongo。 另请参阅Cursor Help ,以获取mongo shell中的游标帮助列表。

mongo Shell中的多行操作

如果您以开括号('('),大括号('{')或开括号('[')结束一行,则后续行以省略号(“ ...”)开头,直到您 输入相应的右括号(')',右括号('}')或右括号(']')。 mongo shell在评估代码之前等待右括号,右括号或右括号,如以下示例所示:
1
>if ( x > 0 ) {
2
... count++;
3
... print (x);
4
... }
Copied!
如果输入两个空行,则可以退出行继续模式,如以下示例所示:
1
> if (x > 0
2
...
3
...
4
>
Copied!

制表符完成和其他键盘快捷键

shell支持键盘快捷键。 例如:
  • 使用向上/向下箭头键滚动浏览命令历史记录。有关.dbshell文件的更多信息,请参见.dbshell 文档。
  • 使用<Tab>来自动完成或列出完成可能性,如以下示例中所示,该示例使用<Tab>来完成以字母'c'开头的方法名称:
1
db.myCollection.c<Tab>
Copied!
因为有许多以字母'c'开头的收集方法,所以<Tab>将列出以**'c'**开头的各种方法。 有关快捷键的完整列表,请参见:Shell 快捷命令(Shell Keyboard Shortcuts)。

mongorc.js文件

启动时,mongo将在用户的HOME目录中检查名为.mongorc.js的JavaScript文件。 如果找到,mongo会在首次显示提示之前解释.mongorc.js的内容。如果您使用舍shell程序来评估JavaScript文件或表达式,或者通过在命令行上使用--eval选项,或者通过将.js文件指定给mongo,则mongo将在JavaScript完成处理后读取.mongorc.js文件。 您可以使用--norc选项防止加载.mongorc.js

退出Shell

要退出shell,请键入quit()或使用 <Ctrl-C>快捷方式。
另可参考:
译者:王恒 金江

MongoDB中文社区

MongoDB中文社区—MongoDB爱好者技术交流平台
资源列表推荐
资源入口
MongoDB中文社区官网
微信服务号 ——最新资讯和优质文章
Mongoing中文社区(mongoing-mongoing)
微信订阅号 ——发布文档翻译内容
MongoDB中文用户组(mongoing123)
官方微信号 —— 官方最新资讯
MongoDB数据库(MongoDB-China)
MongoDB中文社区组委会成员介绍
MongoDB中文社区翻译小组介绍
MongoDB中文社区微信技术交流群
添加社区助理小芒果微信(ID:mongoingcom),并备注 mongo
MongoDB中文社区会议及文档资源
MongoDB中文社区大咖博客
MongoDB初学者教程-7天入门
社区活动邮件订阅
最近更新 1mo ago