All Products
Search
Document Center

PolarDB:Add and manage AI nodes

Last Updated:May 10, 2026

PolarDB for PostgreSQL and support adding independent AI nodes to your cluster. These nodes isolate AI workloads from other business tasks, preventing them from impacting each other's performance.

Prerequisites for PostgreSQL

To add an AI node, your cluster must meet the following requirements:

  • Region: This feature is available only in the Japan (Tokyo) region.

  • product version: enterprise edition

  • kernel version:

    • 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)

    Note

    You can view the minor engine version in the console or check it by running the SHOW polardb_version; command. If your cluster does not meet the minor engine version requirement, you must upgrade the minor engine version.

  • You must create a standard account.

Add an AI node

  1. Log on to the PolarDB console. In the navigation pane on the left, click Clusters, select the region of your target cluster, and then find the cluster.

  2. Use either of the following methods to open the Add/Remove Node:

    1. In the Actions column, click Add/Remove Node.

    2. Go to the details page of the target cluster. In the Database Nodes section, click Add/Remove Node.

  3. In the Add/Remove Node, select the Add AI Node check box and click OK.

  4. On the cluster configuration change page, select the specifications and number of AI nodes, and then confirm your selection.

  5. After you complete the payment, return to the cluster details page. The node is successfully added when its status changes to Running.

Configure connection account

In the Database Nodes section, find and select the new AI Nodes. In the dialog box that appears, select the standard account that you created, enter the Database Password, and then click Confirm.

Obtain node token

Once the AI node is added and its account is configured, go to the Database Nodes section and select the AI node. In the dialog box that appears, click View Node Token and record the Node Token. This token is required to access large language model (LLM) services when you configure the PolarDB for AI extension.

Remove an AI node

  1. Log on to the PolarDB console. In the navigation pane on the left, click Clusters, select the region of your target cluster, and then find the cluster.

  2. Use either of the following methods to open the Add/Remove Node:

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

    • Go to the details page of the target cluster. In the Database Nodes section, click Add/Remove Node.

  3. In the Add/Remove Node, select the Delete AI Node check box and click OK.

  4. On the cluster configuration change page, select the AI node that you want to remove, and then confirm your selection.

Related information

AI node specifications

Adding AI nodes incurs charges. They are billed as standard compute nodes.