Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
28 commits
Select commit Hold shift + click to select a range
ca230ef
v8.5.7: deprecate telemetry (#22961) (#23171)
ti-chi-bot Jun 30, 2026
68bb5e6
v8.5.7: support logging session connect attrs to slow query log (#225…
ti-chi-bot Jun 30, 2026
e82c14e
v8.5.7: update BR gcp_v2 storage (#23122) (#23133)
ti-chi-bot Jun 30, 2026
7cb9d9c
v8.5.7: remove TiDB Lightning web interface (#23095) (#23121)
ti-chi-bot Jun 30, 2026
5e6e120
v8.5.7: update doc for max-user-connections (#20488) (#23125)
ti-chi-bot Jun 30, 2026
fbc622d
v8.5.7: bump Go requirement to 1.25 in docs (#23135) (#23136)
ti-chi-bot Jun 30, 2026
154568d
Merge branch 'release-8.5' into feature/preview-v8.5.7
lilin90 Jul 1, 2026
3db150c
v8.5.7: clarify DM foreign key support for one-to-one routing (#23153…
ti-chi-bot Jul 1, 2026
a48ad7c
toc: keep Lightning web interface for users of early versions (#23194)
lilin90 Jul 2, 2026
2c1a821
Merge branch 'release-8.5' into feature/preview-v8.5.7
qiancai Jul 6, 2026
98f5aaa
v8.5.7: correct stats variable defaults for v8.5 (#23114)
0xPoe Jul 6, 2026
1c3cb3d
v8.5.7: add LATERAL derived tables documentation (#23123) (#23206)
ti-chi-bot Jul 6, 2026
91b672c
v8.5.7: add the description of tidb_enable_batch_query_region (#23037…
ti-chi-bot Jul 6, 2026
fe6ffb8
v8.5.7: add tidb_enable_strict_not_null_check (#22859) (#23208)
ti-chi-bot Jul 6, 2026
4111b59
v8.5.7: add document for partial index (#21903) (#23204)
ti-chi-bot Jul 6, 2026
c1c8003
v8.5.7: document CPU-aware hot region scheduling (#23140) (#23209)
ti-chi-bot Jul 6, 2026
36744af
v8.5.7: restore v8.5 Top SQL multidimensional docs for v8.5.7 (#23062)
yibin87 Jul 6, 2026
d5d5964
v8.5.7: add max-ts configuration docs for v8.5.7 (#23197)
qiancai Jul 7, 2026
6375757
v8.5.7: optimizer: update default value of fix control 52869 (#23142)
time-and-fate Jul 7, 2026
80a354d
Merge branch 'release-8.5' into feature/preview-v8.5.7
qiancai Jul 8, 2026
1e6ad12
v8.5.7: add table routing feature for cdc (#23211) (#23222)
ti-chi-bot Jul 8, 2026
cc602e3
v8.5.7: add info about tidb_opt_enable_alternative_logical_plans (#23…
ti-chi-bot Jul 8, 2026
108da63
v8.5.7: add doc for tidb_enable_cache_prepare_stmt (#23216) (#23219)
ti-chi-bot Jul 8, 2026
6e4c6d5
Apply suggestions from code review
qiancai Jul 8, 2026
92f0ee2
Update variables.json
qiancai Jul 8, 2026
1ba8222
Merge branch 'feature/preview-v8.5.7' of https://github.com/pingcap/d…
qiancai Jul 8, 2026
32a2a5c
Merge branch 'release-8.5' into feature/preview-v8.5.7
lilin90 Jul 9, 2026
47b1135
v8.5.7: add new resource-control TiKV configs (#23035) (#23229)
ti-chi-bot Jul 9, 2026
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
2 changes: 2 additions & 0 deletions TOC.md
Original file line number Diff line number Diff line change
Expand Up @@ -66,6 +66,7 @@
- [Replicate Data to Storage Services](/ticdc/ticdc-sink-to-cloud-storage.md)
- [Manage Changefeeds](/ticdc/ticdc-manage-changefeed.md)
- [Log Filter](/ticdc/ticdc-filter.md)
- [Table Routing](/ticdc/ticdc-table-routing.md)
- [DDL Replication](/ticdc/ticdc-ddl.md)
- [Bidirectional Replication](/ticdc/ticdc-bidirectional-replication.md)
- Monitor and Alert
Expand Down Expand Up @@ -272,6 +273,7 @@
- [Subquery Related Optimizations](/subquery-optimization.md)
- [Column Pruning](/column-pruning.md)
- [Decorrelation of Correlated Subquery](/correlated-subquery-optimization.md)
- [LATERAL Derived Tables](/lateral-derived-tables.md)
- [Eliminate Max/Min](/max-min-eliminate.md)
- [Predicates Push Down](/predicate-push-down.md)
- [Partition Pruning](/partition-pruning.md)
Expand Down
30 changes: 26 additions & 4 deletions br/backup-and-restore-storages.md
Original file line number Diff line number Diff line change
Expand Up @@ -138,11 +138,33 @@ It is recommended that you configure access to S3 using either of the following
</div>
<div label="GCS" value="gcs">

You can configure the account used to access GCS by specifying the access key. If you specify the `credentials-file` parameter, the authentication is performed using the specified `credentials-file`. Besides specifying the key in the URI, the following methods are also supported:
You can configure the credentials used to access GCS in the following ways:

- BR reads the file in the path specified by the environment variable `$GOOGLE_APPLICATION_CREDENTIALS`
- BR reads the file `~/.config/gcloud/application_default_credentials.json`.
- BR obtains the credentials from the metadata server when the cluster is running in GCE or GAE.
- Method 1: Explicitly specify `credentials-file`

- If `credentials-file` points to a Service Account JSON file, BR and TiKV access GCS using this credential.
- If TiKV uses the `gcp_v2` external storage backend, `credentials-file` can also point to the `external_account` JSON used by Google Cloud WIF.

- Method 2: Use Application Default Credentials (ADC)

- BR reads the file in the path specified by the environment variable `$GOOGLE_APPLICATION_CREDENTIALS`.
- BR reads the file `~/.config/gcloud/application_default_credentials.json`.
- When BR runs in GCE or GAE, it uses the credentials obtained from the metadata server.

If you want TiKV to use GCS WIF or ADC, you need to enable the `gcp_v2` external storage backend. **Starting from v8.5.7, TiKV enables the `gcp_v2` external storage backend by default.** You can configure `gcp_v2` in the following ways:

- Full backup and restore: set `[backup].gcp-v2-enable` to `true` in [TiKV Configuration File Descriptions](/tikv-configuration-file.md)
- Log backup: set `[log-backup].gcp-v2-enable` to `true` in [TiKV Configuration File Descriptions](/tikv-configuration-file.md)

The default values of the preceding two configuration items are both `true`. If you disable `gcp_v2`, TiKV continues to use the legacy GCS implementation. This implementation supports only Service Account JSON and does not support using WIF directly.

> **Note:**
>
> The GCS JSON credentials explicitly passed to `gcp_v2` support only the `service_account` and `external_account` types. If you are using the `authorized_user` JSON generated by ADC and need TiKV to access GCS directly, it is recommended to set `--send-credentials-to-tikv=false` and configure ADC on each TiKV node. Otherwise, BR might send the `authorized_user` JSON to TiKV as an explicit credential, but `gcp_v2` does not accept this type of explicit JSON.

> **Tip:**
>
> After `gcp_v2` is enabled, if GCS JSON credentials are not explicitly provided on the TiKV side, TiKV uses the Google Default Credentials flow. Therefore, when using ADC and setting `--send-credentials-to-tikv=false`, make sure that each TiKV node itself has a usable Google credentials environment.
Comment thread
qiancai marked this conversation as resolved.

</div>
<div label="Azure Blob Storage" value="azure">
Expand Down
2 changes: 2 additions & 0 deletions correlated-subquery-optimization.md
Original file line number Diff line number Diff line change
Expand Up @@ -19,6 +19,8 @@ The disadvantage of this rewriting is that when the correlation is not lifted, t

Therefore, when there are few external values, do not perform decorrelation, which might bring better execution performance. In this case, you can disable this optimization by using the [`NO_DECORRELATE`](/optimizer-hints.md#no_decorrelate) optimizer hint or by disabling the "subquery decorrelation" optimization rule in the [blocklist of optimization rules and expression pushdown](/blocklist-control-plan.md). In most cases, it is recommended to use the optimizer hint along with [SQL Plan Management](/sql-plan-management.md) to disable the decorrelation.

Starting from v8.5.7, you can also use the system variable [`tidb_opt_enable_alternative_logical_plans`](/system-variables.md#tidb_opt_enable_alternative_logical_plans-new-in-v857) to optimize such scenarios. After you enable this variable, if the decorrelated candidate plan fails to generate an equivalent `IndexJoin` candidate plan with the same access direction as the original correlated subquery, the optimizer additionally retains a non-decorrelated candidate plan, evaluates both the decorrelated and non-decorrelated candidate plans, and selects the [execution plan](/explain-subqueries.md) with the lower cost.

## Example

{{< copyable "sql" >}}
Expand Down
Loading
Loading