Compose Database-as-a-Service Help and Documentation

Everything you need to know about Compose, Hosted or Enterprise, is here in our help system. Whether you run one database for your businesses' sole application or six different databases to support an entire corporation, we've got the information you need.

Data Browser For MongoDB

For a high-level view of why data browsers are available on Compose, and a full list of deployment types they are available on: Compose Deployments - Data Browsers.

Overview

The data browser allows access to your MongoDB databases, collections, and documents from inside the Compose UI. It also provides data migration, user management, and other administrative tools.

The first view is a listing of databases in your deployment with their respective sizes.

Location of the Browser in the sidebar.

Clicking on an a database brings you to a list of collections in that database. Clicking on one of the collections brings you to the Collections view.

The Collections Sidebar

Collections

As the top sidebar item that appears when clicking on a database, it has a listing of all the collections in the current database, the number of documents each contains, and the size of each collection. Click on a collection to view and manage the data within it.

The Collections view.

Once inside the collection there are three tabs: Documents, Indexes, and Settings.

Documents

The first tab provides a command-line for running queries with the find command.

Running a 'find' command from the browser.

Limit the number of results by specifying a number in limit(). Optional arguments fields{}, sort(), skip(), and explain() are toggled with the buttons beneath the command-line.

Indexes

The second tab supplies a command-line for running the ensureIndex command with the ability to toggle optional parameters sparse, unique, and expiresAfterSeconds.

The Index tab.

Below the command-line is a list of all the active indexes for the collection.

Settings

The third tab contains collection statistics, a field for renaming the collection, and a Delete Collection button.

Imports

The Import Tool moves data from another MongoDB database into the current database. It overwrites all data and indexes in the current database with the imported data. It can be used to move data from another database in the same deployment, a database from a different deployment, or an external database.

Users

This is a list of all users that have been created and their permissions level. To remove a user, click on Drop to the right of the username. To add a user, click on Add User in the upper-right. A command-line displaying the createUser command appears and the optional argument readOnly is toggled below. Once a user is created it is displayed in the list.

Admin

The Admin tab contains some handy database tools. From the command db.stats(), it displays dataSize, indexSize, and fileSize. There is, finally, a Delete Database button at the bottom.

Adding Databases, Collections, and Documents

To make a new database, click on Add Database in the upper-right of the main data browser page. This brings up a command-line with the use command.

The Databases view.

Type in a name for the new database and run the command. Once the database has been created, the view changes and the createCollection command appears.

The Collections view.

Optional arguments size and max are toggled with the buttons beneath the command-line.

Once the collection has been created, the view changes to run queries on documents and display results. To create new document, click on Add Document in the upper-right. This provides a text box with brackets so document details can be filled in.

Adding a new document.

Click on Validate to ensure that it is a valid BSON object and click on Save to add the document to the collection.


###Still Need Help?

If this article didn't solve things, summon a human and get some help.

Updated about a year ago

Data Browser For MongoDB


Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.