.. _`Find`:

.. _`com.sympathyfordata.database.mongodb.findmany`:

Find
````

.. image:: find_mongodb.svg
   :width: 48


Find multiple documents from the database




Documentation
:::::::::::::

Find multiple documents from the database matching `filter`.

Selection of fields to return can be specified using `projection`.  Filter
and Projection can be specified either as part of the configuration or
using opt-in json-ports.

See https://docs.mongodb.com/manual/reference/method/db.collection.find/
for more details.

For info on how to input data to MongoDB, see :ref:`mongodb_data_format`.


Definition
::::::::::


Input ports
...........

    **mongodb**  mongodb
        MongoDB

    **filter** 0 - 1,  json
        Filter as json

    **projection** 0 - 1,  json
        Projection as json


Output ports
............

    **mongodb** 0 - 1,  mongodb
        MongoDB

    **documents**  json
        Documents




Configuration
.............

    **Filter** (filter)
        Filter as json.
    **Limit** (limit)
        Limit the maximum number of output documents.
        (0=unlimited)
    **Projection** (projection)
        Projection as json.







Examples
........

* :download:`MongoDBtoTable.syx </Examples/MongoDB/MongoDB/MongoDBtoTable.syx>`

* :download:`MongoDBBasicOperations.syx </Examples/MongoDB/MongoDB/MongoDBBasicOperations.syx>`




Implementation
..............

.. automodule:: node_mongodb
    :noindex:

.. class:: FindMongoDB
    :noindex: