This topic describes how to create a user-created Oracle data source.
Prerequisites
Ensure that your network is configured correctly:
If you connect to your Oracle database from Quick BI over the public network, add the Quick BI IP addresses to your database's whitelist. For more information, see Use a security group.
If you connect to your Oracle database from Quick BI over an internal network, establish a connection in one of the following ways:
If your Oracle database is hosted on an Alibaba Cloud ECS instance, you can connect to it through a VPC.
You can set up a bastion host and connect to your database through an SSH tunnel.
For a private deployment, contact us for an Alibaba Cloud Quick BI solution consultation.
You have a self-hosted Oracle database.
You have the username and password for your Oracle database.
Limitations
This connector supports Oracle version 11.0.
Procedure
Add IP addresses to a whitelist.
Before you connect to Oracle, you must add the Quick BI IP addresses to your Oracle database's whitelist.
Verify the connection and create the data source.
Log on to the Quick BI console.
Follow these steps to add a data source:
Navigate to the page for creating a data source.
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 as it appears in the data source list.
Enter a descriptive name. Do not use special characters or leading or trailing spaces.
Database address
The IP address or domain name of your Oracle database.
Port
The port number of 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 of your database account.
Password
The password of your database account.
Character encoding
Quick BI supports the following character encodings. Select the one that matches your database.
GBK (Default)
UTF-8
GB2312
ISO-8859-1
VPC data source
Select this option if your data source is a user-created data source in a VPC. If you select VPC Data Source, you must configure the following parameters:
AccessKey ID: The AccessKey ID of the account that owns the instance.
For more information, see Create an AccessKey pair.
NoteEnsure that the AccessKey ID has at least
Readpermissions for the target instance. Quick BI automatically adds its IP addresses to the whitelist if the key also hasWritepermissions. Otherwise, you must add the IP addresses manually. For more information, see Create a custom RAM policy.AccessKey Secret: The AccessKey Secret of the account that owns the instance.
For more information, see Create an AccessKey pair.
Instance ID: The ID of the ECS instance. You can find the instance ID on the Instances page in the ECS console.
For more information, see View instance information.
Region: The region where the ECS instance is located. You can find this information in the upper-left corner of the ECS console.
For more information, see View instance information.
SSH
Select this option if you want to connect to your data source through an SSH tunnel. If you select SSH, you must configure the following parameters:
SSH host: The hostname or IP address of the SSH server.
SSH username: The SSH username for the database host.
SSH password: The password for the SSH user.
SSH port: The port number for the SSH connection. The default is 22.
Enable file upload
Allows you to upload files.
Initialization SQL
Allows you to specify SQL statements that run automatically after a connection is established.
These statements are executed each time a connection is established. Only
SETstatements are allowed. Use semicolons (;) to separate multiple statements.Click Test Connection to verify the connection to the data source.

If the test is successful, click OK to add the data source.
Next steps
After you create the data source, you can create a dataset and analyze your data.
To add tables or custom SQL queries from your Oracle database to 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 analysis, see Step 3: Configure and display drill-down data.