You can use transformations to define SQL statements. You can have these transformation SQL statements executed:

  • After deploying a data model. The applicable transformation categories are 'Modeling' and 'Instrumentation'.
  • Before or after exporting data. The applicable transformation category is 'Processing'.


DMS Administrator DMS Administrator Start Start What's the purpose  of the transformation? What's the purpose  of the transformation? Set up modeling transformation Set up modeling transformation On deploy of a data model, you can use modeling transformations to create views in the target database. These views are created based on the business entities that are created in the target database on deploy. A modeling transformation contains one or several SQL statements which define the transformation actions to be done. Usually, a transformation is created in SQL and then the file is uploaded to the Data templates and transformations. On upload, a new transformation is created or an existing transformation is overwritten. You can also manually create a transformation in DMS and create or copy the SQL statements to the Definition field. Procedure 1. Go to Data modeling studio > Data modeling studio > Data templates and transformations. 2. Sub-task: Upload modeling transformation. 3. Click Upload. 4. On the dialog, browse for and select the desired compressed (zipped) folder or single modeling transformation file. Click Upload. Note: If you select a compressed (zipped) folder with several data templates and transformations, all these data templates and transformations are considered for upload. 5. Click the desired action: 'Yes' or 'No'. 6. On the Data templates and transformations page, in the list, find and select the uploaded transformation. 7. Click Edit. 8. In the Description field, type or edit the description. 9. In the Category field, select 'Modeling'. 10. Sub-task: Create modeling transformation. 11. On the Data templates and transformations page, click New. 12. In the Template field, type a value. 13. In the Description field, type a value. 14. In the Category field, select 'Modeling'. 15. In the Type field, select 'T-SQL'. 16. Expand the Definition section. 17. In the Definition field, create or copy the desired SQL statements. 18. Close the page. Notes In the SQL statements, you can use variables. On deploy, these variables are replaced with a value. You can use these variables: $MODEL$: Is replaced with the name of the deployed data model. $SCHEMA$: Is replaced with schema name as defined for the deployed data model. $EXECUTIONID$: Is replaced with the execution GUID that is assigned to the deployment of the data model. Set up instrumentation transformation Set up instrumentation transformation On deploy of a data model, you can use instrumentation transformations to create objects, stored procedures, and schemas in the target database. You can also use these transformations to do calculations on the metadata that is exported on deploy. An instrumentation transformation contains one or several SQL statements which define the transformation actions to be done. Usually, a transformation is created in SQL and then the file is uploaded to the Data templates and transformations. On upload, a new transformation is created or an existing transformation is overwritten. You can also manually create a transformation in DMS and create or copy the SQL statements to the Definition field. Procedure 1. Go to Data modeling studio > Data modeling studio > Data templates and transformations. 2. Sub-task: Upload instrumentation transformation. 3. Click Upload. 4. On the dialog, browse for and select the desired compressed (zipped) folder or single instrumentation transformation file. Click Upload. Note: If you select a compressed (zipped) folder with several data templates and transformations, all these data templates and transformations are considered for upload. 5. Click the desired action: 'Yes' or 'No'. 6. On the Data templates and transformations page, in the list, find and select the uploaded transformation. 7. Click Edit. 8. In the Description field, type or edit the description. 9. In the Category field, select 'Instrumentation'. 10. Sub-task: Create instrumentation transformation. 11. On the Data templates and transformations page, click New. 12. In the Template field, type a value. 13. In the Description field, type a value. 14. In the Category field, select 'Instrumentation'. 15. In the Type field, select 'T-SQL'. 16. Expand the Definition section. 17. In the Definition field, create or copy the desired SQL statements. 18. Close the page. Notes In the SQL statements, you can use variables. On deploy, these variables are replaced with a value. You can use these variables: $MODEL$: Is replaced with the name of the deployed data model. $SCHEMA$: Is replaced with schema name as defined for the deployed data model. $EXECUTIONID$: Is replaced with the execution GUID that is assigned to the deployment of the data model. Set up processing transformation Set up processing transformation On data export for a data model, you can use processing transformations to do calculations in the target database. A processing transformation contains one or several SQL statements which define the transformation actions to be done. You can have processing transformations executed before or after exporting data: Pre-export transformations: Used to do calculations on the metadata in the target database. For example, on enumerations or labels. Post-export transformations: Used to do calculations based on the data that has just been exported to the target database. Usually, a transformation is created in SQL and then the file is uploaded to the Data templates and transformations. On upload, a new transformation is created or an existing transformation is overwritten. You can also manually create a transformation on the Data templates and transformations page, and create or copy the SQL statements to the Definition field. Procedure 1. Go to Data modeling studio > Data modeling studio > Data templates and transformations. 2. Sub-task: Upload processing transformation. 3. Click Upload. 4. On the dialog, browse for and select the desired compressed (zipped) folder or single processing transformation file. Click Upload. Note: If you select a compressed (zipped) folder with several data templates and transformations, all these data templates and transformations are considered for upload. 5. Click the desired action: 'Yes' or 'No'. 6. On the Data templates and transformations page, in the list, find and select the uploaded transformation. 7. Click Edit. 8. In the Description field, type or edit the description. 9. In the Category field, select 'Processing'. 10. Sub-task: Create processing transformation. 11. On the Data templates and transformations page, click New. 12. In the Template field, type a value. 13. In the Description field, type a value. 14. In the Category field, select 'Processing'. 15. In the Type field, select 'T-SQL'. 16. Expand the Definition section. 17. In the Definition field, create or copy the desired SQL statements. 18. Close the page. Notes In the SQL statements, you can use variables. On export, these variables are replaced with a value. You can use these variables: $MODEL$: Is replaced with the name of the exported data model. $SCHEMA$: Is replaced with schema name as defined for the exported data model. $EXECUTIONID$: Is replaced with the execution GUID that is assigned to the export of the data model. End End Modeling Instrumentation Processing

Activities

Name Responsible Description

Set up modeling transformation

DMS Administrator

On deploy of a data model, you can use modeling transformations to create views in the target database. These views are created based on the business entities that are created in the target database on deploy. A modeling transformation contains one or several SQL statements which define the transformation actions to be done.

Usually, a transformation is created in SQL and then the file is uploaded to the Data templates and transformations. On upload, a new transformation is created or an existing transformation is overwritten. You can also manually create a transformation in DMS and create or copy the SQL statements to the Definition field.

Set up instrumentation transformation

DMS Administrator

On deploy of a data model, you can use instrumentation transformations to create objects, stored procedures, and schemas in the target database. You can also use these transformations to do calculations on the metadata that is exported on deploy. An instrumentation transformation contains one or several SQL statements which define the transformation actions to be done.

Usually, a transformation is created in SQL and then the file is uploaded to the Data templates and transformations. On upload, a new transformation is created or an existing transformation is overwritten. You can also manually create a transformation in DMS and create or copy the SQL statements to the Definition field.

Set up processing transformation

DMS Administrator

On data export for a data model, you can use processing transformations to do calculations in the target database. A processing transformation contains one or several SQL statements which define the transformation actions to be done.

You can have processing transformations executed before or after exporting data:

  • Pre-export transformations: Used to do calculations on the metadata in the target database. For example, on enumerations or labels.
  • Post-export transformations: Used to do calculations based on the data that has just been exported to the target database.

Usually, a transformation is created in SQL and then the file is uploaded to the Data templates and transformations. On upload, a new transformation is created or an existing transformation is overwritten. You can also manually create a transformation on the Data templates and transformations page, and create or copy the SQL statements to the Definition field.

Provide feedback