Using the Query Builder

<< Click to Display Table of Contents >>

Navigation:  Dashboard Designer > Work with Data >

Using the Query Builder

 

 

Using the Query Builder

In the Query Builder dialog, you can add data tables and views to the data source, and select which columns to include. The Query Builder automatically joins the related tables, so all you need to do is drag-and-drop.

 

UQB1

 

Add Tables

To add the required tables/views to a data source, double-click the table (or view) or drag-and-drop it from the Tables pane onto the Diagram pane.

UQB3

Then, select the required columns.

UQB4

Join Tables

Note that if at least one table has been added to the Diagram pane, the Tables pane highlights tables that have a relationship with any of the recently added tables.

UQB5

To join the already added table with an another table, do one of the following.

Click the UQB6 button next to the foreign key column (SupplierID and CategoryID in the image above). Drag and drop the highlighted table from the Tables pane to Diagram pane.

The Query Builder will display a relationship between tables.

UQB7

To edit this relation, select it and use its context menu.

 

UQB8

 

UQB9

 

First, check the join type. You can specify it in the Join type combo box (Inner join or Left outer join). To edit column and table names in the existing condition, click the name you wish to replace and choose a different name from the popup menu.

 

Edit Column Settings

After you have added the tables and selected the required columns, you can change settings for each column in the Grid pane.

UQB12

The following settings are available for each column.

UQB13 Use Column to select the required column from the combo box or add a new column. If necessary, you can customize a column expression. To do this, click the ellipsis button for the required column and specify the expression in the invoked Expression Editor dialog.

 

The Output column allows you to choose whether to include specific columns to the query.

Use the Sorting type combo box to specify the sort order of column values. The Sort order column allows you to specify the order in which several columns are sorted.

The Group By statement is used in conjunction with the aggregate functions to group the result-set by one or more columns.

 

Filter Data

To filter data in the Query Builder, click the Filter... button. This will invoke the Filter Editor dialog, which allows you to build filter criteria.

UQB16

To learn more, see Filter Queries.

Customize SQL Query

 

After you add the required tables, you can customize the automatically generated SQL query. To do this, enable the Allow Edit SQL check box and edit the SQL query displayed in the SQL pane.

UQB20

For instance, you can add a WHERE clause to the SQL expression.

 

Preview Data

The Query Builder allows you to preview data for the created SQL query. To do this, click the Preview Results... button.

This invokes the Data Preview window containing data returned after executing the query.