release-8.5: v8.5.7 doc changes (#21777)

Author: qiancai

TOC-pingkai.md

@@ -177,6 +177,7 @@
       - [同步数据到存储服务](/ticdc/ticdc-sink-to-cloud-storage.md)
     - [管理 Changefeed](/ticdc/ticdc-manage-changefeed.md)
     - [日志过滤器](/ticdc/ticdc-filter.md)
+    - [表路由](/ticdc/ticdc-table-routing.md)
     - [DDL 同步](/ticdc/ticdc-ddl.md)
     - [双向复制](/ticdc/ticdc-bidirectional-replication.md)
   - 监控告警
@@ -342,6 +343,7 @@
 - 性能调优
   - 优化手册
     - [优化概述](/performance-tuning-overview.md)
+    - [配置 TiDB 以优化性能](/tidb-performance-tuning-config.md)
     - [优化方法](/performance-tuning-methods.md)
     - [OLTP 负载性能优化实践](/performance-tuning-practices.md)
     - [TiFlash 性能分析方法](/tiflash-performance-tuning-methods.md)
@@ -381,6 +383,7 @@
         - [子查询相关的优化](/subquery-optimization.md)
         - [列裁剪](/column-pruning.md)
         - [关联子查询去关联](/correlated-subquery-optimization.md)
+        - [横向派生表](/lateral-derived-tables.md)
         - [Max/Min 消除](/max-min-eliminate.md)
         - [谓词下推](/predicate-push-down.md)
         - [分区裁剪](/partition-pruning.md)

TOC.md

@@ -65,6 +65,7 @@
       - [同步数据到存储服务](/ticdc/ticdc-sink-to-cloud-storage.md)
     - [管理 Changefeed](/ticdc/ticdc-manage-changefeed.md)
     - [日志过滤器](/ticdc/ticdc-filter.md)
+    - [表路由](/ticdc/ticdc-table-routing.md)
     - [DDL 同步](/ticdc/ticdc-ddl.md)
     - [双向复制](/ticdc/ticdc-bidirectional-replication.md)
   - 监控告警
@@ -269,6 +270,7 @@
         - [子查询相关的优化](/subquery-optimization.md)
         - [列裁剪](/column-pruning.md)
         - [关联子查询去关联](/correlated-subquery-optimization.md)
+        - [横向派生表](/lateral-derived-tables.md)
         - [Max/Min 消除](/max-min-eliminate.md)
         - [谓词下推](/predicate-push-down.md)
         - [分区裁剪](/partition-pruning.md)

br/backup-and-restore-storages.md

@@ -138,11 +138,33 @@ tiup br restore db --db test -u "${PD_IP}:2379" \
 </div>
 <div label="GCS" value="gcs">
 
-配置访问 GCS 的账户可以通过指定访问密钥的方式。如果指定了 `credentials-file` 参数，将按照指定的 `credentials-file` 进行鉴权。除了在 URI 中指定密钥文件外，还支持以下方式：
+可以通过以下方式配置访问 GCS 所使用的凭据：
 
-- br 命令行工具读取位于 `$GOOGLE_APPLICATION_CREDENTIALS` 环境变量所指定路径的文件内容
-- br 命令行工具读取位于 `~/.config/gcloud/application_default_credentials.json` 的文件内容
-- 在 GCE 或 GAE 中运行时，从元数据服务器中获取的凭证
+- 方式一：显式指定 `credentials-file`
+
+    - 如果 `credentials-file` 指向 Service Account JSON，则 BR 和 TiKV 按该凭据访问 GCS。
+    - 如果 TiKV 使用 `gcp_v2` 外部存储后端，则 `credentials-file` 也可以指向 Google Cloud WIF 使用的 `external_account` JSON。
+
+- 方式二：使用应用默认凭据 (ADC)
+
+    - br 命令行工具读取 `$GOOGLE_APPLICATION_CREDENTIALS` 环境变量指定路径中的文件。
+    - br 命令行工具读取 `~/.config/gcloud/application_default_credentials.json` 文件。
+    - 当 BR 在 GCE 或 GAE 中运行时，使用从元数据服务器中获取的凭据。
+
+如果希望 TiKV 使用 GCS 的 WIF 或 ADC，需要启用 `gcp_v2` 外部存储后端。**从 v8.5.7 开始，TiKV 默认启用 `gcp_v2` 外部存储后端**。你可以通过以下方式配置 `gcp_v2`：
+
+- full backup 和 restore：将 [TiKV 配置文件描述](/tikv-configuration-file.md) 中 `[backup].gcp-v2-enable` 设为 `true`
+- log backup：将 [TiKV 配置文件描述](/tikv-configuration-file.md) 中 `[log-backup].gcp-v2-enable` 设为 `true`
+
+上述两个配置项的默认值均为 `true`。如果禁用 `gcp_v2`，TiKV 将继续使用旧版 GCS 实现。该实现仅支持 Service Account JSON，不支持直接使用 WIF。
+
+> **注意：**
+>
+> `gcp_v2` 显式传入的 GCS JSON 凭据只支持 `service_account` 和 `external_account` 两种类型。如果你使用的是 ADC 生成的 `authorized_user` JSON，并且需要让 TiKV 直接访问 GCS，建议设置 `--send-credentials-to-tikv=false`，并在每个 TiKV 节点上配置 ADC。否则，BR 可能会把 `authorized_user` JSON 作为显式凭据发送给 TiKV，而 `gcp_v2` 不接受这类显式 JSON。
+
+> **Tip:**
+>
+> 在启用 `gcp_v2` 后，如果 TiKV 侧未显式提供 GCS JSON 凭据，TiKV 会使用 Google Default Credentials flow。因此，在使用 ADC 且设置 `--send-credentials-to-tikv=false` 时，需要确保每个 TiKV 节点自身都具备可用的 Google 凭据环境。
 
 </div>
 <div label="Azure Blob Storage" value="azure">

correlated-subquery-optimization.md

@@ -19,6 +19,8 @@ TiDB 之所以要进行这样的改写，是因为关联子查询每次子查询
 
 因此，在外部的值比较少的情况下，不解除关联依赖反而可能对执行性能更有帮助。这时可以通过使用 Optimizer Hint [`NO_DECORRELATE`](/optimizer-hints.md#no_decorrelate) 或[优化规则及表达式下推的黑名单](/blocklist-control-plan.md)中关闭“子查询去关联”优化规则的方式来关闭这个优化。在一般情况下，推荐使用 Optimizer Hint 并在需要时配合[执行计划管理](/sql-plan-management.md)功能来禁止解除关联。
 
+从 v8.5.7 起，你还可以使用系统变量 [`tidb_opt_enable_alternative_logical_plans`](/system-variables.md#tidb_opt_enable_alternative_logical_plans-从-v857-版本开始引入) 来优化这类场景。开启该变量后，如果去关联后的候选计划未能生成与原始关联子查询访问方向相同的等价 `IndexJoin` 候选计划，优化器会额外保留一个“不去关联”的候选计划，并同时评估“去关联”和“不去关联”两类候选计划，最终选择代价更低的[执行计划](/explain-subqueries.md)。
+
 ## 样例
 
 {{< copyable "sql" >}}