DetectDuplicate
Description
Caches a value, computed from FlowFile attributes, for each incoming FlowFile and determines if the cached value has already been seen. If so, routes the FlowFile to 'duplicate' with an attribute named 'original.identifier' that specifies the original FlowFile's "description", which is specified in the <FlowFile Description> property. If the FlowFile is not determined to be a duplicate, the Processor routes the FlowFile to 'non-duplicate'
Tags
dedupe, dupe, duplicate, hash
Properties
In the list below required Properties are shown with an asterisk (*). Other properties are considered optional. The table also indicates any default values, and whether a property supports the NiFi Expression Language.
| Display Name | API Name | Default Value | Allowable Values | Description |
|---|---|---|---|---|
| Cache Entry Identifier * | Cache Entry Identifier | ${hash.value} | A FlowFile attribute, or the results of an Attribute Expression Language statement, which will be evaluated against a FlowFile in order to determine the value used to identify duplicates; it is this value that is cached Supports Expression Language, using FlowFile attributes and Environment variables. | |
| FlowFile Description * | FlowFile Description | When a FlowFile is added to the cache, this value is stored along with it so that if a duplicate is found, this description of the original FlowFile will be added to the duplicate's "original.flowfile.description" attribute Supports Expression Language, using FlowFile attributes and Environment variables. | ||
| Age Off Duration | Age Off Duration | Time interval to age off cached FlowFiles | ||
| Distributed Cache Service * | Distributed Cache Service | Controller Service: DistributedMapCacheClient Implementations: HazelcastMapCacheClient MapCacheClientService RedisDistributedMapCacheClientService SimpleRedisDistributedMapCacheClientService | The Controller Service that is used to cache unique identifiers, used to determine duplicates | |
| Cache The Entry Identifier | Cache The Entry Identifier | true |
| When true this cause the processor to check for duplicates and cache the Entry Identifier. When false, the processor would only check for duplicates and not cache the Entry Identifier, requiring another processor to add identifiers to the distributed cache. |
Dynamic Properties
This component does not support dynamic properties.
Relationships
| Name | Description |
|---|---|
| duplicate | If a FlowFile has been detected to be a duplicate, it will be routed to this relationship |
| failure | If unable to communicate with the cache, the FlowFile will be penalized and routed to this relationship |
| non-duplicate | If a FlowFile's Cache Entry Identifier was not found in the cache, it will be routed to this relationship |
Reads Attributes
This processor does not read attributes.
Writes Attributes
| Name | Description |
|---|---|
| original.flowfile.description | All FlowFiles routed to the duplicate relationship will have an attribute added named original.flowfile.description. The value of this attribute is determined by the attributes of the original copy of the data and by the FlowFile Description property. |
State Management
This component does not store state.
Restricted
This component is not restricted.
Input Requirement
This component requires an incoming relationship.
System Resource Considerations
This component does not specify system resource considerations.
See Also
DistributedMapCacheClientService, DistributedMapCacheServer