Verifying the Consistency of Data Migrated from Delta Lake (with Metadata) to MRS Delta Lake

This section describes how to use MgC to verify the consistency of data migrated from self-built Delta Lake clusters to Huawei Cloud MRS Delta Lake clusters.

For Delta Lake clusters that have metadata storage, the metadata can be collected data lake metadata collection tasks.

Preparations

Install Edge, an MgC tool used for data verification, in the source intranet environment and register an account. For details, see Installing Edge for Linux.

Procedure

Sign in to the MgC console. On the Overview page, click Create Migration Project.
In the displayed dialog box, enter a project name, select a project type, and click Confirm.

To review this migration project, choose Settings > Migration Projects in the navigation pane.
Connect Edge to MgC. For more information, see Connecting the Edge Device to MgC.
After the connection is successful, add the username/password pairs for accessing the source Delta Lake executor and the target MRS Delta Lake executor to Edge. For more information, see Adding Resource Credentials.
On the MgC console, in the navigation pane on the left, choose Research > Data Lineage. In the upper left corner of the page, choose the migration project created in step 2.
In the Metadata Collection area, click Create Connection.
Select Delta Lake (with metadata) and click Next.

Set connection parameters based on Table 1 and click Test. If the test is successful, the connection is set up.

**Table 1** Parameters for creating a connection to Delta Lake (with metadata)
Parameter	Configuration
Connection Source	Select Source.
Connection Name	The default name is Delta-Lake-with-metadata-4 random characters (including letters and numbers). You can also customize a name.
Edge Device	Select the Edge device connected to MgC in step 3.
Executor Credential	Select the source Delta Lake executor credential added to Edge in step 4.
Executor IP Address	Enter the IP address for connecting to the executor.
Executor Port	Enter the port for connecting to the executor. The default port is 22.
Spark Client Directory	Enter the absolute path of the bin directory on the Spark client.
Environment Variable Address	Enter the absolute path of the environment variable file, for example, /opt/bigdata/client/bigdata_env. If this field is not left blank, the environment variable file is automatically sourced before commands are executed.
SQL File Location	Enter a directory for storing the SQL files generated for consistency verification. You must have the read and write permissions for the folder. NOTICE: After the migration is complete, you need to manually clear the folders generated at this location to release storage space.

In the Metadata Collection area, choose Create Task > Data Lake Metadata Collection.

Set a data lake metadata collection task based on Table 2 and click Confirm.

**Table 2** Parameters for configuring a metadata collection task
Parameter	Configuration
Task Name	The default name is Data-Lake-Metadata-Collection-Task-4 random characters (including letters and numbers). You can also customize a name.
Metadata Source	Select the connection created in step 8.
Databases (Optional)	Enter the names of the databases whose metadata needs to be collected. If no database name is specified, the metadata of all databases is collected.
Concurrent Threads	Set the maximum number of threads for executing the collection. The default value is 3. The value ranges from 1 to 10. More concurrent threads means more efficient collection, but more connection and Edge device resources will be consumed.
Custom Parameters	You can customize parameters to specify the tables and partitions to collect or set criteria to filter tables and partitions. If you want to collect metadata from Alibaba Cloud EMR, add the following parameter: Parameter: conf Value: spark.sql.catalogImplementation=hive If the source is Alibaba Cloud EMR Delta Lake 2.2 and is accessed through Delta Lake 2.3, add the following parameters: Parameter: master Value: local

In the Metadata Collection area, click Collection tasks.
Under Tasks, you can review the created metadata collection task and its settings. Click Execute Task in the Operation column to run the task. Each time the task is executed, a task execution is generated.
Click View Executions in the Operation column. Under Task Executions, you can view the execution records of the task and the status and collection results of each task execution. When a task execution enters a Completed status and the collection results are displayed, you can view the list of databases and tables extracted from collected metadata on the Tables tab page.
In the navigation pane on the left, choose Migrate > Big Data Verification. If this is your first time to visit this page, select an Edge device to enable the verification feature. Click Select Edge Device. In the displayed dialog box, select the Edge device connected to MgC in step 3.

Ensure that the selected Edge device is always Online and Enabled before your verification is complete.
In the Features area, click Table Management.

Under Table Groups, click Create. Configure the parameters for creating a table group and click Confirm.

**Table 3** Parameters for creating a table group
Parameter	Description
Table Group	Enter a name.
Metadata Source	Select the connection created in step 8. CAUTION: A table group can only contain tables coming from the same metadata source.
Verification Rule	Select a rule that defines the method for verifying data consistency and the inconsistency tolerance. MgC provides multiple verification rules for you to choose. For details about these rules, click View More.
Description (Optional)	Enter a description to identify the table group.

On the Table Management page, click the Tables tab, select the data tables to be added to the same table group, and choose Option > Add Tables to Group above the list. In the displayed dialog box, select the desired table group and click Confirm.

You can manually import information of incremental data tables to MgC. For details, see Creating a Table Group and Adding Tables to the Group.
Create a connection to the source and target executors separately. For details, see Creating an Executor Connection. Select the source and target executor credentials added to Edge in step 4.
Create a data verification task for the source and target Delta Lake clusters, respectively, and execute the tasks. For more information, see Creating and Executing Verification Tasks. During the task creation, select the table group created in step 16.
- On the Select Task Type page, choose Delta Lake.
- Select a verification method. For details about each verification method, see Verification Methods.
Wait until the task executions enter a Completed status. You can view and export the task execution results on the Verification Results page. For details, see Viewing and Exporting Verification Results.