@@ -44,35 +44,51 @@ the columns in a relational database table.
4444How do I create a database and a collection?
4545--------------------------------------------
4646
47+ .. note::
48+
49+ You can enter the commands referenced in this FAQ by using
50+ the :binary:`MongoDB Shell <~bin.mongosh>`. The MongoDB Shell is an
51+ interactive JavaScript interface to MongoDB. You can use the MongoDB
52+ Shell to query and update data as well as perform administrative
53+ operations.
54+
4755If a database does not exist, MongoDB creates the database when you
4856first store data for that database.
4957
5058If a collection does not exist, MongoDB creates the collection when you
51- first store data for that collection. [#explicit-creation]_
59+ first store data for that collection.
5260
5361As such, you can switch to a non-existent database (``use <dbname>``)
5462and perform the following operation:
5563
5664.. code-block:: javascript
5765
58- use myNewDB
66+ use myNewDB;
67+
68+ db.myNewCollection1.insertOne( { x: 1 } );
69+ db.myNewCollection2.createIndex( { a: 1 } );
5970
60- db.myNewCollection1 .insertOne( { x: 1 } )
61- db.myNewCollection2.createIndex( { a: 1 } )
71+ - The :method:` db.collection .insertOne()` method creates
72+ the collection ``myNewCollection1`` if it does not already exist.
6273
63- The ``insert`` operation creates both the database ``myNewDB`` and the
64- collection ``myNewCollection1 `` if they do not already exist.
74+ - The :method:`db.collection.createIndex()` method creates the index and
75+ the collection ``myNewCollection2 `` if it does not already exist.
6576
66- The ``createIndex`` operation, which occurs after the ``myNewDB`` has
67- been created, creates the index and the collection ``myNewCollection2``
68- if the collection does not exist. If ``myNewDb`` did not exist, the
69- ``createIndex`` operation would have also created the ``myNewDB``.
77+ - If the ``myNewDb`` database did not exist, either the
78+ :method:`db.collection.createIndex()` method or
79+ :method:`db.collection.insertOne()` method would have created
80+ the ``myNewDb`` database automatically.
81+
82+ You can also create a collection explicitly using
83+ :method:`db.createCollection` method if you want to specify specific
84+ :ref:`options<create_collection_parameters>`, such as maximum size
85+ or document validation rules:
86+
87+ .. code-block:: javascript
7088
71- .. [#explicit-creation]
89+ use myNewDB;
7290
73- You can also create a collection explicitly using
74- :method:`db.createCollection` if you want to specify specific
75- options, such as maximum size or document validation rules.
91+ db.createCollection("myNewCollection1");
7692
7793.. _faq-schema-free:
7894
0 commit comments