All Products
Search
Document Center

Quick BI:Association and Merging

Last Updated:Dec 18, 2025

Quick BI supports single-table models and multi-table models. Multiple tables can be associated or merged. This topic describes how to build a model.

Before you start

You have created a dataset. For more information, see Create a dataset.

Background information

Association

Quick BI supports LEFT JOIN, RIGHT JOIN, INNER JOIN, and FULL JOIN operations. The following example uses a student table and a course score table to describe the four join methods for building models.

image
Note

The preceding figure shows only the principles of the JOIN operations. When you join tables, the original columns of the tables that you join are retained.

Merging

Quick BI supports merging between data tables. The following example uses provincial sales data to describe three scenarios of table merging.

image

Limits

  • You can join tables from different data sources only in Quick BI Enterprise Standard.

  • To join or merge tables from different data sources, you must enable the Quick engine extraction acceleration feature. You can go to the Data Source Function Item List to view the data sources that support the extraction acceleration feature.

  • MySQL data sources do not support Full Outer Join.

  • You can configure a maximum of five layers (five association nodes) for table association. There is no limit on the number of associations in each layer.

  • You can merge a maximum of five tables.

  • In API data sources, only data sources in extraction mode can be associated and merged. Direct connection mode supports only single-table modeling.

Select a data source and a data table

  1. When you create a dataset by using Procedure of Entry 4, the data table of the current data source is selected by default. You can manually modify the data source. For other entries, you need to manually select a data source and a data table.image

  2. After you select a data source, you can move the pointer over a data table in the data table list on the left side and click the image icon on the right side to view the details of the data table.

    image

    You can move the pointer over a data table and click the image icon to copy the name of the data table.

  3. Double-click a data table or drag it to the canvas. You can also use Use Custom SQL Statement to Create a Dataset to create a table.

  4. After you select a data table, you can view Table Details.

    image

  5. On the Table Details page, you can select fields.

    image

  6. When you no longer need a data table, you can delete it.

    image

Association

Procedure

  1. Select a data source.

  2. Select or create tables to associate.

    You can associate a data table with a data table, associate a data table with a table created by using SQL code, associate a table created by using SQL code with a data table, or associate a table created by using SQL code with a table created by using SQL code.

    Note

    For information about how to edit SQL code, see Use Custom SQL Statement to Create a Dataset.

    1. Associate a data table with a data table

      On the dataset edit page, follow the steps that are shown in the following figure to drag tables to the canvas.

      image

    2. Associate a data table with a table created by using SQL code

      16

      1. Double-click a data table or drag it to the canvas.

      2. Double-click Create Table by Using SQL Code or drag it to the canvas.

      3. On the SQL code editing page, enter SQL statements, click Run, and confirm the edits to create the table.

    3. Associate a table created by using SQL code with a data table

      17

      1. Click Use SQL Code to Create a Dataset, enter SQL statements, click Run, and confirm the edits to create the table.

      2. Double-click a data table or drag it to the canvas.

    4. Associate a table created by using SQL code with a table created by using SQL code

      15

      1. Click Use SQL Code to Create a Dataset, enter SQL statements, click Run, and confirm the edits to create the table.

      2. Double-click Create Table by Using SQL Code or drag it to the canvas.

      3. On the SQL code editing page, enter SQL statements, click Run, and confirm the edits to create the table.

  3. You can select fields based on your business requirements.

    image

  4. In the Add Association Relationship panel, configure data association by following the steps in the following figure.

    image

    1. Select Left Join, Right Join, Inner Join, or Full Join as the association method.

      Note

      MySQL does not support Full Outer Join.

    2. Set association keys.

      1. The association symbol is set to "=" by default. You can change it to "≠", ">", ">=", "<", or "<=".

        image

      2. You can click Add Association Key to add multiple association keys.

        image

      3. You can delete association keys.

        image

      4. You can clear all association keys.

        image

  5. Click Complete and Start Data Processing to complete the configuration and go to the data processing page.imageOn the data processing page, you can click Model Configuration on the left side or click Source Table -> Model Details to go to the Model Configuration page again. For information about operations on the data processing page, see Create a dataset.imageYou can click the association icon on the canvas to view the association relationship.imageIf you do not need a node, you can click the image icon on the right side of the node and select Delete.image

    Note

    You can delete only the last node of a model.

Custom join condition

When you configure a custom join condition, you can create a custom formula as a field that you want to associate with the custom join condition.

  1. When you select an association field, select Create Custom Calculation from the drop-down list.image

  2. Enter a field expression and click OK.image

  3. Click OK. You can see the newly created field expression in the association field.image

  4. You can also edit the custom calculation.image

Filter before association

When you associate tables, you can create filter conditions for each of the two tables. The filter operations are performed before the association.image

  1. Click the image icon on the right side of the table that corresponds to the association field.

  2. Set filter conditions.image

  3. Click OK to complete the configuration of the filter conditions before association.image

Cross-source association

When the data tables that you need to use are stored in different data sources, you can associate multiple tables from different data sources on the dataset edit page to form a model for data analytics. To configure a whitelist, perform the following steps:

Note
  • You can join tables from different data sources only in Quick BI Enterprise Standard.

  • To join tables from different data sources, you must enable the Quick engine extraction acceleration feature. You can go to the Data Source Function Item List to view the data sources that support the extraction acceleration feature.

  1. In the data table list on the dataset edit page, find the data table of the target database and drag it to the canvas.image

  2. Switch the data list to another target database, find the required data table, and drag it to the canvas.image

  3. Configure the association relationship between the data tables based on your requirements. For more information, see Add Association Relationship in this topic. After you complete the configuration, save the current dataset.

  4. Click Advanced Configuration in the toolbar at the top of the page.

    image

  5. Click Acceleration Configuration to go to the acceleration configuration page and turn on Quick Engine.

    image

  6. After you turn on Quick Engine, you need to configure the following parameters. For information about the configuration, see Configure Quick Engine.image

  7. Click Save to complete the extraction acceleration configuration.

Merging

Data merging is used to configure the summarization and integration of information from different data sources or data tables into a single dataset for better analysis, processing, or reporting.

Note

After tables are merged, they can be associated as a whole. When you associate merged results, Custom Calculation and Filter Before Association are not supported.

Procedure

  1. Select a data source.

  2. Select or create tables to merge.

    You can merge a data table with a data table, merge a data table with a table created by using SQL code, merge a table created by using SQL code with a data table, or merge a table created by using SQL code with a table created by using SQL code.

    Note

    The following example shows how to merge a data table with a table created by using SQL code:

    18

    1. Double-click a data table or drag it to the canvas.

    2. Drag Create Table by Using SQL Code to the lower part of the table to be merged.

    3. On the SQL code editing page, enter SQL statements, click Run, and confirm the edits to create the table.

  3. Configure table merging relationship.

    image

    1. Fields with the same name and type are automatically matched.

    2. You can click a field box and select a field from the drop-down list to manually adjust field matching.

      Note

      The drop-down list displays only fields of the same type.

      image

    3. You can select fields based on your business requirements.

      image

  4. After you configure the table merging relationship, click Complete and Start Data Processing to complete the configuration and go to the data processing page.

    image

    For information about operations on the data processing page, see Create a dataset.

Cross-source merging

When the data tables that you need to use are stored in different data sources, you can merge multiple tables from different data sources on the dataset edit page to form a model for data analytics. To configure a whitelist, perform the following steps:

Note
  • You can merge tables from different data sources only in Quick BI Enterprise Standard.

  • To merge tables from different data sources, you must enable the Quick engine extraction acceleration feature. You can go to the Data Source Function Item List to view the data sources that support the extraction acceleration feature.

  1. In the data table list on the dataset edit page, find the data table of the target database and drag it to the canvas.image

  2. Switch the data list to another target database, find the required data table, and drag it to the canvas.

    image

  3. Configure the merging relationship between the data tables based on your requirements. For more information, see Configure table merging relationship in this topic. After you complete the configuration, click Complete and Start Data Processing to go to the data processing page, and save the current dataset.

  4. Click Advanced Configuration in the toolbar at the top of the page.

    image

  5. Click Acceleration Configuration to go to the acceleration configuration page and turn on Quick Engine.

    image

  6. After you turn on Quick Engine, you need to configure the following parameters. For information about the configuration, see Configure Quick Engine.image

  7. Click Save to complete the extraction acceleration configuration.

Switch data tables

When you need to use other data tables, you can switch data tables on the table details page. You can switch to a data table from the same data source or a data table from another data source.

Notes

  • Currently, you cannot switch data tables for the following data sources:

    • Data sources created by using custom SQL statements

    • File data sources in exploration spaces

    • API data sources

    • DingTalk table data sources

    • Lark spreadsheet data sources

    • Lark multidimensional table data sources

  • When you switch data tables, fields with the same name are automatically matched. Make sure that the fields in the destination table are consistent with those in the source table.

  • If the data source type of the destination table is different from that of the source table, check whether the calculated fields are correct after you switch the data tables. If you have configured extraction acceleration, reset it.

Procedure

  1. On the Table Details page, click Switch Data Table.image

  2. On the Switch Data Table page, select a data source and a data table.

    image

  3. Click OK.

  4. In the dialog box that appears, click OK to switch the data source.