mongo shell_MonogDB 中文网

参考 > mongo shell

在本页面

启动mongoShell并连接到MongoDB
使用mongoShell
制表符完成和其他键盘快捷键
.mongorc.js 文件
退出壳牌

该mongo外壳是MongoDB的交互式JavaScript接口。您可以使用mongo外壳查询和更新数据以及执行管理操作。

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

打开下载中心。对于 mongoEnterprise Shell，选择 MongoDB Enterprise Server选项卡。
从下拉列表中选择您的首选版本和操作系统。

选择要根据您的平台下载的软件包：

平台	下载包
Windows	选择ZIP软件包以下载包含`mongo`外壳的档案。
macOs	选择TGZ软件包以下载包含`mongo`外壳的档案。
<>	选择外壳程序包以下载外壳程序 `mongo`。

一旦你已经安装，并已开始MongoDB中，将连接mongo外壳到正在运行的MongoDB实例。

注意

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

启动`mongo`Shell并连接到MongoDB¶

前提条件¶

在尝试启动mongo外壳程序之前，请确保MongoDB正在运行。

打开终端窗口（或Windows的命令提示符）并转到目录：<mongodb installation dir>/bin

复制

cd <mongodb installation dir>/bin

小费

将您的代码添加到环境变量后，您可以键入内容，而不必去目录或指定二进制文件的完整路径。<mongodb installation dir>/binPATHmongo<mongodb installation dir>/bin

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

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

复制

mongo

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

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

复制

mongo --port 28015

远程主机上的MongoDB实例¶

要明确指定主机名和/或端口，

您可以指定一个连接字符串。例如，要连接到在远程主机上运行的MongoDB实例，请执行以下操作：
复制
```
mongo "mongodb://mongodb0.example.com:28015"
```
您可以使用命令行选项。例如，要连接到在远程主机上运行的MongoDB实例，请执行以下操作：--host <host>:<port>
复制
```
mongo --host mongodb0.example.com:28015
```
您可以使用和命令行选项。例如，要连接到在远程主机上运行的MongoDB实例，请执行以下操作：--host <host>--port <port>
复制
```
mongo --host mongodb0.example.com --port 28015
```

具有身份验证的MongoDB实例¶

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

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

注意

如果未在连接字符串中指定密码，则外壳程序将提示您输入密码。
复制
```
mongo "mongodb://alice@mongodb0.examples.com:28015/?authSource=admin"
```
您可以使用和，命令行选项。例如，以用户身份连接并认证到远程MongoDB实例：--username <user>--password--authenticationDatabase <db>alice

注意

如果指定时--password没有用户密码，那么外壳程序将提示您输入密码。
复制
```
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/"
```
注意

使用+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 / SSL连接，

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

复制

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

如果使用DNS种子列表连接格式，则可以包括 +srv连接字符串修饰符：
复制
```
mongo "mongodb+srv://server.example.com/"
```
注意

使用+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的示例。

与工作`mongo`壳牌¶

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

复制

db

该操作应返回test，这是默认数据库。

要切换数据库，请发出帮助程序，如以下示例所示：use <db>

复制

use <database>

另请参见db.getSiblingDB()在不切换当前数据库上下文（即db）的情况下从当前数据库访问其他数据库的方法。

要列出用户可用的数据库，请使用帮助器。[1]show dbs

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

复制

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

这db.myCollection.insertOne()是mongo shell中可用的方法之一。

db 引用当前数据库。
myCollection 是集合的名称。

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

复制

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

所述mongo壳提示具有4095码点用于每个线的限制。如果您输入的行包含4095个以上的代码点，则Shell会截断它。

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

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

格式打印的结果¶

该db.collection.find()方法将光标返回到结果。但是，在mongo外壳程序中，如果未使用var关键字将返回的游标分配给变量，则该游标将自动迭代最多20次，以打印最多与查询匹配的前20个文档。该mongo外壳会提示迭代另一个20倍。Type it

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

复制

db.myCollection.find().pretty()

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

print() 打印而不格式化
print(tojson(<obj>))以JSON格式打印并等效于printjson()
printjson()以JSON格式打印并等效于print(tojson(<obj>))

有关mongo外壳程序中光标处理的更多信息和示例，请参阅在mongo Shell中迭代光标。另请参阅 “光标帮助”以获取Shell中光标帮助的列表 mongo。

`mongo`Shell 中的多行操作¶

如果您以开括号（'('），大括号（'{'）或开括号（）结尾'['，则后续行以省略号（"..."）开头，直到您输入相应的右括号（')'），右括号（'}'）或右括号（']'）。该mongo对右括号，右大括号，或评估的代码，如在下面的例子中之前闭合托架壳等待：

复制

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

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

复制

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

制表符补全和其他键盘快捷键¶

该mongo外壳支持键盘快捷键。例如，

使用向上/向下箭头键滚动浏览命令历史记录。有关该文件的更多信息，请参见 .dbshell文档.dbshell。
使用<Tab>自动完成或列出完成的可能性，如下面的例子使用<Tab>来完成方法名开头字母'c'：
复制
```
db.myCollection.c<Tab>
```
因为有很多以字母开头的收集方法 'c'，所以<Tab>将会列出以开头的各种方法 'c'。

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

`.mongorc.js`文件¶

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

退出Shell¶

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

也可以看看

入门指南
mongo 参考页

MongoDB 中文手册

mongo shell

启动mongoShell并连接到MongoDB¶

前提条件¶

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

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

远程主机上的MongoDB实例¶

具有身份验证的MongoDB实例¶

连接到MongoDB副本集¶

TLS / SSL连接¶

与工作mongo壳牌¶

格式打印的结果¶

mongoShell 中的多行操作¶

制表符补全和其他键盘快捷键¶

.mongorc.js文件¶

退出Shell¶

启动`mongo`Shell并连接到MongoDB¶

与工作`mongo`壳牌¶

`mongo`Shell 中的多行操作¶

`.mongorc.js`文件¶