Connecting Bold BI to PostgreSql data source

The Bold BI Dashboard Designer supports connecting the PostgreSql database using the SQL Live Query (C# API).

Supported Server Versions: PostgreSQL (v9.5, v9.6, v10, v11, and v12)

Choose PostgreSql data source

To configure the PostgreSql data source, follow these steps:

Click Data Sources in the configuration panel to add a new data connection.
Click CREATE NEW to launch a new connection from the connection panel.
Select the PostgreSql connection in the connection panel.

NOTE: You can also create a data source from the home page by clicking the Data Sources menu from left menu panel and Create Data Source from the data sources page.

Choose data source

Connect to PostgreSql

Create PostgreSql data source

After clicking the data source, the NEW DATA SOURCE configuration panel opens. Follow the given steps to create a PostgreSql data source:

Enter a name and description (optional) for the data source.
Enter a valid PostgreSql server or host name in the ServerName text box.
Enter a valid PostgreSql username in the UserName text box.
Enter a valid PostgreSql password in the Password text box.
Enter a valid PostgreSql database in the Database text box.
To connect PostgreSql with SSL connection, enter the connection string sslmode=Require;TrustServerCertificate=true in Additional connection parameters text box.

To kill the created sessions, enter the connection string Maximum Pool Size=1;Connection Idle Lifetime=45;Command Timeout=15 in Additional connection parameters text box.

NOTE: To connect data source with SSH, enable the SSH check box in the NEW DATA SOURCE configuration panel and enter the required credentials.

There are two connection types available in a data source:

* Live mode
* Extract mode

Live mode connection

In this connection type, a data source is directly fetched from source. Choose the Live mode option for this connection.

Live Connection

Data Preview

Click Connect to connect the PostgreSql server with configured details. The schema represents the collection list retrieved from the PostgreSql server. This dialog displays a list of schemas in treeview and their corresponding values.
Now, the data design view page with the selected table schema opens. Drag the table.

You can use the Code View option for passing a query to display data.
Click Save to save the data source with a relevant name.

Extract mode connection

In this connection type, a data source is fetched from source periodically. Choose the Extract mode option for this connection.

Extract Connection

NOTE: Initially, data will be extracted based on the Max Rows selected in order to proceed with data model creation. The remaining records (there is no limit) will be extracted during the next refresh.

Refresh Settings

Steps to configure the data source refresh settings:

Click Refresh Settings in the configuration panel.
Select the recurrence type, recurrence start, and end dates in the Refresh Setting dialog box.
- Data refresh can be scheduled hourly, daily, weekly, and monthly.
- Application Time Zone is displayed below the date picker. Start time of the schedule is converted to the client Time Zone and shown at the right-side for users convenience. After selecting, click Schedule.

Preview and data import

Click Connect to connect the PostgreSql server with configured details.
The Extract Data dialog opens. This dialog has two modes of connection either via Table or Custom query.
- Under custom query option, write the required query and click Connect.
- Under the Table option, This dialog displays list of tables and views in treeview. Select the required table(s) or view(s) from treeview to use in the designer. The option is available for configuring incremental refresh column (The table must have a primary key column and date column to configure this option) for the selected items in the right side panel. If you configured it, then the data source will work on Incremental update, otherwise works on Full load concept. And finally click Connect.
Now, the data design view page with the selected table schema opens. Drag the table.

You can use the Code View option for passing query to display data.
Click Save to save the data source with a relevant name.