The mongo Shell

在本页面

• 启动mongo Shell并连接到MongoDB

• 使用mongo Shell

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

• mongorc.js文件

• 退出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 目录。

cd <mongodb安装目录>/bin

[success] Note

将<mongodb安装目录> / bin添加到PATH环境变量中，可以键入mongo，而不必转到<mongodb安装目录> / bin目录或指定二进制文件的完整路径。

默认端口上的本地MongoDB实例

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

mongo

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

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

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

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

mongo --port 28015

远程主机上的MongoDB实例

要明确指定主机名或端口：

• 您可以指定一个连接字符串。例如：要连接到在远程主机上运行的MongoDB实例，请执行以下操作：

mongo "mongodb://mongodb0.example.com:28015"

• 您可以使用命令行选项--host <host>:<port>。例如，要连接到在远程主机上运行的MongoDB实例，请执行以下操作：

mongo --host mongodb0.example.com:28015

您可以使用--host<host>和--port <port> 命令行选项。例如，要连接到在远程主机上运行的MongoDB实例，请执行以下操作：

mongo --host mongodb0.example.com --port 28015

具有身份验证的MongoDB实例

要连接到MongoDB实例，需要进行身份验证：

您可以在连接字符串中指定用户名，身份验证数据库以及可选的密码。例如：以alice用户身份连接并认证到远程MongoDB实例：

[success] Note

如果未在连接字符串中指定密码，则shell程序将提示您输入密码。

mongo "mongodb://[e-mail]:28015/?authSource=admin"

您可以使用--username<user> 和--password, --authenticationDatabase <db>命令行选项。 例如，以alice用户身份连接并认证到远程MongoDB实例：

[success] Note

如果您指定**--password**而不输入用户密码，则shell程序将提示您输入密码。

mongo --username alice --password --authenticationDatabase admin --host mongodb0.examples.com --port 28015

连接到MongoDB复制集

要连接到复制集：

• 您可以在连接字符串中指定复制集名称和成员

mongo "mongodb://mongodb0.example.com.local:27017,mongodb1.example.com.local:27017,mongodb2.example.com.local:27017/?replicaSet=replA"

• 如果使用DNS Seedlist 链接格式，则可以指定连接字符串：

mongo "mongodb+srv://server.example.com/"

[success] Note

对于连接，使用**+ srv**连接字符串修饰符会自动将ssl选项设置为true。

• 您可以从 --host <replica set name>/<host1>:<port1>,<host2>:<port2>,... 命令行选项中指定复制集名称和成员。 例如，要连接到名为replA的复制集，请执行以下操作：

mongo --host replA/mongodb0.example.com.local:27017,mongodb1.example.com.local:27017,mongodb2.example.com.local:27017

TLS/SSL 连接

关于TLS/SS连接：

• 您可以在连接字符串中指定ssl = true选项。

mongo "mongodb://mongodb0.example.com.local:27017,mongodb1.example.com.local:27017,mongodb2.example.com.local:27017/?replicaSet=replA&ssl=true"

• 如果使用DNS Seedlist 链接格式，则可以包括**+srv**连接字符串修饰符：

mongo "mongodb+srv://server.example.com/"

[success] Note

对于连接，使用**+srv**连接字符串修饰符会自动将ssl选项设置为true。

• 您可以指定--ssl命令行选项。 例如，要连接到名为replA的复制集，请执行以下操作：

mongo --ssl --host replA/mongodb0.example.com.local:27017,mongodb1.example.com.local:27017,mongodb2.example.com.local:27017

另：有关连接示例中使用的选项以及其他选项的更多信息，请参阅(mongo参考和 启动mongo的示例)。

使用mongoShell

要显示您正在使用的数据库，请键入db：

db

该操作应返回test 数据库名，这是默认数据库。 要切换数据库，请发出**use <db>**帮助器，如以下示例所示：

use <database>

另请参见db.getSiblingDB()方法，以从当前数据库访问其他数据库，而无需切换当前数库上下文（即db）。 要列出用户可用的数据库，可使用：show dbs <显示用户列表里所有数据库>

您可以切换到不存在的数据库。首次将数据存储在数据库中（例如通过创建集合）时，MongoDB会创建数据库。 例如，以下代码在insertOne（）操作期间创建数据库myNewDatabase和集合 myCollection：

use myNewDatabase
db.myCollection.insertOne( { x: 1 } );

是mongo shell中可用的方法之一。

• db是指当前数据库。

• myCollection是集合的名称。

  如果mongo shell不接受集合的名称，则可以使用替代的 db.getCollection()语法。例如，如果集合名称包含空格或连字符，以数字开头或与内置函数冲突：

db.getCollection("3 test").find()
db.getCollection("3-test").find()
db.getCollection("stats").find()

mongo shell提示符每行的限制为4095个字符（code points）。 如果您输入的行中包含4095个以上的字符（code points），则Shell将截断它。 有关mongo shell中MongoDB基本操作的更多文档，请参阅：

• Getting Started Guide

• Insert Documents

• Query Documents

• Update Documents

• Delete Documents

• mongo Shell Methods

如果部署使用访问控制运行，则该操作将根据用户权限返回不同的值。 有关详细信息，请参见listDatabases Behavior。

格式化打印结果

db.collection.find()方法是用于从集合中检索文档的JavaScript方法。 db.collection.find()方法将游标返回到结果。 但是，在mongo shell中，如果未使用var关键字将返回的游标分配给变量，则该游标会自动迭代最多20次，来打印与查询匹配的前20个文档。 mongo shell将提示 输入it以使其再次迭代20次。

要格式化打印结果，可以将.pretty()添加到操作中，如下所示：

db.myCollection.find().pretty()

此外，您可以在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在评估代码之前等待右括号，右括号或右括号，如以下示例所示：

>if ( x > 0 ) {
... count++;
... print (x);
... }

如果输入两个空行，则可以退出行继续模式，如以下示例所示：

> if (x > 0
...
...
>

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

shell支持键盘快捷键。 例如：

• 使用向上/向下箭头键滚动浏览命令历史记录。有关.dbshell文件的更多信息，请参见.dbshell 文档。

• 使用<Tab>来自动完成或列出完成可能性，如以下示例中所示，该示例使用<Tab>来完成以字母'c'开头的方法名称：

db.myCollection.c<Tab>

因为有许多以字母'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>快捷方式。

另可参考：

• Getting Started Guide

• mongo Reference Page

译者：王恒 金江

MongoDB中文社区

MongoDB中文社区—MongoDB爱好者技术交流平台

资源列表推荐	资源入口
MongoDB中文社区官网	https://mongoing.com/
微信服务号 ——最新资讯和优质文章	Mongoing中文社区（mongoing-mongoing）
微信订阅号 ——发布文档翻译内容	MongoDB中文用户组（mongoing123）
官方微信号 —— 官方最新资讯	MongoDB数据库（MongoDB-China）
MongoDB中文社区组委会成员介绍	https://mongoing.com/core-team-members
MongoDB中文社区翻译小组介绍	https://mongoing.com/translators
MongoDB中文社区微信技术交流群	添加社区助理小芒果微信（ID:mongoingcom），并备注 mongo
MongoDB中文社区会议及文档资源	https://mongoing.com/resources
MongoDB中文社区大咖博客	基础知识 性能优化 原理解读 运维监控 最佳实践
MongoDB白皮书	https://mongoing.com/mongodb-download-white-paper
MongoDB初学者教程-7天入门	https://mongoing.com/mongodb-beginner-tutorial
社区活动邮件订阅	https://sourl.cn/spszjN