Scale a cluster in Azure Cosmos DB for PostgreSQL
APPLIES TO: Azure Cosmos DB for PostgreSQL (powered by the Citus database extension to PostgreSQL)
Azure Cosmos DB for PostgreSQL provides self-service scaling to deal with increased load. The Azure portal makes it easy to add new worker nodes, and to increase the vCores and storage for existing nodes.
Adding nodes causes no downtime, and even moving shards to the new nodes (called shard rebalancing) happens without interrupting queries.
Add worker nodes
On the portal page for your cluster, select Scale from the left menu.
On the Scale page, under Nodes, select a new value for Node count.
Select Save to apply the changed values.
Once you increase nodes and save, you can't decrease the number of worker nodes by using this form.
To take advantage of newly added nodes you must rebalance distributed table shards, which means moving some shards from existing nodes to the new ones. Rebalancing can work in the background, and requires no downtime.
Increase or decrease vCores on nodes
You can increase the capabilities of existing nodes. Adjusting compute capacity up and down can be useful for performance experiments, and short- or long-term changes to traffic demands.
To change the vCores for all worker nodes, on the Scale screen, select a new value under Compute per node. To adjust the coordinator node's vCores, expand Coordinator and select a new value under Coordinator compute.
You can scale compute on cluster read replicas independent of their primary cluster's compute.
There is a vCore quota per Azure subscription per region. The default quota should be more than enough to experiment with Azure Cosmos DB for PostgreSQL. If you need more vCores for a region in your subscription, see how to adjust compute quotas.
Increase storage on nodes
You can increase the disk space of existing nodes. Increasing disk space can allow you to do more with existing worker nodes before needing to add more worker nodes.
To change the storage amount for all worker nodes, on the Scale screen, select a new value under Storage per node. To adjust the coordinator node's storage, expand Coordinator and select a new value under Coordinator storage.
Once you increase storage and save, you can't decrease the amount of storage.
- Learn more about cluster performance options.
- Rebalance distributed table shards so that all worker nodes can participate in parallel queries
- See the sizes of distributed tables, and other useful diagnostic queries.
Submit and view feedback for