Skip to main content

Connector queries

DronaHQ enables your controls to interact with various data sources by using data queries. With DronaHQ, you can seamlessly query most databases and APIs.

Lets say you can set your Tablegrid's data to be {{}} where your data query is selecting data from an SQL, and the Tablegrid will then display data from data_query1. Also you can run a data query on click of a Button to trigger a specific action, such as {{update_data}}, which can initiate an API POST request.

Connector Query
Connector Query


To start using direct connector queries in your app builder, you need a connector in place already. It could be a Database or an API connector. Once the connector is in place, you can query into it with a choice of editors depending on what type of a connector is configured.

Existing connector
Configured connectors' list
Querying into an API

We also consider adding an API endpoint as a data query. The pre-requisite being that the connector category needs to be already configured.

Sections in connector query

While you want to write a connector query which will be eventually referenced in any of the controls like a Tablegrid, you need to start off navigating to Data queries -> New -> Connector query. Please note that you need not have the query already added in the library, you can create these queries on the fly. All the queries added will be available to edit or access only in that particular app and will not be available at the account level.

While adding the connector query you will see the following sections

Query editor

Depending on which connector you choose, the appropriate query editor will be initialized for the best experience of writing the query. In this example we have an SQL editor since the connector selected is a MySQL type of a connector. Similarly for graphQL, No SQL, REST APIS, Firebase etc. will have their own unique editors. An example of writing a query in the SQL editor is as below with a dynamic variable:

SELECT * FROM products WHERE id = {{dropdown}}
Query Editor
Query Editor


While building your queries the schema of your tables (in case of SQL) comes handy. This section provides with a blueprint of the whole schema or the database down to the column type.

Empty schema

There are times when some type of data sources dont allow fetching of schemas or the added credentials dont have the privilege of fetching schemas. In this case the section will be empty.

Database schema
Database schemas

Test values

When you have dynamic variables in your query like {{dropdown}} you might want to change the values in it and test the query to check your responses. This is the reason the test values can be modified to try out different cases with your query. In this example you can see the test value of the dropdown is set to Folder and the query is built with the same value.

Test values

This section comes in handy even while configuring the failure conditions for different scenarios and/or users and simulate.

Test values
Test values


You will see the response of your query in this section when you test. You can toggle between viewing tabular data or JSON type of data depending on the format of the response data. In this case since we had an SQL SELECT query, we had an array of object type of data which we can view in tabular as well as json format.

Tabular response data
Response in tabular format
JSON response data
Response data in JSON format

Failure conditions

There are times when there would be non 2XX responses from an API with specific conditions (e.g. 403 forbidden response) and you might want to handle the same with custom response messages to the user. You can configure Failure conditions in this case.

You have the following keywords available to build your failure conditions:

  • OUTPUT - Output json keys
  • ERROR - Error keys
  • STATUSCODE - HTTP status code received from the target connector
  • STATUSMESSAGE - HTTP status message received from the target connector

Typical example would be:

{{STATUSCODE == 403}}
{{OUTPUT[0].id == null}}
Failure condition
Example: Failure condition


This sections is exactly same as the one in the connector library.

Transform response
Transform response section