Configuring On-premises to Cloud Transformation

In the Transformation stage, the legacy codes and the business logic are transformed to the preferred target.

To configure the Transformation stage, follow the below steps:

In Source Type, select the required source data store, such as Netezza, Oracle, SQL Server, Teradata, Vertica, and more.

In Input Type, select the type of input script, such as SQL/BTQ/Procedure or KSH.
In Target Type, select the preferred target type, such as Spark, Snowflake, Amazon Redshift, and so on.
In Output Type, select the output type (such as Python, RSQL) to generate artifacts in that format.

In Input Artifacts, upload the files that you need to transform to the target source.

Click Data Configuration to configure the data.

Note:

If the selected target is Databricks Lakehouse, enable Unity Catalog to transform the constraints such as primary key, foreign key, etc., present in the source data to the Databricks-native equivalent. Otherwise, the default Hive meta store will be used, and Hive or Spark tables will be generated without any constraints. In Databricks, there are two types of catalogs:

Hive Meta Store: Hive meta store serves as a central repository to create, store, and manage large datasets or tables. However, it does not support constraints like primary key, foreign key, etc.
Unity Catalog: Unity Catalog in Databricks serves as a centralized metadata repository with advanced metadata management features that support constraints including primary key, foreign key, etc. It serves as a comprehensive repository for storing metadata information within Databricks.

In Validation Type, select the validation type:

None: Performs no validation.
Cluster: Syntax validation is performed on queries transformed by the LeapLogic Core transformation engine.

In LeapFusion, select the preferred Base and Helper models to convert queries that require augmented transformation, and perform syntax validation for accuracy and optimal performance.

Base Model: Select the preferred base model to convert queries that are not handled by the default LeapLogic Core transformation engine to the target equivalent. The Base Model supports both offline (LeapLogic) and online (Amazon Bedrock) modes of transformation. By default, the system enables online mode (Amazon Bedrock) and disables offline mode (LeapLogic). To enable the offline modes (LeapLogic) such as Embark, Energize, Intercept, and Velocity, as a prerequisite you need to provide EC2 instance connection details and a prompt file (.txt) on the Add New Sources and Targets page (Governance > Intelligence Modernization > Custom/ Source/ Target > Add New Sources and Targets).

To view the detailed steps for providing EC2 instance connection details and the prompt file, click here.

The offline modes include:

Energize, Velocity, and Embark: To convert small- to medium-sized SQLs.
Intercept: To convert large-sized SQLs and procedural code.

Helper Model: Select helper models to perform syntax validation of the queries that are transformed by the Base Model and suggest corrections if needed. By default, the selected base model is set as a helper model. If needed, you can add multiple helper models. When multiple Helper models are configured:

The first helper model (same as the base model) validates the queries transformed by the base model. If it claims any queries are incorrectly transformed, it suggests updated queries.
Then, the updated queries are passed to the next Helper model, which validates them and suggests corrections if required.
This process continues through all configured helper models until the queries are validated successfully.

This validation process ensures higher accuracy, better performance, and more efficient transformation.

Notes:

To increase the accuracy, it is recommended to include metadata in the Transformation stage.
It is recommended to use Online model (native integration with all Amazon Bedrock including Claude LLM models) as the Base Model. However, you have the flexibility to choose any model as required.

To access this intelligent modernization feature (LeapFusion), ensure that your account has the manager and llexpress_executor roles.

To view the detailed steps for assigning manager and llexpress_executor roles to your account, click here.

In Source Configuration, select the source configuration as Live or Offline.
If the selected Source Configuration is:
1. Live: Upload the data source and select the Default Database.
2. Offline: Upload the DDL files. It supports .sql and .zip file formats.

In Target Configuration, select the target configuration as Live.
Upload the target data source.

Note:

To increase the accuracy, it is recommended to include metadata in the Transformation stage.

In File Format, select the storage type as ORC, Parquet, Text File, or Avro
In Mapping as per Changed Data Model, upload files for mapping between source and target tables.

Notes:

While configuring the Transformation stage, if the selected target is either Databricks Lakehouse or Databricks Notebook, the Databricks Recommendations Report field will appear in the Additional Information section. In this field, you can upload the Databricks recommendations (databricksrecommendation.csv) report generated as part of the corresponding assessment, which enables the system to incorporate relevant optimizations into the converted DDL queries.

To obtain databricksrecommendation.csv report follow the steps below:

Go to Reports section in assessment.
Download Insights and Recommendations.
The downloaded archived file contains the databricksrecommendation.csv report. If required, you can update details such as cluster_by_columns.

Upload databricksrecommendation.csv file in the Databricks Recommendations Report field.

If the selected source is Teradata and the target is Kyvos, in the Table-Cube mapping field upload the mapping file. It is used to map between table and cube where table is replaced with <Folder Name> and table alias is replaced with <Cube Name>. The input to the Table-Cube mapping field is the output CSV file generated from the assessment, where you need to add <Folder Name> and <Cube Name> corresponding to the queries manually.

In Triggers, upload the trigger statements for a more accurate conversion.
Click Save to save the Transformation stage.
An alert pop-up message appears. This message prompts you to refer your respective assessment to determine the anticipated quota deduction required when converting your scripts to target. Then click Ok.

Click the Execute icon to execute the integrated or standalone pipeline. Clicking the Execute icon navigates you to the pipeline listing page which shows your pipeline status as Running state. It changes its state to Success when it is completed successfully.

Click on your pipeline card to see reports.

To view the On-premises to Cloud Transformation, visit On-premises to Cloud Transformation Report.

Note:

When you license LeapLogic, it comes with a certain quota limit, for example unit, script, and block. The system alarms the user when the limit exceeds and highlights quota exhaustion in the pipeline reports.