diff --git a/TOC-tidb-cloud-premium.md b/TOC-tidb-cloud-premium.md index eab29bec45ee1..ed1c98569b2ab 100644 --- a/TOC-tidb-cloud-premium.md +++ b/TOC-tidb-cloud-premium.md @@ -222,6 +222,7 @@ - [`ANALYZE TABLE`](/sql-statements/sql-statement-analyze-table.md) - [`BATCH`](/sql-statements/sql-statement-batch.md) - [`BEGIN`](/sql-statements/sql-statement-begin.md) + - [`CANCEL DISTRIBUTION JOB`](/sql-statements/sql-statement-cancel-distribution-job.md) - [`CANCEL IMPORT JOB`](/sql-statements/sql-statement-cancel-import-job.md) - [`COMMIT`](/sql-statements/sql-statement-commit.md) - [`CREATE [GLOBAL|SESSION] BINDING`](/sql-statements/sql-statement-create-binding.md) @@ -237,6 +238,7 @@ - [`DELETE`](/sql-statements/sql-statement-delete.md) - [`DESC`](/sql-statements/sql-statement-desc.md) - [`DESCRIBE`](/sql-statements/sql-statement-describe.md) + - [`DISTRIBUTE TABLE`](/sql-statements/sql-statement-distribute-table.md) - [`DO`](/sql-statements/sql-statement-do.md) - [`DROP [GLOBAL|SESSION] BINDING`](/sql-statements/sql-statement-drop-binding.md) - [`DROP DATABASE`](/sql-statements/sql-statement-drop-database.md) @@ -291,6 +293,7 @@ - [`SHOW CREATE TABLE`](/sql-statements/sql-statement-show-create-table.md) - [`SHOW CREATE USER`](/sql-statements/sql-statement-show-create-user.md) - [`SHOW DATABASES`](/sql-statements/sql-statement-show-databases.md) + - [`SHOW DISTRIBUTION JOBS`](/sql-statements/sql-statement-show-distribution-jobs.md) - [`SHOW ENGINES`](/sql-statements/sql-statement-show-engines.md) - [`SHOW ERRORS`](/sql-statements/sql-statement-show-errors.md) - [`SHOW FIELDS FROM`](/sql-statements/sql-statement-show-fields-from.md) @@ -309,6 +312,7 @@ - [`SHOW STATS_META`](/sql-statements/sql-statement-show-stats-meta.md) - [`SHOW STATS_TOPN`](/sql-statements/sql-statement-show-stats-topn.md) - [`SHOW STATUS`](/sql-statements/sql-statement-show-status.md) + - [`SHOW TABLE DISTRIBUTION`](/sql-statements/sql-statement-show-table-distribution.md) - [`SHOW TABLE NEXT_ROW_ID`](/sql-statements/sql-statement-show-table-next-rowid.md) - [`SHOW TABLE STATUS`](/sql-statements/sql-statement-show-table-status.md) - [`SHOW TABLES`](/sql-statements/sql-statement-show-tables.md) @@ -463,6 +467,7 @@ - [Server Status Variables](/status-variables.md) - [Table Filter](/table-filter.md) - [URI Formats of External Storage Services](/external-storage-uri.md) + - [`ANALYZE` Embedded in DDL Statements](/ddl_embedded_analyze.md) - [Troubleshoot Inconsistency Between Data and Indexes](/troubleshoot-data-inconsistency-errors.md) - [Notifications](/tidb-cloud/notifications.md) - Support Plan diff --git a/TOC-tidb-cloud-releases.md b/TOC-tidb-cloud-releases.md index 0c1e2ce823e75..21d36c5b32070 100644 --- a/TOC-tidb-cloud-releases.md +++ b/TOC-tidb-cloud-releases.md @@ -3,7 +3,11 @@ # Table of Contents -## RELEASE NOTES +## OVERVIEW + +- [TiDB Cloud Release Overview](/tidb-cloud/releases/_index.md) + +## CLOUD PLATFORM RELEASE NOTES - [2026](/tidb-cloud/releases/tidb-cloud-release-notes.md) - [2025](/tidb-cloud/releases/release-notes-2025.md) @@ -14,6 +18,11 @@ - [2021](/tidb-cloud/releases/release-notes-2021.md) - [2020](/tidb-cloud/releases/release-notes-2020.md) +## TiDB X KERNEL RELEASE NOTES + +- [Kernel Versioning for TiDB Cloud Premium](/tidb-cloud/releases/tidb-cloud-kernel-versioning.md) +- [TiDB-X-CLOUD.202510.1 Release Notes](/tidb-cloud/releases/tidb-x-cloud.202510.1.md) + ## MAINTENANCE NOTIFICATIONS - [[2024-09-15] TiDB Cloud Console Maintenance Notification](/tidb-cloud/releases/notification-2024-09-15-console-maintenance.md) diff --git a/sql-statements/sql-statement-cancel-distribution-job.md b/sql-statements/sql-statement-cancel-distribution-job.md index a49b2ff19b7b2..7121e96eb2d61 100644 --- a/sql-statements/sql-statement-cancel-distribution-job.md +++ b/sql-statements/sql-statement-cancel-distribution-job.md @@ -7,14 +7,10 @@ summary: An overview of the usage of CANCEL DISTRIBUTION JOB in TiDB. The `CANCEL DISTRIBUTION JOB` statement is used to cancel a Region scheduling task created using the [`DISTRIBUTE TABLE`](/sql-statements/sql-statement-distribute-table.md) statement in TiDB. - - > **Note:** > > This feature is not available on [{{{ .starter }}}](https://docs.pingcap.com/tidbcloud/select-cluster-tier#starter) and [{{{ .essential }}}](https://docs.pingcap.com/tidbcloud/select-cluster-tier#essential) instances. - - ## Synopsis ```ebnf+diagram diff --git a/sql-statements/sql-statement-distribute-table.md b/sql-statements/sql-statement-distribute-table.md index f0555b01ddb2a..321280f883e76 100644 --- a/sql-statements/sql-statement-distribute-table.md +++ b/sql-statements/sql-statement-distribute-table.md @@ -9,14 +9,10 @@ summary: An overview of the usage of DISTRIBUTE TABLE for the TiDB database. > > This feature is experimental. It is not recommended that you use it in the production environment. This feature might be changed or removed without prior notice. If you find a bug, you can report an [issue](https://github.com/pingcap/tidb/issues) on GitHub. - - > **Note:** > > This feature is not available on [{{{ .starter }}}](https://docs.pingcap.com/tidbcloud/select-cluster-tier#starter) and [{{{ .essential }}}](https://docs.pingcap.com/tidbcloud/select-cluster-tier#essential) instances. - - The `DISTRIBUTE TABLE` statement redistributes and reschedules Regions of a specified table to achieve a balanced distribution at the table level. Executing this statement helps prevent Regions from being concentrated on a few TiFlash or TiKV nodes, addressing the issue of uneven region distribution in the table. ## Synopsis diff --git a/sql-statements/sql-statement-show-distribution-jobs.md b/sql-statements/sql-statement-show-distribution-jobs.md index 85850ba9aef98..71a678aaccc5f 100644 --- a/sql-statements/sql-statement-show-distribution-jobs.md +++ b/sql-statements/sql-statement-show-distribution-jobs.md @@ -7,14 +7,10 @@ summary: An overview of the usage of SHOW DISTRIBUTION JOBS for the TiDB databas The `SHOW DISTRIBUTION JOBS` statement shows all current Region distribution jobs. - - > **Note:** > > This feature is not available on [{{{ .starter }}}](https://docs.pingcap.com/tidbcloud/select-cluster-tier#starter) and [{{{ .essential }}}](https://docs.pingcap.com/tidbcloud/select-cluster-tier#essential) instances. - - ## Synopsis ```ebnf+diagram diff --git a/sql-statements/sql-statement-show-table-distribution.md b/sql-statements/sql-statement-show-table-distribution.md index 81287a85c4da9..30cbc0efa1375 100644 --- a/sql-statements/sql-statement-show-table-distribution.md +++ b/sql-statements/sql-statement-show-table-distribution.md @@ -7,14 +7,10 @@ summary: An overview of the usage of SHOW TABLE DISTRIBUTION for the TiDB databa The `SHOW TABLE DISTRIBUTION` statement shows the Region distribution information for a specified table. - - > **Note:** > > This feature is not available on [{{{ .starter }}}](https://docs.pingcap.com/tidbcloud/select-cluster-tier#starter) and [{{{ .essential }}}](https://docs.pingcap.com/tidbcloud/select-cluster-tier#essential) instances. - - ## Synopsis ```ebnf+diagram diff --git a/tidb-cloud/releases/_index.md b/tidb-cloud/releases/_index.md index 8aa2b1df1a0af..987c79bf6a39c 100644 --- a/tidb-cloud/releases/_index.md +++ b/tidb-cloud/releases/_index.md @@ -1,16 +1,35 @@ --- title: TiDB Cloud Releases -summary: Learn about TiDB Cloud release notes and maintenance notifications. +summary: Learn about TiDB Cloud release notes, kernel versioning, and maintenance notifications. --- # TiDB Cloud Releases -[TiDB Cloud](https://www.pingcap.com/tidb/cloud/) is a fully managed Database-as-a-Service (DBaaS) that brings [TiDB](https://docs.pingcap.com/tidb/stable/overview), an open-source Hybrid Transactional and Analytical Processing (HTAP) database, to your cloud. TiDB Cloud offers an easy way to deploy and manage databases to let you focus on your applications, not the complexities of databases. This document provides an overview of TiDB Cloud release notes and maintenance notifications. +[TiDB Cloud](https://www.pingcap.com/tidb/cloud/) is a fully managed Database-as-a-Service (DBaaS) that brings [TiDB](https://docs.pingcap.com/tidb/stable/overview), an open-source Hybrid Transactional and Analytical Processing (HTAP) database, to your cloud. -## Release notes +TiDB Cloud offers two types of releases: [cloud platform releases](#cloud-platform-release-notes) and [database kernel releases](#database-kernel-release-notes). They follow independent release cycles and are documented separately. -TiDB Cloud release notes provide information about new features and improvements in each release. For detailed release notes, see [TiDB Cloud Release Notes](/tidb-cloud/releases/tidb-cloud-release-notes.md). +## Cloud platform release notes + +Cloud platform releases cover the TiDB Cloud console, APIs, and control plane, including new plan features, UI changes, integrations, and operational improvements across all TiDB Cloud plans. + +- [TiDB Cloud Release Notes](/tidb-cloud/releases/tidb-cloud-release-notes.md) + +## Database kernel release notes + +The database kernel is the core engine that processes your SQL queries and manages your data. Depending on your TiDB Cloud plan, your resources run on different kernels, each with its own release cadence. + +| Plan | Kernel information and release notes | +| --- | --- | +| TiDB Cloud **Starter** | Running on a customized [TiDB X](/tidb-cloud/tidb-x-architecture.md) engine based on the classic [TiDB v8.5.3](/releases/release-8.5.3.md) kernel. | +| TiDB Cloud **Essential** | Running on a customized [TiDB X](/tidb-cloud/tidb-x-architecture.md) engine based on the classic [TiDB v8.5.3](/releases/release-8.5.3.md) kernel by default. | +| TiDB Cloud **Premium** | Running on the [`TiDB-X-CLOUD.202510.1`](/tidb-cloud/releases/tidb-x-cloud.202510.1.md) version of the [TiDB X](/tidb-cloud/tidb-x-architecture.md) kernel. | +| TiDB Cloud **Dedicated** | Running on the classic TiDB kernel, and the kernel version corresponds directly to TiDB Self-Managed versions. Currently, the default TiDB version of newly created TiDB Cloud Dedicated clusters is [v8.5.7](/releases/release-8.5.7.md). | + +> **Note:** +> +> If you want your TiDB Cloud Essential instances to run on the same kernel as TiDB Cloud Premium, contact [TiDB Cloud Support](https://docs.pingcap.com/tidbcloud/tidb-cloud-support). ## Maintenance notifications -TiDB Cloud maintenance notifications provide information about scheduled maintenance activities that might affect your TiDB Cloud services. +TiDB Cloud maintenance notifications provide information about scheduled maintenance activities that might affect your TiDB Cloud services. For the list of notifications, see the navigation pane on the left. diff --git a/tidb-cloud/releases/tidb-cloud-kernel-versioning.md b/tidb-cloud/releases/tidb-cloud-kernel-versioning.md new file mode 100644 index 0000000000000..dba27bfedd1cc --- /dev/null +++ b/tidb-cloud/releases/tidb-cloud-kernel-versioning.md @@ -0,0 +1,56 @@ +--- +title: Kernel Versioning for TiDB Cloud Premium +summary: Learn about the kernel versioning rules and format for TiDB Cloud Premium. +--- + +# Kernel Versioning for TiDB Cloud Premium + +This document describes the versioning rules for the underlying database kernel used by TiDB Cloud Premium. + +> **Note:** +> +> The kernel versioning rules described in this document apply only to TiDB Cloud Premium. Other TiDB Cloud plans use different kernel versioning models: +> +> - TiDB Cloud Starter instances run on a customized TiDB X engine based on the classic TiDB v8.5.3 kernel. This kernel differs slightly from the TiDB Cloud Premium kernel. +> - TiDB Cloud Essential instances run on a customized TiDB X engine based on the classic TiDB v8.5.3 kernel by default. If you want your TiDB Cloud Essential instances to run on the same kernel as TiDB Cloud Premium, contact [TiDB Cloud Support](https://docs.pingcap.com/tidbcloud/tidb-cloud-support). +> - TiDB Cloud Dedicated clusters run on the classic TiDB kernel, and their kernel versions correspond directly to TiDB Self-Managed versions. + +## Kernel versioning + +TiDB Cloud Premium kernel versions use the following time-based format: + +```text +TiDB-X-CLOUD.YYYYMM.x +``` + +For example: + +```text +TiDB-X-CLOUD.202510.1 +``` + +Where: + +- `YYYYMM` indicates the baseline code branch used to develop the kernel. For example, `202510` means that the baseline branch was created in October 2025. It does not indicate when the kernel version was released. +- `x` indicates the patch release number for that baseline branch. + +For example, `TiDB-X-CLOUD.202510.1` indicates that the kernel is based on a branch created in October 2025 and is the first patch release built from that branch. + +Because kernel development and release schedules are independent, a kernel version might be released several months after its baseline branch is created. + +Because TiDB Cloud Premium follows its own kernel release cadence, [TiDB Cloud Premium release notes](/tidb-cloud/releases/tidb-x-cloud.202510.1.md) are published separately from [TiDB Self-Managed release notes](https://docs.pingcap.com/releases/tidb-self-managed/). + +## FAQ + +### How do I check the kernel version of my TiDB Cloud Premium instance? + +1. In the [TiDB Cloud console](https://tidbcloud.com/), navigate to the **My TiDB** page, and then click the name of your TiDB Cloud Premium instance to go to its overview page. +2. On the overview page, locate the **TiDB version** information in the details pane of your TiDB Cloud Premium instance. + +### Can I choose the kernel version for my TiDB Cloud Premium instance? + +No. TiDB Cloud manages the entire kernel lifecycle for TiDB Cloud Premium. + +Although the kernel version is displayed for transparency, you cannot select a specific version when creating a TiDB Cloud Premium instance. + +TiDB Cloud automatically provides validated kernel versions for new deployments and performs managed upgrades when appropriate. This helps ensure security, stability, compatibility, and access to the latest features and improvements without requiring manual maintenance. \ No newline at end of file diff --git a/tidb-cloud/releases/tidb-x-cloud.202510.1.md b/tidb-cloud/releases/tidb-x-cloud.202510.1.md new file mode 100644 index 0000000000000..c0b6289ab2d20 --- /dev/null +++ b/tidb-cloud/releases/tidb-x-cloud.202510.1.md @@ -0,0 +1,69 @@ +--- +title: TiDB-X-CLOUD.202510.1 Release Notes +summary: Learn about the features for the TiDB-X-CLOUD.202510.1 kernel. +--- + +# TiDB-X-CLOUD.202510.1 Release Notes + +Release date: April 28, 2026 + +Applicable TiDB Cloud plan: {{{ .premium }}} + +TiDB X kernel version: `TiDB-X-CLOUD.202510.1` + +{{{ .premium }}} is available in public preview starting April 28, 2026, using the `TiDB-X-CLOUD.202510.1` kernel. + +In `TiDB-X-CLOUD.202510.1`: + +- `202510` indicates that the baseline code branch of this kernel version was created in October 2025, which is different from the release date. +- `1` indicates that it is the first patch release built from the `TiDB-X-CLOUD.202510` baseline branch. + +The `TiDB-X-CLOUD.202510.1` kernel is based on the [TiDB v8.5.0](/releases/release-8.5.0.md) kernel and includes most of the features and improvements introduced in TiDB v8.5.0. + +In addition, compared with the [TiDB v8.5.0](/releases/release-8.5.0.md) kernel, the `TiDB-X-CLOUD.202510.1` kernel introduces the following features: + +## New TiDB X architecture + +* Introduce the TiDB X architecture, which is a cloud-native shared-storage architecture that makes cloud-native object storage the backbone of TiDB. + + This architecture enables elastic scalability, predictable performance, and optimized total cost of ownership (TCO) for AI-era workloads. + + TiDB X represents a fundamental evolution from the shared-nothing architecture of [classic TiDB](/tidb-architecture.md) to a cloud-native shared-storage architecture. By transitioning from a shared-nothing to a shared-storage architecture, TiDB X addresses the physical limitations of coupled nodes to achieve the following technical objectives: + + - **Accelerated scaling**: Improving scaling performance by up to 10x by eliminating the need for physical data migration. + - **Task isolation**: Ensuring zero interference between background maintenance tasks (such as compaction) and online transactional traffic. + - **Resource elasticity**: Implementing a true "pay-as-you-go" model where compute resources scale independently of storage volume. + + For more information, see [TiDB X Architecture](/tidb-cloud/tidb-x-architecture.md). + +## Performance features + +* Support redistributing data of a specific table (experimental) [#63260](https://github.com/pingcap/tidb/issues/63260) @[bufferflies](https://github.com/bufferflies) + + PD automatically schedules data to be distributed as evenly as possible across all TiKV nodes in a cluster. However, this automatic scheduling focuses on the cluster as a whole. In some cases, even if the cluster-wide data distribution is balanced, the data of a specific table might still be unevenly distributed across TiKV nodes. + + Now you can use the [`SHOW TABLE DISTRIBUTION`](https://docs.pingcap.com/tidb/v8.5/sql-statement-show-table-distribution/) statement to check how the data of a specific table is distributed across all TiKV nodes. If the data distribution is unbalanced, you can use the [`DISTRIBUTE TABLE`](https://docs.pingcap.com/tidb/v8.5/sql-statement-distribute-table) statement to redistribute the table's data (experimental) to improve load balancing. + + Note that redistributing the data of a specific table is a one-time task with a timeout limit. If the distribution task is not completed before the timeout, it will automatically exit. + + For more information, see [documentation](https://docs.pingcap.com/tidb/v8.5/sql-statement-distribute-table). + +* Support `ANALYZE` embedded in DDL statements [#57948](https://github.com/pingcap/tidb/issues/57948) @[terry1purcell](https://github.com/terry1purcell) @[AilinKid](https://github.com/AilinKid) + + This feature applies to the following types of DDL statements: + + - DDL statements that create new indexes: [`ADD INDEX`](/sql-statements/sql-statement-add-index.md) + - DDL statements that reorganize existing indexes: [`MODIFY COLUMN`](/sql-statements/sql-statement-modify-column.md) and [`CHANGE COLUMN`](/sql-statements/sql-statement-change-column.md) + + When you enable this feature, TiDB automatically runs an `ANALYZE` (statistics collection) operation before the new or reorganized index becomes visible to users. This prevents inaccurate optimizer estimates and potential plan changes caused by temporarily unavailable statistics after index creation or reorganization. + + For more information, see [documentation](https://docs.pingcap.com/tidb/v8.5/ddl_embedded_analyze). + +## Limitations + +Because of the architectural differences between TiDB X and classic TiDB, the TiDB X kernel does not support the following storage features of the classic TiDB kernel: + +- [TiKV MVCC In-Memory Engine (IME)](/tikv-in-memory-engine.md) +- [Follower Read](/follower-read.md) + +To learn more about the limitations, see [Limited SQL features on TiDB X Instances](/tidb-cloud/limited-sql-features-tidb-x.md). \ No newline at end of file