Cookies help us deliver our services. By using our services, you agree to our use of cookies. More information

Difference between revisions of "Find"

From NoSQLZoo
Jump to: navigation, search
Line 1: Line 1:
 
{{TopTenTips}}
 
{{TopTenTips}}
 
<div style="min-height:25em">
 
<div style="min-height:25em">
<code>find()</code> is used to query documents. It takes a <code>query</code> parameter and an optional <code>projecetion</code> parameter, and returns a [http://docs.mongodb.org/manual/reference/glossary/#term-cursor cursor].<br/>
+
<code>find()</code> is used to filter and project<br/>
 
By default <code>find()</code> returns a cursor containing all the documents in the collection it is used on. This is the same as <code>find({})</code><br /><br/>
 
By default <code>find()</code> returns a cursor containing all the documents in the collection it is used on. This is the same as <code>find({})</code><br /><br/>
 
To get all the documents with a certain value, <code>find(<field>:{"$eq":<value>}})</code> can be used, this can be simplified to <code>find(<field>:<value>})</code><br/>
 
To get all the documents with a certain value, <code>find(<field>:{"$eq":<value>}})</code> can be used, this can be simplified to <code>find(<field>:<value>})</code><br/>
Line 14: Line 14:
 
</div>
 
</div>
 
<div class="q nonum" data-lang="mongo">
 
<div class="q nonum" data-lang="mongo">
<p class="strong>Show the capital city and population of France</p>
+
<p class="strong>Show the name and capital for every country of "South America"</p>
 
<pre class=def>
 
<pre class=def>
db.world.findOne({"name":"France"},{"_id":0,"population":1,"capital":1})
+
db.world.find({continent:"South America"},{"_id":0,name:1,capital:1})
 
</pre>
 
</pre>
 
</div>
 
</div>

Revision as of 15:25, 3 December 2015

find() is used to filter and project
By default find() returns a cursor containing all the documents in the collection it is used on. This is the same as find({})

To get all the documents with a certain value, find(<field>:{"$eq":<value>}}) can be used, this can be simplified to find(<field>:<value>})
$eq can be replaced with other conditional operators such as $lt, $gt to perform less than or greater than comparisons.

To query nested documents, dot notation can be used, e.g. parent.child.field

The second parameter selects what fields to include. If the second parameter is not present the default action is to include all the fields in the result documents.
To hide a field, <field>:0 is used. The other fields won't be removed.
Using <field>:1 will include that field and hide all the others except the _id and other fields set to 1.
Passing an empty ({}) second parameter hides all fields except the _id field, to hide _id it has to be explicitly set to 0.

find_one() limits the result to one document.

Show the name and capital for every country of "South America"

db.world.find({continent:"South America"},{"_id":0,name:1,capital:1})