diff --git a/source/images/hero.png b/source/images/hero.png new file mode 100644 index 00000000000..c272c9d05ee Binary files /dev/null and b/source/images/hero.png differ diff --git a/source/images/icons/compass.svg b/source/images/icons/compass.svg new file mode 100644 index 00000000000..ddd1c267e06 --- /dev/null +++ b/source/images/icons/compass.svg @@ -0,0 +1,23 @@ + + + + + + + + + + + + + + + + + + + + + + + diff --git a/source/images/icons/drivers.svg b/source/images/icons/drivers.svg new file mode 100644 index 00000000000..5c9e8a1de02 --- /dev/null +++ b/source/images/icons/drivers.svg @@ -0,0 +1,31 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/source/images/icons/opsmanager.svg b/source/images/icons/opsmanager.svg new file mode 100644 index 00000000000..537c2129203 --- /dev/null +++ b/source/images/icons/opsmanager.svg @@ -0,0 +1,8 @@ + + + + + + + + diff --git a/source/images/scaling.png b/source/images/scaling.png new file mode 100644 index 00000000000..872685eae00 Binary files /dev/null and b/source/images/scaling.png differ diff --git a/source/images/security.png b/source/images/security.png new file mode 100644 index 00000000000..cae4f808cbf Binary files /dev/null and b/source/images/security.png differ diff --git a/source/index.txt b/source/index.txt index d1675dcfc41..e3f59ceb0ff 100644 --- a/source/index.txt +++ b/source/index.txt @@ -1,171 +1,233 @@ -:orphan: +:template: product-landing +:hidefeedback: header +:noprevnext: -============================= -The MongoDB |version| Manual -============================= +================ +What is MongoDB? +================ -.. default-domain:: mongodb +.. introduction:: -.. note:: MongoDB 4.4 Released Jul 30, 2020 + MongoDB is a document database designed for ease of application + development and scaling. - For new features in MongoDB 4.4, see :doc:`/release-notes/4.4`. + Run MongoDB with - To download MongoDB 4.4, go to the `MongoDB Download Center - `_. + - `MongoDB Atlas + `__ fully managed in + the cloud, + - the source available and free-to-use :doc:`MongoDB + Community `, or + - the :doc:`MongoDB Enterprise Advanced + ` subscription. -.. include:: /includes/fact-mongodb-intro.rst + .. button:: Install MongoDB + :uri: /installation -The Manual documents features and functionality for MongoDB Community, -Enterprise, and Atlas deployments. + `Get started with MongoDB Atlas `__ -Getting Started ---------------- +.. image:: /images/hero.png + :alt: Homepage hero image -MongoDB provides a Getting Started Guide in the following editions: +.. kicker:: What You Can Do -.. list-table:: - :class: index-table +Work with your data in MongoDB +------------------------------ - * - :doc:`mongo Shell Edition ` +.. tabs:: - `Node.JS Edition `_ + .. tab:: Store and query your data + :tabid: store - - :driver:`Python Edition ` + .. procedure:: - `C++ Edition `_ + .. step:: Model your data - - `Java Edition `_ + Design your data schema to support frequent access patterns. + You can update or enforce your schema at any point. - `C# Edition `_ + :doc:`To learn more, see Data Modeling Introduction ` - - `Ruby Edition `_ + .. step:: Connect to MongoDB -Once you complete the Getting Started Guide, you may find the following topics -useful. + Import data from CSV or JSON files into your MongoDB + database. -.. list-table:: - :header-rows: 1 - :class: index-table + `To learn more, see MongoDB Shell (mongosh) `__ - * - Introduction - - Developers - - Administrators - - Reference + .. step:: Insert, query, update, or delete documents - * - :doc:`/introduction` + Use the MongoDB Query API to perform CRUD operations on your + data - with or without transactions. - :doc:`Installation Guides ` + :ref:`To learn more, see MongoDB CRUD Operations ` - :doc:`/core/databases-and-collections` + .. code-block:: javascript - :doc:`/core/document` + ➜ mongosh --port 27017 + Current Mongosh Log ID: 123a4bc5d67891011ef1213g + Connecting to: mongodb://127.0.0.1:27017/ - - :doc:`CRUD Operations ` + For mongosh info see: https://docs.mongodb.com/mongodb-shell/ - :doc:`Aggregation ` + test> db.messages.insertMany([ + { + message: "Hello World!", + author: "MongoDB", + comments: [], + _id: 1 + } + ]) + { acknowledged: true, insertedIds: { '0': 1 } } - :doc:`SQL to MongoDB ` + test> db.messages.findOne({ _id: 1 }) + { _id: 1, message: 'Hello World!', author: 'MongoDB', comments: [] } - :doc:`/indexes` + .. tab:: Transform data with Aggregations + :tabid: transform - - :doc:`/administration/production-notes` + .. procedure:: - :doc:`Replica Sets ` + .. step:: Import your data - :doc:`Sharded Clusters ` + Import data from a CSV or JSON file with mongoimport. - :doc:`MongoDB Security ` + `To learn more, see mongoimport `__ - - :doc:`Shell Methods ` + .. step:: Aggregate your data - :doc:`Query Operators ` + Use aggregation pipelines to process your data in multiple stages and return the computed results. - :doc:`Reference ` + :doc:`To learn more, see Aggregation ` - :doc:`/reference/glossary` + .. code-block:: javascript -Support -------- + test> db.orders.insertMany([ + { "item" : "almonds", "price" : 12, "quantity" : 2 }, + { "item" : "pecans", "price" : 20, "quantity" : 1 }, + ]) -.. include:: /includes/fact-support.rst + test> db.inventory.insertMany([ + { "sku" : "almonds", "description": "product 1", "instock" : 120 }, + { "sku" : "cashews", "description": "product 3", "instock" : 60 }, + { "sku" : "pecans", "description": "product 4", "instock" : 70 } + ]) -.. _`Stack Overflow`: http://stackoverflow.com/questions/tagged/mongodb + test> db.orders.aggregate([ + { $match: { price: { $lt: 15 } } }, + { $lookup: { + from: "inventory", + localField: "item", + foreignField: "sku", + as: "inventory_docs" + } }, + { $sort: { price: 1 } }, + ]) -Issues ------- + .. tab:: Secure access to your data + :tabid: create -For instructions on how to file a JIRA ticket for the MongoDB server or -one of the related projects, see -``_. + .. procedure:: + .. step:: Authenticate a client -Community ---------- + Verify the identity of a user, replica set member, or + sharded cluster member with authentication. -Getting involved in the MongoDB community is a great way to build -relationships with other talented and like-minded engineers, increase -awareness for the interesting work that you are doing, and sharpen your -skills. To learn about the MongoDB community, see -`Get Involved with MongoDB `_. + :ref:`To learn more, see Authentication ` -Learning MongoDB ----------------- + .. step:: Control access to your database -In addition to the documentation, there are many ways to learn to use -MongoDB. You can: + Enable Role-Based Access Controls to manage user privileges + on your entire database cluster or individual collections. -- Enroll in a free online course at `MongoDB University - `_ + :ref:`To learn more, see Role-Based Access Controls ` -- Browse the archive of `MongoDB Presentations - `_ + .. step:: Encrypt your most sensitive data -- Join a local `MongoDB User Group (MUG) - `_ + Client-side field level encryption protects data while it is + in-use by the database. Fields are encrypted before they + leave your application, protecting them over the network, in + memory and at rest. -- Attend an upcoming MongoDB `event `_ or - `webinar `_ + :doc:`To learn more, see Client-Side Field Level Encryption ` -- Read the `MongoDB blog `_ + .. image:: /images/security.png + :alt: MongoDB Security -- Download the `Architecture Guide - `_ + .. tab:: Deploy and scale your database + :tabid: deploy -- Read the `Practical MongoDB Aggregations - `__ e-book + .. procedure:: -Licensing ---------- + .. step:: Deploy a replica set -The manual is licensed under a `Creative Commons -Attribution-NonCommercial-ShareAlike 3.0 United States License -`_. + Provide redundancy and resilience for your database by deploying a replica set. -For information on MongoDB licensing, see `MongoDB Licensing -`_. + :ref:`To learn more, see Replication ` + .. step:: Scale out your database -Additional Resources --------------------- + Use sharding to horizontally scale your database or to ensure location-based separation of data. -`MongoDB, Inc.`_ - The company behind MongoDB. + :ref:`To learn more, see Sharding ` -`MongoDB Atlas `_ - Database as a service. + .. image:: /images/scaling.png + :alt: MongoDB Deploy and Scale -|mms-home| - A cloud-based hosted operations management solution for MongoDB. +.. kicker:: Related Products & Resources -`MongoDB Ops Manager `_ - Enterprise operations management solution for MongoDB: includes - Automation, Backup, and Monitoring. +Go Further with MongoDB +----------------------- -`MongoDB Drivers `_ - The documentation available for the drivers for use with MongoDB. +Explore libraries and tools for MongoDB. -.. _`MongoDB, Inc.`: https://www.mongodb.com?tck=docs_server +.. card-group:: + :columns: 3 + :style: compact -.. include:: /includes/replacement-mms.rst + .. card:: + :cta: Learn about Drivers + :url: https://docs.mongodb.com/drivers/ + :icon: /images/icons/drivers.svg + :icon-alt: MongoDB Atlas icon -.. |arrow| unicode:: U+27A4 + Use MongoDB in your application’s language + + .. card:: + :cta: View Compass Docs + :url: https://docs.mongodb.com/compass/current/ + :icon: /images/icons/compass.svg + :icon-alt: MongoDB University icon + + Visually explore your data with MongoDB Compass + + .. card:: + :cta: View Ops Manager + :url: https://docs.opsmanager.mongodb.com/current/ + :icon: /images/icons/opsmanager.svg + :icon-alt: MongoDB Server icon + + Manage and monitor your deployments + +.. toctree:: + :titlesonly: + + Introduction + Installation + MongoDB Shell (mongosh) + /crud + /aggregation + /data-modeling + /core/transactions + /indexes + /security + /changeStreams + /replication + /sharding + /administration + /storage + /faq + /reference + /release-notes + /support