Skip to content

Commit

Permalink
add release notes, refine wording
Browse files Browse the repository at this point in the history
  • Loading branch information
Oreoxmt committed Apr 1, 2024
1 parent aaab320 commit b9e4702
Show file tree
Hide file tree
Showing 7 changed files with 48 additions and 33 deletions.
2 changes: 1 addition & 1 deletion develop/dev-guide-build-cluster-in-cloud.md
Original file line number Diff line number Diff line change
Expand Up @@ -29,7 +29,7 @@ This document walks you through the quickest way to get started with TiDB Cloud.

3. On the [**Clusters**](https://tidbcloud.com/console/clusters) page, click **Create Cluster**.

4. On the **Create Cluster** page, **Serverless** is selected by default. Update the default cluster name if necessary, and then select the region where you want to create your cluster.
4. On the **Create Cluster** page, **Serverless** is selected by default. Update the default cluster name if necessary, and then select the [cluster plan](/tidb-cloud/select-cluster-tier.md#cluster-plan).

5. Click **Create** to create a TiDB Serverless cluster.

Expand Down
8 changes: 5 additions & 3 deletions tidb-cloud/create-tidb-cluster-serverless.md
Original file line number Diff line number Diff line change
Expand Up @@ -31,13 +31,15 @@ If you are in the `Organization Owner` or the `Project Owner` role, you can crea

4. The cloud provider of TiDB Serverless is AWS. You can select an AWS region where you want to host your cluster.

5. Select **Cluster Plan**. TiDB Serverless has two [Cluster Plans](/tidb-cloud/select-cluster-tier.md#cluster-plan). You can start with Free Cluster and later update to Scalable Cluster as your needs grow. If you want to create a scalable cluster, you need to set a spending limit and add a credit card.
5. Update the default cluster name if necessary.

6. Select a cluster plan. TiDB Serverless provides two [cluster plans](/tidb-cloud/select-cluster-tier.md#cluster-plan): **Free Cluster** and **Scalable Cluster**. You can start with a free cluster and later upgrade to a scalable cluster as your needs grow. To create a scalable cluster, you need to specify a **Monthly Spending Limit** and add a credit card.

> **Note:**
>
> For each organization in TiDB Cloud, you can create a maximum of five Free Clusters by default. To create more TiDB Serverless clusters, you need to add a credit card and create [Scalable Clusters](/tidb-cloud/select-cluster-tier.md#scalable-clusters) for the usage.
> For each organization in TiDB Cloud, you can create a maximum of five [free clusters](/tidb-cloud/select-cluster-tier.md#free-cluster-plan) by default. To create more TiDB Serverless clusters, you need to add a credit card and create [scalable clusters](/tidb-cloud/select-cluster-tier.md##scalable-cluster-plan) for the usage.
6. Update the default cluster name if necessary, and then click **Create**.
7. Click **Create**.

The cluster creation process starts and your TiDB Cloud cluster will be created in approximately 30 seconds.

Expand Down
18 changes: 10 additions & 8 deletions tidb-cloud/manage-serverless-spend-limit.md
Original file line number Diff line number Diff line change
@@ -1,34 +1,36 @@
---
title: Manage Spending Limit for TiDB Serverless scalable clusters
title: Manage Spending Limit for TiDB Serverless Scalable Clusters
summary: Learn how to manage spending limit for your TiDB Serverless scalable clusters.
---

# Manage Spending Limit for TiDB Serverless Scalable Clusters

> **Note:**
>
> The spending limit is only applicable to TiDB Serverless [scalable clusters](/tidb-cloud/select-cluster-tier.md#scalable-clusters).
> The spending limit is only applicable to TiDB Serverless [scalable clusters](/tidb-cloud/select-cluster-tier.md#scalable-cluster-plan).
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 scalable clusters.

For each organization in TiDB Cloud, you can create a maximum of five free clusters by default. To create more TiDB Serverless clusters, you need to add a credit card and create [Scalable Clusters](/tidb-cloud/select-cluster-tier.md#scalable-clusters) 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.
For each organization in TiDB Cloud, you can create a maximum of five [free clusters](/tidb-cloud/select-cluster-tier.md#free-cluster-plan) by default. To create more TiDB Serverless clusters, you need to add a credit card and create scalable clusters 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, no matter Free Cluster or Scalable Cluster, TiDB Cloud provides a free usage quota for each of them as follows:
For the first five TiDB Serverless clusters in your organization, whether they are free or scalable, TiDB Cloud provides a free usage quota for each of them as follows:

- Row-based storage: 5 GiB
- [Request Units (RUs)](/tidb-cloud/tidb-cloud-glossary.md#request-unit): 50 million RUs per month

Once the usage quota of a cluster is reached, new connection attempts will be immediately denied until you [increase the quota](#update-spending-limit) or the usage is reset upon the start of a new month. For connections that were established prior to the throttling, there will be no change in behavior. For example, when the storage of a cluster exceeds 5 GiB for a free cluster, new connection attempts to the cluster will be directly restricted.
Once a cluster reaches its usage quota, it immediately denies any new connection attempts until you [increase the quota](#update-spending-limit) or the usage is reset upon the start of a new month. Existing connections established before reaching the quota will not be affected. For example, when the storage of a cluster exceeds 5 GiB for a free cluster, the cluster automatically restricts any new connection attempts.

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](https://www.pingcap.com/tidb-cloud-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](/tidb-cloud/create-tidb-cluster-serverless.md).

## Upgrade to Scalable Cluster
## Update spending limit

For an existing TiDB Serverless free cluster, you can upgrade to Scalable Cluster as follows:
For a TiDB Serverless free cluster, you can increase the usage quota by upgrading it to a scalable cluster. For an existing scalable cluster, you can adjust the monthly spending limit directly.

To update the spending limit for a TiDB Serverless cluster, perform the following steps:

1. On the [**Clusters**](https://tidbcloud.com/console/clusters) page of your project, click the name of your target cluster to go to its overview page.

Expand All @@ -38,7 +40,7 @@ For an existing TiDB Serverless free cluster, you can upgrade to Scalable Cluste
2. In the **Usage This Month** area, click **Upgrade to Scalable Cluster**.

If you want to increase the spending limit for a exsiting scalable cluster, click <svg width="14" height="14" viewBox="0 0 24 24" fill="none" xmlns="http://www.w3.org/2000/svg"><path d="M11 3.99998H6.8C5.11984 3.99998 4.27976 3.99998 3.63803 4.32696C3.07354 4.61458 2.6146 5.07353 2.32698 5.63801C2 6.27975 2 7.11983 2 8.79998V17.2C2 18.8801 2 19.7202 2.32698 20.362C2.6146 20.9264 3.07354 21.3854 3.63803 21.673C4.27976 22 5.11984 22 6.8 22H15.2C16.8802 22 17.7202 22 18.362 21.673C18.9265 21.3854 19.3854 20.9264 19.673 20.362C20 19.7202 20 18.8801 20 17.2V13M7.99997 16H9.67452C10.1637 16 10.4083 16 10.6385 15.9447C10.8425 15.8957 11.0376 15.8149 11.2166 15.7053C11.4184 15.5816 11.5914 15.4086 11.9373 15.0627L21.5 5.49998C22.3284 4.67156 22.3284 3.32841 21.5 2.49998C20.6716 1.67156 19.3284 1.67155 18.5 2.49998L8.93723 12.0627C8.59133 12.4086 8.41838 12.5816 8.29469 12.7834C8.18504 12.9624 8.10423 13.1574 8.05523 13.3615C7.99997 13.5917 7.99997 13.8363 7.99997 14.3255V16Z" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"></path></svg> **Edit**.
To adjust the spending limit for an existing scalable cluster, click <svg width="14" height="14" viewBox="0 0 24 24" fill="none" xmlns="http://www.w3.org/2000/svg"><path d="M11 3.99998H6.8C5.11984 3.99998 4.27976 3.99998 3.63803 4.32696C3.07354 4.61458 2.6146 5.07353 2.32698 5.63801C2 6.27975 2 7.11983 2 8.79998V17.2C2 18.8801 2 19.7202 2.32698 20.362C2.6146 20.9264 3.07354 21.3854 3.63803 21.673C4.27976 22 5.11984 22 6.8 22H15.2C16.8802 22 17.7202 22 18.362 21.673C18.9265 21.3854 19.3854 20.9264 19.673 20.362C20 19.7202 20 18.8801 20 17.2V13M7.99997 16H9.67452C10.1637 16 10.4083 16 10.6385 15.9447C10.8425 15.8957 11.0376 15.8149 11.2166 15.7053C11.4184 15.5816 11.5914 15.4086 11.9373 15.0627L21.5 5.49998C22.3284 4.67156 22.3284 3.32841 21.5 2.49998C20.6716 1.67156 19.3284 1.67155 18.5 2.49998L8.93723 12.0627C8.59133 12.4086 8.41838 12.5816 8.29469 12.7834C8.18504 12.9624 8.10423 13.1574 8.05523 13.3615C7.99997 13.5917 7.99997 13.8363 7.99997 14.3255V16Z" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"></path></svg> **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 Cluster Plan**.
35 changes: 18 additions & 17 deletions tidb-cloud/select-cluster-tier.md
Original file line number Diff line number Diff line change
Expand Up @@ -18,38 +18,39 @@ TiDB Cloud provides the following two options of cluster tiers. Before creating
<!--To be confirmed-->
TiDB Serverless is a fully managed, multi-tenant TiDB offering. It delivers an instant, autoscaling MySQL-compatible database and offers a generous free tier and consumption based billing once free limits are exceeded.

### Cluster Plan
### Cluster plan

At TiDB Serverless, we offer two distinct service plans designed to cater to the diverse needs of our users. Whether you're just getting started or scaling to meet the demands of growing applications, our service plans provide the flexibility and power you need.
TiDB Serverless offers two service plans to meet different user requirements. Whether you are just getting started or scaling to meet the increasing application demands, these service plans provide the flexibility and capability you need.

#### Free Cluster
The Free Cluster Plan is ideal for those who are getting started with TiDB Serverless. It's designed to provide developers and small teams with the essential features as following:
#### Free cluster plan

- **No Cost**: Absolutely free with no credit card required to start.
- **Storage**: Comes with 5GiB of initial storage capacity.
- **Request Units**: Includes 50 million request units for your database operations.
- **Easy Upgrade**: Seamlessly transition to the Scalable Cluster Plan as your needs grow.
The free cluster plan is ideal for those who are getting started with TiDB Serverless. It provides developers and small teams with the following essential features:

#### Scalable Cluster
- **No cost**: This plan is completely free, with no credit card required to get started.
- **Storage**: Provides an initial storage capacity of 5 GiB.
- **Request Units**: Includes 50 million [Request Units (RUs)](/tidb-cloud/tidb-cloud-glossary.md#request-unit) for database operations.
- **Easy upgrade**: Offers a smooth transition to the [scalable cluster plan](#scalable-cluster-plan) as your needs grow.

For applications with increasing workloads that require on-the-fly scalability, the Scalable Cluster Plan offers the agility and performance to keep pace with your business growth with the following features:
#### Scalable cluster plan

- **Enhanced Capabilities**: Includes all the capabilities of the Free Cluster Plan, plus the ability to handle larger, more demanding workloads, with more advanced security features.
- **Automatic Scaling**: Automatically adjusts storage and compute resources to efficiently handle varying workload demands.
- **Predictable Pricing**: While this plan requires a credit card, you pay only for the resources you consume, ensuring cost efficiency as you scale.
For applications experiencing growing workloads and needing scalability in real time, the scalable cluster plan provides the flexibility and performance to keep pace with your business growth with the following features:

- **Enhanced capabilities**: Includes all capabilities of the free cluster plan, along with the capacity to handle larger and more complex workloads, as well as advanced security features.
- **Automatic scaling**: Automatically adjusts storage and computing resources to efficiently meet changing workload demands.
- **Predictable pricing**: Although this plan requires a credit card, you are only charged for the resources you use, ensuring cost-effective scalability.

### Usage quota

For each organization in TiDB Cloud, you can create a maximum of five Free Clusters by default. To create more TiDB Serverless clusters, you need to add a credit card and create Scalable Clusters for the usage.
For each organization in TiDB Cloud, you can create a maximum of five [free clusters](#free-cluster-plan) by default. To create more TiDB Serverless clusters, you need to add a credit card and create [scalable clusters](#scalable-cluster-plan) for the usage.

For the first five TiDB Serverless clusters in your organization, no matter Free Cluster or Scalable Cluster, TiDB Cloud provides a free usage quota for each of them as follows:
For the first five TiDB Serverless clusters in your organization, whether they are free or scalable, TiDB Cloud provides a free usage quota for each of them as follows:

- Row-based storage: 5 GiB
- [Request Units (RUs)](/tidb-cloud/tidb-cloud-glossary.md#request-unit): 50 million RUs per month
- Request Units (RUs): 50 million RUs per month

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.

Once the usage quota of a cluster is reached, new connection attempts will be immediately denied until you [increase the quota](#update-spending-limit) or the usage is reset upon the start of a new month. For connections that were established prior to the throttling, there will be no change in behavior. For example, when the storage of a cluster exceeds 5 GiB for a free cluster, new connection attempts to the cluster will be directly restricted.
Once a cluster reaches its usage quota, it immediately denies any new connection attempts until you [increase the quota](/tidb-cloud/manage-serverless-spend-limit.md#update-spending-limit) or the usage is reset upon the start of a new month. Existing connections established before reaching the quota will not be affected. For example, when the storage of a cluster exceeds 5 GiB for a free cluster, the cluster automatically restricts any new connection attempts.

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](https://www.pingcap.com/tidb-cloud-serverless-pricing-details).

Expand Down
6 changes: 3 additions & 3 deletions tidb-cloud/serverless-limitations.md
Original file line number Diff line number Diff line change
Expand Up @@ -56,16 +56,16 @@ We are constantly filling in the feature gaps between TiDB Serverless and TiDB D

## Usage quota

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](/tidb-cloud/tidb-cloud-glossary.md#spending-limit) for the usage.
For each organization in TiDB Cloud, you can create a maximum of five [free clusters](/tidb-cloud/select-cluster-tier.md#free-cluster-plan) by default. To create more TiDB Serverless clusters, you need to add a credit card and create [scalable clusters](/tidb-cloud/select-cluster-tier.md#scalable-cluster-plan) for the usage.

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

- Row-based storage: 5 GiB
- [Request Units (RUs)](/tidb-cloud/tidb-cloud-glossary.md#request-unit): 50 million RUs per month

The Request Unit (RU) is a unit of measurement used to track the resource consumption of a query or transaction. It is a metric that allows you to estimate the computational resources required to process a specific request in the database. The request unit is also the billing unit for TiDB Cloud Serverless service.

Once the usage quota of a cluster is reached, new connection attempts will be immediately denied until you [increase the quota](#update-spending-limit) or the usage is reset upon the start of a new month. For connections that were established prior to the throttling, there will be no change in behavior.
Once a cluster reaches its usage quota, it immediately denies any new connection attempts until you [increase the quota](/tidb-cloud/manage-serverless-spend-limit.md#update-spending-limit) or the usage is reset upon the start of a new month. Existing connections established before reaching the quota will not be affected.

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](https://www.pingcap.com/tidb-cloud-serverless-pricing-details).

Expand Down
2 changes: 1 addition & 1 deletion tidb-cloud/tidb-cloud-quickstart.md
Original file line number Diff line number Diff line change
Expand Up @@ -30,7 +30,7 @@ Additionally, you can try out TiDB features on [TiDB Playground](https://play.ti
- To create a new TiDB Serverless cluster on your own, follow these steps:

1. Click **Create Cluster**.
2. On the **Create Cluster** page, **Serverless** is selected by default. Select the target region for your cluster, update the default cluster name if necessary, and then click **Create**. Your TiDB Serverless cluster will be created in approximately 30 seconds.
2. On the **Create Cluster** page, **Serverless** is selected by default. Select the target region for your cluster, update the default cluster name if necessary, select your [cluster plan](/tidb-cloud/select-cluster-tier.md#cluster-plan), and then click **Create**. Your TiDB Serverless cluster will be created in approximately 30 seconds.

## Step 2: Try AI-powered Chat2Query (beta)

Expand Down
10 changes: 10 additions & 0 deletions tidb-cloud/tidb-cloud-release-notes.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,6 +8,16 @@ aliases: ['/tidbcloud/supported-tidb-versions','/tidbcloud/release-notes']

This page lists the release notes of [TiDB Cloud](https://www.pingcap.com/tidb-cloud/) in 2024.

## April 2, 2024

**General changes**

- Introduce two service plans for [TiDB Serverless](/tidb-cloud/select-cluster-tier.md#tidb-serverless) clusters: **Free** and **Scalable**.

To meet different user requirements, TiDB Serverless offers the free and scalable service plans. Whether you are just getting started or scaling to meet the increasing application demands, these plans provide the flexibility and capability you need.

For more information, see [Cluster plan](/tidb-cloud/select-cluster-tier.md#cluster-plan).

## March 5, 2024

**General changes**
Expand Down

0 comments on commit b9e4702

Please sign in to comment.