@@ -689,26 +689,36 @@ Options
689
689
the documents included in the output of :binary:`~bin.mongodump`. To
690
690
use the ``--query`` option, you must also specify the
691
691
:option:`--collection <mongodump --collection>` option.
692
-
692
+
693
693
.. include:: /includes/fact-quote-command-line-query.rst
694
-
694
+
695
695
The query :red:`must` be in :manual:`Extended JSON v2 format
696
696
(either relaxed or canonical/strict mode)
697
697
</reference/mongodb-extended-json>`, including enclosing the field
698
698
names and operators in quotes. For example:
699
-
699
+
700
700
.. code-block:: sh
701
-
701
+
702
702
mongodump -d=test -c=records -q='{ "a": { "$gte": 3 }, "date": { "$lt": { "$date": "2016-01-01T00:00:00.000Z" } } }'
703
-
703
+
704
+ .. note::
705
+
706
+ When you use the ``--query`` option on a :ref:`time series
707
+ collection <manual-timeseries-collection>`, you can only query the
708
+ field specified as the ``metaField``.
704
709
705
710
.. option:: --queryFile=<path>
706
-
711
+
707
712
Specifies the path to a file containing a JSON document as a query
708
713
filter that limits the documents included in the output of
709
- :binary:`~bin.mongodump`. :option:`--queryFile` enables you to create query filters that
710
- are too large to fit in your terminal's buffer.
714
+ :binary:`~bin.mongodump`. :option:`--queryFile` enables you to create
715
+ query filters that are too large to fit in your terminal's buffer.
716
+
717
+ .. note::
711
718
719
+ When you use the ``--queryFile`` option on a :ref:`time series
720
+ collection <manual-timeseries-collection>`, you can only query the
721
+ field specified as the ``metaField``.
712
722
713
723
.. option:: --readPreference=<string|document>
714
724
0 commit comments