When you update a deployed application by redeploying the application or by deploying an application patch, you can choose to retain the state information for the deployed application or to discard it.
State information refers to mapping properties and the properties of run-time objects such as mapping outputs or the Sequence Generator transformation. When you retain state information, you retain these settings and properties in the deployed application. When you discard state information, you discard the state of these settings and properties in the deployed application.
Example: Retaining or discarding configurable properties
An application includes a mapping with configurable run-time properties. You set the High Precision property to True. After you deploy the application, you edit the mapping and change the High Precision property to False. When you redeploy the application and check
Retain state information
, the Data Integration Service retains state information in the deployed application and does not recognize changes to the run-time properties. You must uncheck
Retain state information
for the change to the property to take effect.
Example: Retaining or discarding sequences
A mapping includes a Sequence Generator transformation that generates unique keys for rows in a target table. After you deploy the application that contains the mapping, the mapping runs and the Sequence Generator transformation generates keys for rows 1-2000. The next time the mapping runs, the Sequence Generator transformation would generate keys beginning with 2001, but you decide you want the sequence to start at 10000. Edit the Sequence Generator transformation to specify the new start value. When you redeploy the application and check
Retain state information
, the Data Integration Service retains state information in the deployed application and does not recognize changes to the setting. When the mapping runs again, the sequence resumes at 2001. You must uncheck
Retain state information
for the change to the setting to take effect.
Your choice to retain or discard application state has no effect on the Reset property of a Sequence Generator transformation.