releases: add TiDB 7.1.0 release notes (preview version)

releases/release-7.1.0.md

@@ -0,0 +1,290 @@
+---
+title: TiDB 7.1.0 Release Notes
+summary: 了解 TiDB 7.1.0 版本的新功能、兼容性变更、改进提升，以及错误修复。
+---
+
+# TiDB 7.1.0 Release Notes
+
+发版日期：2023 年 x 月 x 日
+
+TiDB 版本：7.1.0
+
+试用链接：[快速体验](https://docs.pingcap.com/zh/tidb/dev/quick-start-with-tidb) | [下载离线包](https://cn.pingcap.com/product-community/)
+
+在 7.1.0 版本中，你可以获得以下关键特性：
+
+## 功能详情
+
+### 可扩展性
+
+* TiFlash 支持存算分离和对象存储 GA [#6882](https://github.com/pingcap/tiflash/issues/6882) @[flowbehappy](https://github.com/flowbehappy) @[JaySon-Huang](https://github.com/JaySon-Huang) @[breezewish](https://github.com/breezewish) @[JinheLin](https://github.com/JinheLin) @[lidezhu](https://github.com/lidezhu) @[CalvinNeo](https://github.com/CalvinNeo) **tw:qiancai**
+
+ 在 v7.0.0 版本中，TiFlash 在已有的存算一体架构之外，新增存算分离架构。在此架构下，TiFlash 节点分为 Compute Node （计算节点）和 Write Node（写入节点）两种类型，并支持兼容 S3 API 的对象存储。这两种节点都可以单独扩缩容，独立调整计算或数据存储能力。
+
+ 从 v7.1.0 版本开始，TiFlash 存算分离架构 GA。TiFlash 的存算分离架构和存算一体架构不能混合使用、相互转换，需要在部署 TiFlash 时进行相应的配置指定使用其中的一种架构。
+
+ 更多信息，请参考[用户文档](/tiflash/tiflash-disaggregated-and-s3.md)。
+
+### 性能
+
+* TiFlash 查询支持延迟物化功能 GA [#5829](https://github.com/pingcap/tiflash/issues/5829) @[Lloyd-Pottiger](https://github.com/Lloyd-Pottiger) **tw:qiancai**
+
+ 当 `SELECT` 语句中包含过滤条件（`WHERE` 子句）时，TiFlash 默认会先读取该查询所需列的全部数据，然后再根据查询条件对数据进行过滤、聚合等计算任务。延迟物化是一种优化方式，它支持下推部分过滤条件到 TableScan 算子，即先扫描过滤条件相关的列数据，过滤得到符合条件的行后，再扫描这些行的其他列数据，继续后续计算，从而减少 IO 扫描和数据处理的计算量。
+
+ 从 v7.1.0 版本开始，TiFlash 延迟物化功能 GA。在实验特性阶段引入的系统变量 [`tidb_opt_enable_late_materialization`](/system-variables.md#tidb_opt_enable_late_materialization-从-v700-版本开始引入) 的默认值将调整为 `ON` 开启，TiDB 优化器会根据统计信息和查询的过滤条件，决定哪些过滤条件会被下推到 TableScan 算子。
+
+ 更多信息，请参考[用户文档](/tiflash/tiflash-late-materialization.md)。
+
+* TiFlash MPP 模式根据网络交换数据量自动选择 JOIN 算法 [#7084](https://github.com/pingcap/tiflash/issues/7084) @[solotzg](https://github.com/solotzg) **tw:qiancai**
+
+ TiFlash MPP 模式有多种 JOIN 算法。在 v7.1.0 版本之前，TiDB 根据变量 `tidb_broadcast_join_threshold_count` 和 `tidb_broadcast_join_threshold_size` 以及实际数据量决定 TiFlash MPP 模式是否使用 Broadcast Join 算法。
+
+ 在 v7.1.0 版本中，TiDB 引入变量 `tidb_prefer_broadcast_join_by_exchange_data_size`，控制是否基于最小网络数据交换策略选择 MPP Join 算法。默认为 `OFF`，表示关闭该功能，使用 v7.1.0 版本之前的评估模型，即和之前的版本功能一致；设定为 `ON`，表示启用该功能，`tidb_broadcast_join_threshold_count` 和 `tidb_broadcast_join_threshold_size` 将不再生效；
+
+ 更多信息，请参考[用户文档](/tiflash/use-tiflash-mpp-mode.md#mpp-模式的算法支持)。
+
+* 自适应副本读来缓解读热点 [#14151](https://github.com/tikv/tikv/issues/14151) @[sticnarf](https://github.com/sticnarf) @[you06](https://github.com/you06)
+
+ 发生读热点场景，其他 TiKV 节点可能仍存在闲置资源，与其在数据主节点持续排队等待，转而从其他节点读取副本可能带来更低的延迟。 TiDB 在新版本开始支持负载自适应副本读，通过 [`tidb_load_based_replica_read_threshold`](/system-variables.md#tidb_load_based_replica_read_threshold) 参数来设置排队时间的临界值，当估算的排队时间超过设定时，TiDB 会尝试从副本节点读取数据。在读热点的情况下，相比于不打散有 70%-200% 的读取吞吐量提升。
+
+ 更多信息，请参考[用户文档](/distsql-read.md)。
+
+* 非 Prepare 语句的执行计划缓存 GA [#36598](https://github.com/pingcap/tidb/issues/36598) @[qw4990](https://github.com/qw4990)
+
+ TiDB 在 v7.0.0 支持缓存非 Prepare 语句的执行计划，以提升在线交易场景的并发能力。 v7.1.0 持续优化了这个能力，支持更多模式的 SQL 进入缓存，并正式将这个能力 GA 。 
+
+ GA 之后，非 Prepare 与 Prepare SQL 的缓存池合并，以提升内存利用率，缓存大小通过变量 [`tidb_session_plan_cache_size`]() 设置。 原有的变量 [`tidb_prepared_plan_cache_size`](/system-variables.md#tidb_prepared_plan_cache_size) 和 [`tidb_non_prepared_plan_cache_size`](/system-variables.md#tidb_non_prepared_plan_cache_size) 将被废弃。 
+
+ 为了保持设置向前兼容，对于从低版本升级到 v7.1.0 的客户，缓存池大小 `tidb_session_plan_cache_size` 将会继承 `tidb_prepared_plan_cache_size`的设置，非 Parepare 语句的缓存保持关闭。经过性能测试后，用户可通过 [`tidb_enable_non_prepared_plan_cache`](/system-variables.md#tidb_enable_non_prepared_plan_cache) 打开。 对于新部署的客户，非 Parepare 语句的缓存则默认打开。 
+
+ 更多信息，请参考[用户文档]()。
+
+* 功能标题 [#issue号](链接) @[贡献者 GitHub ID](链接)
+
+ 功能描述（需要包含这个功能是什么、在什么场景下对用户有什么价值、怎么用）
+
+ 更多信息，请参考[用户文档](链接)。
+
+### 稳定性
+
+* 功能标题 [#issue号](链接) @[贡献者 GitHub ID](链接)
+
+ 功能描述（需要包含这个功能是什么、在什么场景下对用户有什么价值、怎么用）
+
+ 更多信息，请参考[用户文档](链接)。
+
+### 高可用
+
+* 功能标题 [#issue号](链接) @[贡献者 GitHub ID](链接)
+
+ 功能描述（需要包含这个功能是什么、在什么场景下对用户有什么价值、怎么用）
+
+ 更多信息，请参考[用户文档](链接)。
+
+### SQL 功能
+
+* 支持通过 `INSERT INTO SELECT` 语句保存 TiFlash 查询结果 GA [#37515](https://github.com/pingcap/tidb/issues/37515) @[gengliqi](https://github.com/gengliqi) **tw:qiancai**
+
+ 从 v6.5.0 起，TiDB 支持下推 `INSERT INTO SELECT` 语句中的 `SELECT` 子句（分析查询）到 TiFlash，你可以将 TiFlash 的查询结果方便地保存到 `INSERT INTO` 指定的 TiDB 表中供后续分析使用，起到了结果缓存（即结果物化）的效果。
+
+ 在 v7.1.0 版本中，TiDB 正式将该功能 GA。不同 SQL mode 对于 `INSERT INTO SELECT` 语句的计算有不同要求，而 TiFlash 的计算规则不满足 `STRICT SQL Mode` 要求，因此，TiDB 要求只有当前会话的 SQL Mode 是除 `STRICT_TRANS_TABLES`, `STRICT_ALL_TABLES` 之外的值时，才允许将 `INSERT INTO SELECT` 语句中的查询下推至 TiFlash。同时，在实验特性阶段引入的系统变量 `tidb_enable_tiflash_read_for_write_stmt` 将被移除。TiDB 保持查询结果时，是否将查询下推至 TiFlash，完全根据 SQL Mode 及 TiFlash 副本的代价估算，由优化器自行决定。
+
+ 更多信息，请参考[用户文档](/tiflash/tiflash-results-materialization.md)。
+
+* MySQL 兼容的多值索引 (Multi-Valued Index) GA [#39592](https://github.com/pingcap/tidb/issues/39592) @[xiongjiwei](https://github.com/xiongjiwei) @[qw4990](https://github.com/qw4990) @[YangKeao](https://github.com/YangKeao)
+
+ 过滤 JSON 列中某个数组的值是一个常见的操作，但普通索引起不到加速作用。在数组上创建多值索引能够大幅提升过滤的性能。如果 JSON 列中的某个数组上存在多值索引，那么函数 `MEMBER OF()`、`JSON_CONTAINS()`、`JSON_OVERLAPS()` 的检索条件可以利用多值索引过滤，从而减少大量的 I/O 消耗，提升执行速度。
+
+ 在 v7.1.0 中， TiDB 多值索引 (Multi-Valued Index) GA，支持更完整的数据类型，并与 TiDB 的工具链兼容。用户可以在生产环境利用“多值索引”加速对 JSON 数组的检索操作。
+
+ 更多信息，请参考[用户文档](/sql-statements/sql-statement-create-index.md#多值索引)
+
+* 支持完善的分区管理 [#42728](https://github.com/pingcap/tidb/issues/42728) @[mjonss](https://github.com/mjonss)
+
+ 在 v7.1.0 版本之前，TiDB 支持 `RANGE`、`LIST`、`HASH`、`KEY` 分区以及 `RANGE`、`LIST` 分区的管理功能。从 v7.1.0 版本开始，TiDB 增加对于 `HASH`、`KEY` 分区的 `ADD PARTITION` 和 `COALESCE PARTITION` 管理功能，以及表的分区类型修改（包括 `REMOVING PARTITIONING`、将非分区表修改为分区表、修改分区表的分区类型），完善整体分表的分区管理能力。你可以根据需要，灵活的对表的分区方式进行调整。
+
+ 更多信息，请参考[用户文档](/partitioned-table.md#)。
+
+* 功能标题 [#issue号](链接) @[贡献者 GitHub ID](链接)
+
+ 功能描述（需要包含这个功能是什么、在什么场景下对用户有什么价值、怎么用）
+
+ 更多信息，请参考[用户文档](链接)。
+
+### 数据库管理
+
+* 功能标题 [#issue号](链接) @[贡献者 GitHub ID](链接)
+
+ 功能描述（需要包含这个功能是什么、在什么场景下对用户有什么价值、怎么用）
+
+ 更多信息，请参考[用户文档](链接)。
+
+### 可观测性
+
+* 功能标题 [#issue号](链接) @[贡献者 GitHub ID](链接)
+
+ 功能描述（需要包含这个功能是什么、在什么场景下对用户有什么价值、怎么用）
+
+ 更多信息，请参考[用户文档](链接)。
+
+### 安全
+
+* 更换 TiFlash 系统表信息的查询接口 [#6941](https://github.com/pingcap/tiflash/issues/6941) @[flowbehappy](https://github.com/flowbehappy) **tw:qiancai**
+
+ 在 v7.1.0 之前的版本中，TiFlash 通过 http 服务接口向 TiDB 提供 `information_schema.tiflash_tables` 和 `information_schema.tiflash_segments` 系统表信息查询。但是 http 协议存在安全风险。
+
+ 从 v7.1.0 版本开始，TiFlash 使用 gRPC 服务接口向 TiDB 提供`information_schema.tiflash_tables` 和 `information_schema.tiflash_segments` 系统表信息查询，避免 http 服务的安全风险。
+
+### 数据迁移
+
+* 功能标题 [#issue号](链接) @[贡献者 GitHub ID](链接)
+
+ 功能描述（需要包含这个功能是什么、在什么场景下对用户有什么价值、怎么用）
+
+ 更多信息，请参考[用户文档](链接)。
+
+## 兼容性变更
+
+> **注意：**
+>
+> 以下为从 v7.0.0 升级至当前版本 (v7.1.0) 所需兼容性变更信息。如果从 v6.6.0 或之前版本升级到当前版本，可能也需要考虑和查看中间版本 release notes 中提到的兼容性变更信息。
+
+### MySQL 兼容性
+
+* 兼容性 1
+
+* 兼容性 2
+
+### 行为变更
+
+* TiFlash 废弃了 HTTP 服务端口（默认 `8123`）**tw:qiancai**
+
+ 如果你已经将 TiFlash 升级到 v7.1.0，那么在升级 TiDB 到 v7.1.0 的过程中，TiFlash 系统表（`TIFLASH_SEGMENTS` 和 `TIFLASH_TABLES`）不可读。
+
+* 行为变更 2
+
+### 系统变量
+
+| 变量名 | 修改类型（包括新增/修改/删除） | 描述 |
+|--------|------------------------------|------|
+| | | |
+| | | |
+| | | |
+| | | |
+
+### 配置文件参数
+
+| 配置文件 | 配置项 | 修改类型 | 描述 |
+| -------- | -------- | -------- | -------- |
+| TiFlash | `http_port` | 删除 | 废弃 TiFlash HTTP 服务端口（默认 `8123`）。|
+| | | | |
+| | | | |
+| | | | |
+
+### 其他
+
+## 废弃功能
+
+## 改进提升
+
++ TiDB
+
+ - note [#issue](链接) @[贡献者 GitHub ID](链接)
+ - note [#issue](链接) @[贡献者 GitHub ID](链接)
+
++ TiKV
+
+ - note [#issue](链接) @[贡献者 GitHub ID](链接)
+ - note [#issue](链接) @[贡献者 GitHub ID](链接)
+
++ PD
+
+ - note [#issue](链接) @[贡献者 GitHub ID](链接)
+ - note [#issue](链接) @[贡献者 GitHub ID](链接)
+
++ TiFlash
+
+ - note [#issue](链接) @[贡献者 GitHub ID](链接)
+ - note [#issue](链接) @[贡献者 GitHub ID](链接)
+
++ Tools
+
+ + Backup & Restore (BR)
+
+ - note [#issue](链接) @[贡献者 GitHub ID](链接)
+ - note [#issue](链接) @[贡献者 GitHub ID](链接)
+
+ + TiCDC
+
+ - note [#issue](链接) @[贡献者 GitHub ID](链接)
+ - note [#issue](链接) @[贡献者 GitHub ID](链接)
+
+ + TiDB Data Migration (DM)
+
+ - note [#issue](链接) @[贡献者 GitHub ID](链接)
+ - note [#issue](链接) @[贡献者 GitHub ID](链接)
+
+ + TiDB Lightning
+
+ - note [#issue](链接) @[贡献者 GitHub ID](链接)
+ - note [#issue](链接) @[贡献者 GitHub ID](链接)
+
+ + TiUP
+
+ - note [#issue](链接) @[贡献者 GitHub ID](链接)
+ - note [#issue](链接) @[贡献者 GitHub ID](链接)
+
+## 错误修复
+
++ TiDB
+
+ - note [#issue](链接) @[贡献者 GitHub ID](链接)
+ - note [#issue](链接) @[贡献者 GitHub ID](链接)
+
++ TiKV
+
+ - note [#issue](链接) @[贡献者 GitHub ID](链接)
+ - note [#issue](链接) @[贡献者 GitHub ID](链接)
+
++ PD
+
+ - note [#issue](链接) @[贡献者 GitHub ID](链接)
+ - note [#issue](链接) @[贡献者 GitHub ID](链接)
+
++ TiFlash
+
+ - note [#issue](链接) @[贡献者 GitHub ID](链接)
+ - note [#issue](链接) @[贡献者 GitHub ID](链接)
+
++ Tools
+
+ + Backup & Restore (BR)
+
+ - note [#issue](链接) @[贡献者 GitHub ID](链接)
+ - note [#issue](链接) @[贡献者 GitHub ID](链接)
+
+ + TiCDC
+
+ - note [#issue](链接) @[贡献者 GitHub ID](链接)
+ - note [#issue](链接) @[贡献者 GitHub ID](链接)
+
+ + TiDB Data Migration (DM)
+
+ - note [#issue](链接) @[贡献者 GitHub ID](链接)
+ - note [#issue](链接) @[贡献者 GitHub ID](链接)
+
+ + TiDB Lightning
+
+ - note [#issue](链接) @[贡献者 GitHub ID](链接)
+ - note [#issue](链接) @[贡献者 GitHub ID](链接)
+
+ + TiUP
+
+ - note [#issue](链接) @[贡献者 GitHub ID](链接)
+ - note [#issue](链接) @[贡献者 GitHub ID](链接)
+
+## 贡献者
+
+感谢来自 TiDB 社区的贡献者们：
+
+- [贡献者 GitHub ID]()