.. _`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**
        | Type: mongodb
        | Description: MongoDB
    **filter**
        | Type: json
        | Description: Filter as json
        | Optional number of ports: 0--1 (default: 0)
        
    **projection**
        | Type: json
        | Description: Projection as json
        | Optional number of ports: 0--1 (default: 0)
        

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

    **mongodb**
        | Type: mongodb
        | Description: MongoDB
        | Optional number of ports: 0--1 (default: 1)
        
    **documents**
        | Type: json
        | Description: Documents



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

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







Examples
........



Example flows demonstrating this node:

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

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






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

.. automodule:: node_mongodb
    :noindex:

.. class:: FindMongoDB
    :noindex: