Table of Contents

Search

  1. Preface
  2. Introduction to Transformations
  3. Transformation Ports
  4. Transformation Caches
  5. Address Validator Transformation
  6. Aggregator Transformation
  7. Association Transformation
  8. Bad Record Exception Transformation
  9. Case Converter Transformation
  10. Classifier Transformation
  11. Comparison Transformation
  12. Consolidation Transformation
  13. Data Masking Transformation
  14. Data Processor Transformation
  15. Decision Transformation
  16. Duplicate Record Exception Transformation
  17. Expression Transformation
  18. Filter Transformation
  19. Hierarchical to Relational Transformation
  20. Java Transformation
  21. Java Transformation API Reference
  22. Java Expressions
  23. Joiner Transformation
  24. Key Generator Transformation
  25. Labeler Transformation
  26. Lookup Transformation
  27. Lookup Caches
  28. Dynamic Lookup Cache
  29. Match Transformation
  30. Match Transformations in Field Analysis
  31. Match Transformations in Identity Analysis
  32. Normalizer Transformation
  33. Merge Transformation
  34. Parser Transformation
  35. Python Transformation
  36. Rank Transformation
  37. Read Transformation
  38. Relational to Hierarchical Transformation
  39. REST Web Service Consumer Transformation
  40. Router Transformation
  41. Sequence Generator Transformation
  42. Sorter Transformation
  43. SQL Transformation
  44. Standardizer Transformation
  45. Union Transformation
  46. Update Strategy Transformation
  47. Web Service Consumer Transformation
  48. Parsing Web Service SOAP Messages
  49. Generating Web Service SOAP Messages
  50. Weighted Average Transformation
  51. Window Transformation
  52. Write Transformation
  53. Appendix A: Transformation Delimiters

Developer Transformation Guide

Developer Transformation Guide

Dynamic Lookup Cache Properties

Dynamic Lookup Cache Properties

Configure the dynamic lookup properties to enable a dynamic lookup cache and configure how the cache is updated. For example, you can configure the values that are inserted and updated in the dynamic cache.
Configure the following properties when you enable a dynamic lookup cache:
On Multiple Matches
Set to Report Error.
Dynamic Lookup Cache
Enables a dynamic lookup cache.
This option is available after you enable lookup caching.
Update Else Insert
Applies to rows entering the Lookup transformation where the row type is update. When enabled, the Integration Service updates existing rows in the cache, and inserts a row if it is new. When disabled, the Integration Service does not insert new rows.
This option is available after you enable dynamic caching.
Insert Else Update
Applies to rows entering the Lookup transformation where the row type is insert. When enabled, the Integration Service inserts rows in the cache and updates existing rows. When disabled, the Integration Service does not update existing rows.
This option is available after you enable dynamic caching.
Output Old Value on Update
The Lookup transformation can output the existing or new values from the cache. When enabled, the Integration Service outputs the existing values from the lookup/output ports before it updates the value in the cache. When the Integration Service updates a row in the cache, it outputs the value in the lookup cache before it updates the row based on the input data. When the Integration Service inserts a row in the cache, it outputs null values.
Disable the property for the Integration Service to pass the same values from the lookup/output and input/output ports. This property is enabled by default.
This option is available after you enable dynamic caching.
Update Dynamic Cache Condition
When enabled, the Integration Service uses the condition expression to determine whether to update the dynamic cache. The Integration Service updates the cache when the condition is true and the data exists in the cache.
Create the expression using lookup ports or input ports. The expression can contain input values or values in the lookup cache. Default is true.
This option is available after you enable dynamic caching.
NewLookupRow
The Developer tool adds this port to a Lookup transformation that is configured with a dynamic cache.
The NewLookupRow property can contain one of the following values:
  • 0 = No update to the cache.
  • 1 = Insert row into cache.
  • 2 = Update row in cache.
To keep the lookup cache and the target table synchronized, pass rows to the target when the NewLookupRow value is equal to 1 or 2.
Associated Port
The Integration Service uses the value of the associated port when it updates data in the cache. The Integration Service associates input ports and lookup source ports specified in the lookup condition. You must configure associated ports for the remaining lookup source ports in the dynamic lookup. If you do not configure an associated port for all lookup source ports in a dynamic lookup, the mapping validation fails.
You can associate a lookup source port with the following objects:
Object
Description
Input port
Updates the cache based on the value of an input port.
Associated expression
Select to enter an expression. The Integration Service updates the cache based on the result of the expression.
Sequence ID
Generates a primary key for rows inserted in the lookup cache. You can associate a sequence ID with bigint and int columns only.
Ignore Null Inputs for Updates
The Developer tool activates this port property for lookup/output ports when you configure the Lookup transformation to use a dynamic cache. Select this property when you do not want the Integration Service to update the column in the cache with a null input value.
Ignore in Comparison
The Developer tool activates this port property for lookup/output ports not used in the lookup condition when you configure the Lookup transformation to use a dynamic cache. The Integration Service compares the values in all lookup ports with the values in their associated ports by default. Select this property if you want the Integration Service to ignore the port when it compares values before updating a row. Use this property to increase the performance of the comparison.

0 COMMENTS

We’d like to hear from you!