DOCSP-25448 Create a Collection in MongoDB SEO Optimizations (#6829)

kanchana-mongodb · web-flow · commit 0517fcaac94d · 2024-04-11T14:45:45.000-04:00
* DOCSP-25448 Create a Collection in MongoDB SEO Optimizations * DOCSP-25448 updates for copy feedback * DOCSP-25448 updates for SEO * DOCSP-25448 updates for EG's feedback
diff --git a/source/core/databases-and-collections.txt b/source/core/databases-and-collections.txt
@@ -1,8 +1,8 @@
 .. _databases-and-collections:
 
-=========================
-Databases and Collections
-=========================
+====================================
+Databases and Collections in MongoDB 
+====================================
 
 .. default-domain:: mongodb
 
@@ -22,8 +22,8 @@ Databases and Collections
    :values: reference
 
 .. meta:: 
-   :description: Overview of what databases and collections (tables) are in MongoDB.
-   :keywords: atlas
+   :description: Learn how databases and collections work within MongoDB
+   :keywords: atlas, compass, MongoDB
 
 .. contents:: On this page
    :local:
@@ -33,48 +33,154 @@ Databases and Collections
 
 Overview 
 --------
+
 MongoDB stores data records as :term:`documents <document>`
 (specifically :ref:`BSON documents <bson-document-format>`) which are
 gathered together in :term:`collections <collection>`.  A
 :term:`database <database>` stores one or more collections of documents.
 
-.. |page-topic| replace:: manage MongoDB :atlas:`databases </atlas-ui/databases>` and :atlas:`collections </atlas-ui/collections>` in the UI
+You can manage :atlas:`databases </atlas-ui/databases>` and
+:atlas:`collections </atlas-ui/collections>` on the Atlas cluster from 
+the Atlas UI, :binary:`~bin.mongosh`, or |compass|. This page describes
+how to manage databases and collections on the Atlas cluster from the
+Atlas UI. For self-managed deployments, you can use
+:binary:`~bin.mongosh` or |compass| to manage databases and collections. 
+
+Select the client that you want to use to manage databases and
+collections.  
+
+.. tabs:: 
+
+   .. tab:: Atlas UI
+      :tabid: atlas
+
+      MongoDB Atlas is a multi-cloud database service that simplifies
+      deploying and managing your databases on the cloud providers of
+      your choice. 
+
+   .. tab:: mongosh 
+      :tabid: mongosh 
 
-.. cta-banner::
-   :url: https://www.mongodb.com/docs/atlas/atlas-ui/databases/
-   :icon: Cloud
+      The MongoDB Shell, :program:`mongosh`, is a JavaScript and Node.js 
+      :abbr:`REPL (Read Eval Print Loop)` environment for interacting
+      with MongoDB deployments. To learn more, see :mongosh:`mongosh
+      </>`. 
 
-   .. include:: /includes/fact-atlas-compatible.rst
+   .. tab:: MongoDB Compass 
+      :tabid: compass 
 
+      MongoDB Compass is a powerful GUI for querying, aggregating, and
+      analyzing your MongoDB data in a visual environment. To learn
+      more, see :compass:`MongoDB Compass </>`.
 
 Databases
 ---------
-In MongoDB, databases hold one or more collections of documents. To
-select a database to use, in :binary:`~bin.mongosh`, issue the
-``use <db>`` statement, as in the following example:
 
-.. code-block:: javascript
+In MongoDB, databases hold one or more collections of documents. 
+
+.. tabs:: 
+   :hidden:
+
+   .. tab:: Atlas UI
+      :tabid: atlas
+
+      To select a database to use, log in to Atlas and do the following:
+
+      .. procedure:: 
+         :style: normal
 
-   use myDB
+         .. step:: Navigate to the :guilabel:`Collections` tab.
 
+         .. step:: Select the database from the list of databases in the left pane.
+
+   .. tab:: mongosh 
+      :tabid: mongosh 
+
+      To select a database to use, in :binary:`~bin.mongosh`, issue the
+      ``use <db>`` statement, as in the following example: 
+
+      .. code-block:: javascript
+
+         use myDB
+
+   .. tab:: MongoDB Compass 
+      :tabid: compass 
+
+      To select a database to use, complete the following steps:
+
+      .. procedure:: 
+         :style: normal 
+
+         .. step:: Start |compass| and connect to your cluster. 
+
+            To learn more, see :compass:`Connect to MongoDB
+            </connect/>`.
+            
+         .. step:: Select :guilabel:`Databases` from the left navigation. 
+
+            The :guilabel:`Databases` tab opens to list the existing databases
+            for your MongoDB deployment. 
+            
 Create a Database
 ~~~~~~~~~~~~~~~~~
 
-If a database does not exist, MongoDB creates the database when you
-first store data for that database. As such, you can switch to a
-non-existent database and perform the following operation in
-:binary:`~bin.mongosh`:
+.. tabs:: 
+   :hidden:
 
-.. code-block:: javascript
+   .. tab:: Atlas UI 
+      :tabid: atlas
 
-   use myNewDB
+      To create a new database, log in to Atlas and do the following:
 
-   db.myNewCollection1.insertOne( { x: 1 } )
+      .. procedure:: 
+         :style: normal
 
-The :method:`~db.collection.insertOne()` operation creates both the
-database ``myNewDB`` and the collection ``myNewCollection1`` if they do
-not already exist. Be sure that both the database and collection names
-follow MongoDB :ref:`restrictions-on-db-names`.
+         .. step:: Navigate to the :guilabel:`Collections` tab.
+
+         .. step:: Click :guilabel:`Create Database`.
+
+         .. step:: Enter the :guilabel:`Database Name` and the :guilabel:`Collection Name`.
+
+            Enter the database and the collection name to create the
+            database and its first collection. 
+
+         .. step:: Click :guilabel:`Create`.
+
+            Upon successful creation, the database and the collection
+            displays in the left pane in the Atlas UI. 
+
+   .. tab:: mongosh 
+      :tabid: mongosh 
+
+      If a database does not exist, MongoDB creates the database when you
+      first store data for that database. As such, you can switch to a
+      non-existent database and perform the following operation in
+      :binary:`~bin.mongosh`:
+
+      .. code-block:: javascript
+
+         use myNewDB
+
+         db.myNewCollection1.insertOne( { x: 1 } )
+
+      The :method:`~db.collection.insertOne()` operation creates both the
+      database ``myNewDB`` and the collection ``myNewCollection1`` if they do
+      not already exist. Be sure that both the database and collection names
+      follow MongoDB :ref:`restrictions-on-db-names`.
+
+   .. tab:: MongoDB Compass 
+      :tabid: compass 
+
+      .. procedure:: 
+         :style: normal   
+
+         .. step:: Open the :guilabel:`Databases` tab.
+
+         .. step:: Click the :guilabel:`Create database` button.
+
+         .. step:: Enter database and first collection names in the :guilabel:`Create Database` dialog. 
+
+         .. step:: Click :guilabel:`Create Database` to create the database and its first collection. 
 
 .. _collections:
 
@@ -92,27 +198,136 @@ Create a Collection
 If a collection does not exist, MongoDB creates the collection when you
 first store data for that collection.
 
-.. code-block:: javascript
+.. tabs:: 
+   :hidden:
+
+   .. tab:: Atlas 
+      :tabid: atlas
+
+      To create a new collection, log in to Atlas and do the following:
+
+      .. procedure:: 
+         :style: normal
 
-   db.myNewCollection2.insertOne( { x: 1 } )
-   db.myNewCollection3.createIndex( { y: 1 } )
+         .. step:: Navigate to the :guilabel:`Collections` tab.
 
-Both the :method:`~db.collection.insertOne()` and the
-:method:`~db.collection.createIndex()` operations create their
-respective collection if they do not already exist. Be sure that the
-collection name follows MongoDB :ref:`restrictions-on-db-names`.
+         .. step:: Click the :guilabel:`+` icon for the database.
+
+         .. step:: Enter the name of the collection.
+
+         .. step:: Click :guilabel:`Create`.
+
+            Upon successful creation, the collection displays underneath
+            the database in the Atlas UI. 
+
+   .. tab:: mongosh 
+      :tabid: mongosh 
+
+      .. code-block:: javascript
+
+         db.myNewCollection2.insertOne( { x: 1 } )
+         db.myNewCollection3.createIndex( { y: 1 } )
+
+      Both the :method:`~db.collection.insertOne()` and the
+      :method:`~db.collection.createIndex()` operations create their
+      respective collection if they do not already exist. Be sure that the
+      collection name follows MongoDB :ref:`restrictions-on-db-names`.
+
+   .. tab:: MongoDB Compass 
+      :tabid: compass 
+
+      .. procedure:: 
+         :style: normal   
+
+         .. step:: Click the name of the database where you to want to create a collection in the left navigation.
+
+         .. step:: Click the :guilabel:`+` icon next to the database name.
+
+         .. step:: Enter the name of the collection in the :guilabel:`Create Collection` dialog.
+
+         .. step:: Click :guilabel:`Create Collection` to create the collection. 
 
 Explicit Creation
 ~~~~~~~~~~~~~~~~~
 
-MongoDB provides the :method:`db.createCollection()` method to
-explicitly create a collection with various options, such as setting
-the maximum size or the documentation validation rules. If you are not
-specifying these options, you do not need to explicitly create the
-collection since MongoDB creates new collections when you first store
-data for the collections.
+.. tabs:: 
+   :hidden:
+
+   .. tab:: Atlas 
+      :tabid: atlas
+
+      To create a new collection, log in to Atlas and do the following:
+
+      .. procedure:: 
+         :style: normal
+
+         .. step:: Navigate to the :guilabel:`Collections` tab.
+
+         .. step:: Click the :guilabel:`+` icon for the database.
+
+         .. step:: Enter the name of the collection.
+         
+         .. step:: Optional. From the :guilabel:`Additional Preferences` dropdown, select the type of collection that you want to create.
+
+            You can create one of the following types of collections:
+            
+            - :ref:`Capped collection <manual-capped-collection>`
 
-To modify these collection options, see :dbcommand:`collMod`.
+              If you select to create a capped collection, specify the
+              maximum size in bytes. 
+
+            - :ref:`Time Series Collection <manual-timeseries-landing>`
+
+              If you select to create a time series collection, specify
+              the time field and granularity. You can optionally specify
+              the meta field and the time for old data in the collection
+              to expire.  
+
+            - :ref:`Clustered Index Collection <clustered-collections>`
+
+              If you select to create a clustered collection, you must
+              specify clustered index key value and a name for the
+              clustered index.  
+         
+         .. step:: Click :guilabel:`Create`.
+
+            Upon successful creation, the collection displays underneath
+            the database in the Atlas UI.          
+
+   .. tab:: mongosh 
+      :tabid: mongosh 
+
+      MongoDB provides the :method:`db.createCollection()` method to
+      explicitly create a collection with various options, such as setting
+      the maximum size or the documentation validation rules. If you are not
+      specifying these options, you do not need to explicitly create the
+      collection since MongoDB creates new collections when you first store
+      data for the collections.
+
+      To modify these collection options, see :dbcommand:`collMod`.
+
+   .. tab:: MongoDB Compass 
+      :tabid: compass 
+
+      .. procedure:: 
+         :style: normal   
+
+         .. step:: Click the name of the database where you to want to create a collection in the left navigation.
+
+         .. step:: Click the :guilabel:`Create collection` button.
+
+         .. step:: Enter the name of the collection and optionally, configure additional preferences.
+
+         .. step:: Click :guilabel:`Create Collection` to create the collection. 
+
+            |compass| provides the following additional preferences that
+            you can configure for your collection: 
+
+            - :compass:`Create a Capped Collection</collections/capped-collection/>`
+            - :compass:`Create a Clustered Collection</collections/clustered-collection/>`
+            - :compass:`Create a Collection with Collation </collections/collation-collection/>`
+            - :compass:`Create a Collection with Encrypted Field </collections/encrypted-collection/>`
+            - :compass:`Create a Time Series Collection </collections/time-series-collection/>`
 
 Document Validation
 ~~~~~~~~~~~~~~~~~~~
@@ -151,9 +366,21 @@ identifier)`. The
 collection UUID remains the same across all members of a replica set
 and shards in a sharded cluster.
 
-To retrieve the UUID for a collection, run either the
-:manual:`listCollections </reference/command/listCollections>` command
-or the :method:`db.getCollectionInfos()` method.
+.. tabs:: 
+   :hidden:
+
+   .. tab:: Atlas 
+      :tabid: atlas
+
+   .. tab:: mongosh 
+      :tabid: mongosh 
+
+      To retrieve the UUID for a collection, run either the
+      :manual:`listCollections </reference/command/listCollections>` command
+      or the :method:`db.getCollectionInfos()` method.
+
+   .. tab:: MongoDB Compass 
+      :tabid: compass
 
 .. toctree::
    :titlesonly:
