From 8368de709989b04e9d397b7434dca53ee6e7c2bc Mon Sep 17 00:00:00 2001 From: qiancai Date: Wed, 17 Dec 2025 17:12:28 +0800 Subject: [PATCH 1/7] Update tidb-cloud-glossary.md --- tidb-cloud/tidb-cloud-glossary.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/tidb-cloud/tidb-cloud-glossary.md b/tidb-cloud/tidb-cloud-glossary.md index ec6a46c2fe7f5..c77fc319aec34 100644 --- a/tidb-cloud/tidb-cloud-glossary.md +++ b/tidb-cloud/tidb-cloud-glossary.md @@ -145,7 +145,9 @@ A Request Capacity Unit (RCU) is a unit of measure used to represent the provisi ### Request Unit (RU) -A Request Unit (RU) is a unit of measure used to represent the amount of resources consumed by a single request to the database. The amount of RUs consumed by a request depends on various factors, such as the operation type or the amount of data being retrieved or modified. For more information, see [{{{ .starter }}} Pricing Details](https://www.pingcap.com/tidb-cloud-starter-pricing-details/). +For {{{ .starter }}}, a Request Unit (RU) is a **billing and usage metric** that represent the amount of resources consumed by a single request to the database. The amount of RUs consumed by a request depends on various factors, such as the operation type or the amount of data being retrieved or modified. For more information, see [{{{ .starter }}} Pricing Details](https://www.pingcap.com/tidb-cloud-starter-pricing-details/). + +For TiDB Cloud Dedicated and TiDB Self-Managed, a Request Unit (RU) is a **resource abstraction unit** that represents system resource consumption, which currently includes CPU, IOPS, and IO bandwidth metrics. It is used by the resource control feature to limit, isolate, and manage resources consumed by database requests, rather than for billing purposes. For more information, see [Use Resource Control to Achieve Resource Group Limitation and Flow Control](/tidb-resource-control-ru-groups.md). ## S From 284fbe1d496316d590adad242034159ee8362c97 Mon Sep 17 00:00:00 2001 From: Grace Cai Date: Wed, 17 Dec 2025 17:18:20 +0800 Subject: [PATCH 2/7] Update tidb-cloud/tidb-cloud-glossary.md Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com> --- tidb-cloud/tidb-cloud-glossary.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/tidb-cloud/tidb-cloud-glossary.md b/tidb-cloud/tidb-cloud-glossary.md index c77fc319aec34..9567c47591edd 100644 --- a/tidb-cloud/tidb-cloud-glossary.md +++ b/tidb-cloud/tidb-cloud-glossary.md @@ -145,7 +145,7 @@ A Request Capacity Unit (RCU) is a unit of measure used to represent the provisi ### Request Unit (RU) -For {{{ .starter }}}, a Request Unit (RU) is a **billing and usage metric** that represent the amount of resources consumed by a single request to the database. The amount of RUs consumed by a request depends on various factors, such as the operation type or the amount of data being retrieved or modified. For more information, see [{{{ .starter }}} Pricing Details](https://www.pingcap.com/tidb-cloud-starter-pricing-details/). +For {{{ .starter }}}, a Request Unit (RU) is a **billing and usage metric** that represents the amount of resources consumed by a single request to the database. The amount of RUs consumed by a request depends on various factors, such as the operation type or the amount of data being retrieved or modified. For more information, see [{{{ .starter }}} Pricing Details](https://www.pingcap.com/tidb-cloud-starter-pricing-details/). For TiDB Cloud Dedicated and TiDB Self-Managed, a Request Unit (RU) is a **resource abstraction unit** that represents system resource consumption, which currently includes CPU, IOPS, and IO bandwidth metrics. It is used by the resource control feature to limit, isolate, and manage resources consumed by database requests, rather than for billing purposes. For more information, see [Use Resource Control to Achieve Resource Group Limitation and Flow Control](/tidb-resource-control-ru-groups.md). From 19a6922f4932fe2db389adc3a1d48cedaff3a09a Mon Sep 17 00:00:00 2001 From: Grace Cai Date: Wed, 17 Dec 2025 17:19:52 +0800 Subject: [PATCH 3/7] Update tidb-cloud/tidb-cloud-glossary.md --- tidb-cloud/tidb-cloud-glossary.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/tidb-cloud/tidb-cloud-glossary.md b/tidb-cloud/tidb-cloud-glossary.md index 9567c47591edd..8e2ed440fc737 100644 --- a/tidb-cloud/tidb-cloud-glossary.md +++ b/tidb-cloud/tidb-cloud-glossary.md @@ -147,7 +147,7 @@ A Request Capacity Unit (RCU) is a unit of measure used to represent the provisi For {{{ .starter }}}, a Request Unit (RU) is a **billing and usage metric** that represents the amount of resources consumed by a single request to the database. The amount of RUs consumed by a request depends on various factors, such as the operation type or the amount of data being retrieved or modified. For more information, see [{{{ .starter }}} Pricing Details](https://www.pingcap.com/tidb-cloud-starter-pricing-details/). -For TiDB Cloud Dedicated and TiDB Self-Managed, a Request Unit (RU) is a **resource abstraction unit** that represents system resource consumption, which currently includes CPU, IOPS, and IO bandwidth metrics. It is used by the resource control feature to limit, isolate, and manage resources consumed by database requests, rather than for billing purposes. For more information, see [Use Resource Control to Achieve Resource Group Limitation and Flow Control](/tidb-resource-control-ru-groups.md). +For TiDB Cloud Dedicated and TiDB Self-Managed, a Request Unit (RU) is a **resource abstraction unit** that represents system resource consumption, which currently includes CPU, IOPS, and IO bandwidth metrics. It is used by the resource control feature to limit, isolate, and manage resources consumed by database requests, not for billing purposes. For more information, see [Use Resource Control to Achieve Resource Group Limitation and Flow Control](/tidb-resource-control-ru-groups.md). ## S From e8ee4effbb8b247f936ad08dcd5b55d6ab25a67f Mon Sep 17 00:00:00 2001 From: Grace Cai Date: Wed, 17 Dec 2025 17:49:11 +0800 Subject: [PATCH 4/7] Update tidb-cloud/tidb-cloud-glossary.md --- tidb-cloud/tidb-cloud-glossary.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/tidb-cloud/tidb-cloud-glossary.md b/tidb-cloud/tidb-cloud-glossary.md index 8e2ed440fc737..6b1631bb671ff 100644 --- a/tidb-cloud/tidb-cloud-glossary.md +++ b/tidb-cloud/tidb-cloud-glossary.md @@ -145,7 +145,7 @@ A Request Capacity Unit (RCU) is a unit of measure used to represent the provisi ### Request Unit (RU) -For {{{ .starter }}}, a Request Unit (RU) is a **billing and usage metric** that represents the amount of resources consumed by a single request to the database. The amount of RUs consumed by a request depends on various factors, such as the operation type or the amount of data being retrieved or modified. For more information, see [{{{ .starter }}} Pricing Details](https://www.pingcap.com/tidb-cloud-starter-pricing-details/). +For {{{ .starter }}} and Essential, a Request Unit (RU) is a **billing and usage metric** that represents the amount of resources consumed by a single request to the database. The amount of RUs consumed by a request depends on various factors, such as the operation type or the amount of data being retrieved or modified. For more information, see [{{{ .starter }}} Pricing Details](https://www.pingcap.com/tidb-cloud-starter-pricing-details/) and [{{{ .essential }}} Pricing Details](https://www.pingcap.com/tidb-cloud-essential-pricing-details/). For TiDB Cloud Dedicated and TiDB Self-Managed, a Request Unit (RU) is a **resource abstraction unit** that represents system resource consumption, which currently includes CPU, IOPS, and IO bandwidth metrics. It is used by the resource control feature to limit, isolate, and manage resources consumed by database requests, not for billing purposes. For more information, see [Use Resource Control to Achieve Resource Group Limitation and Flow Control](/tidb-resource-control-ru-groups.md). From 4183938cc92a7f9e3cdfebd3cbbff994fbeccf53 Mon Sep 17 00:00:00 2001 From: qiancai Date: Fri, 19 Dec 2025 15:35:01 +0800 Subject: [PATCH 5/7] clarify difference between RU and RCU --- tidb-cloud/tidb-cloud-billing.md | 2 +- tidb-cloud/tidb-cloud-glossary.md | 5 ++++- 2 files changed, 5 insertions(+), 2 deletions(-) diff --git a/tidb-cloud/tidb-cloud-billing.md b/tidb-cloud/tidb-cloud-billing.md index 0b438f26b8b19..80559b14b2bb5 100644 --- a/tidb-cloud/tidb-cloud-billing.md +++ b/tidb-cloud/tidb-cloud-billing.md @@ -19,7 +19,7 @@ See [{{{ .starter }}} Pricing Details](https://www.pingcap.com/tidb-cloud-starte ### Pricing for {{{ .essential }}} {#pricing-for-essential} -For {{{ .essential }}}, you are charged based on the number of provisioned Request Capacity Units (RCUs), **not** on the actual usage by your application. See [{{{ .essential }}} Pricing Details](https://www.pingcap.com/tidb-cloud-essential-pricing-details/). +See [{{{ .essential }}} Pricing Details](https://www.pingcap.com/tidb-cloud-essential-pricing-details/). diff --git a/tidb-cloud/tidb-cloud-glossary.md b/tidb-cloud/tidb-cloud-glossary.md index 6b1631bb671ff..af07e64560f3e 100644 --- a/tidb-cloud/tidb-cloud-glossary.md +++ b/tidb-cloud/tidb-cloud-glossary.md @@ -145,7 +145,10 @@ A Request Capacity Unit (RCU) is a unit of measure used to represent the provisi ### Request Unit (RU) -For {{{ .starter }}} and Essential, a Request Unit (RU) is a **billing and usage metric** that represents the amount of resources consumed by a single request to the database. The amount of RUs consumed by a request depends on various factors, such as the operation type or the amount of data being retrieved or modified. For more information, see [{{{ .starter }}} Pricing Details](https://www.pingcap.com/tidb-cloud-starter-pricing-details/) and [{{{ .essential }}} Pricing Details](https://www.pingcap.com/tidb-cloud-essential-pricing-details/). +For {{{ .starter }}} and Essential, a Request Unit (RU) is a **usage metric** that represents the amount of resources consumed by a single request to the database. The number of RUs consumed by a request depends on factors such as the operation type, the size of data accessed, and system resource usage. However, the billing models for {{{ .starter }}} and Essential are different: + +- {{{ .starter }}} is billed based on the total number of RUs consumed. For more information, see [{{{ .starter }}} Pricing Details](https://www.pingcap.com/tidb-cloud-starter-pricing-details/). +- {{{ .essential }}} is billed based on the number of provisioned [Request Capacity Units (RCUs)](#request-capacity-unit-rcu), which define the sustained RU-per-second capacity of the cluster. RCUs determine the billing and capacity limits, while RUs track the actual consumption against that provisioned capacity. For more information, see [{{{ .essential }}} Pricing Details](https://www.pingcap.com/tidb-cloud-essential-pricing-details/). For TiDB Cloud Dedicated and TiDB Self-Managed, a Request Unit (RU) is a **resource abstraction unit** that represents system resource consumption, which currently includes CPU, IOPS, and IO bandwidth metrics. It is used by the resource control feature to limit, isolate, and manage resources consumed by database requests, not for billing purposes. For more information, see [Use Resource Control to Achieve Resource Group Limitation and Flow Control](/tidb-resource-control-ru-groups.md). From 2f579a58fe6bfa9b1eb61cea0f5980314c28a4b9 Mon Sep 17 00:00:00 2001 From: Grace Cai Date: Fri, 19 Dec 2025 15:36:56 +0800 Subject: [PATCH 6/7] Discard changes to tidb-cloud/tidb-cloud-billing.md --- tidb-cloud/tidb-cloud-billing.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/tidb-cloud/tidb-cloud-billing.md b/tidb-cloud/tidb-cloud-billing.md index 80559b14b2bb5..0b438f26b8b19 100644 --- a/tidb-cloud/tidb-cloud-billing.md +++ b/tidb-cloud/tidb-cloud-billing.md @@ -19,7 +19,7 @@ See [{{{ .starter }}} Pricing Details](https://www.pingcap.com/tidb-cloud-starte ### Pricing for {{{ .essential }}} {#pricing-for-essential} -See [{{{ .essential }}} Pricing Details](https://www.pingcap.com/tidb-cloud-essential-pricing-details/). +For {{{ .essential }}}, you are charged based on the number of provisioned Request Capacity Units (RCUs), **not** on the actual usage by your application. See [{{{ .essential }}} Pricing Details](https://www.pingcap.com/tidb-cloud-essential-pricing-details/). From ed476fa2e3d32b6375baae0521d0d890d3a93111 Mon Sep 17 00:00:00 2001 From: Grace Cai Date: Mon, 22 Dec 2025 10:54:36 +0800 Subject: [PATCH 7/7] be consistent with the descriptions on the pricing page --- tidb-cloud/tidb-cloud-glossary.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/tidb-cloud/tidb-cloud-glossary.md b/tidb-cloud/tidb-cloud-glossary.md index af07e64560f3e..9568224f6f37f 100644 --- a/tidb-cloud/tidb-cloud-glossary.md +++ b/tidb-cloud/tidb-cloud-glossary.md @@ -145,12 +145,12 @@ A Request Capacity Unit (RCU) is a unit of measure used to represent the provisi ### Request Unit (RU) -For {{{ .starter }}} and Essential, a Request Unit (RU) is a **usage metric** that represents the amount of resources consumed by a single request to the database. The number of RUs consumed by a request depends on factors such as the operation type, the size of data accessed, and system resource usage. However, the billing models for {{{ .starter }}} and Essential are different: +For {{{ .starter }}} and Essential, a Request Unit (RU) is a unit of measure used to represent the amount of resources consumed by a single request to the database. The amount of RUs consumed by a request depends on various factors, such as the operation type or the amount of data being retrieved or modified. However, the billing models for {{{ .starter }}} and Essential are different: - {{{ .starter }}} is billed based on the total number of RUs consumed. For more information, see [{{{ .starter }}} Pricing Details](https://www.pingcap.com/tidb-cloud-starter-pricing-details/). -- {{{ .essential }}} is billed based on the number of provisioned [Request Capacity Units (RCUs)](#request-capacity-unit-rcu), which define the sustained RU-per-second capacity of the cluster. RCUs determine the billing and capacity limits, while RUs track the actual consumption against that provisioned capacity. For more information, see [{{{ .essential }}} Pricing Details](https://www.pingcap.com/tidb-cloud-essential-pricing-details/). +- {{{ .essential }}} is billed based on the number of provisioned [Request Capacity Units (RCUs)](#request-capacity-unit-rcu). One RCU provides a fixed amount of compute resources that can process a certain number of RUs-per-second. For more information, see [{{{ .essential }}} Pricing Details](https://www.pingcap.com/tidb-cloud-essential-pricing-details/). -For TiDB Cloud Dedicated and TiDB Self-Managed, a Request Unit (RU) is a **resource abstraction unit** that represents system resource consumption, which currently includes CPU, IOPS, and IO bandwidth metrics. It is used by the resource control feature to limit, isolate, and manage resources consumed by database requests, not for billing purposes. For more information, see [Use Resource Control to Achieve Resource Group Limitation and Flow Control](/tidb-resource-control-ru-groups.md). +For TiDB Cloud Dedicated and TiDB Self-Managed, a Request Unit (RU) is a resource abstraction unit that represents system resource consumption, which currently includes CPU, IOPS, and IO bandwidth metrics. It is used by the resource control feature to limit, isolate, and manage resources consumed by database requests, **not for billing purposes**. For more information, see [Use Resource Control to Achieve Resource Group Limitation and Flow Control](/tidb-resource-control-ru-groups.md). ## S