Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Binary file modified media/tidb-cloud/regional-high-avaliability-alibaba-cloud.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified media/tidb-cloud/regional-high-avaliability-aws.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
8 changes: 1 addition & 7 deletions tidb-cloud/architecture-concepts.md
Original file line number Diff line number Diff line change
Expand Up @@ -53,15 +53,9 @@ For applications experiencing growing workloads and needing scalability in real

- **Enhanced capabilities**: includes all capabilities of the Starter 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.
- **High availability**: built-in fault tolerance and redundancy ensure your applications remain available and resilient, even during infrastructure failures.
- **Predictable pricing**: billed based on storage and Request Capacity Units (RCUs) of the compute resources, offering transparent, usage-based pricing that scales with your needs, so you only pay for what you use without surprises.

{{{ .essential }}} offers two types of high availability to address varying operational requirements.

- Zonal High Availability: places all components within the same availability zone, which results in lower network latency.
- Regional High Availability: distributes nodes across multiple availability zones, providing maximum infrastructure isolation and redundancy.

For more information, see [High Availability in TiDB Cloud](/tidb-cloud/serverless-high-availability.md).
{{{ .essential }}} offers Zonal High Availability: places all components within the same availability zone, which results in lower network latency. For more information, see [High Availability in TiDB Cloud](/tidb-cloud/serverless-high-availability.md).
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

low

The phrase "offers Zonal High Availability: places all components..." is grammatically awkward. Additionally, "zonal high availability" should be in lowercase to maintain consistency with other parts of the documentation. Let's rephrase it for better clarity and flow.

Suggested change
{{{ .essential }}} offers Zonal High Availability: places all components within the same availability zone, which results in lower network latency. For more information, see [High Availability in TiDB Cloud](/tidb-cloud/serverless-high-availability.md).
{{{ .essential }}} offers zonal high availability, which places all components within the same availability zone to reduce network latency. For more information, see [High Availability in TiDB Cloud](/tidb-cloud/serverless-high-availability.md).
References
  1. Use consistent terminology and lowercase for 'zonal high availability' as seen in other parts of the documentation. (link)


## {{{ .premium }}}

Expand Down
2 changes: 1 addition & 1 deletion tidb-cloud/features.md
Original file line number Diff line number Diff line change
Expand Up @@ -253,7 +253,7 @@ This document lists the feature support status for different TiDB Cloud plans, i
<td rowspan="1" style="background-color: white;">High availability</td>
<td>Cross-AZ failover</td>
<td style="text-align:center; font-size: 14px;">❌</td>
<td style="text-align:center;"></td>
<td style="text-align:center;"></td>
<td style="text-align:center;">✅</td>
<td style="text-align:center;">✅</td>
</tr>
Expand Down
4 changes: 2 additions & 2 deletions tidb-cloud/serverless-high-availability.md
Original file line number Diff line number Diff line change
Expand Up @@ -22,7 +22,7 @@ TiDB Cloud extends these capabilities with zonal high availability and regional
>
> - For {{{ .starter }}} instances, only zonal high availability is enabled, and it is not configurable.
> - For {{{ .premium }}} instances, only regional high availability is enabled and is not configurable.
> - For {{{ .essential }}} instances hosted in the AWS Tokyo (ap-northeast-1) region or any Alibaba Cloud region, regional high availability is enabled by default. You can change it to zonal high availability as needed during {{{ .essential }}} instance creation. For {{{ .essential }}} instances hosted in other regions, only zonal high availability is enabled, and it is not configurable.
> - For {{{ .essential }}} instances, only zonal high availability is enabled, and it is not configurable.

- **Zonal high availability**: This option places all nodes within a single availability zone, reducing network latency. It ensures high availability without requiring application-level redundancy across zones, making it suitable for applications that prioritize low latency within a single zone. For more information, see [Zonal high availability architecture](#zonal-high-availability-architecture).

Expand Down Expand Up @@ -86,7 +86,7 @@ The gateway and computing layers are stateless, so failover involves restarting

## Regional high availability architecture

When you create a {{{ .essential }}} or {{{ .premium }}} instance with regional high availability, critical OLTP (Online Transactional Processing) workload components, such as PD and TiKV, are deployed across multiple availability zones to ensure redundant replication and maximizing availability. During normal operations, components like Gateway, TiDB, and TiFlash compute/write nodes are hosted in the primary availability zone. These components in data plane offer infrastructure redundancy through virtual machine pools, which minimizes failover time and network latency due to colocation.
When you create a {{{ .premium }}} instance with regional high availability, critical OLTP (Online Transactional Processing) workload components, such as PD and TiKV, are deployed across multiple availability zones to ensure redundant replication and maximizing availability. During normal operations, components like Gateway, TiDB, and TiFlash compute/write nodes are hosted in the primary availability zone. These components in data plane offer infrastructure redundancy through virtual machine pools, which minimizes failover time and network latency due to colocation.
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

low

Improve grammatical parallelism ("to ensure... and maximize...") and add the missing article ("in the data plane").

Suggested change
When you create a {{{ .premium }}} instance with regional high availability, critical OLTP (Online Transactional Processing) workload components, such as PD and TiKV, are deployed across multiple availability zones to ensure redundant replication and maximizing availability. During normal operations, components like Gateway, TiDB, and TiFlash compute/write nodes are hosted in the primary availability zone. These components in data plane offer infrastructure redundancy through virtual machine pools, which minimizes failover time and network latency due to colocation.
When you create a {{{ .premium }}} instance with regional high availability, critical OLTP (Online Transactional Processing) workload components, such as PD and TiKV, are deployed across multiple availability zones to ensure redundant replication and maximize availability. During normal operations, components like Gateway, TiDB, and TiFlash compute/write nodes are hosted in the primary availability zone. These components in the data plane offer infrastructure redundancy through virtual machine pools, which minimizes failover time and network latency due to colocation.


> **Note:**
>
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -48,7 +48,7 @@ The Amazon RDS instance must meet the following requirements:

> **Note**
>
> To connect to a cross-region RDS instance, contact [TiDB Cloud Support](/tidb-cloud/tidb-cloud-support.md).
> Private Link currently does not support cross-region connectivity. For cross-region connections, it is recommended to use VPC peering to establish a link (TiDB Cloud Premium only feature).
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

low

According to the style guide, we should write in the second person ("you") and avoid passive phrasing like "it is recommended to use". Let's rephrase this to be more direct.

Suggested change
> Private Link currently does not support cross-region connectivity. For cross-region connections, it is recommended to use VPC peering to establish a link (TiDB Cloud Premium only feature).
> Private Link currently does not support cross-region connectivity. For cross-region connections, use VPC peering to establish a connection (available only for TiDB Cloud Premium).
References
  1. Write in second person ('you') and avoid passive/indirect phrasing like 'it is recommended to'. (link)


## Step 2. Expose the Amazon RDS instance as an endpoint service

Expand Down