Skip to content

Commit 63a3756

Browse files
biniona-mongodbterakilobyte
authored andcommitted
(DOCSP-20836) Read Operators (#176)
1 parent 19a7aa2 commit 63a3756

File tree

8 files changed

+229
-31
lines changed

8 files changed

+229
-31
lines changed

source/crud/read_operators.txt

Lines changed: 91 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,91 @@
1+
:template: guide
2+
3+
==============================================
4+
Read Data using Operators and Compound Queries
5+
==============================================
6+
7+
.. default-domain:: mongodb
8+
9+
.. contents:: On this page
10+
:local:
11+
:backlinks: none
12+
:depth: 2
13+
:class: singlecol
14+
15+
Overview
16+
--------
17+
18+
In the previous read guide, :doc:`/crud/read_queries`,
19+
you read data using embedded fields and ``dot notation``. In
20+
this guide, you will:
21+
22+
- read data from the ``inventory`` collection with MongoDB's comparison operators.
23+
- combine query criteria to make compound queries
24+
25+
.. time:: 30
26+
27+
28+
What You'll Need
29+
----------------
30+
31+
.. include:: /includes/prereqs_read_CRUD.rst
32+
33+
Check Your Environment
34+
----------------------
35+
36+
.. include:: /includes/check_for_drivers_install.rst
37+
38+
Procedure
39+
---------
40+
41+
.. tabs-selector:: drivers
42+
43+
Read Data with Embedded Fields and Comparison Operators
44+
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
45+
In this exercise, you will read data using comparison operators.
46+
47+
.. procedure::
48+
:style: normal
49+
50+
.. include:: /includes/read_operators.rst
51+
52+
Read Data with Compound Queries
53+
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
54+
Now you will read data from MongoDB using AND and OR logic to form compound queries.
55+
56+
.. procedure::
57+
:style: normal
58+
59+
.. include:: /includes/read_compound.rst
60+
61+
Retrieving Data with More Than One Compounding Clause
62+
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
63+
64+
Now you will retrieve data from MongoDB using AND and OR logic together to form compound queries.
65+
66+
.. procedure::
67+
:style: normal
68+
69+
.. include:: /includes/read_compound2.rst
70+
71+
Summary
72+
-------
73+
74+
Congratulations! If you have successfully completed this guide, you have read data from MongoDB
75+
using MongoDB query operators and compound queries.
76+
77+
What's Next
78+
-----------
79+
80+
In the next guide, you'll learn how to update data in MongoDB.
81+
82+
- :doc:`Update Data in MongoDB </server/update>`
83+
84+
See Also
85+
--------
86+
87+
- :doc:`/server/insert`
88+
- :doc:`/server/update`
89+
- :doc:`/server/delete`
90+
91+
.. guide-next::

source/includes/driver-example-query-11.rst

Lines changed: 10 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -19,15 +19,15 @@
1919
2020
- id: python
2121
content: |
22-
.. literalinclude:: /driver-examples/test_examples.py
22+
.. literalinclude:: /includes/examples/curl_examples/test_examples.py
2323
:language: python
2424
:dedent: 8
2525
:start-after: Start Example 11
2626
:end-before: End Example 11
2727

2828
- id: go
2929
content: |
30-
.. literalinclude:: /driver-examples/examples.go
30+
.. literalinclude:: /includes/examples/curl_examples/examples.go
3131
:language: go
3232
:dedent: 2
3333
:start-after: Start Example 11
@@ -36,7 +36,7 @@
3636

3737
- id: motor
3838
content: |
39-
.. literalinclude:: /driver-examples/test_examples_motor.py
39+
.. literalinclude:: /includes/examples/curl_examples/test_examples_motor.py
4040
:language: python
4141
:dedent: 8
4242
:start-after: Start Example 11
@@ -56,55 +56,55 @@
5656
5757
- id: java-sync
5858
content: |
59-
.. literalinclude:: /driver-examples/DocumentationSamples.java
59+
.. literalinclude:: /includes/examples/curl_examples/DocumentationSamples.java
6060
:language: java
6161
:dedent: 8
6262
:start-after: Start Example 11
6363
:end-before: End Example 11
6464

6565
- id: nodejs
6666
content: |
67-
.. literalinclude:: /driver-examples/examples_tests.js
67+
.. literalinclude:: /includes/examples/curl_examples/examples_tests.js
6868
:language: javascript
6969
:dedent: 8
7070
:start-after: Start Example 11
7171
:end-before: End Example 11
7272

7373
#- id: php
7474
# content: |
75-
# .. literalinclude:: /driver-examples/DocumentationExamplesTest.php
75+
# .. literalinclude:: /includes/examples/curl_examples/DocumentationExamplesTest.php
7676
# :language: php
7777
# :dedent: 8
7878
# :start-after: Start Example 11
7979
# :end-before: End Example 11
8080

8181
#- id: perl
8282
# content: |
83-
# .. literalinclude:: /driver-examples/driver-examples.t
83+
# .. literalinclude:: /includes/examples/curl_examples/driver-examples.t
8484
# :language: perl
8585
# :dedent: 4
8686
# :start-after: Start Example 11
8787
# :end-before: End Example 11
8888

8989
#- id: ruby
9090
# content: |
91-
# .. literalinclude:: /driver-examples/shell_examples_spec.rb
91+
# .. literalinclude:: /includes/examples/curl_examples/shell_examples_spec.rb
9292
# :language: ruby
9393
# :dedent: 8
9494
# :start-after: Start Example 11
9595
# :end-before: End Example 11
9696

9797
#- id: scala
9898
# content: |
99-
# .. literalinclude:: /driver-examples/DocumentationExampleSpec.scala
99+
# .. literalinclude:: /includes/examples/curl_examples/DocumentationExampleSpec.scala
100100
# :language: scala
101101
# :dedent: 4
102102
# :start-after: Start Example 11
103103
# :end-before: End Example 11
104104

105105
- id: csharp
106106
content: |
107-
.. literalinclude:: /driver-examples/DocumentationExamples.cs
107+
.. literalinclude:: /includes/examples/curl_examples/DocumentationExamples.cs
108108
:language: c#
109109
:dedent: 12
110110
:start-after: Start Example 11

source/includes/driver-example-query-12.rst

Lines changed: 10 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -19,7 +19,7 @@
1919
2020
- id: python
2121
content: |
22-
.. literalinclude:: /driver-examples/test_examples.py
22+
.. literalinclude:: /includes/examples/curl_examples/test_examples.py
2323
:language: python
2424
:dedent: 8
2525
:start-after: Start Example 12
@@ -28,15 +28,15 @@
2828

2929
- id: go
3030
content: |
31-
.. literalinclude:: /driver-examples/examples.go
31+
.. literalinclude:: /includes/examples/curl_examples/examples.go
3232
:language: go
3333
:dedent: 2
3434
:start-after: Start Example 12
3535
:end-before: End Example 12
3636

3737
- id: motor
3838
content: |
39-
.. literalinclude:: /driver-examples/test_examples_motor.py
39+
.. literalinclude:: /includes/examples/curl_examples/test_examples_motor.py
4040
:language: python
4141
:dedent: 8
4242
:start-after: Start Example 12
@@ -56,55 +56,55 @@
5656
5757
- id: java-sync
5858
content: |
59-
.. literalinclude:: /driver-examples/DocumentationSamples.java
59+
.. literalinclude:: /includes/examples/curl_examples/DocumentationSamples.java
6060
:language: java
6161
:dedent: 8
6262
:start-after: Start Example 12
6363
:end-before: End Example 12
6464

6565
- id: nodejs
6666
content: |
67-
.. literalinclude:: /driver-examples/examples_tests.js
67+
.. literalinclude:: /includes/examples/curl_examples/examples_tests.js
6868
:language: javascript
6969
:dedent: 8
7070
:start-after: Start Example 12
7171
:end-before: End Example 12
7272

7373
- id: csharp
7474
content: |
75-
.. literalinclude:: /driver-examples/DocumentationExamples.cs
75+
.. literalinclude:: /includes/examples/curl_examples/DocumentationExamples.cs
7676
:language: c#
7777
:dedent: 12
7878
:start-after: Start Example 12
7979
:end-before: End Example 12
8080

8181
#- id: php
8282
# content: |
83-
# .. literalinclude:: /driver-examples/DocumentationExamplesTest.php
83+
# .. literalinclude:: /includes/examples/curl_examples/DocumentationExamplesTest.php
8484
# :language: php
8585
# :dedent: 8
8686
# :start-after: Start Example 12
8787
# :end-before: End Example 12
8888

8989
#- id: perl
9090
# content: |
91-
# .. literalinclude:: /driver-examples/driver-examples.t
91+
# .. literalinclude:: /includes/examples/curl_examples/driver-examples.t
9292
# :language: perl
9393
# :dedent: 4
9494
# :start-after: Start Example 12
9595
# :end-before: End Example 12
9696

9797
#- id: ruby
9898
# content: |
99-
# .. literalinclude:: /driver-examples/shell_examples_spec.rb
99+
# .. literalinclude:: /includes/examples/curl_examples/shell_examples_spec.rb
100100
# :language: ruby
101101
# :dedent: 8
102102
# :start-after: Start Example 12
103103
# :end-before: End Example 12
104104

105105
#- id: scala
106106
# content: |
107-
# .. literalinclude:: /driver-examples/DocumentationExampleSpec.scala
107+
# .. literalinclude:: /includes/examples/curl_examples/DocumentationExampleSpec.scala
108108
# :language: scala
109109
# :dedent: 4
110110
# :start-after: Start Example 12

source/includes/driver-example-query-13.rst

Lines changed: 10 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -22,23 +22,23 @@
2222
2323
- id: python
2424
content: |
25-
.. literalinclude:: /driver-examples/test_examples.py
25+
.. literalinclude:: /includes/examples/curl_examples/test_examples.py
2626
:language: python
2727
:dedent: 8
2828
:start-after: Start Example 13
2929
:end-before: End Example 13
3030

3131
- id: go
3232
content: |
33-
.. literalinclude:: /driver-examples/examples.go
33+
.. literalinclude:: /includes/examples/curl_examples/examples.go
3434
:language: go
3535
:dedent: 2
3636
:start-after: Start Example 13
3737
:end-before: End Example 13
3838

3939
- id: motor
4040
content: |
41-
.. literalinclude:: /driver-examples/test_examples_motor.py
41+
.. literalinclude:: /includes/examples/curl_examples/test_examples_motor.py
4242
:language: python
4343
:dedent: 8
4444
:start-after: Start Example 13
@@ -60,55 +60,55 @@
6060
6161
- id: java-sync
6262
content: |
63-
.. literalinclude:: /driver-examples/DocumentationSamples.java
63+
.. literalinclude:: /includes/examples/curl_examples/DocumentationSamples.java
6464
:language: java
6565
:dedent: 8
6666
:start-after: Start Example 13
6767
:end-before: End Example 13
6868

6969
- id: nodejs
7070
content: |
71-
.. literalinclude:: /driver-examples/examples_tests.js
71+
.. literalinclude:: /includes/examples/curl_examples/examples_tests.js
7272
:language: javascript
7373
:dedent: 8
7474
:start-after: Start Example 13
7575
:end-before: End Example 13
7676

7777
#- id: php
7878
# content: |
79-
# .. literalinclude:: /driver-examples/DocumentationExamplesTest.php
79+
# .. literalinclude:: /includes/examples/curl_examples/DocumentationExamplesTest.php
8080
# :language: php
8181
# :dedent: 8
8282
# :start-after: Start Example 13
8383
# :end-before: End Example 13
8484

8585
#- id: perl
8686
# content: |
87-
# .. literalinclude:: /driver-examples/driver-examples.t
87+
# .. literalinclude:: /includes/examples/curl_examples/driver-examples.t
8888
# :language: perl
8989
# :dedent: 4
9090
# :start-after: Start Example 13
9191
# :end-before: End Example 13
9292

9393
#- id: ruby
9494
# content: |
95-
# .. literalinclude:: /driver-examples/shell_examples_spec.rb
95+
# .. literalinclude:: /includes/examples/curl_examples/shell_examples_spec.rb
9696
# :language: ruby
9797
# :dedent: 8
9898
# :start-after: Start Example 13
9999
# :end-before: End Example 13
100100

101101
#- id: scala
102102
# content: |
103-
# .. literalinclude:: /driver-examples/DocumentationExampleSpec.scala
103+
# .. literalinclude:: /includes/examples/curl_examples/DocumentationExampleSpec.scala
104104
# :language: scala
105105
# :dedent: 4
106106
# :start-after: Start Example 13
107107
# :end-before: End Example 13
108108

109109
- id: csharp
110110
content: |
111-
.. literalinclude:: /driver-examples/DocumentationExamples.cs
111+
.. literalinclude:: /includes/examples/curl_examples/DocumentationExamples.cs
112112
:language: c#
113113
:dedent: 12
114114
:start-after: Start Example 13

0 commit comments

Comments
 (0)