Transformations > Sequence Generator Transformation > Sequence Generator Properties
  

Sequence Generator Properties

Configure Sequence Generator properties to define how the Sequence Generator generates numeric values.
Configure the following Sequence Generator properties on the Sequence tab:
Property
Description
Start Value
Start value of the generated sequence that you want the Mapping Configuration task to use if you use the Cycle option. When the sequence values reach the End Value, they cycle back to this value.
Default is 0.
Maximum value is 9,223,372,036,854,775,806.
Increment By
The difference between two consecutive values in a generated sequence. For example, if Increment By is 2 and the existing value is 4, then the next value generated in the sequence will be 6.
Default is 1.
Maximum value is 2,147,483,647.
End Value
Maximum value that the Mapping Configuration task generates. If the sequence reaches this value during the task run and the sequence is not configured to cycle, the run fails.
Maximum value is 9,223,372,036,854,775,807.
If you connect the NEXTVAL field to a downstream integer field, set the End Value to a value no larger than the integer maximum value. If the NEXTVAL exceeds the data type maximum value for the downstream field, the mapping run fails.
Initial Value
The value you want the Mapping Configuration task to use as the first value in the sequence. If you want to cycle through a series of values, the value must be greater than or equal to the Start Value and less than the End Value.
Default is 1.
Cycle
If enabled, the Mapping Configuration task cycles through the sequence range. If disabled, the task stops the sequence at the configured End Value. The session fails if the task reaches the End Value and still has rows to process.
Default is disabled.
Number of Cached Values
Number of sequential values the Mapping Configuration task caches for each run. Each subsequent run uses a new batch of values. The task discards unused sequences for the batch. The Mapping Configuration task updates the repository as it caches each value. When set to 0, the task does not cache values.
Use this option when multiple partitions use the same Sequence Generator at the same time to ensure each partition receives unique values.
Default is 0.
This option is not available when the Cycle property is enabled.
Reset
If enabled, the Mapping Configuration task generates values based on the original Initial Value for each run.
Default is disabled.
Configure advanced Sequence Generator properties in the Advanced tab in the Mapping Designer.
Property
Description
Tracing Level
Level of detail about the transformation that the Mapping Configuration task writes into the mapping log. You can choose terse, normal, verbose initialization, or verbose data.
Default is normal.
Optional
Specifies whether the transformation is optional.
The CURRVAL field or the NEXTVAL field must be configured if the transformation is required. Otherwise, the Mapping Configuration task fails. If the transformation is optional and the CURRVAL field or the NEXTVAL field is not configured, the Mapping Configuration task can run.
Default is optional.