Deploy a Model Edition
After the initial model edition is deployed, it is possible to deploy other model editions. This single mechanism is used for example to:
Update the deployed model edition with the latest changes performed in an open model edition.
Deploy a new closed model version to a production or test environment.
Revert a deployed model edition to a previous edition.
|Deploying open model editions is only possible in a development data location.
To deploy a model edition:
In the Management view, expand the Data Locations node, right-click the data location node, and select Deploy Model Edition….
If you have unsaved editors, select those to save when prompted.
In the Deploy Model Edition wizard, select the model edition you want to deploy.
Leave the Generate Jobs Definition option checked to generate new integration jobs.
Select the Clear API Enricher Caches option to force the deletion of the enricher caches.
Click Next. The changes to perform on the data location to support this new model edition are computed. A second page shows the SQL script to run on the schema to deploy this model edition.
Click Finish to run the script and close the wizard.
The model edition deploys the jobs first and then runs the SQL code to create or modify the database objects. You can follow this second operation in the Console view at the bottom of the Application Builder.
The new model edition is deployed and the previous model deployment appears under the Deployment History node in the data location.
|Deploying a model edition does not modify data already in place in the data location.
Although it is recommended to update both the jobs and schemas at the same time, you may want to update the data structure first, and then the jobs later. For example, if the data you have in the data editions using this model edition is not fit for the new version of the jobs. In that case, you may want to run some transformation on the data with the updated data structures before updating the jobs.
Another use case for not deploying the job definition is when you know that the new and old job definitions are similar and you want to preserve the existing job logs.
|It is not possible to deploy a model edition in a data location that requires an upgrade.
When deploying a model edition, Semarchy lists the database objects in the data location schema and detects those it needs to create or modify. If you need to create database objects (such as indexes) in the data location schema, make sure to prefix their name with
USR_ to prevent them from being removed or overwritten during model deployment.
After multiple deployments, you may decide to clean up your deployment history.
To delete deployment history records:
In the Management view, expand the Deployment History node under the data location.
Select one or many deployments (hold Shift to select multiple options).
Right-click and select Delete.
The selected deployment history records are deleted.
|The deployment history can also be purged via a REST API call. For more information, see Manage Data Hubs with the REST API.