Starting in version 1.22, MongoDB Compass contains an embedded shell, mongosh. mongosh is a JavaScript environment for interacting with MongoDB deployments. You can use mongosh to test queries and operations in your database.
Open the Embedded MongoDB Shell
To open the embedded mongosh,you can either:
Click >_ on the right of your deployment name in the Connections Sidebar.
Click >_Open MongoDB shell in the top right of any tab connected to a MongoDB deployment.
Use the Embedded MongoDB Shell
By default, mongosh, connects to the test database. To use a different database, run the following command in mongosh:
use <database name>
To run an operation in the embedded MongoDB Shell, type the operation into the shell and press Enter.
The following example runs a db.collection.find() operation:
Example
db.employees.find( { "last_name": "Smith" } )
Multi-Line Operations in the Embedded MongoDB Shell
To write an operation that spans multiple lines in the embedded mongosh, begin with the first line, then press Shift + Enter to move to the next line of code.
When you are finished writing your operation, press Enter to run it.
The following multi-line example runs the $match stage in an aggregation pipeline:
Example
db.employees.aggregate( [ // press Shift + Enter { $match: { "last_name": "Smith" } } // press Shift + Enter ] ) // Press Enter
Disable the Embedded MongoDB Shell
You can disable the embedded MongoDB shell in Compass to avoid running unauthorized commands on mongosh.
To disable the embedded MongoDB shell:
Learn More
The following links direct to the mongosh documentation, which contains more a complete reference for mongosh, including syntax and behaviors.
Learn how to perform CRUD operations in
mongosh.Learn how to run aggregation pipelines in
mongosh.