@@ -44,51 +44,35 @@ the columns in a relational database table.
44
44
How do I create a database and a collection?
45
45
--------------------------------------------
46
46
47
- .. note::
48
-
49
- You can enter the commands referenced in this FAQ by using
50
- the :binary:`MongoDB Shell <~bin.mongo>`. 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
-
55
47
If a database does not exist, MongoDB creates the database when you
56
48
first store data for that database.
57
49
58
50
If a collection does not exist, MongoDB creates the collection when you
59
- first store data for that collection.
51
+ first store data for that collection. [#explicit-creation]_
60
52
61
53
As such, you can switch to a non-existent database (``use <dbname>``)
62
54
and perform the following operation:
63
55
64
56
.. code-block:: javascript
65
57
66
- use myNewDB;
67
-
68
- db.myNewCollection1.insertOne( { x: 1 } );
69
- db.myNewCollection2.createIndex( { a: 1 } );
58
+ use myNewDB
70
59
71
- - The :method:` db.collection .insertOne()` method creates
72
- the collection ``myNewCollection1`` if it does not already exist.
60
+ db.myNewCollection1 .insertOne( { x: 1 } )
61
+ db.myNewCollection2.createIndex( { a: 1 } )
73
62
74
- - The :method:`db.collection.createIndex()` method creates the index and
75
- the collection ``myNewCollection2 `` if it does not already exist.
63
+ The ``insert`` operation creates both the database ``myNewDB`` and the
64
+ collection ``myNewCollection1 `` if they do not already exist.
76
65
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
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``.
88
70
89
- use myNewDB;
71
+ .. [#explicit-creation]
90
72
91
- db.createCollection("myNewCollection1");
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.
92
76
93
77
.. _faq-schema-free:
94
78
0 commit comments