Create a user-created Impala data source to connect Quick BI to your Impala database. This feature is available only in Quick BI Pro and Quick BI Advanced workspaces.
Prerequisites
-
Network connectivity is established between Quick BI and your Impala database.
-
If you connect to your Impala database over the internet, you must add the Quick BI IP addresses to the database whitelist. For more information, see Manage security group rules.
-
If you connect to your Impala database over an internal network, connect using one of the following methods:
-
If your Impala database is hosted on an Alibaba Cloud ECS instance, you can connect through a VPC.
-
You can set up a bastion host and connect to your database using an SSH tunnel.
-
-
-
An Impala database is deployed.
-
You have the username and password for the Impala database.
Limitations
Impala versions 2.10.0 and 3.4.0 are supported.
Procedure
Log on to the Quick BI console.
-
Add the data source:
-
Navigate to the data source creation page using an entry point for creating a data source.
-
On the User-Created Data Source tab, click Impala.

-
-
In the Configure Connection dialog box, configure the following parameters.

Parameter
Description
Display name
The display name shown in the data source list.
Enter a name without special characters or leading or trailing spaces.
Database Address and Port
The endpoint of your Impala database. You can enter an IP address or a domain name.
Port
The port used to connect to the database. Default: 21050.
Database
The name of the database you want to connect to.
Database version
The database version. Versions 2.x and 3.x are supported.
Username and Password
The username and password for the database. The user must have CREATE, INSERT, UPDATE, and DELETE permissions on the database tables.
VPC data source
Select this option if your data source is in an ECS VPC. When VPC Data Source is selected, configure the following parameters:
-
Purchaser AccessKey ID: The AccessKey ID of the account that purchased the instance.
For more information, see Create an AccessKey pair.
NoteThe AccessKey ID must have Read permissions on the target instance. If the AccessKey ID also has Write permissions on the corresponding security group, Quick BI automatically adds its IP addresses to the whitelist. Otherwise, you must manually add them. For more information, see Create a custom policy.
-
Purchaser AccessKey Secret: The AccessKey Secret of the account that purchased the instance.
For more information, see Create an AccessKey pair.
-
Instance ID: The ID of the ECS instance. You can obtain the instance ID on the Instances page of the ECS console.
For more information, see View instance information.
-
Region: The region where the instance is located.
For more information, see View instance information.
SSL
If your data source uses SSL, select the SSL checkbox to encrypt data in transit.
SSH
Select this option to connect to your data source through an SSH tunnel. When SSH is selected, configure the following parameters:
-
SSH host: The hostname or IP address of the SSH server.
-
SSH username: The username for the SSH connection.
-
SSH password: The password for the SSH user.
-
SSH port: The port for the SSH connection. Default: 22.
NoteConnecting to a user-created data source through an SSH tunnel is supported only in Quick BI Pro workspaces.
Auth
If you select this option, you must enter a Username and Password.
Initial SQL
SQL statements that are automatically executed after a connection to the data source is established.
Only SET statements are allowed. Separate multiple statements with semicolons (;). Do not use line breaks.
-
-
Click Test Connection to test the data source connectivity.

-
After the test succeeds, click OK to add the data source.
Next steps
After you create the data source, you can create datasets and start analyzing data.
-
Create a dataset in Quick BI using tables or custom SQL queries from your Impala database. For more information, see Create a dataset.
-
Add visualization charts to a dashboard to analyze data. For more information, see Create a new dashboard and Overview of visualization charts.
-
Drill down into your data for in-depth analysis. For more information, see Step 3: Configure and display drill-down data.