Connecting Bold BI to Snowflake data source

Bold BI Dashboard Designer supports connecting Snowflake database through SQL Live query.

Supported Server Editions: Standard, Enterprise and Business Critical

Choose Snowflake data source

To configure the Snowflake data source, follow these steps:

1. Click the Data Sources button in the configuration panel to add a new data connection.

   

2. Click CREATE NEW to launch a new connection from the connection panel.

3. Select the Snowflake 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.

Connect to Snowflake

Create Snowflake data source

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

1. Enter a name and description (optional) for the data source.
2. Enter a valid Snowflake server or host name in the Server Name text box.

For example, https://dum421.west-europe.azure.snowflakecomputing.com 3. Enter a valid Snowflake user name in the User Name text box. 4. Enter a valid Snowflake password in the Password text box. 5. Enter a valid Snowflake database name in the Database text box.

There are two connection types in a data source:

• Live mode
• Extract mode

Live mode connection

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

Data Preview

1. Click Connect to connect the Snowflake server with configured details.

The schema represents the collection list that are retrieved from the Snowflake server. This dialog displays a list of schemas in treeview and its corresponding values.

2. Now, the data design view page with selected table schema opens. Drag and drop the table.

   

   Either you can use the Code View options for passing query to display data.

   

3. Click Save to save the data source with a relevant name.

Extract mode connection

In this connection type, a data source is fetched from the source periodically. Choose the Extract mode option for this 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:

1. Click Refresh Settings in the configuration panel.

   

2. 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 in the right side for users convenience. After selecting, click Schedule.

   

Preview and data import

1. Click Connect to connect the snowflake server with configured details.

2. 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.

   • Incremental Update can be performed in both tables and views.

   • 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 for the selected items in the right side panel.

     • The table must have a primary key column and date column to configure the incremental refresh option.
     • The Views must have a date column to configure the incremental refresh option and unique column(s) is optional which is used to update the modified records.

     If you configured it, then the data source will work on Incremental update, otherwise works on Full load concept. And finally click Connect.

   

3. Now, the data design view page with the selected table schema opens. Drag and drop the table.

   

   You can use the Code View options for passing query to display data.

   

4. Click Save to save the data source with a relevant name.

NOTE: In future, you can edit the connection information for both Live and Extract mode connections using the Edit Connection option.

Connecting Bold BI to Snowflake Data Source via REST API

Prerequisites

Supported Server Editions: Standard, Enterprise and Business Critical

Type while creating the data source needs to be snowflake.

Rest API - v4.0

Modes

Through the REST API, only the live mode data source can be created and edited.

Parameters for creating Data Source

Parameters for adding expressions when creating Data Source

Parameters for editing Data Source

NOTE: For editing Data Source via API. All the parameters are optional. The parameter which needs to be changed can be provided.

Parameters for modifying expressions when editing Data Source

Connection Sample for Table Mode

For creating connection:

"Connection":
{
"Servername": "string",
"Port": "string",
"Username": "string",
"Password": "string",
"Database": "string",
"Schemaname": "string",
"Tablename": "string",
"AdvancedSettings": "string",
"CommandTimeout": "300",
"Expressions" : [{
"Name": "Expression1",
"Expression" : "SUM(numeric expression)"
    },
    {
"Name": "Expression2",
"Expression" :  "UPPER(string expression)"
}]
}

For editing connection:

"Connection":
{
"Servername": "string",
"Port": "string",
"Username": "string",
"Password": "string",
"Database": "string",
"Schemaname": "string",
"Tablename": "string",
"AdvancedSettings": "string",
"CommandTimeout": "300",
"Expressions" : [{
"Name": "Expression1",
"Expression" : "SUM(numeric expression)",
"NewName" : "Sum",
"Action": "edit"
    },
    {
"Name": "Expression2",
"Expression" :  "UPPER(string expression)"
"Action": "delete"
}]
}

NOTE: Through Rest API, the data source can be created or edited with only one table. If different table is provided in edit data source, the table will be replaced. The widgets will be retained only if the schema is same as the previous table.

Connection Sample for Code View Mode

"Connection":
{
"Servername": "string",
"Port": "string",
"Username": "string",
"Password": "string",
"Database": "string",
"Query": "string",
"AdvancedSettings": "string",
"CommandTimeout": "300",
"Expressions" : [{
"Name": "Expression1",
"Expression" : "SUM(numeric expression)"
    },
    {
"Name": "Expression2",
"Expression" :  "UPPER(string expression)"
}]
}

Related links

Data Transformation

Editing a Data Connection

Dashboard Designer Walkthrough

Snowflake Integration