All Products
Search
Document Center

AnalyticDB:Create an instance

Last Updated:Jan 22, 2026

This topic describes how to create an instance in the AnalyticDB for PostgreSQL console.

Preparations

  • An Alibaba Cloud account is required. If you do not have an account, you can register one on the Alibaba Cloud official website.

  • Authorize a service-linked role. The first time you use AnalyticDB for PostgreSQL, you must authorize the creation of a service-linked role in the console. To do this, perform the following steps:

    1. Log on to the AnalyticDB for PostgreSQL console.
    2. In the upper-right corner of the page, click Create Instance.

    3. In the Create Service Linked Role dialog box that appears, click OK.

Free trial

Alibaba Cloud offers a free trial for Storage-elastic Mode instances. If you are a new user of AnalyticDB for PostgreSQL, you can visit Alibaba Cloud Free Trial to apply for a free trial. If you are not eligible for a free trial, follow the steps in this topic to create an instance in the console.

Create an instance

  1. Log on to the AnalyticDB for PostgreSQL console.
  2. In the upper-right corner of the page, click Create Instance to open the instance purchase page.

  3. Select a Product Type. The following types are supported:

    • Subscription: You are billed on a subscription basis and must pay for resources before you use them. This billing method is suitable for long-term use and is more cost-effective than the pay-as-you-go method. The discount increases with the subscription duration.

    • Pay-as-you-go: You are billed on a pay-as-you-go basis and charged for resources hourly. This billing method is suitable for short-term use. You can release the instance immediately after use to save costs.

  4. Configure the following parameters.

    Parameter

    Description

    Region and Zone

    The Region is the geographical location of the instance.

    Note
    • You cannot change the region of an instance after the instance is created. Select a region that is close to the geographic location of your application to reduce network latency for database access.

    • Ensure that the instance and the ECS instance to which you want to connect are in the same region. Otherwise, they cannot communicate over an internal network and must use the internet, which can negatively impact performance.

    A Zone is an independent physical area in a region. No significant differences exist between zones.

    You can create the instance and the ECS instance in the same zone or in different zones.

    Instance Resource Type

    Select the resource type of the instance. The following types are supported:

    • Storage-elastic Mode: Supports independent disk scaling and online smooth scale-out.

    • Serverless Pro: Allows you to specify only the required computing resources without reserving storage resources.

    Note

    The available Instance Resource Type options vary by region and zone. If your desired Instance Resource Type is unavailable in the current region and zone, select a different one.

    For more information about the resource types that you can create in different regions and zones, see Specifications and instance types.

    Engine Version

    Select the database engine version of the instance. Valid values: 7.0 Standard Edition and 6.0 Standard Edition.

    Note

    This parameter is specific to instances in Storage-elastic Mode.

    Instance Series

    Select the instance series. Valid values: High-performance (Basic Edition) and High-availability Edition.

    Note

    Only instances in Storage-elastic Mode can use High-performance (Basic Edition). For more information, see High-performance instances.

    Vector Engine Optimization

    Select whether to enable vector engine optimization. Valid values:

    • Disable (Recommended for data warehouses): Disable vector engine optimization for mainstream analytics, data warehouse, and real-time data warehouse scenarios.

    • Enable: Enable vector engine optimization for AIGC and vector retrieval scenarios.

    Enabling vector engine optimization can improve the vector analysis performance of the instance. However, this feature consumes a large amount of memory resources and significantly reduces the concurrency of the instance. Be aware of these implications before you enable this feature.

    Note
    • Only Storage-elastic Mode instances support vector engine optimization.

    • The compute node specifications must be 4 CPU cores and 32 GB of memory or higher.

    Master resources

    Select the specifications of the Master resources. Select the specifications based on the formula: Master CUs = Number of CPU cores of a single segment node.

    If you require more Master resources, you can increase the specifications after the instance is created. For more information, see Manage Master resources.

    Node specifications (segment)

    Select the compute node specifications. The available node specifications vary depending on the Instance Resource Type and Instance Series. For more information about the specifications, see Specifications and instance types.

    Note

    This parameter applies only to instances in Storage-elastic Mode.

    Number of nodes (segment)

    Select the number of compute nodes. Performance increases linearly with the number of nodes. The available range for the number of nodes varies depending on the Instance Series. The details are as follows:

    • High-availability Edition: The minimum number of nodes is 4, the maximum number of nodes is 512, and the step size is 4.

    • High-performance (Basic Edition): The minimum number of nodes is 2, the maximum number of nodes is 512, and the step size is 2.

    Note

    This parameter applies only to instances in Storage-elastic Mode.

    Storage disk type

    Select the disk type for data storage. The details are as follows:

    • ESSD PL1 (Recommended)

    • ESSD PL0

    • ESSD PL2 (High-throughput)

    For more information about the performance of different disk types, see Block storage performance.

    Note

    This parameter applies only to instances in Storage-elastic Mode.

    Encryption type

    Select Not Encrypted or Disk Encryption.

    Note

    This parameter is specific to instances in Storage-elastic Mode.

    Encryption key

    Select an encryption key for the cloud disk.

    For Storage Elastic Mode, this parameter is required only if you select Disk Encryption.

    Storage capacity per node

    Specifies the exclusive storage space for each node in the instance. The storage capacity ranges from 50 GB to 6000 GB. The value must be a multiple of 50.

    Note

    This parameter is specific to instances in Storage-elastic Mode.

    Reserved computing resources

    The number of CUs for compute nodes. The minimum value is 16 CUs (16 Segments).

    Note

    This parameter is applicable only to instances in Serverless Pro mode.

    Serverless cache

    The total size of cloud disks that are mounted to compute nodes. The recommended minimum size is 800 GB. If the size exceeds 800 GB, you can adjust the size based on the amount of hot data. For example, you can set the size to 30% of the total data volume.

    Note

    This parameter is available only for instances in Serverless Pro mode and specifies the total cache size for all compute nodes, not the cache size of a single compute node.

    Network type

    The network type of the instance. This parameter is fixed to virtual network.

    Virtual Private Cloud (VPC)

    Select the ID of the VPC.

    A VPC provides an isolated network environment that is more secure and performs better than the classic network. You must create a VPC and a vSwitch in the same region as the instance beforehand.

    vSwitch

    Select a vSwitch that belongs to the VPC. If no vSwitches are listed, it means that no vSwitch is available in the current zone. You can switch to another zone or create a vSwitch in the current zone.

    Resource group

    Select the resource group to which the instance belongs. For more information about resource groups, see What is Resource Management?.

    Sample data

    Select whether to load sample data. For more information about sample datasets, see Manage sample datasets.

    Duration

    Select the subscription duration of the instance.

    Note

    This parameter is required only if the Billing Method is set to Subscription.

  5. Click Buy Now.

  6. On the Confirm Order page, perform the following operations based on your selected Product Type:

    • For a Subscription instance, click Go to Pay and then click Order.

    • For a Pay-as-you-go instance, click Activate Now.

    Note

    An AnalyticDB for PostgreSQL instance takes some time to initialize. You can view the new instance in the Instances. The instance is ready for use when its status changes to Running.

Related APIs

API

Description

CreateDBInstance

Creates an AnalyticDB for PostgreSQL instance.

FAQ

How can I resolve the The DBInstance vswitch id is not valid error during instance creation?

Cause: You did not select a vSwitch.

Solution: Select a vSwitch that belongs to the current VPC. If no vSwitches are available for the current VPC, create a vSwitch.