Insert and View Data in Your Cluster

Estimated completion time: 5 minutes

The following steps in this tutorial show you how to insert and interact with data on your cluster. Select the appropriate tab based on how you would like to interact with your cluster data:

Drivers allow you to interact with your databases programmatically using one of several available programming languages. For a complete list of MongoDB drivers, see the driver documentation.

Estimated completion time: 5 minutes

In the previous section you used the PyMongo driver to connect to your Atlas cluster. In this section you'll create a new collection, add data to it, and read the new data.


We have already established our client connection and stored it in a variable called client. Run the following command in your Python shell to create a database on your cluster:

db = client.gettingStarted

This command creates a new database on your cluster called gettingStarted. The variable db points to your new database.


Run the following command in your Python shell to create a new collection for your database:

people = db.people

This command creates a new collection in your gettingStarted database called people. The variable people points to your new collection.


In your Python shell, run the following command to create a document which will be inserted into your collection:

import datetime
personDocument = {
"name": { "first": "Alan", "last": "Turing" },
"birth": datetime.datetime(1912, 6, 23),
"death": datetime.datetime(1954, 6, 7),
"contribs": [ "Turing machine", "Turing test", "Turingery" ],
"views": 1250000

The document is stored in a variable called personDocument.


This command does not insert the document into your collection. This command only specifies the document. We will insert the document in the next step.


In your Python shell, run the following command to insert the document you created in the previous step into your collection:


Remember that the people variable refers to our people collection we specified in a previous step of this section, and personDocument contains the document we want to insert.

If your insert was successful, PyMongo displays a message similar to the following:

<pymongo.results.InsertOneResult object at 0x10950e5f0>

Now that you have successfully inserted a document into your Atlas cluster using the PyMongo driver, you can try reading that data with the PyMongo find_one() method.

The following command returns one document from the people collection that has a name.last value of Turing:

people.find_one({ "name.last": "Turing" })

This command returns the following output. This example has been broken into multiple lines for readability.

'_id': ObjectId('5ecd43aa2600f51da704b35f'),
'name': {
'first': 'Alan',
'last': 'Turing'
'birth': datetime.datetime(1912, 6, 23, 0, 0),
'death': datetime.datetime(1954, 6, 7, 0, 0),
'contribs': [
'Turing machine',
'Turing test',
'views': 1250000

You may see a different value for ObjectId, because it is a system-generated value.

See also:

To learn more about querying data with PyMongo, see the PyMongo documentation.

If you continue to grow your cluster, consider scaling your cluster to support more users and operations.

Give Feedback