[jira] [Created] (GEODE-3840) Explain the role of the Filters in the FunctionService execution

["Christian Tzolov (JIRA)" <ji...@apache.org>]

Christian Tzolov created GEODE-3840:
---------------------------------------

             Summary: Explain the role of the Filters in the FunctionService execution
                 Key: GEODE-3840
                 URL: https://issues.apache.org/jira/browse/GEODE-3840
             Project: Geode
          Issue Type: Improvement
          Components: docs
            Reporter: Christian Tzolov


To direct a query to specific partitioned region node, this query needs to be executed within a function.  The function filters configuration is used to specify on which partitions this function should be run:
{code:java}
FunctionService
   .onRegion(region)
   .setArguments(qStr)
   .withFilter(filter)
   .execute(func);
{code}
The "Querying a Partitioned Region on a Single Node" chapter is unclear about the role of the Filters and the way they work.
For example it is not clear that conceptually a Filter stands for a *Partitions Reference/Pointer*.  Furthermore this reference is not to a Partition Id (such doesn't exist) but the partition is identified by a member key that belongs to this Partition.  In other words the Filter should contain an Key that when evaluated by the PartitionResolver will produce a routing-key pointing to the target resolver. 
From implementation stand point it is important to be mentioned that the Filter values are evaluated by exactly the same PartitionResolver used by all other region operations.



--
This message was sent by Atlassian JIRA
(v6.4.14#64029)