Navigation

Data Explorer

The Data Explorer in Atlas provides the ability to:

  • View databases,collections and indexes in your cluster.
  • Create and drop databases, collections, and indexes.
  • Insert/edit/delete documents.

Data explorer reads from the primary unless the primary is unavailable. If the primary is unavailable, data explorer reads from a non-hidden, non-delayed secondary member.

Access Data Explorer

Required Privileges

To access Data Explorer, you must have access provided by at least one of the following roles:

To access Data Explorer, click Clusters and then for the MongoDB cluster, click the Collections button. Or, if you are already viewing a specific cluster, select the Collections tab. The tab lists the databases in your deployment and the collections in each database.

View Databases and Collections

From the Collections tab, you can view the databases and collections in the deployment. To view the collections in a particular database, click on the database.

View Documents

From the Collections tab, you can view documents in a collection. To view documents for a collection:

1

Select the database for the collection.

The main panel and the left-hand side displays the collections in the datatabse.

2

Select the collection on the left-hand side or in the main panel.

The main panel displays the Find view and the Indexes view.

3

Select the Find view.

The panel displays the documents in the collection. Each page displays up to 20 documents.

4

Optional. Specify query filter.

To specify filter condition, type in a query filter document in the filter bar. For example, to specify equality condition, use a filter document of the form:

{ <field1>: <value1>, ... }

To use query operators to specify a filter condition, use a filter document of the form:

{ <field1>: { <queryoperator>: <value1> }, ... }

For more information on specifying query filters, including compound conditions, see Query Documents.

5

Click Find to run query.

Insert Documents

To insert a new document through the Data Explorer, you must have access provided by at least one of the following roles:

To add a document to a collection through the Data Explorer, you can specify the document to insert from scratch or you can clone an existing document and modify its fields and values as needed.

Insert Document

1

Go to Find tab in Data Explorer.

Select the collection and go to the Find tab.

2

Click Insert Document button.

The document editor appears with the _id field with an ObjectId value that reflects the time of its generation and not the insertion time of the document. As such, the ObjectId does not represent a strict insertion order.

3

Modify the document.

  • To add a new field after an existing field, hover over the field and click on the plus sign that appears over the field’s line number.
  • To delete a field, hover over the field and click on the x sign that appears to the left of the field’s line number. You cannot delete the _id field.
  • To edit a field name, value, or type, click on the field name, value, or type.
4

Click Insert.

Clone a Document

1

Go to Find tab in Data Explorer.

Select the collection and go to the Find tab.

Up to 20 documents displays in the tab.

2

Optional. Specify a filter.

To specify filter condition, type in a query filter document in the filter bar. For example, to specify equality condition, use a filter document of the form:

{ <field1>: <value1>, ... }

To use query operators to specify a filter condition, use a filter document of the form:

{ <field1>: { <queryoperator>: <value1> }, ... }
3

Clone the document.

To clone a document displayed in the query results, hover over the document and click on its clone document icon.

Clone document icon

The document editor appears with the _id field with an ObjectId value that reflects the time of its generation and not the insertion time of the document. As such, the ObjectId does not represent a strict insertion order.

4

Modify the document.

  • To add a new field after an existing field, hover over the field and click on the plus sign that appears over the field’s line number.
  • To delete a field, hover over the field and click on the x sign that appears to the left of the field’s line number. You cannot delete the _id field.
  • To edit a field name, value, or type, click on the field name, value, or type.
5

Click Insert.

Edit a Document

To edit a collection’s documents through the Data Explorer, you must have access provided by at least one of the following roles:

To edit a document from a collection through the Data Explorer,

1

Go to Find tab in Data Explorer.

Select the collection and go to the Find tab.

Up to 20 documents displays in the tab.

2

Optional. Specify a filter.

To specify filter condition, type in a query filter document in the filter bar. For example, to specify equality condition, use a filter document of the form:

{ <field1>: <value1>, ... }

To use query operators to specify a filter condition, use a filter document of the form:

{ <field1>: { <queryoperator>: <value1> }, ... }
3

Edit the document.

To edit a document displayed in the query results, hover over the document to edit and click on the pencil icon.

The document appears in the document editor:

  • To add a new field, hover over the field and click on the plus sign that appears over the field’s line number.
  • To delete a field, hover over the field and click on the x sign that appears to the left of the field’s line number. You cannot delete the _id field.
  • To edit a field name, value, or type, click on the field name, value, or type.
  • To revert a specific change, hover over the edited field and click the revert icon that appears to the left of the field’s line number.
4

Save or cancel changes.

To confirm and save changes, click the Update button.

To cancel all modifications to the document, click the Cancel button.

Delete a Document

To delete documents from a collection through the Data Explorer, you must have access provided by at least one of the following roles:

To delete a document from a collection through the Data Explorer,

1

Go to Find tab in Data Explorer.

Select the collection and go to the Find tab.

Up to 20 documents displays in the tab.

2

Optional. Specify a filter.

To specify filter condition, type in a query filter document in the filter bar. For example, to specify equality condition, use a filter document of the form:

{ <field1>: <value1>, ... }

To use query operators to specify a filter condition, use a filter document of the form:

{ <field1>: { <queryoperator>: <value1> }, ... }
3

Delete the document.

To delete a document displayed in the query results, hover over the document to delete and click on the trash can icon.

The document is flagged for deletion.

4

To confirm, click the Delete button.

View Indexes

From the Collections tab, you can view index information for a collection. To view index information for a collection:

1

Select the database for the collection.

The main panel and the left-hand side displays the collections in the datatabse.

2

Select the collection on the left-hand side or in the main panel.

The main panel displays the Find view and the Indexes view.

3

Select the Indexes view.

The indexes table lists the indexes and associated index information for the collection. Index information includes the index definition, the size, and the usage frequency.

Create a Database

To create a database through the Data Explorer, you must have access provided by at least one of the following roles:

To create a database through the Data Explorer,

1

Click Create Database.

2

Enter the Database Name and the Collection Name.

Enter the Database Name and the Collection Name to create the database and its first collection.

For more information on MongoDB database names and collection names, see Naming Restrictions.

3

Optional. Specify a capped collection.

Select whether the collection is a capped collection. If you select to create a capped collection, specify the maximum size in bytes.

4

Click Create.

Upon successful creation, the database and the collection appears in the Data Explorer.

Create a Collection

To create a collection through the Data Explorer, you must have access provided by at least one of the following roles:

To create a collection in an existing database through the Data Explorer,

Tip

To create the first collection in a new database, see Create a Database.

1

Click on the plus sign + icon for a database.

Either select or hover over the database to drop and click on the plus sign + icon.

2

Enter the Collection Name.

For more information on MongoDB collection names, see Naming Restrictions.

3

Optional. Specify a capped collection.

Select whether the collection is a capped collection. If you select to create a capped collection, specify the maximum size in bytes.

4

Click Create.

Upon successful creation, the collection appears underneath the database in the Data Explorer.

Create an Index

To create an index through the Data Explorer, you must have access provided by at least one of the following roles:

To create an index for a collection through the Data Explorer,

1

Go to the Indexes tab.

Select the collection you wish to index, and go to the Indexes tab.

2

Click + Create.

Enter the index key specification document:

{ <field1>: <index type>, ... }

For example, to create a compound index on the fields category (ascending order) and score (descending order), specify the index specification document:

{ category: 1, score: -1 }

For more information on indexes, see Indexes.

3

Optional. Specify the index options.

{ <option1>: <value1>, ... }

For example, the following options document specifies the unique option and the name for the index to create:

{ unique: true, name: "myUniqueIndex" }
4

Click Create.

For more information on creating indexes, see the MongoDB Manual.

Drop a Database

To drop a database through the Data Explorer, you must have access provided by at least one of the following roles:

To drop a database, including all its collections, through the Data Explorer,

1

Drop the database.

Either select or hover of the database to drop and click on its trash can icon.

2

Confirm action.

Confirm by typing the name of the database, and click Drop.

Drop a Collection

To drop a collection through the Data Explorer, you must have access provided by at least one of the following roles:

To drop a collection, including its documents and indexes, through the Data Explorer,

1

Drop the collection.

Either select or hover of the collection to drop and click on its trash can icon.

2

Confirm action.

Confirm by typing the name of the collection, and click Drop.

Drop an Index

To drop an index through the Data Explorer, you must have access provided by at least one of the following roles:

To drop an index from a collection through the Data Explorer,

Note

You cannot delete the _id index.

1

Go to the Indexes tab.

Select the collection whose index you wish to drop, and go to the Indexes tab.

2

Click the Drop Index button for the index to drop.

3

Confirm action.

Confirm by typing the name of the index, and click Drop.

Shard a Collection for Global Writes

Administrators can shard collections residing in a Global Cluster for Global Writes using the Data Explorer. You must have the Project Owner role for the cluster’s Atlas project to shard a collection for Global Writes in the Data Explorer.

Review the guidance and restrictions for Sharding Collections for Global Writes before beginning this procedure.

Important

After selecting a shard key via the Data Explorer, Atlas attempts to shard the target collection. During this period, ensure that no user manually shards the collection. If Atlas detects that the target collection was sharded with a different key than that selected via the Data Explorer, Atlas stops the procedure and displays a warning for that collection in the Data Explorer. You can clear the warning by clicking Unmanage Collection, which removes the collection from Atlas management while leaving the underlying collection and the manually chosen shard key intact.

To shard a collection in a Global Cluster

1

Click Clusters in the left navigation pane.

2

Click the Collections button below the cluster that contains the collection that you want to shard.

3

Click the collection that you want to shard.

4

Click the Global Writes tab.

5

Enter the second field of the compound shard key in Second shard key field.

6

Click Shard Collection.

Atlas displays the compound shard key near the top of the Global Writes tab after configuring the collection.