Mongo 壳牌

在本页面

Introduction

mongo shell 是 MongoDB 的交互式 JavaScript 界面。您可以使用mongo shell 查询和更新数据以及执行 Management 操作。

mongo Shell 是MongoDB Server安装的一部分。 MongoDB 还提供mongo shell 作为独立软件包。要下载独立的mongo shell 软件包：

  • 打开Download Center。对于mongo Enterprise Shell，选择 MongoDB Enterprise Server 标签。

  • 从下拉列表中选择您的首选版本和 os。

  • 从“程序包”下拉列表中选择Shell，然后单击“下载”开始下载程序包。

如果所选 os 和版本Shell选项不可用，请与 MongoDB Technical Support联系以获得帮助。

拥有安装并启动了 MongoDB后，将mongo Shell 连接到正在运行的 MongoDB 实例。

Note

从 MongoDB 3.6.15 开始，当连接到非正版 MongoDB 实例时，mongo shell 将显示警告消息，因为这些实例的行为可能与官方 MongoDB 实例不同。例如缺少或不完整的功能，不同的功能行为等。

MongoDB Manual中的大多数示例都使用mongo shell；但是，许多drivers提供与 MongoDB 相似的接口。

启动 mongo Shell

Important

在尝试启动mongo shell 之前，请确保 MongoDB 正在运行。

要启动mongo shell 并使用默认端口 连接到在 localhost 上运行的MongoDB实例，请执行以下操作：

  • 在终端窗口的提示符下(或 Windows 的命令提示符)，转到<mongodb installation dir>：
cd <mongodb installation dir>
  • Importing./bin/mongo以启动mongo：
./bin/mongo

如果已将<mongodb installation dir>/bin添加到PATH环境变量，则只需键入mongo而不是./bin/mongo即可。

Options

当您不带任何参数运行mongo时，mongo shell 将尝试连接到端口27017的localhost接口上运行的 MongoDB 实例。要指定其他主机或端口号以及其他选项，请参见启动 mongo 的示例和mongo reference，其中提供了有关可用选项的详细信息。

.mongorc.js File

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

使用 mongo Shell

要显示您正在使用的数据库，请 Importingdb：

db

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

use <database>

要列出可用的数据库，请使用助手show dbs。另请参见db.getSiblingDB()方法，以从当前数据库访问其他数据库而无需切换当前数据库上下文(即db)。

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

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

db.myCollection.insertOne()是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 个代码点。如果您 Importing 的行中包含 4095 个以上的代码点，则 Shell 将截断它。

有关mongo shell 中 MongoDB 基本操作的更多文档，请参阅：

格式化打印结果

db.collection.find()方法将cursor返回到结果；但是，在mongoShell 程序中，如果未使用var关键字将返回的游标分配给变量，则该游标会自动重复进行多达 20 次以最多打印与查询匹配的前 20 个文档。 mongo shell 将提示Type it重复进行 20 次。

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

db.myCollection.find().pretty()

此外，您可以在mongo shell 中使用以下显式打印方法：

  • print()无需格式化即可打印

  • print(tojson(<obj>))以JSON格式打印，等效于printjson()

  • printjson()以JSON格式打印，等效于print(tojson(<obj>))

有关mongo shell 中的游标处理的更多信息和示例，请参见在 mongo Shell 中迭代游标。另请参见Cursor Help以获取mongo shell 中的光标帮助列表。

mongo Shell 中的多行操作

如果您以开括号('(')，大括号('{')或开括号('[')结尾的行，则后续行以省略号("...")开头，直到您 Importing 相应的右括号(')')，右括号('}')或右括号(']')。 mongo shell 在评估代码之前 await 右括号，右括号或右括号，如以下示例所示：

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

如果 Importing 两个空行，则可以退出行 continue 模式，如以下示例所示：

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

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

mongo shell 支持键盘快捷键。例如，

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

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

db.myCollection.c<Tab>

由于有许多以字母'c'开头的收集方法，因此<Tab>将列出以'c'开头的各种方法。

有关快捷方式的完整列表，请参见Shell 键盘快捷键。

退出 Shell

要退出 Shell，请键入quit()或使用<Ctrl-C>快捷方式。

See also