Manage Spending Limit for TiDB Serverless Clusters

Spending limit refers to the maximum amount of money that you are willing to spend on a particular workload in a month. It is a cost-control mechanism that allows you to set a budget for your TiDB Serverless clusters.

For each organization in TiDB Cloud, you can create a maximum of five TiDB Serverless clusters by default. To create more TiDB Serverless clusters, you need to add a credit card and set a spending limit for the usage. But if you delete some of your previous clusters before creating more, the new cluster can still be created without a credit card.

Usage quota

For the first five TiDB Serverless clusters in your organization, TiDB Cloud provides a free usage quota for each of them as follows:

• Row-based storage: 5 GiB
• Request Units (RUs): 50 million RUs per month

Once the free quota of a cluster is reached, the read and write operations on this cluster will be throttled until you increase the quota or the usage is reset upon the start of a new month. For example, when the storage of a cluster exceeds 5 GiB, the maximum size limit of a single transaction is reduced from 10 MiB to 1 MiB.

To learn more about the RU consumption of different resources (including read, write, SQL CPU, and network egress), the pricing details, and the throttled information, see TiDB Serverless Pricing Details.

If you want to create a TiDB Serverless cluster with an additional quota, you can edit the spending limit on the cluster creation page. For more information, see Create a TiDB Serverless cluster.

Update spending limit

For an existing TiDB Serverless cluster, you can increase the usage quota by updating the spending limit as follows:

1. On the Clusters page of your project, click the name of your target cluster to go to its overview page.

   Tip

   If you have multiple projects, you can click in the lower-left corner and switch to another project.

2. In the Usage This Month area, click Get more usage quota.

   If you have previously updated the spending limit for a cluster and want to increase it further, click Edit.

3. Edit the monthly spending limit as needed. If you have not added a payment method, you will need to add a credit card after editing the limit.

4. Click Update Spending Limit.