diff --git a/TOC-tidb-cloud-essential.md b/TOC-tidb-cloud-essential.md index 57aeabfcc24b5..6e27f0b50d550 100644 --- a/TOC-tidb-cloud-essential.md +++ b/TOC-tidb-cloud-essential.md @@ -53,7 +53,7 @@ - 监控和告警 - [概览](/tidb-cloud/monitor-tidb-cluster.md) - [内置指标](/tidb-cloud/built-in-monitoring.md) - - [Top RU](/tidb-cloud/top-ru.md) + - [Top RU](/tidb-cloud/top-ru.md) ![PREVIEW](/media/tidb-cloud/blank_transparent_placeholder.png) - [内置告警](/tidb-cloud/monitor-built-in-alerting.md) - [将 TiDB Cloud 与 Prometheus 和 Grafana 集成](/tidb-cloud/prometheus-grafana-integration.md) - 订阅告警通知 diff --git a/TOC-tidb-cloud-premium.md b/TOC-tidb-cloud-premium.md index 238bdfcc95be9..a4e9716ba84e1 100644 --- a/TOC-tidb-cloud-premium.md +++ b/TOC-tidb-cloud-premium.md @@ -52,7 +52,7 @@ - 监控和告警 - [概览](/tidb-cloud/monitor-tidb-cluster.md) - [内置指标](/tidb-cloud/premium/built-in-monitoring-premium.md) - - [Top RU](/tidb-cloud/top-ru.md) + - [Top RU](/tidb-cloud/top-ru.md) ![PREVIEW](/media/tidb-cloud/blank_transparent_placeholder.png) - [内置告警](/tidb-cloud/monitor-built-in-alerting.md) - [将 TiDB Cloud 与 Prometheus 和 Grafana 集成](/tidb-cloud/prometheus-grafana-integration.md) - 订阅告警通知 @@ -224,6 +224,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) @@ -239,6 +240,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) @@ -293,6 +295,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) @@ -311,6 +314,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) @@ -465,6 +469,7 @@ - [服务器状态变量](/status-variables.md) - [表库过滤](/table-filter.md) - [外部存储服务的 URI 格式](/external-storage-uri.md) + - [内嵌于 DDL 的 Analyze](/ddl_embedded_analyze.md) - [数据索引不一致报错](/troubleshoot-data-inconsistency-errors.md) - [通知](/tidb-cloud/notifications.md) - 支持计划 diff --git a/TOC-tidb-cloud-releases.md b/TOC-tidb-cloud-releases.md index c094ae3940e0e..fe280ec4bee87 100644 --- a/TOC-tidb-cloud-releases.md +++ b/TOC-tidb-cloud-releases.md @@ -3,24 +3,34 @@ # 目录 -## 发布记录 +## 概述 + +- [TiDB Cloud 发布概览](/tidb-cloud/releases/_index.md) + +## 云平台发布说明 - [2026](/tidb-cloud/releases/tidb-cloud-release-notes.md) - [2025](/tidb-cloud/releases/release-notes-2025.md) -- [2024](/tidb-cloud/releases/release-notes-2024.md) - 早期发布记录 + - [2024](/tidb-cloud/releases/release-notes-2024.md) - [2023](/tidb-cloud/releases/release-notes-2023.md) - [2022](/tidb-cloud/releases/release-notes-2022.md) - [2021](/tidb-cloud/releases/release-notes-2021.md) - [2020](/tidb-cloud/releases/release-notes-2020.md) +## TiDB X 内核发布说明 + +- [TiDB Cloud Premium 的内核版本管理](/tidb-cloud/releases/tidb-cloud-kernel-versioning.md) +- [TiDB-X-CLOUD.202510.1 发布说明](/tidb-cloud/releases/tidb-x-cloud.202510.1.md) + ## 维护通知 - [[2024-09-15] TiDB Cloud 控制台维护通知](/tidb-cloud/releases/notification-2024-09-15-console-maintenance.md) - [[2024-04-18] TiDB Cloud 数据迁移 (DM) 功能维护通知](/tidb-cloud/releases/notification-2024-04-18-dm-feature-maintenance.md) -- [[2024-04-16] TiDB Cloud 监控功能维护通知](/tidb-cloud/releases/notification-2024-04-16-monitoring-features-maintenance.md) -- [[2024-04-11] TiDB Cloud 数据迁移 (DM) 功能维护通知](/tidb-cloud/releases/notification-2024-04-11-dm-feature-maintenance.md) -- [[2024-04-09] TiDB Cloud 监控功能维护通知](/tidb-cloud/releases/notification-2024-04-09-monitoring-features-maintenance.md) -- [[2023-11-14] TiDB Cloud Dedicated Scale 功能维护通知](/tidb-cloud/releases/notification-2023-11-14-scale-feature-maintenance.md) -- [[2023-09-26] TiDB Cloud 控制台维护通知](/tidb-cloud/releases/notification-2023-09-26-console-maintenance.md) -- [[2023-08-31] TiDB Cloud 控制台维护通知](/tidb-cloud/releases/notification-2023-08-31-console-maintenance.md) +- 早期维护通知 + - [[2024-04-16] TiDB Cloud 监控功能维护通知](/tidb-cloud/releases/notification-2024-04-16-monitoring-features-maintenance.md) + - [[2024-04-11] TiDB Cloud 数据迁移 (DM) 功能维护通知](/tidb-cloud/releases/notification-2024-04-11-dm-feature-maintenance.md) + - [[2024-04-09] TiDB Cloud 监控功能维护通知](/tidb-cloud/releases/notification-2024-04-09-monitoring-features-maintenance.md) + - [[2023-11-14] TiDB Cloud Dedicated Scale 功能维护通知](/tidb-cloud/releases/notification-2023-11-14-scale-feature-maintenance.md) + - [[2023-09-26] TiDB Cloud 控制台维护通知](/tidb-cloud/releases/notification-2023-09-26-console-maintenance.md) + - [[2023-08-31] TiDB Cloud 控制台维护通知](/tidb-cloud/releases/notification-2023-08-31-console-maintenance.md) diff --git a/index-advisor.md b/index-advisor.md index 5aa246dc526d6..565375951c333 100644 --- a/index-advisor.md +++ b/index-advisor.md @@ -192,13 +192,13 @@ WHERE last_access_time IS NOT NULL AND percentage_access_0 + percentage_access_0 ## 假设索引 -假设索引（Hypothetical Indexes，Hypo Indexes）是通过 SQL 注释（类似于 [查询提示](/optimizer-hints.md)）而非 `CREATE INDEX` 语句创建的。这种方式可以让你在无需物理落地索引的情况下，轻量级地进行索引实验。 +在 `EXPLAIN` 语句中，你可以使用 `/*+ HYPO_INDEX(...) */` SQL 注释语法来定义一个供查询优化器考虑的假设索引。这种方式可以让你在无需物理落地索引的情况下，轻量级地进行索引实验。 -例如，`/*+ HYPO_INDEX(t, idx_ab, a, b) */` 注释会指示查询优化器为表 `t` 的 `a`、`b` 列创建名为 `idx_ab` 的假设索引。优化器会生成该索引的元数据，但不会实际创建物理索引。如果适用，优化器会在查询优化阶段考虑该假设索引，而不会产生索引创建的相关开销。 +例如，`/*+ HYPO_INDEX(t, idx_ab, a, b) */` 注释会指示查询优化器为表 `t` 的 `a`、`b` 列创建名为 `idx_ab` 的假设索引。优化器会生成该索引的元信息，但不会实际创建物理索引。如果适用，优化器会在查询优化阶段考虑该假设索引，而不会产生索引创建的相关开销。 `RECOMMEND INDEX` Advisor 会利用假设索引进行 “What-If” 分析，评估不同索引的潜在收益。你也可以直接使用假设索引，在正式创建索引前进行设计实验。 -以下示例展示了如何在查询中使用假设索引： +以下示例展示了如何在 `EXPLAIN` 语句中使用假设索引： ```sql CREATE TABLE t(a INT, b INT, c INT); diff --git a/latest_translation_commit.json b/latest_translation_commit.json index 43234f5832648..0d77f56522995 100644 --- a/latest_translation_commit.json +++ b/latest_translation_commit.json @@ -1,4 +1,4 @@ { "target": "release-8.5", - "sha": "990bdd74e418faa003ee9611c9402858a0a3d0b2" + "sha": "b6f7f75a70c32ead3841d9636a62c0749c211fc4" } diff --git a/sql-statements/sql-statement-cancel-distribution-job.md b/sql-statements/sql-statement-cancel-distribution-job.md index d46de578e088c..d5f4501739266 100644 --- a/sql-statements/sql-statement-cancel-distribution-job.md +++ b/sql-statements/sql-statement-cancel-distribution-job.md @@ -7,14 +7,10 @@ summary: TiDB 中 CANCEL DISTRIBUTION JOB 的用法概述。 `CANCEL DISTRIBUTION JOB` 语句用于取消通过 [`DISTRIBUTE TABLE`](/sql-statements/sql-statement-distribute-table.md) 语句在 TiDB 中创建的 Region 调度任务。 - - > **Note:** > > 该功能在 [{{{ .starter }}}](https://docs.pingcap.com/tidbcloud/select-cluster-tier#starter) 和 [{{{ .essential }}}](https://docs.pingcap.com/tidbcloud/select-cluster-tier#essential) 实例中不可用。 - - ## 语法 ```ebnf+diagram @@ -43,4 +39,4 @@ Query OK, 0 rows affected (0.01 sec) ## 参考 * [`DISTRIBUTE TABLE`](/sql-statements/sql-statement-distribute-table.md) -* [`SHOW DISTRIBUTION JOBS`](/sql-statements/sql-statement-show-distribution-jobs.md) +* [`SHOW DISTRIBUTION JOBS`](/sql-statements/sql-statement-show-distribution-jobs.md) \ No newline at end of file diff --git a/sql-statements/sql-statement-distribute-table.md b/sql-statements/sql-statement-distribute-table.md index 74b6ee0998b70..ecc91641d1f80 100644 --- a/sql-statements/sql-statement-distribute-table.md +++ b/sql-statements/sql-statement-distribute-table.md @@ -9,14 +9,10 @@ summary: TiDB 数据库中 DISTRIBUTE TABLE 的用法概述。 > > 该功能为实验性功能。不建议在生产环境中使用。该功能可能会在没有提前通知的情况下更改或移除。如果你发现了 bug，可以在 GitHub 上提交一个 [issue](https://github.com/pingcap/tidb/issues)。 - - > **Note:** > > 该功能在 [{{{ .starter }}}](https://docs.pingcap.com/tidbcloud/select-cluster-tier#starter) 和 [{{{ .essential }}}](https://docs.pingcap.com/tidbcloud/select-cluster-tier#essential) 实例中不可用。 - - `DISTRIBUTE TABLE` 语句会重新分布并重新调度指定表的 Region，以实现表级别的均衡分布。执行该语句有助于防止 Region 集中在少数 TiFlash 或 TiKV 节点上，从而解决表内 Region 分布不均的问题。 ## 语法 @@ -125,4 +121,4 @@ DISTRIBUTE TABLE t4 PARTITION (p1, p2) RULE = "learner-scatter" ENGINE="tiflash" - [`SHOW DISTRIBUTION JOBS`](/sql-statements/sql-statement-show-distribution-jobs.md) - [`SHOW TABLE DISTRIBUTION`](/sql-statements/sql-statement-show-table-distribution.md) - [`SHOW TABLE REGIONS`](/sql-statements/sql-statement-show-table-regions.md) -- [`CANCEL DISTRIBUTION JOB`](/sql-statements/sql-statement-cancel-distribution-job.md) +- [`CANCEL DISTRIBUTION JOB`](/sql-statements/sql-statement-cancel-distribution-job.md) \ No newline at end of file diff --git a/sql-statements/sql-statement-show-distribution-jobs.md b/sql-statements/sql-statement-show-distribution-jobs.md index 73fdf9dde2386..97bef34a82d66 100644 --- a/sql-statements/sql-statement-show-distribution-jobs.md +++ b/sql-statements/sql-statement-show-distribution-jobs.md @@ -7,14 +7,10 @@ summary: SHOW DISTRIBUTION JOBS 在 TiDB 数据库中的用法概述。 `SHOW DISTRIBUTION JOBS` 语句用于显示当前所有的 Region 分布作业。 - - > **Note:** > > 此功能在 [TiDB Cloud Starter](https://docs.pingcap.com/tidbcloud/select-cluster-tier#starter) 和 [TiDB Cloud Essential](https://docs.pingcap.com/tidbcloud/select-cluster-tier#essential) 实例中不可用。 - - ## 语法 ```ebnf+diagram @@ -48,4 +44,4 @@ SHOW DISTRIBUTION JOBS; - [`DISTRIBUTE TABLE`](/sql-statements/sql-statement-distribute-table.md) - [`SHOW TABLE DISTRIBUTION`](/sql-statements/sql-statement-show-table-distribution.md) -- [`CANCEL DISTRIBUTION JOB`](/sql-statements/sql-statement-cancel-distribution-job.md) +- [`CANCEL DISTRIBUTION JOB`](/sql-statements/sql-statement-cancel-distribution-job.md) \ No newline at end of file diff --git a/sql-statements/sql-statement-show-table-distribution.md b/sql-statements/sql-statement-show-table-distribution.md index 1ebe41b48fed7..2b86a7e1f9059 100644 --- a/sql-statements/sql-statement-show-table-distribution.md +++ b/sql-statements/sql-statement-show-table-distribution.md @@ -7,14 +7,10 @@ summary: TiDB 数据库中 SHOW TABLE DISTRIBUTION 的用法概述。 `SHOW TABLE DISTRIBUTION` 语句用于显示指定表的 Region 分布信息。 - - > **Note:** > > 此功能不适用于 [TiDB Cloud Starter](https://docs.pingcap.com/tidbcloud/select-cluster-tier#starter) 和 [TiDB Cloud Essential](https://docs.pingcap.com/tidbcloud/select-cluster-tier#essential) 实例。 - - ## 语法 ```ebnf+diagram @@ -66,4 +62,4 @@ SHOW TABLE t DISTRIBUTIONS; - [`DISTRIBUTE TABLE`](/sql-statements/sql-statement-distribute-table.md) - [`SHOW DISTRIBUTION JOBS`](/sql-statements/sql-statement-show-distribution-jobs.md) -- [`CANCEL DISTRIBUTION JOB`](/sql-statements/sql-statement-cancel-distribution-job.md) +- [`CANCEL DISTRIBUTION JOB`](/sql-statements/sql-statement-cancel-distribution-job.md) \ No newline at end of file diff --git a/statistics.md b/statistics.md index bd05edbc54bb3..9167959465134 100644 --- a/statistics.md +++ b/statistics.md @@ -748,23 +748,29 @@ mysql> SHOW WARNINGS; #### `tidb_build_stats_concurrency` -执行 `ANALYZE` 语句时，任务会被拆分为多个小任务，每个小任务只处理一个列或索引的统计信息。你可以通过 [`tidb_build_stats_concurrency`](/system-variables.md#tidb_build_stats_concurrency) 变量控制同时运行的小任务数。默认值为 `2`。v7.4.0 及更早版本默认值为 `4`。 +该变量控制手动执行 `ANALYZE` 时构建统计信息的并发度，例如可同时处理的表或分区分析任务数。默认值为 `2`。v7.4.0 及更早版本默认值为 `4`。 #### `tidb_build_sampling_stats_concurrency` -分析普通列时，可以通过 [`tidb_build_sampling_stats_concurrency`](/system-variables.md#tidb_build_sampling_stats_concurrency-new-in-v750) 控制采样任务的并发度。默认值为 `2`。 +该变量控制 `ANALYZE` 并发的以下方面： + +- 合并从不同 Region 收集的样本的并发度。 +- 收集特殊索引（例如基于生成虚拟列的索引）统计信息的并发度，例如 TiDB 可同时为其收集统计信息的索引数。 + +默认值为 `2`。 #### `tidb_analyze_partition_concurrency` -执行 `ANALYZE` 语句时，可以通过 [`tidb_analyze_partition_concurrency`](/system-variables.md#tidb_analyze_partition_concurrency) 控制分区表读写统计信息的并发度。默认值为 `2`。v7.4.0 及更早版本默认值为 `1`。 +该变量控制保存 `ANALYZE` 结果（将 TopN 和直方图写入系统表）的并发度。默认值为 `2`。v7.4.0 及更早版本默认值为 `1`。 -#### `tidb_distsql_scan_concurrency` +#### `tidb_analyze_distsql_scan_concurrency` {#tidb-analyze-distsql-scan-concurrency} -分析普通列时，可以通过 [`tidb_distsql_scan_concurrency`](/system-variables.md#tidb_distsql_scan_concurrency) 变量控制一次读取的 Region 数。默认值为 `15`。注意，修改该值会影响查询性能，请谨慎调整。 +该变量控制 `ANALYZE` 并发的以下方面： -#### `tidb_index_serial_scan_concurrency` +- 扫描 TiKV Region 的并发度。 +- 扫描特殊索引（基于虚拟列生成的索引）的 Region 的并发度。 -分析索引列时，可以通过 [`tidb_index_serial_scan_concurrency`](/system-variables.md#tidb_index_serial_scan_concurrency) 变量控制一次读取的 Region 数。默认值为 `1`。注意，修改该值会影响查询性能，请谨慎调整。 +默认值为 `4`。 ## 另请参阅 diff --git a/storage-engine/rocksdb-overview.md b/storage-engine/rocksdb-overview.md index c5ca822dc174f..c560650b9b982 100644 --- a/storage-engine/rocksdb-overview.md +++ b/storage-engine/rocksdb-overview.md @@ -27,7 +27,7 @@ TiKV 的架构如下图所示： ## RocksDB 内存使用 -为了提升读取性能并减少对磁盘的读取操作，RocksDB 会根据一定大小（默认 64 KB）将存储在磁盘上的文件划分为块。在读取块时，首先检查数据是否已存在于内存中的 BlockCache。如果存在，可以直接从内存读取，无需访问磁盘。 +为了提升读取性能并减少对磁盘的读取操作，RocksDB 会根据一定大小（默认 32 KiB）将存储在磁盘上的文件划分为块。在读取块时，首先检查数据是否已存在于内存中的 BlockCache。如果存在，可以直接从内存读取，无需访问磁盘。 BlockCache 根据 LRU 算法淘汰最少使用的数据。默认情况下，TiKV 将系统内存的 45% 分配给 BlockCache。用户也可以通过修改 `storage.block-cache.capacity` 配置自行设置合适的值，但不建议超过系统总内存的 60%。 diff --git a/system-variables.md b/system-variables.md index 69428bb9ae09e..696754fde907b 100644 --- a/system-variables.md +++ b/system-variables.md @@ -1153,13 +1153,19 @@ MPP 是 TiFlash 引擎提供的分布式计算框架，允许节点之间的数 ### tidb_analyze_distsql_scan_concurrency 从 v7.6.0 版本开始引入 +> **注意：** +> +> 在 v7.6.0 之前版本中，常规 `ANALYZE` 的 Region 扫描由 `tidb_distsql_scan_concurrency` 控制，而索引统计信息扫描由 `tidb_index_serial_scan_concurrency` 控制。因此，对于这些版本，如需调整扫描 TiKV Region 的并发度，可以考虑修改 `tidb_distsql_scan_concurrency` 的值。 + - 作用域：SESSION | GLOBAL - 是否持久化到集群：是 - 是否受 Hint [SET_VAR](/optimizer-hints.md#set_varvar_namevar_value) 控制：否 - 类型：整数型 - 默认值：`4` - 范围：`[0, 4294967295]`。在 v8.2.0 之前版本中，最小值为 `1`。当设置为 `0` 时，TiDB 会根据集群规模自适应调整并发度。 -- 这个变量用来设置执行 `ANALYZE` 时 `scan` 操作的并发度。 +- 这个变量控制 `ANALYZE` 并发中的以下方面： + - 扫描 TiKV Region 的并发度。 + - 扫描特殊索引（例如生成虚拟列上的索引）的 Region 的并发度。 ### tidb_analyze_partition_concurrency @@ -1168,7 +1174,7 @@ MPP 是 TiFlash 引擎提供的分布式计算框架，允许节点之间的数 - 是否受 Hint [SET_VAR](/optimizer-hints.md#set_varvar_namevar_value) 控制：否 - 默认值：`2`。TiDB v7.4.0 及其之前版本默认值为 `1`。 - 范围：`[1, 128]`。在 v8.4.0 之前版本中，取值范围是 `[1, 18446744073709551615]`。 -- 这个变量用于 TiDB analyze 分区表时，写入分区表统计信息的并发度。 +- 对于手动和自动 `ANALYZE`，这个变量控制保存 `ANALYZE` 结果的并发度，包括将 TopN 和直方图写入系统表。 ### tidb_analyze_version 从 v5.1.0 版本开始引入 @@ -1216,7 +1222,7 @@ mysql> SELECT @@tidb_analyze_skip_column_types; +----------------------------------+ | @@tidb_analyze_skip_column_types | +----------------------------------+ -| json,blob,mediumblob,longblob | +| json,blob,mediumblob,longblob,mediumtext,longtext | +----------------------------------+ 1 row in set (0.00 sec) @@ -1316,7 +1322,7 @@ mysql> SELECT job_info FROM mysql.analyze_jobs ORDER BY end_time DESC LIMIT 1; - 类型：整数型 - 默认值：`2` - 范围：`[1, 256]` -- 这个变量用来设置执行统计信息自动修改的并发度。 +- 这个变量控制 auto `ANALYZE` 期间构建统计信息的并发度，例如可同时处理的表或分区分析任务数量。 - 从 v8.5.7 开始，该变量的默认值从 `1` 变为 `2`。如果你的集群是从以下版本升级而来，升级后该变量的值保持不变。 ### tidb_backoff_lock_fast @@ -1430,8 +1436,7 @@ mysql> SELECT job_info FROM mysql.analyze_jobs ORDER BY end_time DESC LIMIT 1; - 单位：线程 - 默认值：`2`。TiDB v7.4.0 及其之前版本默认值为 `4`。 - 取值范围：`[1, 256]` -- 这个变量用来设置 ANALYZE 语句执行时并发度。 -- 当这个变量被设置得更大时，会对其它的查询语句执行性能产生一定影响。 +- 这个变量控制手动 `ANALYZE` 期间构建统计信息的并发度，例如可同时处理的表或分区分析任务数量。 ### tidb_build_sampling_stats_concurrency 从 v7.5.0 版本开始引入 @@ -1442,8 +1447,9 @@ mysql> SELECT job_info FROM mysql.analyze_jobs ORDER BY end_time DESC LIMIT 1; - 单位：线程 - 默认值：`2` - 取值范围：`[1, 256]` -- 这个变量用来设置 `ANALYZE` 过程中的采样并发度。 -- 当这个变量被设置得更大时，会对其它的查询语句执行性能产生一定影响。 +- 这个变量控制 `ANALYZE` 并发中的以下方面： + - 合并从不同 Region 收集的样本的并发度。 + - 收集特殊索引（例如生成虚拟列上的索引）统计信息的并发度，例如 TiDB 可并发收集统计信息的索引数量。 ### tidb_capture_plan_baselines 从 v4.0 版本开始引入 @@ -3645,6 +3651,10 @@ v5.0 后，用户仍可以单独修改以上系统变量（会有废弃警告） ### tidb_index_serial_scan_concurrency +> **警告：** +> +> 该变量已废弃，不再控制执行行为。顺序索引扫描的并发度现在由 [`tidb_executor_concurrency`](#tidb_executor_concurrency-new-in-v50) 控制，而 [`ANALYZE TABLE`](/sql-statements/sql-statement-analyze-table.md) 使用 [`tidb_analyze_distsql_scan_concurrency`](#tidb_analyze_distsql_scan_concurrency-new-in-v760) 来控制索引统计信息扫描的并发度。 + - 作用域：SESSION | GLOBAL - 是否持久化到集群：是 - 是否受 Hint [SET_VAR](/optimizer-hints.md#set_varvar_namevar_value) 控制：是 @@ -3652,7 +3662,7 @@ v5.0 后，用户仍可以单独修改以上系统变量（会有废弃警告） - 默认值：`1` - 范围：`[1, 256]` - 单位：线程 -- 这个变量用来设置顺序 scan 操作的并发度，AP 类应用适合较大的值，TP 类应用适合较小的值。 +- 该变量仅为向后兼容而保留。请使用 [`tidb_executor_concurrency`](#tidb_executor_concurrency-new-in-v50) 控制顺序索引扫描的并发度，或使用 [`tidb_analyze_distsql_scan_concurrency`](#tidb_analyze_distsql_scan_concurrency-new-in-v760) 控制索引统计信息扫描的并发度。 ### tidb_init_chunk_size @@ -4172,7 +4182,7 @@ v5.0 后，用户仍可以单独修改以上系统变量（会有废弃警告） - 是否持久化到集群：是 - 是否受 Hint [SET_VAR](/optimizer-hints.md#set_varvar_namevar_value) 控制：否 - 默认值：`1` -- 这个变量用于 TiDB analyze 分区表时，对分区表统计信息进行合并时的并发度。 +- 这个变量控制合并分区表 TopN 结果的并发度。 ### tidb_enable_async_merge_global_stats 从 v7.5.0 版本开始引入 diff --git a/tidb-cloud/architecture-concepts.md b/tidb-cloud/architecture-concepts.md index f5b6934a511eb..dd28e004cd483 100644 --- a/tidb-cloud/architecture-concepts.md +++ b/tidb-cloud/architecture-concepts.md @@ -87,6 +87,38 @@ For more information, see [High Availability in TiDB Cloud](/tidb-cloud/serverle 为最大限度地提升关键业务工作负载的可用性和弹性，{{{ .premium }}} 提供[区域级高可用](/tidb-cloud/serverless-high-availability.md#regional-high-availability-architecture)，通过将节点分布在多个可用区中，提供比同区部署更高的冗余能力。 + + +## TiDB Cloud BYOC {#tidb-cloud-byoc} + +TiDB Cloud BYOC（Bring Your Own Cloud）专为需要更强的数据位置、云资源、网络边界和合规态势控制能力，同时仍希望将 TiDB Cloud 作为托管服务使用的组织而设计。使用 BYOC 时，TiDB Cloud 控制平面由 PingCAP 管理，而 TiDB 数据平面运行在你自己的云账户中。 + +BYOC 提供以下特性： + +- **Data plane 部署在客户自己的账户中**：将 TiDB 服务资源、数据存储和网络边界保留在你的云账户中。 +- **托管运维**：使用 TiDB Cloud 进行部署、扩缩容、监控、升级、备份和生命周期管理。 +- **灵活的高可用性**：同时支持 Single-AZ 和 Multi-AZ 部署，你可以在更低延时的单可用区部署与更高韧性的跨可用区部署之间进行选择。 +- **云账户级自主控制**：允许你应用自己的云策略来管理网络、安全、可审计性和合规性。 +- **私有网络连接**：根据你的 BYOC 配置，支持 VPC peering 等私有网络访问方式。 + +为满足不同工作负载的需求，TiDB Cloud BYOC 同时支持 Single-AZ 和 Multi-AZ 部署，使你能够在更低延时的单可用区部署和跨多个可用区的更高韧性部署之间进行选择。 + +![TiDB Cloud BYOC Architecture](/media/tidb-cloud/byoc-architecture.png) + +一个 TiDB Cloud BYOC 部署包含以下主要组件： + +- **TiDB Cloud control plane**：提供 TiDB Cloud 控制台、组织和项目管理、计费、生命周期编排、监控视图、告警以及维护工作流。 +- **BYOC data plane**：在你的云账户中运行 TiDB 服务及相关基础设施。TiDB Cloud 会基于你在 BYOC 接入过程中授予的权限来运维此环境。 +- **TiDB 服务 VPC**：承载为应用流量提供服务的 TiDB 服务组件。 +- **可观测性服务 VPC**：承载可观测性组件，用于收集 BYOC 部署的指标、日志和运维数据。 +- **应用 VPC**：承载你的应用。此 VPC 由你管理，你需要配置网络连通性以访问 BYOC TiDB 服务。 + +每个 BYOC Region 都是独立部署和运维的。添加某个 BYOC Region 时，TiDB Cloud 会在你的云账户中预配该 Region 所需的资源。由于每个 BYOC Region 都有各自独立的数据平面设置，因此不同 Region 不会共享同一个 TiDB Service VPC 或 Observability Service VPC。 + +你的应用会从应用环境连接到 {{{ .byoc }}} 实例。根据你的 BYOC 配置，连接可以使用私有访问或受控的公网访问。对于私有访问，BYOC 支持 VPC peering 及其他私有连接选项。 + + + ## TiDB Cloud Dedicated TiDB Cloud Dedicated 专为关键业务设计，提供跨多个可用区的高可用性、水平扩展能力以及完整的 HTAP 功能。 diff --git a/tidb-cloud/backup-and-restore-concepts.md b/tidb-cloud/backup-and-restore-concepts.md index 175e0347dd8c7..ea299b5bb6bca 100644 --- a/tidb-cloud/backup-and-restore-concepts.md +++ b/tidb-cloud/backup-and-restore-concepts.md @@ -7,21 +7,32 @@ summary: 了解 TiDB Cloud 的备份与恢复相关概念。 TiDB Cloud 的备份与恢复功能旨在保护你的数据安全，并通过支持数据的备份与恢复，确保业务的连续性。 + + +使用 TiDB Cloud BYOC 时，你可以通过 TiDB Cloud 控制台管理备份与恢复操作，而数据平面运行在你自己的云账户中。这样既能提供托管式的备份与恢复体验，又能将数据平面保留在你的云环境中。 + + + ## 自动备份 在 TiDB Cloud 中，默认会自动进行快照备份，并根据你的备份保留策略进行存储。 欲了解更多信息，请参见以下内容： -- [TiDB Cloud Starter 和 TiDB Cloud Essential 实例的自动备份](/tidb-cloud/backup-and-restore-serverless.md#automatic-backups) -- [TiDB Cloud Premium 实例的自动备份](/tidb-cloud/premium/backup-and-restore-premium.md#automatic-backups) +- [{{{ .starter }}} 和 {{{ .essential }}} 实例的自动备份](/tidb-cloud/backup-and-restore-serverless.md#automatic-backups) +- [{{{ .premium }}} 和 {{{ .byoc }}} 实例的自动备份](/tidb-cloud/premium/backup-and-restore-premium.md#automatic-backups) - [TiDB Cloud Dedicated 集群的自动备份](/tidb-cloud/backup-and-restore.md#turn-on-auto-backup) ## 手动备份 -手动备份是 TiDB Cloud Dedicated 的一项功能，允许你根据需要将数据备份到已知状态，并可随时恢复到该状态。 +手动备份使你能够根据需要将数据备份到某个已知状态，并可在任何时候恢复到该状态。你可以在执行高风险操作（如系统升级、关键数据删除或不可逆的 schema 变更）之前使用手动备份。 + +{{{ .premium }}}, {{{ .byoc }}}, 和 TiDB Cloud Dedicated 支持手动备份。手动备份可提供一个可控的恢复点，并会一直保留，直到你显式将其删除。手动备份不支持 PITR 或部分备份，并且每次恢复操作都会创建一个新的实例。 -欲了解更多信息，请参见 [执行手动备份](/tidb-cloud/backup-and-restore.md#perform-a-manual-backup)。 +更多信息，请参见以下内容： + +- [{{{ .premium }}} 和 {{{ .byoc }}} 实例的手动备份](/tidb-cloud/premium/backup-and-restore-premium.md#manual-backups) +- [TiDB Cloud Dedicated 集群的手动备份](/tidb-cloud/backup-and-restore.md#perform-a-manual-backup) ## 双区域备份 @@ -42,3 +53,9 @@ TiDB Cloud 的备份与恢复功能旨在保护你的数据安全，并通过支 - 对于 TiDB Cloud Starter 实例，不支持时间点恢复。 - 对于 TiDB Cloud Essential 实例，你可以恢复到最近 30 天内的任意时间点。欲了解更多信息，请参见 [恢复模式](/tidb-cloud/backup-and-restore-serverless.md#restore-mode)。 - 对于 TiDB Cloud Dedicated 集群，你需要提前 [开启 PITR](/tidb-cloud/backup-and-restore.md#turn-on-point-in-time-restore)。 + +## 恢复 {#restore} + +TiDB Cloud 支持通过备份快照或时间点恢复将数据恢复到新的集群或实例。恢复操作可帮助你从意外数据丢失、数据损坏或应用程序错误中进行恢复。 + +对于 {{{ .premium }}} 和 {{{ .byoc }}} 实例，你可以将数据恢复到新的实例。你可以从自动备份、手动备份或受支持的外部云存储备份进行恢复。PITR 仅支持自动备份，不支持手动备份。 diff --git a/tidb-cloud/manage-projects-and-resources.md b/tidb-cloud/manage-projects-and-resources.md index f8585cd6a585c..42b72ebcf8777 100644 --- a/tidb-cloud/manage-projects-and-resources.md +++ b/tidb-cloud/manage-projects-and-resources.md @@ -13,7 +13,7 @@ summary: 了解如何在 My TiDB 页面上管理你的 TiDB Cloud 资源和项 TiDB Cloud 资源是你可以管理的可部署单元。它可以是以下之一： -- TiDB X 实例，即一种面向服务的 TiDB Cloud 产品，基于 [TiDB X architecture](/tidb-cloud/tidb-x-architecture.md) 构建，例如 {{{ .starter }}}, Essential, 或 Premium 实例 +- TiDB X 实例，即一种面向服务的 TiDB Cloud 产品，基于 [TiDB X architecture](/tidb-cloud/tidb-x-architecture.md) 构建，例如 {{{ .starter }}}, Essential, Premium, 或 BYOC 实例 - 一个 {{{ .dedicated }}} 集群 ### TiDB Cloud 项目 {#tidb-cloud-projects} @@ -45,6 +45,12 @@ TiDB Cloud 资源是你可以管理的可部署单元。它可以是以下之一 - [Create a {{{ .premium }}} Instance](/tidb-cloud/premium/create-tidb-instance-premium.md) + + +- [Create a {{{ .byoc }}} Instance](/tidb-cloud/byoc/create-tidb-instance-byoc.md) + + + - [Create a {{{ .dedicated }}} Cluster](/tidb-cloud/create-tidb-cluster.md) ### 管理 TiDB Cloud 资源 {#manage-tidb-cloud-resources} @@ -94,10 +100,23 @@ TiDB Cloud 资源是你可以管理的可部署单元。它可以是以下之一 - 如果该项目是为 TiDB X 实例创建的，点击 **Confirm**。 + + > **Note:** > > 对于 {{{ .premium }}} 实例，加密是按实例而不是按项目配置的。创建实例后，你可以启用 [Dual-Layer Data Encryption](/tidb-cloud/premium/dual-layer-data-encryption-premium.md)，在默认的存储层加密之上增加数据库层加密。 + + + + +> **Note:** + > + > - 对于 {{{ .byoc }}} 实例，项目是可选的。数据平面运行在你自己的云账户中，并且 BYOC 环境级别设置会在 BYOC onboarding 期间完成配置。 + > - 对于 {{{ .premium }}} 实例，加密是按实例而不是按项目配置的。创建实例后，你可以启用 [Dual-Layer Data Encryption](/tidb-cloud/premium/dual-layer-data-encryption-premium.md)，在默认的存储层加密之上增加数据库层加密。 + + + - 如果该项目是为 {{{ .dedicated }}} 集群创建的，选择 **Create for Dedicated Cluster** 选项，为该项目配置 [Customer-Managed Encryption Keys (CMEK)](/tidb-cloud/tidb-cloud-encrypt-cmek-aws.md) 和 [maintenance window](/tidb-cloud/configure-maintenance-window.md)，然后点击 **Confirm**。 ### 管理项目 {#manage-a-project} @@ -140,4 +159,4 @@ TiDB Cloud 资源是你可以管理的可部署单元。它可以是以下之一 - 要将 TiDB X 实例移动到某个项目，选择 **To a project**，然后从下拉列表中选择目标项目。 - 要将 TiDB X 实例移出所有项目，选择 **Outside any project**。 -4. 点击 **Move**。 \ No newline at end of file +4. 点击 **Move**。 diff --git a/tidb-cloud/manage-user-access.md b/tidb-cloud/manage-user-access.md index 381f00eda7b16..b78563f9ec5de 100644 --- a/tidb-cloud/manage-user-access.md +++ b/tidb-cloud/manage-user-access.md @@ -137,7 +137,8 @@ TiDB Cloud 定义了不同的用户角色，用于管理组织、项目和实例 | 管理项目下所有 {{{ .starter }}} 实例的 [消费限额](/tidb-cloud/manage-serverless-spend-limit.md)。 | ✅ | ❌ | ❌ | ❌ | | 管理项目中的资源操作，例如创建、修改、移动和删除项目类型支持的实例或集群。 | ✅ | ❌ | ❌ | ❌ | | 管理项目下 {{{ .starter }}} 和 {{{ .essential }}} 实例的分支，如分支创建、连接和删除。 | ✅ | ❌ | ❌ | ❌ | -| 管理资源数据，如数据导入、数据备份与恢复、数据迁移。 | ✅ | ✅ | ❌ | ❌ | +| 管理资源数据，如数据导入、数据备份、数据迁移。 | ✅ | ✅ | ❌ | ❌ | +| 从备份中将实例或集群恢复为新资源。 | ✅ | ❌ | ❌ | ❌ | | 管理 [Data Service](/tidb-cloud/data-service-overview.md) 的只读操作，如使用或创建端点读取数据。 | ✅ | ✅ | ✅ | ❌ | | 管理 [Data Service](/tidb-cloud/data-service-overview.md) 的读写操作。 | ✅ | ✅ | ❌ | ❌ | | 使用 [SQL Editor](/tidb-cloud/explore-data-with-chat2query.md) 查看资源数据（如果资源类型支持）。 | ✅ | ✅ | ✅ | ❌ | diff --git a/tidb-cloud/premium/backup-and-restore-premium.md b/tidb-cloud/premium/backup-and-restore-premium.md index 20604f3eb1c56..94f9523ca6758 100644 --- a/tidb-cloud/premium/backup-and-restore-premium.md +++ b/tidb-cloud/premium/backup-and-restore-premium.md @@ -8,6 +8,12 @@ aliases: ['/zh/tidbcloud/restore-deleted-tidb-cluster'] 本文档介绍如何在 {{{ .premium }}} 实例上备份和恢复数据。{{{ .premium }}} 同时支持自动备份和手动备份，并允许你根据需要将备份数据恢复到新的实例。 + + +本文档也适用于 {{{ .byoc }}}。{{{ .byoc }}} 的备份和恢复功能目前与 {{{ .premium }}} 保持一致。 + + + 备份文件可以来自以下来源： - 活跃的 {{{ .premium }}} 实例 @@ -162,14 +168,16 @@ TiDB Cloud 支持将数据恢复到新实例。 > > 如果你属于多个组织，请先使用左上角的下拉框切换到目标组织。 -2. 在 **Recycle Bin** 页面，点击 **Premium** 页签，进入 {{{ .premium }}} 实例的回收站。 +2. 在 **Recycle Bin** 页面，点击 **Premium****BYOC** 页签，进入 {{{ .premium }}}{{{ .byoc }}} 实例的回收站。 -3. 找到你要恢复的 {{{ .premium }}} 实例，然后点击 **>** 按钮以展开该实例的可用备份。 +3. 找到你要恢复的 {{{ .premium }}}{{{ .byoc }}} 实例，然后点击 **>** 按钮以展开该实例的可用备份。 4. 在目标备份所在行中，点击 **...**，然后选择 **Restore**。 5. 在 **Restore** 页面，按照[恢复到新实例](#restore-to-a-new-instance)中的相同步骤，将备份恢复到新实例。 + + ### 从不同套餐类型恢复备份 {#restore-backups-from-a-different-plan-type} 当前，你只能将托管在 AWS 上的 {{{ .dedicated }}} 集群备份恢复到新的 {{{ .premium }}} 实例。 @@ -187,15 +195,18 @@ TiDB Cloud 支持将数据恢复到新实例。 3. 在 **Restore** 页面，按照[恢复到新实例](#restore-to-a-new-instance)中的相同步骤，将备份恢复到新实例。 + + ### 从云存储恢复备份 {#restore-backups-from-cloud-storage} -{{{ .premium }}} 支持将云存储（例如 Amazon S3 和 Alibaba Cloud Object Storage Service (OSS)）中的备份恢复到新实例。此功能兼容从 {{{ .dedicated }}} 集群或 TiDB Self-Managed 集群生成的备份。 +{{{ .premium }}}{{{ .byoc }}} 支持将云存储（例如 Amazon S3 和 Alibaba Cloud Object Storage Service (OSS)）中的备份恢复到新实例。此功能兼容从 {{{ .dedicated }}} 集群或 TiDB Self-Managed 集群生成的备份。 >**Note:** > > - 当前仅支持恢复位于 **Amazon S3** 和 **Alibaba Cloud OSS** 中的备份。 > - 你只能将备份恢复到由与你的存储 bucket 相同云服务提供商托管的新实例。 > - 如果实例和存储 bucket 位于不同 region，可能会产生额外的跨 region 数据传输费用。 + #### 步骤 {#steps} 开始之前，请确保你拥有具有足够权限以访问备份文件的 access key 和 secret key。 diff --git a/tidb-cloud/premium/import-csv-files-premium.md b/tidb-cloud/premium/import-csv-files-premium.md index 6bca5758324ac..9b2ed234f76ba 100644 --- a/tidb-cloud/premium/import-csv-files-premium.md +++ b/tidb-cloud/premium/import-csv-files-premium.md @@ -214,4 +214,4 @@ summary: 了解如何将 Amazon S3 或 Alibaba Cloud Object Storage Service (OSS ### 导入后的表中行数为零 {#zero-rows-in-the-imported-tables} -当导入进度显示为 **Completed** 后，请检查已导入的表。如果行数为零，表示没有数据文件与您输入的 Bucket URI 匹配。在这种情况下，请通过提供正确的源文件、按照 [Naming Conventions for Data Import](/tidb-cloud/naming-conventions-for-data-import.md) 重命名现有文件，或使用 **Advanced Settings** 进行修改来解决此问题。之后，重新导入这些表。 \ No newline at end of file +当导入进度显示为 **Completed** 后，请检查已导入的表。如果行数为零，表示没有数据文件与你输入的 Bucket URI 匹配。在这种情况下，请通过提供正确的源文件、按照 [Naming Conventions for Data Import](/tidb-cloud/naming-conventions-for-data-import.md) 重命名现有文件，或使用 **Advanced Settings** 进行修改来解决此问题。之后，重新导入这些表。 \ No newline at end of file diff --git a/tidb-cloud/releases/_index.md b/tidb-cloud/releases/_index.md index 61241f95669e9..defcb1957cbed 100644 --- a/tidb-cloud/releases/_index.md +++ b/tidb-cloud/releases/_index.md @@ -1,16 +1,35 @@ --- title: TiDB Cloud 发布记录 -summary: 了解 TiDB Cloud 的发布说明和维护通知。 +summary: 了解 TiDB Cloud 的发布说明、内核版本和维护通知。 --- # TiDB Cloud 发布记录 -[TiDB Cloud](https://www.pingcap.com/tidb/cloud/) 是一款全托管的数据库即服务（DBaaS），将开源的混合事务和分析处理（HTAP）数据库 [TiDB](https://docs.pingcap.com/tidb/stable/overview) 部署到云端。TiDB Cloud 提供了一种简单便捷的方式来部署和管理数据库，使用户能够将更多精力专注于应用程序本身，而无需处理复杂的数据库运维工作。本文档概述了 TiDB Cloud 的发布记录和维护通知相关内容。 +[TiDB Cloud](https://www.pingcap.com/tidb/cloud/) 是一款全托管的数据库即服务（DBaaS），将开源的 HTAP (Hybrid Transactional and Analytical Processing) 数据库 [TiDB](https://docs.pingcap.com/tidb/stable/overview) 部署到云端。 -## 发布说明 +TiDB Cloud 提供两类发布：[云平台发布](#cloud-platform-release-notes) 和 [数据库内核发布](#database-kernel-release-notes)。它们遵循各自独立的发布周期，并分别记录。 -TiDB Cloud 发布说明提供 TiDB Cloud 发布的新功能和改进的相关信息。详细的发布说明，请参阅 [TiDB Cloud 发布说明](/tidb-cloud/releases/tidb-cloud-release-notes.md)。 +## 云平台发布说明 + +云平台发布涵盖 TiDB Cloud 控制台、API 和控制平面，包括适用于所有 TiDB Cloud 方案的新功能、UI 变更、集成和运维改进。 + +- [TiDB Cloud 发布说明](/tidb-cloud/releases/tidb-cloud-release-notes.md) + +## 数据库内核发布说明 + +数据库内核是处理 SQL 查询和管理数据的核心引擎。根据你的 TiDB Cloud 方案，你的资源运行在不同的内核上，每种内核都有各自的发布节奏。 + +| 方案 | 内核信息和发布说明 | +| --- | --- | +| TiDB Cloud **Starter** | 运行在基于经典 [TiDB v8.5.3](https://docs.pingcap.com/tidb/stable/release-8.5.3/) 内核定制的 [TiDB X](/tidb-cloud/tidb-x-architecture.md) 引擎上。 | +| TiDB Cloud **Essential** | 默认运行在基于经典 [TiDB v8.5.3](https://docs.pingcap.com/tidb/stable/release-8.5.3/) 内核定制的 [TiDB X](/tidb-cloud/tidb-x-architecture.md) 引擎上。 | +| TiDB Cloud **Premium** | 运行在 [TiDB X](/tidb-cloud/tidb-x-architecture.md) 内核的 [`TiDB-X-CLOUD.202510.1`](/tidb-cloud/releases/tidb-x-cloud.202510.1.md) 版本上。 | +| TiDB Cloud **Dedicated** | 运行在经典 TiDB 内核上，其内核版本与 TiDB Self-Managed 版本直接对应。目前，新创建的 TiDB Cloud Dedicated 集群默认 TiDB 版本为 [v8.5.7](https://docs.pingcap.com/tidb/stable/release-8.5.7/)。 | + +> **注意：** +> +> 如果你希望 TiDB Cloud Essential 实例运行在与 TiDB Cloud Premium 相同的内核上，请联系 [TiDB Cloud Support](https://docs.pingcap.com/tidbcloud/tidb-cloud-support)。 ## 维护通知 -TiDB Cloud 维护通知提供有关计划维护活动的信息，这些维护活动可能会对你的 TiDB Cloud 服务产生影响。 +TiDB Cloud 维护通知提供有关计划维护活动的信息，这些维护活动可能会对你的 TiDB Cloud 服务产生影响。通知列表请参阅左侧导航栏。 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..54678ec06963a --- /dev/null +++ b/tidb-cloud/releases/tidb-cloud-kernel-versioning.md @@ -0,0 +1,49 @@ +--- +title: TiDB Cloud Premium 的内核版本管理 +summary: 了解 TiDB Cloud Premium 的数据库内核版本规则和格式。 +--- + +# TiDB Cloud Premium 的内核版本管理 + +本文介绍 TiDB Cloud Premium 所使用的底层数据库内核的版本管理规则。 + +> **Note:** +> +> 本文档中介绍的内核版本管理规则仅适用于 TiDB Cloud Premium。其他 TiDB Cloud 方案使用不同的内核版本模型： +> +> - TiDB Cloud Starter 实例运行在基于经典 TiDB v8.5.3 内核定制的 TiDB X engine 上。该内核与 TiDB Cloud Premium 的内核略有不同。 +> - TiDB Cloud Essential 实例默认运行在基于经典 TiDB v8.5.3 内核定制的 TiDB X engine 上。如果你希望 TiDB Cloud Essential 实例运行与 TiDB Cloud Premium 相同的内核，请联系 [TiDB Cloud Support](https://docs.pingcap.com/tidbcloud/tidb-cloud-support)。 +> - TiDB Cloud Dedicated 集群运行在经典 TiDB 内核上，其内核版本与 TiDB Self-Managed 版本直接对应。 + +## 内核版本管理 {#kernel-versioning} + +TiDB Cloud Premium 的内核版本采用以下基于时间的格式： + +```text +TiDB-X-CLOUD.YYYYMM.x +``` + +例如： + +```text +TiDB-X-CLOUD.202510.1 +``` + +其中： + +- `YYYYMM` 表示用于开发该内核的基线代码分支。例如，`202510` 表示该基线分支创建于 2025 年 10 月。它并不表示该内核版本的发布时间。 +- `x` 表示该基线分支的补丁发布编号。 + +例如，`TiDB-X-CLOUD.202510.1` 表示该内核基于 2025 年 10 月创建的分支，并且是从该分支构建的第一个补丁版本。 + +由于内核开发与发布时间表彼此独立，因此某个内核版本可能会在其基线分支创建数月后才发布。 + +由于 TiDB Cloud Premium 遵循自身的内核发布节奏，[TiDB Cloud Premium release notes](/tidb-cloud/releases/tidb-x-cloud.202510.1.md) 与 [TiDB Self-Managed release notes](https://docs.pingcap.com/releases/tidb-self-managed/) 分开发布。 + +## FAQ {#faq} + +### 我可以为我的 TiDB Cloud Premium 实例选择内核版本吗？ {#can-i-choose-the-kernel-version-for-my-tidb-cloud-premium-instance} + +不可以。TiDB Cloud 会管理 TiDB Cloud Premium 的整个内核生命周期。 + +TiDB Cloud 会自动为新的部署提供经过验证的内核版本，并在适当时执行托管升级。这有助于确保安全性、稳定性、兼容性，以及在无需手动维护的情况下访问最新功能和改进。 \ No newline at end of file diff --git a/tidb-cloud/releases/tidb-cloud-release-notes.md b/tidb-cloud/releases/tidb-cloud-release-notes.md index ecd79d001323f..7211c24da58cb 100644 --- a/tidb-cloud/releases/tidb-cloud-release-notes.md +++ b/tidb-cloud/releases/tidb-cloud-release-notes.md @@ -8,6 +8,18 @@ aliases: ['/zh/tidbcloud/supported-tidb-versions','/zh/tidbcloud/release-notes'] 本页面列出了 [TiDB Cloud](https://www.pingcap.com/tidb-cloud/) 在 2026 年的发布说明。 +## 2026 年 7 月 21 日 {#july-21-2026} + +**通用变更** + +- **TiDB Cloud Essential** + + - [Top RU](/tidb-cloud/top-ru.md)（公测中）现已在 [TiDB Cloud Essential](/tidb-cloud/select-cluster-tier.md#essential) 中支持以下新增 Region： + + - Alibaba Cloud：`Jakarta (ap-southeast-5)` + + 此功能会显示按分钟统计的 RU 消耗最高的 SQL，帮助你快速识别最消耗资源的查询以降低成本。 + ## 2026 年 7 月 14 日 {#july-14-2026} **常规变更** 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..a13923e6d31dd --- /dev/null +++ b/tidb-cloud/releases/tidb-x-cloud.202510.1.md @@ -0,0 +1,69 @@ +--- +title: TiDB-X-CLOUD.202510.1 发布说明 +summary: 了解 TiDB-X-CLOUD.202510.1 内核的功能。 +--- + +# TiDB-X-CLOUD.202510.1 发布说明 + +**发布日期**：2026 年 4 月 28 日 + +**适用的 TiDB Cloud 计划**：{{{ .premium }}} + +**TiDB X 内核版本**：`TiDB-X-CLOUD.202510.1` + +{{{ .premium }}} 自 2026 年 4 月 28 日起开始公测，使用 `TiDB-X-CLOUD.202510.1` 内核。 + +在 `TiDB-X-CLOUD.202510.1` 中： + +- `202510` 表示该内核版本的基线代码分支创建于 2025 年 10 月，这与发布日期不同。 +- `1` 表示这是基于 `TiDB-X-CLOUD.202510` 基线分支构建的第一个补丁版本。 + +`TiDB-X-CLOUD.202510.1` 内核基于 [TiDB v8.5.0](https://docs.pingcap.com/tidb/stable/release-8.5.0/) 内核，并包含了 TiDB v8.5.0 中引入的大部分功能和改进。 + +此外，与 [TiDB v8.5.0](https://docs.pingcap.com/tidb/stable/release-8.5.0/) 内核相比，`TiDB-X-CLOUD.202510.1` 内核引入了以下功能： + +## 全新的 TiDB X 架构 {#new-tidb-x-architecture} + +* 引入 TiDB X 架构。这是一种云原生共享存储架构，将云原生对象存储作为 TiDB 的基础支撑。 + + 该架构可为 AI 时代的工作负载提供弹性扩展、可预测的性能以及优化的总体拥有成本（TCO）。 + + TiDB X 标志着从 [classic TiDB](https://docs.pingcap.com/tidbcloud/tidb-architecture/?plan=premium) 的 shared-nothing 架构向云原生共享存储架构的根本性演进。通过从 shared-nothing 架构转向共享存储架构，TiDB X 解决了耦合节点的物理限制，从而实现以下技术目标： + + - **加速扩展**：通过消除物理数据迁移的需求，将扩展性能最高提升 10 倍。 + - **任务隔离**：确保后台维护任务（例如 compaction）与在线事务流量之间零干扰。 + - **资源弹性**：实现真正的“按需付费”模型，使计算资源能够独立于存储容量进行扩展。 + + 更多信息，请参见 [TiDB X Architecture](https://docs.pingcap.com/tidbcloud/tidb-x-architecture/?plan=premium)。 + +## 性能特性 {#performance-features} + +* 支持对特定表的数据进行重新分布（实验特性）[#63260](https://github.com/pingcap/tidb/issues/63260) @[bufferflies](https://github.com/bufferflies) + + PD 会自动调度数据，使其尽可能均匀地分布在集群中的所有 TiKV 节点上。不过，这种自动调度关注的是整个集群。在某些情况下，即使集群范围内的数据分布是均衡的，某个特定表的数据在各个 TiKV 节点上的分布仍可能不均匀。 + + 现在，你可以使用 [`SHOW TABLE DISTRIBUTION`](https://docs.pingcap.com/tidbcloud/sql-statement-show-table-distribution/?plan=premium) 语句检查特定表的数据在所有 TiKV 节点上的分布情况。如果数据分布不均衡，你可以使用 [`DISTRIBUTE TABLE`](https://docs.pingcap.com/tidbcloud/sql-statement-distribute-table/?plan=premium) 语句对该表的数据进行重新分布（实验特性），以改善负载均衡。 + + 请注意，对特定表的数据重新分布是一次性任务，并且有超时限制。如果分布任务在超时前未完成，将自动退出。 + + 更多信息，请参见[文档](https://docs.pingcap.com/tidbcloud/sql-statement-distribute-table/?plan=premium)。 + +* 支持在 DDL 语句中嵌入 `ANALYZE` [#57948](https://github.com/pingcap/tidb/issues/57948) @[terry1purcell](https://github.com/terry1purcell) @[AilinKid](https://github.com/AilinKid) + + 该功能适用于以下类型的 DDL 语句： + + - 创建新索引的 DDL 语句：[`ADD INDEX`](https://docs.pingcap.com/tidbcloud/sql-statement-add-index/?plan=premium) + - 重组现有索引的 DDL 语句：[`MODIFY COLUMN`](https://docs.pingcap.com/tidbcloud/sql-statement-modify-column/?plan=premium) 和 [`CHANGE COLUMN`](https://docs.pingcap.com/tidbcloud/sql-statement-change-column/?plan=premium) + + 启用该功能后，TiDB 会在新建或重组后的索引对用户可见之前，自动运行一次 `ANALYZE`（统计信息收集）操作。这样可以避免在索引创建或重组后，由于统计信息暂时不可用而导致优化器估算不准确以及潜在的执行计划变更。 + + 更多信息，请参见[文档](https://docs.pingcap.com/tidbcloud/ddl_embedded_analyze/?plan=premium)。 + +## 限制 {#limitations} + +由于 TiDB X 与 classic TiDB 在架构上存在差异，TiDB X 内核不支持 classic TiDB 内核中的以下存储特性： + +- [TiKV MVCC In-Memory Engine (IME)](https://docs.pingcap.com/tidb/v8.5/tikv-in-memory-engine) +- [Follower Read](https://docs.pingcap.com/tidb/v8.5/follower-read) + +如需了解更多限制，请参见 [Limited SQL features on TiDB X Instances](https://docs.pingcap.com/tidbcloud/limited-sql-features-tidb-x/?plan=premium)。 \ No newline at end of file diff --git a/tidb-cloud/select-cluster-tier.md b/tidb-cloud/select-cluster-tier.md index 8c68ca48c4124..dc11273bd610f 100644 --- a/tidb-cloud/select-cluster-tier.md +++ b/tidb-cloud/select-cluster-tier.md @@ -10,10 +10,24 @@ aliases: ['/tidbcloud/developer-tier-cluster'] TiDB Cloud 提供了以下几种方案选项。无论你是刚刚开始使用，还是需要扩展以满足不断增长的应用需求，这些服务方案都能为你提供所需的灵活性和能力。在创建 TiDB 资源之前，你需要考虑哪种选项更适合你的需求。 -- [TiDB Cloud Starter](#starter) -- [TiDB Cloud Essential](#essential) + + +- [{{{ .starter }}}](#starter) +- [{{{ .essential }}}](#essential) +- [{{{ .premium }}}](#premium) +- [{{{ .dedicated }}}](#tidb-cloud-dedicated) + + + + + +- [{{{ .starter }}}](#starter) +- [{{{ .essential }}}](#essential) - [{{{ .premium }}}](#premium) -- [TiDB Cloud Dedicated](#tidb-cloud-dedicated) +- [{{{ .byoc }}}](#byoc) +- [{{{ .dedicated }}}](#tidb-cloud-dedicated) + + > **注意：** > @@ -104,6 +118,22 @@ TiDB Cloud 中的每个付费组织总共最多可以创建 100 个 TiDB Cloud S - **可预测的定价**：基于存储和 Request Capacity Units (RCUs) 计费，提供透明的按使用量计费模式，可随你的需求扩展，因此你只需为实际使用量付费，不会有意外费用。 - **高级安全性与合规性**：支持高级加密、客户管理的加密密钥 (CMEK)、私有网络和合规认证，以保护敏感数据。 + + +## {{{ .byoc }}} {#byoc} + +{{{ .byoc }}} 专为需要更强数据位置控制、云资源控制、网络边界控制以及合规态势控制的企业级工作负载而设计。使用 {{{ .byoc }}} 时，TiDB Cloud 控制平面由 PingCAP 管理，而数据平面运行在你自己的云账户中。 + +{{{ .byoc }}} 提供托管式 TiDB Cloud 体验，并具有以下特性： + +- **Data plane 部署在客户自己的账户中**：将 TiDB 服务资源、存储、网络和数据保留在你的云账户中。 +- **托管运维**：使用 TiDB Cloud 进行部署、扩缩容、监控、升级、备份与恢复以及生命周期管理。 +- **灵活的高可用性**：同时支持 Single-AZ 和 Multi-AZ 部署，使你能够在更低延时的单可用区部署与跨多个可用区的更高韧性部署之间进行选择。 +- **云账户级安全控制**：允许你将自己的云策略、网络控制、审计日志记录和合规控制应用到 BYOC 数据平面。 +- **私有网络连接**：根据你的 BYOC 配置，支持 VPC peering 等私有网络访问模式。 + + + ## TiDB Cloud Dedicated TiDB Cloud Dedicated 适用于生产环境，具备跨可用区高可用性、水平扩展能力和 [HTAP](https://en.wikipedia.org/wiki/Hybrid_transactional/analytical_processing) 优势。 diff --git a/tidb-cloud/tidb-cloud-intro.md b/tidb-cloud/tidb-cloud-intro.md index c2b3e18d2947c..daef21120eca5 100644 --- a/tidb-cloud/tidb-cloud-intro.md +++ b/tidb-cloud/tidb-cloud-intro.md @@ -118,6 +118,16 @@ TiDB Cloud 提供以下部署选项： + + +- {{{ .byoc }}} + + {{{ .byoc }}} 专为需要更高控制力、安全性和合规性的大规模生产负载而设计。它使你能够在自己的 AWS 账户中运行数据平面，同时享受 TiDB Cloud 的自动化运维、弹性扩展性和企业级安全能力。 + + 目前，{{{ .byoc }}} 在 AWS 上处于私有预览阶段。 + + + - TiDB Cloud Dedicated TiDB Cloud Dedicated 面向关键业务，提供跨多个可用区的高可用、横向扩展和完整的 HTAP 能力。 @@ -139,3 +149,11 @@ TiDB Cloud 提供以下部署选项： - 你的 VPC 你可以通过私有端点连接或 VPC 对等连接访问你的 TiDB Cloud 资源。详情请参考 [Set Up Private Endpoint Connections](/tidb-cloud/set-up-private-endpoint-connections.md) 或 [Set up VPC Peering Connection](/tidb-cloud/set-up-vpc-peering-connections.md)。 + + + +> **注意：** +> +> TiDB Cloud BYOC 使用的架构与其他 TiDB Cloud 部署选项不同。在 BYOC 中，TiDB Cloud 控制平面由 PingCAP 管理，而数据平面运行在你自己的云账户中。详情请参阅 [TiDB Cloud BYOC architecture](/tidb-cloud/architecture-concepts.md#tidb-cloud-byoc)。 + + diff --git a/tidb-cloud/v8.1-performance-benchmarking-with-tpcc.md b/tidb-cloud/v8.1-performance-benchmarking-with-tpcc.md index e75aa01029e72..005f82f5152a9 100644 --- a/tidb-cloud/v8.1-performance-benchmarking-with-tpcc.md +++ b/tidb-cloud/v8.1-performance-benchmarking-with-tpcc.md @@ -96,8 +96,8 @@ raft-engine.prefill-for-recycle = true ```sql SET tidb_build_stats_concurrency=16; - SET tidb_distsql_scan_concurrency=16; - SET tidb_index_serial_scan_concurrency=16; + SET tidb_build_sampling_stats_concurrency=16; + SET tidb_analyze_distsql_scan_concurrency=16; ``` 5. 运行以下 `go-tpc tpcc` 命令对 TiDB Cloud Dedicated 集群进行压力测试。每个并发测试持续两小时。 diff --git a/tidb-cloud/v8.5-performance-benchmarking-with-tpcc.md b/tidb-cloud/v8.5-performance-benchmarking-with-tpcc.md index 2031afe167239..0590e0425ad06 100644 --- a/tidb-cloud/v8.5-performance-benchmarking-with-tpcc.md +++ b/tidb-cloud/v8.5-performance-benchmarking-with-tpcc.md @@ -96,8 +96,8 @@ raft-engine.prefill-for-recycle = true ```sql SET tidb_build_stats_concurrency=16; - SET tidb_distsql_scan_concurrency=16; - SET tidb_index_serial_scan_concurrency=16; + SET tidb_build_sampling_stats_concurrency=16; + SET tidb_analyze_distsql_scan_concurrency=16; ``` 5. 运行以下 `go-tpc tpcc` 命令对 TiDB Cloud Dedicated 集群进行压力测试。每个并发测试持续两小时。 diff --git a/variables.json b/variables.json index 7ed8eb31aa759..b0c4608358ce4 100644 --- a/variables.json +++ b/variables.json @@ -1,11 +1,14 @@ { "tidb": "TiDB", - "tidb-version": "8.5.4", - "tidb-release-date": "2025-11-27", + "tidb-version": "8.5.7", + "tidb-release-date": "2026-07-09", + "tidb-operator-version": "v1.6.4", "self-managed": "TiDB Self-Managed", "starter": "TiDB Cloud Starter", "essential": "TiDB Cloud Essential", "dedicated": "TiDB Cloud Dedicated", "premium": "TiDB Cloud Premium", - "console-url": "tidbcloud.com" + "console-url": "tidbcloud.com", + "lake": "TiDB Cloud Lake", + "byoc": "TiDB Cloud BYOC" }