crud.txt

.. _crud:

=======================
MongoDB CRUD Operations
=======================

.. default-domain:: mongodb

.. facet::
   :name: genre
   :values: reference

.. meta:: 
   :description: Manage documents in collections by running create, read, update, and delete operations.
   :keywords: atlas

.. contents:: On this page
   :local:
   :backlinks: none
   :depth: 1
   :class: singlecol

CRUD operations *create*, *read*, *update*, and *delete*
:ref:`documents <bson-document-format>`.

You can connect with driver methods and perform CRUD operations
for deployments hosted in the following environments:

.. |page-topic| replace:: :atlas:`perform CRUD operations in the UI </atlas-ui/documents>`

.. cta-banner::
   :url: https://www.mongodb.com/docs/atlas/atlas-ui/documents
   :icon: Cloud

   .. include:: /includes/fact-atlas-compatible.rst


Create Operations
-----------------

Create or insert operations add new :ref:`documents
<bson-document-format>` to a :ref:`collection <collections>`. If the
collection does not currently exist, insert operations will create the
collection.

MongoDB provides the following methods to insert documents into a
collection:

- :method:`db.collection.insertOne()` 
- :method:`db.collection.insertMany()` 

In MongoDB, insert operations target a single :term:`collection`. All
write operations in MongoDB are :doc:`atomic
</core/write-operations-atomicity>` on the level of a single
:ref:`document <bson-document-format>`.

.. include:: /images/crud-annotated-mongodb-insertOne.rst

For examples, see :doc:`/tutorial/insert-documents`.

.. _crud-read-operations:

Read Operations
---------------

Read operations retrieve :ref:`documents <bson-document-format>` from a
:ref:`collection <collections>`; i.e. query a collection for
documents. MongoDB provides the following methods to read documents from
a collection:

- :method:`db.collection.find()`

You can specify :ref:`query filters or criteria
<read-operations-query-argument>` that identify the documents to return.

.. include:: /images/crud-annotated-mongodb-find.rst

For examples, see:

- :doc:`/tutorial/query-documents`

- :doc:`/tutorial/query-embedded-documents`

- :doc:`/tutorial/query-arrays`

- :doc:`/tutorial/query-array-of-documents`

Update Operations
-----------------

Update operations modify existing :ref:`documents
<bson-document-format>` in a :ref:`collection <collections>`. MongoDB
provides the following methods to update documents of a collection:

- :method:`db.collection.updateOne()` 

- :method:`db.collection.updateMany()` 

- :method:`db.collection.replaceOne()` 

In MongoDB, update operations target a single collection. All write
operations in MongoDB are :doc:`atomic
</core/write-operations-atomicity>` on the level of a single document.

You can specify criteria, or filters, that identify the documents to
update. These :ref:`filters <document-query-filter>` use the same
syntax as read operations.

.. include:: /images/crud-annotated-mongodb-updateMany.rst

For examples, see :doc:`/tutorial/update-documents`.

Delete Operations
-----------------

Delete operations remove documents from a collection. MongoDB provides
the following methods to delete documents of a collection:

- :method:`db.collection.deleteOne()` 
- :method:`db.collection.deleteMany()`

In MongoDB, delete operations target a single :term:`collection`. All
write operations in MongoDB are :doc:`atomic
</core/write-operations-atomicity>` on the level of a single document.

You can specify criteria, or filters, that identify the documents to
remove. These :ref:`filters <document-query-filter>` use the same
syntax as read operations.

.. include:: /images/crud-annotated-mongodb-deleteMany.rst

For examples, see :doc:`/tutorial/remove-documents`.

Bulk Write
----------

MongoDB provides the ability to perform write operations in bulk. For
details, see :doc:`/core/bulk-write-operations`.

.. toctree::
   :titlesonly:
   :hidden:

   Insert </tutorial/insert-documents>
   Query </tutorial/query-documents>
   Update </tutorial/update-documents>
   Remove </tutorial/remove-documents>
   Bulk Write </core/bulk-write-operations>
   Retryable Writes </core/retryable-writes>
   Retryable Reads </core/retryable-reads>
   SQL to MongoDB </reference/sql-comparison>
   Text Search </text-search>
   Geospatial Queries </geospatial-queries>
   Read Concern </reference/read-concern>
   Write Concern </reference/write-concern>
   CRUD Concepts </core/crud>