Querying A Table In Reference Data Management
To query a table, you can do the following:
click the Get Started button from the initial dashboard page
click the Query button on the result view. A Query dialog will open where you will configure the criteria for your query.
Info!
If a query was done previously, last applied query settings will be reloaded. If it is unable to fully reload, a notification will prompt users to verify and update the values accordingly.
Opening the Query dialog will discard any uncommitted changes and refresh the Reference Data Profiles if there are any changes to the profiles.
Options | Description |
---|---|
Saved filters | Allows you to manage saved filters within the Query dialog.
|
Action | Contains the following actions to manage the saved filters:
|
Reference Data Profile | Allows you to select a Reference Data Profile that contains the table you want to query from. For more on Reference Data profiles, you can refer to Reference Data Profile. |
Search Type | There are two types of search that you can select as follows:
|
Table | This option appears once you have selected a profile and Standard Search Type. This is a dropdown list of tables configured in the selected Reference Data profile. You select from one table in the list to perform your query on. |
Main Table | This option appears once you have selected a profile and Join Table Search Type. This is a dropdown list of tables configured in the selected Reference Data profile. You select from one table in the list to perform your query on. The alias of the selected main table will always be t1 which will be used for Join Constraints. |
Join Conditions | This option appears once you have selected a profile and Join Table Search Type. Add join conditions to combine two or more tables by selecting Table Name, Join Type and configure Join Constraints. The alias of the selected table will be stated next to the Table Name label, for e.g: The screenshot below indicates that t2 will be the alias of the table. The following join types are supported:
Reference Data Management - Join Condition Dialog Join Constraint is used to specify the conditions for joining tables, for e.g: t1.column_id=t2.column_id. |
Show Columns | This option appears once you have selected a profile and a table. This displays all the column names available in the selected table. You can remove and add the columns at your choosing to be displayed in the query result. Clicking on the All button will select all the columns in the table. All columns are selected by default. |
Data Set Size | This option appears once you have selected a profile and a table. The value in this field controls the maximum row count per data set. The queried data is fetched from the Platform in data sets of configurable size. A large size typically results in a faster query but it may take longer to display the first data set. Info!Data set is the scope in which query results are displayed and modifications are applied. When switching data set, any uncommitted changes will be discarded. Users switch between data sets with buttons on the footer bar in the query result view. |
Query Expressions | This option appears once you have selected a profile and a table. Query Expressions allow you to filter the query results according to the criteria you configure in this option. Click on New Expression to add one to the query. |
Sort Expression | This option appears once you have selected a profile and a table, defaulted to first column in ascending direction. Sort Expressions allow you to sort the query results according to the criteria you configure in this option. Click on New Sort Expression to add additional expression. |
Query Expressions
Options | Description |
---|---|
Column | This is a column in the selected database table. Note!Only columns with supported data types are available for selection. |
Operator | This is a comparison operator that is applied to the values in the specified column and the value. The available operators are:
|
Value | This field contains a value that is used in the expression. When between is the selected operator, two value fields are displayed. You can use SQL wildcards such % and _ with the operators like and not like. An underscore (_) in the pattern matches exactly one character (as opposed to one byte in a multibyte character set) in the value. A percent sign (%) in the pattern can match zero or more characters (as opposed to bytes in a multibyte character set) in the value. The pattern '%' cannot match a null. |
Sort Expressions
Options | Description |
---|---|
Column | This is a column in the selected database table which data needs to be sorted. |
Direction | You can select to view the query results in the following manner:
|
Querying a Result
JSON Viewer
The JSON Viewer is available to assist you by displaying JSON data in a more readable form. This is only available for columns that contain valid JSON format.
Follow the steps below to view the JSON data.
In the Query Result View, click the View Value button.
If the column contains a valid JSON format, the Viewing Value dialog contains the following tabs:
Grid - Displays the JSON data in a grid form.
Text - Displays the JSON data in a text form.
For columns that do not contain valid JSON format, the Viewing Value dialog will display the Text tab only.
Â