All Products
Search
Document Center

PolarDB:Add and manage AI nodes

Last Updated:Mar 28, 2026

Add a dedicated AI node to your PolarDB for PostgreSQL cluster to isolate AI workloads from Online Transaction Processing (OLTP) operations, so neither affects the other's performance.

Prerequisites

Before you begin, confirm the following:

Cluster requirements — your cluster must meet all of these:

  • Region: Japan (Tokyo)

  • Region: Your cluster must be in the Japan (Tokyo) region.

  • Edition: Enterprise Edition

  • Engine version: one of the following

    • PostgreSQL 16 (minor engine version 2.0.16.6.2.0 or later)

    • PostgreSQL 15 (minor engine version 2.0.15.12.4.0 or later)

    • PostgreSQL 14 (minor engine version 2.0.14.13.28.0 or later)

To check the minor engine version, run SHOW polardb_version; in the database, or view it in the console. If the version is earlier than required, upgrade the minor engine version.

What to have ready — before starting the add-node wizard, make sure you have:

  • A standard database account created in the cluster. If you don't have one, create a database account first. You will need this account and its password in the final setup step.

Add an AI node

  1. Log on to the PolarDB console. In the left navigation pane, click Clusters. Select the region where your cluster is located and find the cluster.

  2. Open the Add/Remove Node wizard using either of the following methods:

    • In the Actions column, click Add/Remove Node. image

    • On the cluster details page, in the Database Nodes section, click Add/Remove Node. image

  3. In the wizard, select Add AI Node and click OK.

    image

  4. On the cluster upgrade/downgrade page, select the specifications and number of AI nodes to add, then confirm the order.

    SettingDescription
    SpecificationsThe compute and memory resources allocated to each AI node. Select based on your AI workload size.
    Number of nodesThe number of AI nodes to add.

    image

  5. After payment completes, return to the cluster details page. Wait until the AI node status changes to Running.

    image

  6. Set up the database account for the AI node. In the Database Nodes section, find the AI node entry. In the dialog box, select the standard account, enter the Database Password, and click Confirm.

    image

Delete an AI node

  1. Log on to the PolarDB console. In the left navigation pane, click Clusters. Select the region where your cluster is located and find the cluster.

  2. Open the Add/Remove Node wizard using either of the following methods:

    • In the Actions column, click Add/Remove Node. image

    • On the cluster details page, in the Database Nodes section, click Add/Remove Node. image

  3. In the wizard, select Delete AI Node and click OK.

    image

  4. On the cluster upgrade/downgrade page, select the AI node to delete and confirm the deletion.

    image

Billing

AI nodes incur fees and are billed using the same method as standard compute nodes.