Skip to content

Alicloud pricing #21124

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 12 commits into
base: release-cloud
Choose a base branch
from
Open

Alicloud pricing #21124

wants to merge 12 commits into from

Conversation

likidu
Copy link
Collaborator

@likidu likidu commented Jun 5, 2025

First-time contributors' checklist

What is changed, added or deleted? (Required)

Adding the pricing section for TiDB Cloud Starter and Essential for Alibaba Cloud.

Which TiDB version(s) do your changes apply to? (Required)

Tips for choosing the affected version(s):

By default, CHOOSE MASTER ONLY so your changes will be applied to the next TiDB major or minor releases. If your PR involves a product feature behavior change or a compatibility change, CHOOSE THE AFFECTED RELEASE BRANCH(ES) AND MASTER.

For details, see tips for choosing the affected versions.

  • master (the latest development version)
  • v9.0 (TiDB 9.0 versions)
  • v8.5 (TiDB 8.5 versions)
  • v8.4 (TiDB 8.4 versions)
  • v8.3 (TiDB 8.3 versions)
  • v8.1 (TiDB 8.1 versions)
  • v7.5 (TiDB 7.5 versions)
  • v7.1 (TiDB 7.1 versions)
  • v6.5 (TiDB 6.5 versions)
  • v6.1 (TiDB 6.1 versions)
  • v5.4 (TiDB 5.4 versions)
  • release-cloud

What is the related PR or file link(s)?

  • This PR is translated from:
  • Other reference link(s):

Do your changes match any of the following descriptions?

  • Delete files
  • Change aliases
  • Need modification after applied to another branch
  • Might cause conflicts after applied to another branch

@likidu likidu requested a review from lilin90 June 5, 2025 01:47
@likidu likidu self-assigned this Jun 5, 2025
Copy link

ti-chi-bot bot commented Jun 5, 2025

[APPROVALNOTIFIER] This PR is NOT APPROVED

This pull-request has been approved by:
Once this PR has been reviewed and has the lgtm label, please assign oreoxmt for approval. For more information see the Code Review Process.
Please ensure that each of them provides their approval before proceeding.

The full list of commands accepted by this bot can be found here.

Needs approval from an approver in each of these files:

Approvers can indicate their approval by writing /approve in a comment
Approvers can cancel approval by writing /approve cancel in a comment

@ti-chi-bot ti-chi-bot bot added missing-translation-status This PR does not have translation status info. size/M Denotes a PR that changes 30-99 lines, ignoring generated files. labels Jun 5, 2025
Copy link

@gemini-code-assist gemini-code-assist bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Hello @likidu, I'm Gemini Code Assist1! I'm currently reviewing this pull request and will post my feedback shortly. In the meantime, here's a summary to help you and other reviewers quickly get up to speed!

Summary of Changes

Hello! gemini-code-assist here, providing a summary of this pull request. This PR, authored by likidu, focuses on enhancing the documentation for TiDB Cloud billing. The primary goal is to add comprehensive pricing details specifically for Alibaba Cloud regions for both TiDB Cloud Starter and Essential tiers. It also includes updates to the free trial end date and clarifies concepts like Request Units (RU) and Request Capacity Units (RCU), along with details on free quotas, spending limits, throttling, and the billing cycle.

Highlights

  • Alibaba Cloud Pricing Added: Detailed pricing tables for TiDB Cloud Starter and Essential tiers are introduced for Alibaba Cloud regions (Singapore, Japan, Mexico).
  • RU and RCU Defined: Clear definitions and explanations are provided for Request Units (RU) and Request Capacity Units (RCU), which are key metrics for billing in TiDB Cloud.
  • Free Quota and Spending Limit Details: The documentation now includes specifics on the free quota available for Starter clusters and how the Monthly Spending Limit works.
  • Throttling Policies Explained: Information on how throttling is applied to both Starter (based on spending limit/free quota) and Essential (based on RCU capacity) clusters is added.
  • Free Trial End Date Updated: The free trial end date for TiDB Cloud Starter clusters has been updated from April 30, 2025, to June 9, 2025.

Changelog

Click here to see the changelog
  • tidb-cloud/tidb-cloud-billing.md
    • Updated the free trial end date for Starter clusters to June 9, 2025.
    • Added a new 'Pricing' section covering both Starter and Essential tiers.
    • Included definitions for Request Unit (RU) and Request Capacity Unit (RCU).
    • Provided a table detailing RU consumption for various resources.
    • Added pricing tables for Alibaba Cloud regions (Singapore, Japan, Mexico) for Starter clusters (per 1M RUs, row/column storage).
    • Detailed the Free Quota policy for Starter clusters (per cluster and per organization).
    • Explained the Monthly Spending Limit feature for Starter clusters.
    • Described the throttling behavior for Starter clusters.
    • Added pricing tables for Alibaba Cloud regions (Singapore, Japan, Mexico) for Essential clusters (per RCU, row/column storage).
    • Described the throttling behavior for Essential clusters.
    • Added a section explaining the billing cycle.
Using Gemini Code Assist

The full guide for Gemini Code Assist can be found on our documentation page, here are some quick tips.

Invoking Gemini

You can request assistance from Gemini at any point in your pull request via creating an issue comment (i.e. comment on the pull request page) using either /gemini <command> or @gemini-code-assist <command>. Below is a summary of the supported commands.

Feature Command Description
Code Review /gemini review Performs a code review for the current pull request in its current state.
Pull Request Summary /gemini summary Provides a summary of the current pull request in its current state.
Comment @gemini-code-assist Responds in comments when explicitly tagged, both in issue comments and review comments.
Help /gemini help Displays a list of available commands.

Customization

To customize Gemini Code Assist for GitHub experience, repository maintainers can create a configuration file and/or provide a custom code review style guide (such as PEP-8 for Python) by creating and adding files to a .gemini/ folder in the base of the repository. Detailed instructions can be found here.

Limitations & Feedback

Gemini Code Assist is currently in preview and may make mistakes. Please leave feedback on any instances where its feedback is incorrect or counter productive. You can react with 👍 and 👎 on @gemini-code-assist comments to provide feedback.

You can also get AI-powered code generation, chat, as well as code reviews directly in the IDE at no cost with the Gemini Code Assist IDE Extension.

Footnotes

  1. Review the Privacy Notices, Generative AI Prohibited Use Policy, Terms of Service, and learn how to configure Gemini Code Assist in GitHub here. Gemini can make mistakes, so double check it and use code with caution.

Copy link

@gemini-code-assist gemini-code-assist bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Code Review

The pull request adds pricing information for TiDB Cloud Starter and Essential on Alibaba Cloud. The changes are well-structured and provide a good overview of the pricing models. However, there are a few areas where clarity and consistency can be improved. I have added comments to address these points.

Summary of Findings

  • Clarity and Consistency: Several areas could benefit from improved clarity and consistency in phrasing and formatting.
  • Footnotes: The asterisk (*) next to 'Write' needs a footnote to explain its significance. Also, the double asterisk (**) next to 'transactions' needs a footnote to explain its significance.

Merge Readiness

The pull request is almost ready for merging. Addressing the comments above will improve the clarity and consistency of the documentation. I am unable to directly approve this pull request, and recommend that others review and approve this code before merging.

@lilin90 lilin90 added area/tidb-cloud This PR relates to the area of TiDB Cloud. translation/no-need No need to translate this PR. labels Jun 5, 2025
@ti-chi-bot ti-chi-bot bot removed the missing-translation-status This PR does not have translation status info. label Jun 5, 2025
Comment on lines 34 to 37
| Write* | 2 storage write batch consumes 1 RU |
| | 2 storage write request consumes 1 RU |
| | 1 KiB write request payload consumes 1 RU |
| | 8 KiB write request payload consumes 1 RU (for transactions** >= 16MiB) |
Copy link
Member

@lilin90 lilin90 Jun 5, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

  1. Do we also need to add explanations for Writer* and transactions** below this table, like that on https://www.pingcap.com/tidb-serverless-pricing-details/?

    • *Write: Each write operation is duplicated to multiple storage processes (3 for row-based storage without index), and each duplicate is considered a distinct write operation.

    • **Transaction: This applies only to optimistic transaction or autocommit.

  2. I can convert this table into a HTML table, so the left column can show like that on https://www.pingcap.com/tidb-serverless-pricing-details/ to avoid confusion.

Copy link
Contributor

@sunxiaoguang sunxiaoguang left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Add some suggestions to reflect the latest pricing.

| | 64 KiB read request payload consumes 1 RU |
| Write* | 2 storage write batch consumes 1 RU |
| | 2 storage write request consumes 1 RU |
| | 1 KiB write request payload consumes 1 RU |
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
| | 1 KiB write request payload consumes 1 RU |
| | 2 KiB write request payload consumes 1 RU |

| Write* | 2 storage write batch consumes 1 RU |
| | 2 storage write request consumes 1 RU |
| | 1 KiB write request payload consumes 1 RU |
| | 8 KiB write request payload consumes 1 RU (for transactions** >= 16MiB) |
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
| | 8 KiB write request payload consumes 1 RU (for transactions** >= 16MiB) |
| | 16 KiB write request payload consumes 1 RU (for transactions** >= 16MiB) |

| | 1 KiB write request payload consumes 1 RU |
| | 8 KiB write request payload consumes 1 RU (for transactions** >= 16MiB) |
| SQL CPU | 3 ms consumes 1 RU |
| Network Egress | 1 KiB read consumes 1 RU |
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
| Network Egress | 1 KiB read consumes 1 RU |
| Network Egress | 1 KiB read consumes 1 RU for Public Endpoint |
| | 4 KiB read consumes 1 RU for Private Endpoint |

TiDB Cloud offers the following two pricing options to suit different needs:

* TiDB Cloud Starter: you are charged based on the number of Request Units (RUs) consumed by your application.
* TiDB Cloud Essential: you are charged based on the number of Request Capacity Units (RCUs) have provisioned, **not** on the actual usage by your application.
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
* TiDB Cloud Essential: you are charged based on the number of Request Capacity Units (RCUs) have provisioned, **not** on the actual usage by your application.
* TiDB Cloud Essential: you are charged based on the number of provisioned Request Capacity Units (RCUs), **not** on the actual usage by your application.


A **Request Capacity Unit (RCU)** is a unit of measure used to represent the provisioned compute capacity for your TiDB Cloud Essential cluster. One RCU provides a fixed amount of compute resources that can process a certain number of RUs per second. The number of RCUs you provision determines your cluster's baseline performance and throughput capacity.

Currently, the RU will include statistics for the following resources:
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
Currently, the RU will include statistics for the following resources:
Currently, the RU includes statistics for the following resources:

Comment on lines +34 to +35
| Write* | 2 storage write batch consumes 1 RU |
| | 2 storage write request consumes 1 RU |
Copy link
Collaborator

@qiancai qiancai Jun 6, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
| Write* | 2 storage write batch consumes 1 RU |
| | 2 storage write request consumes 1 RU |
| Write* | 2 storage write batches consume 1 RU |
| | 2 storage write requests consume 1 RU |


> *Write: Each write operation is duplicated to multiple storage processes (3 for row-based storage without index), and each duplicate is considered a distinct write operation.

> **Transaction: This applies only to optimistic transaction or autocommit.
Copy link
Collaborator

@qiancai qiancai Jun 6, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
> **Transaction: This applies only to optimistic transaction or autocommit.
> Transaction**: This applies only to optimistic transactions or autocommit.


#### Free quota

We are offering a free quota up to the first 5 clusters created in each Organization. If you need to create more clusters, you will be required to provide a credit card and set a Monthly Spending Limit. But if you delete some of your previous clusters before creating the 6th, the new cluster will still have a free quota. In other words, you can enjoy the free quota for up to 5 clusters.
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
We are offering a free quota up to the first 5 clusters created in each Organization. If you need to create more clusters, you will be required to provide a credit card and set a Monthly Spending Limit. But if you delete some of your previous clusters before creating the 6th, the new cluster will still have a free quota. In other words, you can enjoy the free quota for up to 5 clusters.
TiDB Cloud offers a free quota up to the first 5 clusters created in each [organization](/tidb-cloud/manage-user-access.md#organizations). To create more clusters, you will be required to provide a credit card and set a [Monthly Spending Limit](#monthly-spending-limit). But if you delete some of your previous clusters before creating the 6th, the new cluster will still have a free quota. In other words, you can enjoy the free quota for up to 5 clusters.

Comment on lines +53 to +54
| Row-based storage (per GiB / month) | $0.36 |
| Columnar-based storage (per GiB / month) | $0.09 |
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
| Row-based storage (per GiB / month) | $0.36 |
| Columnar-based storage (per GiB / month) | $0.09 |
| Row-based storage (per GiB/month) | $0.36 |
| Columnar storage (per GiB/month) | $0.09 |

Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

image


#### Monthly Spending Limit

The "Monthly 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 enables you to set a budget for your TiDB Starter clusters. The Monthly Spending Limit must be set to a minimum of $0.01.
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
The "Monthly 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 enables you to set a budget for your TiDB Starter clusters. The Monthly Spending Limit must be set to a minimum of $0.01.
The Monthly 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 enables you to set a budget for your TiDB Cloud Starter clusters. The Monthly Spending Limit must be set to at least $0.01.


The "Monthly 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 enables you to set a budget for your TiDB Starter clusters. The Monthly Spending Limit must be set to a minimum of $0.01.

Note: It is impossible to set a spending limit value lower than the amount already spent for the current month.
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
Note: It is impossible to set a spending limit value lower than the amount already spent for the current month.
> **Note:**
>
> You cannot set a spending limit lower than the amount already spent in the current month.

Comment on lines +84 to +86
| Compute (per RCU / month) | $0.24 |
| Row-based storage (per GiB / month) | $0.36 |
| Columnar-based storage (per GiB / month) | $0.09 |
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
| Compute (per RCU / month) | $0.24 |
| Row-based storage (per GiB / month) | $0.36 |
| Columnar-based storage (per GiB / month) | $0.09 |
| Compute (per RCU/month) | $0.24 |
| Row-based storage (per GiB/month) | $0.36 |
| Columnar storage (per GiB/month) | $0.09 |


### Billing cycle

Each TiDB Cloud bill, corresponding to the previous month's usage, is finalized at the start of every new month. This finalized bill is then charged to your default payment method, typically occurring between the 3rd and 9th day of the respective month. If your usage within the current month reaches or exceeds $500, an automatic charge will be initiated. Please note that the billing cycle operates strictly in accordance with the UTC (+00:00) time zone.
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
Each TiDB Cloud bill, corresponding to the previous month's usage, is finalized at the start of every new month. This finalized bill is then charged to your default payment method, typically occurring between the 3rd and 9th day of the respective month. If your usage within the current month reaches or exceeds $500, an automatic charge will be initiated. Please note that the billing cycle operates strictly in accordance with the UTC (+00:00) time zone.
Each TiDB Cloud bill, corresponding to the previous month's usage, is finalized at the start of every new month. This finalized bill is charged to your default payment method, typically occurring between the 3rd and 9th day of the respective month. If your usage within the current month reaches or exceeds $500, an automatic charge will be initiated. Note that the billing cycle operates strictly in accordance with the UTC (+00:00) time zone.

Comment on lines +39 to +40
| Network Egress | 1 KiB read consumes 1 RU for Public Endpoint |
| | 4 KiB read consumes 1 RU for Private Endpoint |
Copy link
Collaborator

@qiancai qiancai Jun 6, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
| Network Egress | 1 KiB read consumes 1 RU for Public Endpoint |
| | 4 KiB read consumes 1 RU for Private Endpoint |
| Network Egress | 1 KiB read consumes 1 RU for public endpoint |
| | 4 KiB read consumes 1 RU for private endpoint |


We are offering a free quota up to the first 5 clusters created in each Organization. If you need to create more clusters, you will be required to provide a credit card and set a Monthly Spending Limit. But if you delete some of your previous clusters before creating the 6th, the new cluster will still have a free quota. In other words, you can enjoy the free quota for up to 5 clusters.

Free Quota will be issued monthly to serverless clusters that meet these qualifications. With the free quota, customers can store 5 GiB of row-based data, 5 GiB of columnar data, and consume 50 million RUs for one month.
Copy link
Collaborator

@qiancai qiancai Jun 6, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
Free Quota will be issued monthly to serverless clusters that meet these qualifications. With the free quota, customers can store 5 GiB of row-based data, 5 GiB of columnar data, and consume 50 million RUs for one month.
Free quota is issued monthly to TiDB Cloud Starter clusters that meet these qualifications. With the free quota, each TiDB Cloud Starter cluster can store 5 GiB of row-based data, 5 GiB of columnar data, and consume up to 50 million RUs per month.

Copy link
Collaborator

@qiancai qiancai left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Rest LGTM

@ti-chi-bot ti-chi-bot bot added the needs-1-more-lgtm Indicates a PR needs 1 more LGTM. label Jun 6, 2025
Copy link

ti-chi-bot bot commented Jun 6, 2025

[LGTM Timeline notifier]

Timeline:

  • 2025-06-06 04:56:11.966769551 +0000 UTC m=+590458.169114817: ☑️ agreed by qiancai.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
area/tidb-cloud This PR relates to the area of TiDB Cloud. needs-1-more-lgtm Indicates a PR needs 1 more LGTM. size/M Denotes a PR that changes 30-99 lines, ignoring generated files. translation/no-need No need to translate this PR.
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants