This topic describes how to create a user-created Oracle data source.
Prerequisites
Ensure network connectivity:
If you connect Quick BI to your Oracle database over the public network, add the IP addresses of Quick BI to the database whitelist. For more information, see Add a security group rule.
If you connect Quick BI to your Oracle database over an internal network, establish a connection in one of the following ways:
If your Oracle database is deployed on an Alibaba Cloud ECS instance, you can connect to it through a VPC.
You can also set up a bastion host and use an SSH tunnel to access the database.
For private deployment, see Alibaba Cloud Quick BI Solutions.
You have created an Oracle database.
You have the username and password for your Oracle database.
Limitations
Oracle 11.0 is supported.
Procedure
Add IP addresses to the whitelist.
Before connecting to your Oracle database, you must add the IP addresses of Quick BI to the Oracle whitelist.
Verify the data source connection and create the data source.
Log on to the Quick BI console.
Follow these steps to add a data source:
Navigate to the Create Data Source page.
On the User-Created Data Source tab, select the Oracle data source.

In the Configure Connection dialog box, set the following parameters.

Parameter
Description
Display name
The name of the data source that appears in the data source list.
Enter a descriptive name. The name cannot contain special characters or leading or trailing spaces.
Database address
The IP address or domain name of the Oracle database.
Port
The port number used to connect to the database.
Database
The name of the database that you want to connect to. The connection method is Service Name.
Schema
The name of the schema that you want to connect to.
Username
The username for accessing the database.
Password
The password that corresponds to the username.
Character encoding
Quick BI supports the following character encodings. Select one as needed.
GBK (default)
UTF-8
GB2312
ISO-8859-1
VPC data source
Select this option if your data source is in a VPC. If you select VPC Data Source, you must configure the following parameters:
AccessKey ID: The AccessKey ID of the account that purchased the instance.
For more information, see Obtain an AccessKey.
NoteThe AccessKey ID must have read permissions on the target instance. If the AccessKey ID also has write permissions, Quick BI automatically adds the required IP addresses to the whitelist. Otherwise, you must add them manually. For more information, see Create a custom policy.
AccessKey Secret: The AccessKey Secret of the account that purchased the instance.
For more information, see Obtain an AccessKey.
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 of the ECS instance. You can find the region in the upper-left corner of the ECS console.
For more information, see View instance information.
SSH
Select this option to connect to your data source by using an SSH tunnel. If you select SSH, you must configure the following parameters:
SSH Host: The hostname or IP address of the bastion host.
SSH Username: The username for the bastion host.
SSH Password: The password for the SSH username.
SSH Port: The port number for the SSH connection. The default value is 22.
Enable file upload
Allows you to upload files.
Initialize SQL
Specifies SQL statements to execute each time a connection to the data source is established.
Only SET statements are allowed. Separate multiple statements with a semicolon (;).
Click Test Connection to test the connection to the data source.
After the connection passes the test, click OK to add the data source.
Next steps
After you create the data source, you can create datasets and analyze data.
To add data tables from your Oracle database or create datasets with custom SQL in Quick BI, see Create a dataset.
To add visual charts and analyze data, see Create a dashboard and Overview of visual charts.
To perform a drill-down for in-depth data analysis, see Step 3: Configure and display drill-down data.