mongo

Options¶

--shell¶

Enables the shell interface after evaluating a JavaScript file. If you invoke the mongo command and specify a JavaScript file as an argument, or use --eval to specify JavaScript on the command line, the --shell option provides the user with a shell prompt after the file finishes executing.

--nodb¶

Prevents the shell from connecting to any database instances. Later, to connect to a database within the shell, see Opening New Connections.

--norc¶

Prevents the shell from sourcing and evaluating ~/.mongorc.js on start up.

--quiet¶

Silences output from the shell during the connection process.

--port <port>¶

Specifies the port where the mongod or mongos instance is listening. Unless specified mongo connects to mongod instances on port 27017, which is the default mongod port.

--host <hostname>¶

specifies the host where the mongod or mongos is running to connect to as <hostname>. By default mongo will attempt to connect to a MongoDB process running on the localhost.

--eval <javascript>¶

Evaluates a JavaScript expression specified as an argument to this option. mongo does not load its own environment when evaluating code: as a result many options of the shell environment are not available.

--username <username>, -u <username>¶

Specifies a username to authenticate to the MongoDB instance. Use in conjunction with the --password option to supply a password. If you specify a username and password but the default database or the specified database do not require authentication, mongo will exit with an exception.

--password <password>, -p <password>¶

Specifies a password to authenticate to the MongoDB instance. Use in conjunction with the --username option to supply a username. If you specify a --username without the --password option, mongo will prompt for a password interactively, if the mongod or mongos requires authentication.

--help, -h¶

Returns a basic help and usage text.

--version¶

Returns the version of the shell.

--verbose¶

Increases the verbosity of the output of the shell during the connection process.

--ipv6¶

Enables IPv6 support that allows mongo to connect to the MongoDB instance using an IPv6 network. All MongoDB programs and processes, including mongo, disable IPv6 support by default.

<db address>

Specifies the “database address” of the database to connect to. For example:

mongo admin

The above command will connect the mongo shell to the admin database on the local machine. You may specify a remote database instance, with the resolvable hostname or IP address. Separate the database name from the hostname using a / character. See the following examples:

mongo mongodb1.example.net
mongo mongodb1/admin
mongo 10.8.8.10/test

<file.js>

Specifies a JavaScript file to run and then exit. Must be the last option specified. Use the --shell option to return to a shell after the file finishes running.

Files¶

~/.dbshell

mongo maintains a history of commands in the .dbshell file.

注解

mongo does not recorded interaction related to authentication in the history file, including authenticate and db.addUser().

警告

Versions of Windows mongo.exe earlier than 2.2.0 will save the .dbshell file in the mongo.exe working directory.

~/.mongorc.js

mongo will read the .mongorc.js file from the home directory of the user invoking mongo. In the file, users can define variables, customize the mongo shell prompt, or update information that they would like updated every time they launch a shell. If you use the shell to evaluate a JavaScript file or expression either on the command line with --eval or by specifying a .js file to mongo, mongo will read the .mongorc.js file after the JavaScript has finished processing.

Specify the --norc option to disable reading .mongorc.js.

/tmp/mongo_edit<time_t>.js

Created by mongo when editing a file. If the file exists mongo will append an integer from 1 to 10 to the time value to attempt to create a unique file.

%TEMP%mongo_edit<time_t>.js

Created by mongo.exe on Windows when editing a file. If the file exists mongo will append an integer from 1 to 10 to the time value to attempt to create a unique file.

Environment¶

EDITOR¶

Specifies the path to an editor to use with the edit shell command. A JavaScript variable EDITOR will override the value of EDITOR.

HOME¶

Specifies the path to the home directory where mongo will read the .mongorc.js file and write the .dbshell file.

HOMEDRIVE¶

On Windows systems, HOMEDRIVE specifies the path the directory where mongo will read the .mongorc.js file and write the .dbshell file.

HOMEPATH¶

Specifies the Windows path to the home directory where mongo will read the .mongorc.js file and write the .dbshell file.