PyMongo is a Python distribution  that contains tools for working with MongoDB, So in this blog post let’s see some basic methods that perform CRUD operations to a collection.

Install pymongo:

pip install pymongo

Connecting  to with Database with PyMongo:

1. To perform CRUD operations first need to establish the connection using Mongo client 

>>> from pymongo import MongoClient
>>> client = MongoClient('localhost',27017)  # 27017 is the default port number for mongodb

2. Next step is to connect to the database (test).

db = client.test

3. Now retrieve the collection (person) from the database

col = db.person

Now we are ready to perform the actual CRUD operations.

CRUD Operations:


Mongo store the data in the form of JSON objects. So every record for a collection in mongo is called a document. If the collection does not currently exist, insert operations will create the collection. We can insert the documents into collection in 3 ways.

  • insert_one()
  • insert_many()
  • insert()

1. insert_one(): insert_one() inserts a single document into a collection.

      name: "John",
      salary: 100 ,

The above snippet returns the pymongo.results.InsertOneResult object:

<pymongo.results.InsertOneResult object at 0x7f8fbe7fb960>

2. insert_many(): insert_many() inserts multiple documents into a collection.

The following example inserts three new documents into the users collection. Each document has two fields name and salary. Since the documents do not specify an _id field, MongoDB adds the _id field with an ObjectId value to each document.

     { name: "Jeorge", salary: 100},
     { name: "Steve", salary: 100},
     { name: "David", salary: 100}

The method returns a pymongo.results.InsertManyResult object

<pymongo.results.InsertManyResult object at 0x7f8fbe7fb7d0>

3. insert(): insert() can be used to insert single or array or documents.

# single document
col.insert({ name: "Jeorge", salary: 100})

# array of documents
col.insert([{ name: "Jeorge", salary: 100}, { name: "Steve", salary: 100}])

insert() method returns all the Object ids of the documents that are inserted.

# return type of single document

# return type of multiple documents
[ObjectId('57611d4b1aa303032ad5ba9e'), ObjectId('57611d4b1aa30303sdd5ba9e')]


We can retrieve the documents from a collection using 2 methods.

  • find()
  • find_one()

1. find(): find() function will return with all the documents in that collection. By default it returns a cursor object.

<pymongo.cursor.Cursor object at 0x7f8fc1853890>

2. find_one(): find_one() returns the first document in the collection.

{u'salary': 100, u'_id': ObjectId('57611a711aa303032ad5ba9b'), u'name': u'John'}

We can filter the results by applying conditions on these methods as following

col.find_one({"name": "John"}) # returns object.
col.find({"name": "John"}) # returns cursor

U- Update:

We can update the documents from the collection with the following methods.

  • update()
  • update_one()
  • update_many()
  • replace_one()

The general syntax for all the above methods is

<method_name>(condition, update_or_replace_document, upsert=False, bypass_document_validation=False)


condition: A query that matches the document to replace.
update_or_replace_document: The new document.
upsert (optional): If True, perform an insert if no documents match the filter.
bypass_document_validation: (optional) If True, allows the write to opt-out of document level validation. Default is False.

Following are the snippets forh update(), update_one(), update_many() and replace_one(). All the methods will return UpdateResult object except update().

# update_one
>>> col.update_one({"name":"John"}, {"$set":{"name":"Joseph"}})
<pymongo.results.UpdateResult object at 0x7f8fbe7fb910>

# update_many
>>> col.update_many({"name":"John"}, {"$set":{"name":"Joseph"}})
<pymongo.results.UpdateResult object at 0x7f8fbe7fb7d0>

# update
>>> col.update({"name":"John"}, {"$set":{"name":"Jeorge"}})
{'updatedExisting': False, u'nModified': 0, u'ok': 1, u'n': 0}

>>> col.replace_one({"name":"John"}, {"name":"Jeorge"})
<pymongo.results.UpdateResult object at 0x7f8fbe7fb910>

D- Delete:

We can delete the documents in the collection using  the following methods.

  • delete_one()
  • delete_many()

Both these methods will return a DeleteResult object. The general syntax for the above methods is as follows.


Following are the examples how we use the delete_one() and delete_many() methods, both returns the DeleteResult object.

>>> col.delete_one({"name":"John"})
<pymongo.results.DeleteResult object at 0x7f8fbe7fba00>

>>> col.delete_many({"name":"John"})
<pymongo.results.DeleteResult object at 0x7f8fbe7fb960>

Subscribe To our news letter

Subscribe to our news letter to receive latest blog posts into your inbox. Please fill your email address in the below form.
*We don't provide your email contact details to any third parties
Latest Comments
Related Articles
group() vs aggregation framework vs MapReduce in mongodb Ashwin Kumar

The group() command, Aggregation Framework and MapReduce are collectively aggregation features of MongoDB. group(): Group Performs simple aggregation operations on a collection documents. Group is ...

Continue Reading...
Advanced Querying in MongoDB Ramya Ambati

Advanced Queries of MongoDB: Inserting records to the database and retrieving data from database.
1. Wrapped Queries: Like, sort, limit, count.
2. Query Using Modifiers: ...

Continue Reading...
Full text search in mongodb Nikhila Mergu

Full text search is a custom implementation created by the MongoDB developers as a specific index type

Full text search as an index type when ...

Continue Reading...