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 目录。

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://alice@mongodb0.examples.com: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"
mongo "mongodb+srv://server.example.com/"

[success] Note

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

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

TLS/SSL 连接

关于TLS/SS连接:

mongo "mongodb://mongodb0.example.com.local:27017,mongodb1.example.com.local:27017,mongodb2.example.com.local:27017/?replicaSet=replA&ssl=true"
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基本操作的更多文档,请参阅:

如果部署使用访问控制运行,则该操作将根据用户权限返回不同的值。 有关详细信息,请参见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>快捷方式。

另可参考:

译者:王恒 金江

校对:杨帅

参见

原文 - The mongo Shell

Copyright © 上海锦木信息技术有限公司 all right reserved,powered by Gitbook文件修订时间: 2023-09-01 17:10:26

results matching ""

    No results matching ""