AnalyticDB for PostgreSQL is a cloud-native MPP data warehouse for large-scale OLAP. AnalyticDB for PostgreSQL supports elastic storage mode and Serverless mode. Create an elastic storage mode instance, connect to it, and run your first query.
Prerequisites
-
You must have an Alibaba Cloud account. If you do not have one, register for an account on the Alibaba Cloud official website.
-
If you are using AnalyticDB for PostgreSQL for the first time, you must authorize a service-linked role in the console. Follow these steps:
- Log on to the AnalyticDB for PostgreSQL console.
-
In the upper-right corner of the page, click Create Instance.
-
In the Create Service Linked Role dialog box, click OK.
Billing
Instance creation incurs compute and storage charges. Pricing details are in Product pricing.
Free trial
Alibaba Cloud offers a free trial for Elastic Storage Mode instances. If you are a new user of AnalyticDB for PostgreSQL, you can apply on the Alibaba Cloud Free Trial page. If you are not eligible for a free trial, create an instance by following the procedure in this topic.
Procedure
Create an instance
- Log on to the AnalyticDB for PostgreSQL console.
-
In the upper-right corner of the page, click Create Instance to go to the purchase page.
-
On the purchase page, configure the core parameters. Keep default values for other parameters. All parameters are described in Create an instance.
Parameter
Description
Example
Logon Instance
-
Subscription: Prepaid. Best for long-term use and more cost-effective than pay-as-you-go. Longer subscriptions offer higher discounts.
-
Pay-as-you-go: Postpaid and billed hourly. Best for short-term use. Release the instance anytime to stop charges.
Pay-as-you-go
Region and Zone
The region of the instance. Cannot be changed after purchase.
To use internal network communication, create the instance in the same region as your ECS instance.
China (Hangzhou): Zone J
Product Type
-
Elastic Storage Mode: Scales storage capacity independently and online.
-
ServerlessPro: Specify only compute resources. No storage pre-allocation required.
Elastic storage mode
Engine Version
Select 7.0 Standard Edition for more features. 6.0 Standard Edition is also supported.
7.0 Standard Edition
Instance Edition
-
High-performance (Basic Edition): Suitable for most business analytics scenarios.
-
High-availability Edition: Recommended for core enterprise services.
High-performance (Basic Edition)
VPC
Select a VPC.
To connect to an ECS instance in the same region over the internal network, select the same VPC. Create a VPC and vSwitch if needed.
vpc-xxxx
vSwitch
Select a vSwitch in the VPC. If none are listed, choose a different availability zone or create a vSwitch.
vsw-xxxx
-
-
Click Buy Now, verify the order, and click Create Now.
-
Complete the payment and click Console to return to the instance list.
NoteAn AnalyticDB for PostgreSQL instance takes time to initialize. Wait until the status changes to Running before proceeding.
(Optional) Configure an IP whitelist
Skip this step if you access the instance only through DMS. To connect from a local IDE, configure an IP whitelist. Obtain your client IP address as described in Before you begin.
-
In the instance list, click the instance ID to open its details page.
-
In the left-side navigation pane, click Security Controls.
-
Click Create Whitelist and configure the following parameters:
Parameter
Description
Whitelist Name
The name of the new whitelist group. The name must meet the following requirements:
-
It must consist of lowercase letters, digits, or underscores (_).
-
It must start with a lowercase letter and end with a lowercase letter or a digit.
-
The name must be 2 to 32 characters in length.
IP Addresses
The IP addresses to add to the whitelist. Note the following:
-
Separate multiple IP addresses with commas (,). Duplicate IP addresses are not allowed. You can add a maximum of 999 IP addresses.
-
You can use IP addresses in the
10.23.12.24format and CIDR blocks in the10.23.12.24/24format. CIDR stands for Classless Inter-Domain Routing. In CIDR mode, /24 specifies the length of the address prefix. The prefix length can be an integer from 1 to 32. -
Setting the prefix length to 0, such as in
0.0.0.0/0or127.0.0.1/0, allows access from any IP address. This poses a high security risk. Proceed with caution. -
127.0.0.1denies access from all external IP addresses.
-
-
Click OK.
Create an initial account
AnalyticDB for PostgreSQL provides two types of users:
-
Privileged user: The initial account has the
RDS_SUPERUSERrole with full database permissions. -
Standard user: No default permissions. A privileged user or a user with the
GRANTpermission must grant access to database objects. Create and manage users.
-
In the left-side navigation pane, click Account Management.
-
Click Create Account. In the Create Account window, enter an account name and set a password. Then, click OK.
Parameter
Description
Account
The initial account name must meet the following requirements:
-
Must contain only lowercase letters, digits, and underscores (_).
-
Must start with a lowercase letter and end with a lowercase letter or digit.
-
Cannot start with
gp. -
Must be 2 to 16 characters long.
New Password and Confirm Password
The password must meet the following requirements:
-
Must contain characters from at least three of the following categories: uppercase letters, lowercase letters, digits, and special characters.
-
The supported special characters are
!@#$%^&*()_+-=. -
Must be 8 to 32 characters long.
ImportantFor data security, change your password regularly and do not reuse previous passwords.
-
Load a sample dataset
Load a sample dataset for testing. This takes about 6 to 8 minutes.
-
In the upper-right corner of the instance details page, choose .

-
In the Load Sample Dataset dialog box, click OK.
Connect to the database
This section uses DMS to connect. Other methods are covered in Client connections.
-
In the upper-right corner of the instance details page, click Log On to Database.
-
On the Log On to Instance page, enter the Database Account and Database Password, and then click Log On.
Query data
-
In the DMS left navigation pane, click the target instance (in simple mode, switch to the Database Instance tab first) and verify the
adb_sampledata_tpchdatabase exists.If not displayed, click the refresh icon next to the instance.

-
Double-click the
publicschema underadb_sampledata_tpchto open a SQL console. Run the following query.SELECT count(*) FROM lineitem;Expected result:
+-----------+ | count(*) | +-----------+ |59986052 | +-----------+
Next steps
Explore more features of AnalyticDB for PostgreSQL:
-
Data migration and synchronization: Migrate from self-managed or cloud databases to AnalyticDB for PostgreSQL. Overview.
-
Instance scaling: Scale compute with node scaling or expand storage capacity as your workload grows.