Skip to content

QueryView Basics

This page describes the QueryView interface and how to setup a QueryView.

QueryView Configuration

After clicking the Create New QueryView icon, you will be presented with a new, blank QueryView in Edit mode. A QueryView has two modes: Edit mode, which allows you to edit the configuration, settings and query, and View mode, which allows you to view the results.

The QueryView Edit mode looks as follows:

!Composable New QueryView

Note the three sections: a set of configuration menu items on the left, the query template window, and the sample output window. You will need to set values in Info and Connection to run/save a query.

Edit Mode

Edit Menu Items

Pages to configure a QueryView are in the menu on the left of Edit mode.

Composable QueryView Menu
  • Info: On this modal, enter in the QueryView name, description, and other global settings.
    • Name: The name of the QueryView. Must be Named before Saving.
    • ID: The Composable ID that can be used to refer to the QueryView is other applications.
    • Description: A description field to provide more information or context on the QueryView.
    • Folder: Used for organizing and sharing resources.
    • Tags: Add tags to help searching for resources.
    • Paging Type: Set how the results will display. Options are None which displays the entire result, Limit the number of rows (displayed on one page). Auto and Full provide paging functionality. Auto takes care of the paging, whereas for Full the user sets the paging paramters in the query.
    • Default Order Column: Column order that goes after an ORDER BY clause for result ordering. Can either be column numbers, or column names.
    • Auto-Execute on Page Load: If unselected, the Refresh will need to be clicked to load results.
    • Auto-Refresh on Input Change: If selected, the results will refresh as literal or filter Inputs are changed. If unselected, clicking the refresh button will refresh the results.
    • Display NULL Values as Blank: If unselected, NULL fields will display as NULL. If selected, the fields will be blank.

!Composable New QueryView

  • Connection: Here, select the Composable Key to connect to the data store of your choice.

!Composable New QueryView

  • Inputs: Configure literal and filter parameters whose values can be set in View Mode of the query.
  • Children: Allows you to expand each row of this queryview to bring up additional details. When expanded, a row will execute and display the child QueryViews selected below. These can accept values from the expanded row as inputs, allowing you to dive deep into additional information related to the expanded row.
  • Actions: Linking a DataFlow as an action will include a button(s) adjacent to this QueryView's result table that allows you to execute a DataFlow with the QueryView Input module using data from the QueryView as input data. This can be used to create powerful interactivity between the data your QueryView displays and related DataFlows you've authored.
  • HyperLinks: Configure a hyperlink for each row that can reference data values in the row.

Writing the Query

In the Query Template Window of Edit mode, you can write your SQL statement.

As an example, you can do the following:

!Composable QueryView template

Note that as you write your SQL statement, Composable checks and converts your query into a syntactically correct SQL statement viewable in the Sample Output window on the right. This fills in example values for input parameters so you can ensure that your SQL query is correct. The checkbox icon will turn green when clicked if your syntax is valid.


Composable will execute this query on the underlying SQL host you select via the Composable Key. So you can write your SQL in any flavor of the language (e.g., for Oracle, DB2, MSSQL, Hive, etc.!

Sharing QueryViews

In Edit Mode, the QueryViews configuration can be imported/exported in a json format to be shared across Composable instances. There are button for these actions in the top right corner. The import/export action is for a config file with the settings and parameters in the QueryView, it does not contain results of the query.


Once a QueryView is saved, you can share the QueryView, and also place it in a Folder or add Tags to it (found in the Info modal). A full revision history will also be available.

View Mode

Composable QueryView template

You can now switch to the View mode by clicking on the Execute button. A grid of results will appear. You can switch back and forth between Edit and View to iterate on the query. To switch back to Edit Mode, click the Edit button in the top right.

!Composable QueryView View mode

Exporting QueryView Results

In the View mode, clicking the Export button will export the full results of your query (not just the current page) as a csv or xlsx file. Under Options you can switch between the file format.

View page buttons

You can also export only a subset of the result columns. To exclude a column from being exported, Ctrl + Click on the column name in the results header. An X icon will appear next to the column name to indicate the column will not be included in the export. Ctrl + Click again on the column name to include the column back in the export.

!GroupName is excluded in the file export