Choosing the type Database will change the form as follows:

Database Driver

Select the kind of database you want to connect to

  • MySQL

  • PostgreSQL


  • Oracle

All drivers have the same fields that needs to be set.

  • Server host & port

  • Username & password

  • Database (the name of the database on your host machine)

  • SQL query

The SQL query entered must return a list of data. The data will be converted into JSON automatically so it can easily be used in the a panels later.


The SQL Query support variables to make you data source more flexible or dependant on context information. An example could be

SELECT * FROM myProducts WHERE category = {myCategoryVar}

Prepare the Result

The database result will be in the following form.

  "result": [ 
    { "yourCol" : "valueRow1"},
    { "yourCol" : "valueRow2"}

To prepare the data for visuals like Table or Chart you have to use filters to extract only the data array without the result property. An an example filter could be


which would select all rows and return them as a list.

Encryption in transit

Your machine must support TLS 1.2 to enable encrypted communication for PostgreSQL, MySQL and MSSQL. For Oracle the client requires network encryption to be available on the database.

Whitelist IP’s

In case you need to whitelist an IP to let external data access your database, please whitelist the following IP addresses:



Json Function Support

Json functions like JSON_ARRAY are supported and will be integrated into the resulting JSON and not rendered as string. So the following SQL result

| id   | attributes          |
|    2 | [{ key: "color"},{ key: "fabric"}] 

will be converted to

          { key: "color" },
          { key: "fabric" }


A connection was successfully established with the server, but then an error occurred during the pre-login handshake. (provider: TCP Provider, error: 35 - An internal exception was caught)

This error message occurs mostly when the database server does not support TLS version 1.2.