Creating a table analysis with an SQL business rule with a join condition - Cloud

Talend Cloud API Services Platform Studio User Guide

author
Talend Documentation Team
EnrichVersion
Cloud
EnrichProdName
Talend Cloud
task
Design and Development
EnrichPlatform
Talend Management Console
Talend Studio

In some cases, you may need to analyze database tables or views using an SQL business rule that has a join clause that combines records from two tables in a database. This join clause will compare common values between two columns and give a result data set. Then the data in this set will be analyzed against the business rule.

Depending on the analyzed data and the join clause itself, several different results of the join are possible, for example #match + #no match > #row count,  #match + #no match < #row count or #match + #no match = #row count.

The example below explains in detail the case where the data set in the join result is bigger than the row count (#match + #no match > #row count) which indicates duplicates in the processed data.

Prerequisite(s):
  • At least one SQL business rule has been created in the Profiling perspective of the studio. For further information about creating SQL business rules, see Creating an SQL business rule

  • At least one database connection is set in the Profiling perspective of the studio. For further information, see Connecting to a database.

In this example, you want to add the SQL business rule created in Creating an SQL business rule to a Person table that contains the age and name columns. This SQL business rule will match the customer ages to define those who are older than 18. The business rule also has a join condition that compares the "name" value between the Person table and another table called Person_Ref through analyzing a common column called name.

Below is a capture of both tables:
Below is a capture of the result of the join condition between these two tables:

The result set may give duplicate rows as it is the case here. Thus the results of the analysis may become a bit harder to understand. The analysis here will not analyze the rows of the table that match the business rule but it will run on the result set given by the business rule.

  1. Define the table analysis and select the table you want to analyze as outlined in Creating a table analysis with a simple SQL business rule.

    The selected table is listed in the Analyzed Tables view.

  2. Add the business rule with the join condition to the selected table through clicking the icon next to the table name.

    This business rule has a join condition that compares the "name" value between two different tables through analyzing a common column. For further information about SQL business rules, see Creating an SQL business rule.

  3. Save the analysis and press F6 to execute it.

    An information pop-up opens to confirm that the operation is in progress and the analysis editor switches to the Analysis Results view.

    All age records in the selected table are evaluated against the defined SQL business rule. The analysis results has two bar charts: the first is a row count indicator that shows the number of rows in the analyzed table, and the second is a match and non-match indicator that indicates the age records from the "analyzed result set" that do not match the criteria (age below 18).

    Note: If a join condition is used in the SQL business rule, the number of the rows of the join (#match + # no match) can be different from the number of the analyzed rows (row count).
  4. Right-click the Row Count row in the first table and select View rows.

    The SQL editor opens in the Studio to display a list of the analyzed rows.

  5. Right-click the business rule results in the second table, or right-click the result bar in the chart itself and select:

    Below is the list of the invalid rows in the analyzed table.

  6. In the SQL editor, click the save icon on the toolbar to save the executed query on the SQL business rule and list it under the Libraries > Source Files folder in the DQ Repository tree view.

    For further information, see Saving the queries executed on indicators.

To better understand the Business Rule Statistics bar chart in the analysis results, do the following:

  1. In the analysis editor, right-click the business rule and select View executed query.

    The SQL editor opens in the Studio.

  2. Modify the query in the top part of the editor to read as the following: SELECT * FROM `my_person_joins`.`person` Person JOIN `my_person_joins`.`Person_ref` Person_ref ON (Person.`name`=Person_ref.`Name`).

    This will list the result data set of the join condition in the editor.

  3. In the top left corner of the editor, click the icon to execute the query.

    The query result, that is the analyzed result set, is listed in the bottom part of the editor.

  4. Go back to the analysis editor and click the Analysis Results tab at the bottom of the editor to open a detail view of the analysis results.

    The analyzed result set may contain more or fewer rows than the analyzed table. In this example, the number of match and non-match records (5 + 2 = 7) exceeds the number of analyzed records (6) because the join of the two tables generates more rows than expected.

    Here 5 rows (71.43%) match the business rule and 2 rows do not match. Because the join generates duplicate rows, this result does not mean that 5 rows of the analyzed table match the business rule. It only means that 5 rows among the 7 rows of the result set match the business rule. Actually, some rows of the analyzed tables may not be even analyzed against the business rule. This happens when the join excludes these rows. For this reason, it is advised to check for duplicates on the columns used in the join of the business rule in order to make sure that the join does not remove or add rows in the analyzed result set.  Otherwise the interpretation of the result is more complex.

    In the Analysis Results view, if the number of match and non-match records exceeds the number of analyzed records, you can generate a ready-to-use analysis that will analyze the duplicates in the selected table.