MongoDB Shell (mongosh)¶

Download and Install mongosh¶

To learn how to download and install the mongosh binary, see Install mongosh.

Connect to a MongoDB Deployment¶

Once you have installed the MongoDB Shell and added it to your system PATH, you can connect to a MongoDB deployment. To learn more, see Connect to a Deployment.

MongoDB Shell Editor Mode¶

Run the .editor command within the MongoDB Shell to open the editor and manage comprehensive multiline functions:

.editor

// Entering editor mode (^D to finish, ^C to cancel)
const { Writable } = require('stream');
  const myWritable = new Writable({
    write(chunk, encoding, callback) {
      // ...
    },
    writev(chunks, callback) {
      // ...
    }
  });

• Press Cmd/Ctrl + d to finish and run your function.
• Press Cmd/Ctrl + c to cancel and exit without running your function.

When you close the editor, the MongoDB Shell does not save any functions you had entered into the editor.

The MongoDB Shell versus the Legacy mongo Shell¶

The new MongoDB Shell, mongosh, offers numerous advantages over the legacy mongo shell, such as:

• Improved syntax highlighting.
• Improved command history.
• Improved logging.

Currently mongosh supports a subset of the mongo shell methods. Achieving feature parity between mongosh and the mongo shell is an ongoing effort.

To maintain backwards compatibility, the methods that mongosh supports use the same syntax as the corresponding methods in the mongo shell. To see the complete list of methods supported by mongosh, see MongoDB Shell Methods.

Learn More¶

• Connect to a MongoDB Deployment
• Perform CRUD Operations
• Run Aggregation Pipelines
• Write Scripts
• Retrieve Logs
• View Available Methods in the MongoDB Shell