Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

add 6.6.0 release notes #12321

Merged
merged 140 commits into from
Feb 20, 2023
Merged
Show file tree
Hide file tree
Changes from 139 commits
Commits
Show all changes
140 commits
Select commit Hold shift + click to select a range
cda9c96
add 6.6.0 release notes
TomShawn Jan 31, 2023
e6887c7
add feature description translations
qiancai Feb 3, 2023
596c177
Apply suggestions from code review
qiancai Feb 3, 2023
258a557
Apply suggestions from code review
qiancai Feb 3, 2023
9995019
translate features of shichun
shichun-0415 Feb 3, 2023
d9a1289
update compatibility changes
shichun-0415 Feb 5, 2023
0b6aea3
update new features
Oreoxmt Feb 5, 2023
3b8784c
Update releases/release-6.6.0.md
hfxsd Feb 6, 2023
538f658
Update releases/release-6.6.0.md
hfxsd Feb 6, 2023
922439a
Apply suggestions from code review
ran-huang Feb 6, 2023
6e16c3e
translate new feature desc of tomshawn
TomShawn Feb 6, 2023
8a110cf
translate new features
Oreoxmt Feb 6, 2023
b0bd616
explain ticdc consistent.storage
shichun-0415 Feb 6, 2023
3ab87af
translate some titles to english
TomShawn Feb 6, 2023
9117c5c
Apply suggestions from code review
TomShawn Feb 7, 2023
b4dc1d7
update links and apply suggestions
Oreoxmt Feb 7, 2023
f6af105
Apply suggestions from code review
ran-huang Feb 7, 2023
c40b0d3
Apply suggestions from code review
shichun-0415 Feb 7, 2023
b2c341a
Update releases/release-6.6.0.md
ran-huang Feb 7, 2023
acd9201
Update releases/release-6.6.0.md
qiancai Feb 7, 2023
d663466
Update releases/release-6.6.0.md
qiancai Feb 7, 2023
66ba064
Apply suggestions from code review
Oreoxmt Feb 7, 2023
f0c95c4
add 2 pd gc tuner notes
TomShawn Feb 7, 2023
1b0593a
Apply suggestions from code review
qiancai Feb 7, 2023
5b22c6c
Update releases/release-6.6.0.md
qiancai Feb 7, 2023
799dfaf
Apply suggestions from code review
hfxsd Feb 8, 2023
ffdb009
Apply suggestions from code review
hfxsd Feb 8, 2023
017c86e
add more and translate compatibility info from docs
TomShawn Feb 8, 2023
2b828c5
Update releases/release-6.6.0.md
TomShawn Feb 8, 2023
93cfd8b
Update releases/release-6.6.0.md
TomShawn Feb 8, 2023
e9fc6d5
Update releases/release-6.6.0.md
ran-huang Feb 8, 2023
55525f2
Apply suggestions from code review
TomShawn Feb 9, 2023
31ddfd7
Update releases/release-6.6.0.md
hnes Feb 9, 2023
1de937d
Update releases/release-6.6.0.md
hnes Feb 9, 2023
77f77ae
Update releases/release-6.6.0.md
TomShawn Feb 9, 2023
982650b
fix gogc config
shichun-0415 Feb 9, 2023
a004037
Apply suggestions from code review
Oreoxmt Feb 9, 2023
4efa1c3
Apply suggestions from code review
Oreoxmt Feb 9, 2023
7a58cdd
Update releases/release-6.6.0.md
TomShawn Feb 9, 2023
e10d707
translate feature descriptions for #4075 and #41163
qiancai Feb 9, 2023
bf3bc1b
remove witness
TomShawn Feb 9, 2023
248869c
Apply suggestions from code review
TomShawn Feb 10, 2023
d6a5a9a
add 2 compatibility items
TomShawn Feb 10, 2023
50dc52f
Update releases/release-6.6.0.md
hfxsd Feb 10, 2023
5f69d0a
refine layout according to yiwen92
TomShawn Feb 10, 2023
16b8700
add more anchors
TomShawn Feb 10, 2023
41d1842
Apply suggestions from code review
TomShawn Feb 10, 2023
dfdc0bb
Apply suggestions from code review
TomShawn Feb 13, 2023
b31ab16
Apply suggestions from code review
TomShawn Feb 13, 2023
fbfda3c
update markdown links to html links
TomShawn Feb 13, 2023
6ed9617
add a few compatibility info
TomShawn Feb 13, 2023
efe87f0
Merge remote-tracking branch 'upstream/master' into 6.6-release-notes
TomShawn Feb 13, 2023
2f179eb
wording updates
qiancai Feb 13, 2023
cccb7cd
Update releases/release-6.6.0.md
TomShawn Feb 14, 2023
c0da06b
add notes
TomShawn Feb 14, 2023
31da409
Update release-6.6.0.md
TomShawn Feb 14, 2023
1c003f5
Update releases/release-6.6.0.md
shichun-0415 Feb 14, 2023
0e064f7
add telemetry configs
TomShawn Feb 15, 2023
a1160b5
Update release-6.6.0.md
TomShawn Feb 15, 2023
9bf1095
wrap html notes
TomShawn Feb 15, 2023
ad044e1
add telemetry notes
TomShawn Feb 15, 2023
9317e4b
remove div
TomShawn Feb 15, 2023
b7e1fa4
Apply suggestions from code review
hfxsd Feb 15, 2023
2e86fb1
Apply suggestions from code review
ran-huang Feb 15, 2023
d6f433c
remove highlight links and anchors
TomShawn Feb 15, 2023
0c5d3eb
Update releases/release-6.6.0.md
ran-huang Feb 15, 2023
c22331d
Update releases/release-6.6.0.md
ran-huang Feb 15, 2023
3959068
Update releases/release-6.6.0.md
ran-huang Feb 15, 2023
9b5e93d
translate 20 sql-infra bug fix notes
shichun-0415 Feb 15, 2023
e1a8f5d
Apply suggestions from code review
shichun-0415 Feb 15, 2023
9db7308
add back 40620
shichun-0415 Feb 15, 2023
9ae8082
bug fix: translate sql-infra
Oreoxmt Feb 16, 2023
f734588
sync with source changes
qiancai Feb 16, 2023
e11ee7a
Update releases/release-6.6.0.md
TomShawn Feb 16, 2023
5f5355b
add five persist stmt system variables
shichun-0415 Feb 16, 2023
3d12e12
bump version for 1 place
TomShawn Feb 16, 2023
3a8bea1
Update releases/release-6.6.0.md
TomShawn Feb 16, 2023
83af3e7
Apply suggestions from code review
TomShawn Feb 16, 2023
c4b676a
html -> markdown
TomShawn Feb 16, 2023
75ad35c
Apply suggestions from code review
TomShawn Feb 16, 2023
db1fbe6
translate notes and add 2 tikv config changes
TomShawn Feb 16, 2023
e1b8f05
Apply suggestions from code review
Oreoxmt Feb 16, 2023
b9c1474
Apply suggestions from code review
Oreoxmt Feb 16, 2023
8339c0f
translate bug fixes
qiancai Feb 16, 2023
4c4cb8b
Merge branch '6.6-release-notes' of https://github.com/TomShawn/docs …
qiancai Feb 16, 2023
37f7e6d
Apply suggestions from code review
shichun-0415 Feb 16, 2023
b992045
Apply suggestions from code review
qiancai Feb 16, 2023
e0da4d2
refine `LIMIT`
shichun-0415 Feb 16, 2023
c734f4a
Apply suggestions from code review
TomShawn Feb 16, 2023
1fe08a8
remove a duplicated release notes for #13568
qiancai Feb 17, 2023
72c46e2
Apply suggestions from code review
hfxsd Feb 17, 2023
f6315b6
Update release-6.6.0.md
yiwen92 Feb 17, 2023
3bfaf24
Update releases/release-6.6.0.md
TomShawn Feb 17, 2023
e5a2c30
Apply suggestions from code review
TomShawn Feb 17, 2023
dbeb8a5
fix link
Oreoxmt Feb 17, 2023
9fa3983
Update release-6.6.0.md
yiwen92 Feb 17, 2023
cf3c840
refine
TomShawn Feb 17, 2023
cc6c64e
Merge remote-tracking branch 'upstream/master' into 6.6-release-notes
TomShawn Feb 17, 2023
6427720
add a few sysvars
TomShawn Feb 17, 2023
8775d19
Update release-6.6.0.md
yiwen92 Feb 17, 2023
df68d18
Apply suggestions from code review
qiancai Feb 17, 2023
93d4b19
Update release-6.6.0.md
TomShawn Feb 17, 2023
0da3825
Update release-6.6.0.md
yiwen92 Feb 17, 2023
31894a3
Update release-6.6.0.md
yiwen92 Feb 17, 2023
c50a835
Apply suggestions from code review
qiancai Feb 17, 2023
eba7d2e
Update releases/release-6.6.0.md
TomShawn Feb 17, 2023
f6303a0
Apply suggestions from code review
TomShawn Feb 17, 2023
3fe072f
Apply suggestions from code review
TomShawn Feb 17, 2023
9038f86
Update releases/release-6.6.0.md
TomShawn Feb 17, 2023
1cfd472
Merge remote-tracking branch 'upstream/master' into 6.6-release-notes
TomShawn Feb 17, 2023
11c66c6
Update release-6.6.0.md
TomShawn Feb 17, 2023
d3437c1
Update release-6.6.0.md
yiwen92 Feb 17, 2023
2f36c8f
Update release-6.6.0.md
yiwen92 Feb 17, 2023
069ec2a
Update releases/release-6.6.0.md
TomShawn Feb 19, 2023
fdf24d1
Apply suggestions from code review
TomShawn Feb 19, 2023
d062c16
Apply suggestions from code review
qiancai Feb 20, 2023
6b29349
Merge remote-tracking branch 'upstream/master' into 6.6-release-notes
TomShawn Feb 20, 2023
bc3e775
Update releases/release-6.6.0.md
shichun-0415 Feb 20, 2023
3a20003
remove tw, add toc, fix format
TomShawn Feb 20, 2023
219be2e
fix anchor
TomShawn Feb 20, 2023
7ef6e10
Update release-6.6.0.md
TomShawn Feb 20, 2023
f20bfe0
refine wording
TomShawn Feb 20, 2023
0d4001d
update a config desc
TomShawn Feb 20, 2023
5a825b3
fix anchors
TomShawn Feb 20, 2023
086d094
Apply suggestions from code review
TomShawn Feb 20, 2023
5c27329
update flashback doc
TomShawn Feb 20, 2023
e068d52
Update sql-statement-flashback-to-timestamp.md
TomShawn Feb 20, 2023
7f4d8cf
Update releases/release-6.6.0.md
ran-huang Feb 20, 2023
a6d7911
Update releases/release-6.6.0.md
TomShawn Feb 20, 2023
b30410c
Update releases/release-6.6.0.md
TomShawn Feb 20, 2023
abf3b44
Update releases/release-6.6.0.md
TomShawn Feb 20, 2023
ceadb67
Update releases/release-6.6.0.md
TomShawn Feb 20, 2023
ac10b9a
Apply suggestions from code review
TomShawn Feb 20, 2023
6c4f111
Apply suggestions from code review
shichun-0415 Feb 20, 2023
cd5bc93
move to improvements
Oreoxmt Feb 20, 2023
bd5c01c
move to improvements
Oreoxmt Feb 20, 2023
2f468c5
Apply suggestions from code review
shichun-0415 Feb 20, 2023
1f667e4
Update sql-statements/sql-statement-flashback-to-timestamp.md
TomShawn Feb 20, 2023
b552fe3
Update _index.md
TomShawn Feb 20, 2023
314d69e
Update releases/release-6.6.0.md
TomShawn Feb 20, 2023
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
4 changes: 3 additions & 1 deletion TOC.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@
- [Docs Home](https://docs.pingcap.com/)
- About TiDB
- [TiDB Introduction](/overview.md)
- [TiDB 6.5 Release Notes](/releases/release-6.5.0.md)
- [TiDB 6.6 Release Notes](/releases/release-6.6.0.md)
- [Features](/basic-features.md)
- [MySQL Compatibility](/mysql-compatibility.md)
- [TiDB Limitations](/tidb-limitations.md)
Expand Down Expand Up @@ -939,6 +939,8 @@
- [Release Timeline](/releases/release-timeline.md)
- [TiDB Versioning](/releases/versioning.md)
- [TiDB Installation Packages](/binary-package.md)
- v6.6
- [6.6.0](/releases/release-6.6.0.md)
- v6.5
- [6.5.0](/releases/release-6.5.0.md)
- v6.4
Expand Down
4 changes: 1 addition & 3 deletions _index.md
Original file line number Diff line number Diff line change
Expand Up @@ -71,9 +71,7 @@ hide_commit: true

[Scale a Cluster](https://docs.pingcap.com/tidb/dev/scale-tidb-using-tiup)

[Back Up Cluster Data](https://docs.pingcap.com/tidb/dev/br-usage-backup)

[Restore Cluster Data](https://docs.pingcap.com/tidb/dev/br-usage-restore)
[Back Up and Restore Cluster Data](https://docs.pingcap.com/tidb/dev/backup-and-restore-overview)

[Daily Check](https://docs.pingcap.com/tidb/dev/daily-check)

Expand Down
616 changes: 616 additions & 0 deletions releases/release-6.6.0.md

Large diffs are not rendered by default.

4 changes: 4 additions & 0 deletions releases/release-notes.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,6 +5,10 @@ aliases: ['/docs/dev/releases/release-notes/','/docs/dev/releases/rn/']

# TiDB Release Notes

## 6.6

- [6.6.0](/releases/release-6.6.0.md): 2023-02-20

## 6.5

- [6.5.0](/releases/release-6.5.0.md): 2022-12-29
Expand Down
1 change: 1 addition & 0 deletions releases/release-timeline.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,6 +9,7 @@ This document shows all the released TiDB versions in reverse chronological orde

| Version | Release Date |
| :--- | :--- |
| [6.6.0](/releases/release-6.6.0.md) | 2023-02-20 |
| [6.1.4](/releases/release-6.1.4.md) | 2023-02-08 |
| [6.5.0](/releases/release-6.5.0.md) | 2022-12-29 |
| [5.1.5](/releases/release-5.1.5.md) | 2022-12-28 |
Expand Down
16 changes: 16 additions & 0 deletions sql-statements/sql-statement-flashback-to-timestamp.md
Original file line number Diff line number Diff line change
Expand Up @@ -40,13 +40,29 @@ FlashbackToTimestampStmt ::=
SELECT * FROM mysql.tidb WHERE variable_name = 'tikv_gc_safe_point';
```

<CustomContent platform='tidb'>

* Only a user with the `SUPER` privilege can execute the `FLASHBACK CLUSTER` SQL statement.
* `FLASHBACK CLUSTER` does not support rolling back DDL statements that modify PD-related information, such as `ALTER TABLE ATTRIBUTE`, `ALTER TABLE REPLICA`, and `CREATE PLACEMENT POLICY`.
* At the time specified in the `FLASHBACK` statement, there cannot be a DDL statement that is not completely executed. If such a DDL exists, TiDB will reject it.
* Before executing `FLASHBACK CLUSTER TO TIMESTAMP`, TiDB disconnects all related connections and prohibits read and write operations on these tables until the `FLASHBACK CLUSTER` statement is completed.
* The `FLASHBACK CLUSTER TO TIMESTAMP` statement cannot be canceled after being executed. TiDB will keep retrying until it succeeds.
* During the execution of `FLASHBACK CLUSTER`, if you need to back up data, you can only use [Backup & Restore](/br/br-snapshot-guide.md) and specify a `BackupTS` that is earlier than the start time of `FLASHBACK CLUSTER`. In addition, during the execution of `FLASHBACK CLUSTER`, enabling [log backup](/br/br-pitr-guide.md) will fail. Therefore, try to enable log backup after `FLASHBACK CLUSTER` is completed.
* If the `FLASHBACK CLUSTER` statement causes the rollback of metadata (table structure, database structure), the related modifications will **not** be replicated by TiCDC. Therefore, you need to pause the task manually, wait for the completion of `FLASHBACK CLUSTER`, and manually replicate the schema definitions of the upstream and downstream to make sure that they are consistent. After that, you need to recreate the TiCDC changefeed.

</CustomContent>
TomShawn marked this conversation as resolved.
Show resolved Hide resolved

<CustomContent platform='tidb-cloud'>

* Only a user with the `SUPER` privilege can execute the `FLASHBACK CLUSTER` SQL statement.
* `FLASHBACK CLUSTER` does not support rolling back DDL statements that modify PD-related information, such as `ALTER TABLE ATTRIBUTE`, `ALTER TABLE REPLICA`, and `CREATE PLACEMENT POLICY`.
* At the time specified in the `FLASHBACK` statement, there cannot be a DDL statement that is not completely executed. If such a DDL exists, TiDB will reject it.
* Before executing `FLASHBACK CLUSTER TO TIMESTAMP`, TiDB disconnects all related connections and prohibits read and write operations on these tables until the `FLASHBACK CLUSTER` statement is completed.
* The `FLASHBACK CLUSTER TO TIMESTAMP` statement cannot be canceled after being executed. TiDB will keep retrying until it succeeds.
* If the `FLASHBACK CLUSTER` statement causes the rollback of metadata (table structure, database structure), the related modifications will **not** be replicated by TiCDC. Therefore, you need to pause the task manually, wait for the completion of `FLASHBACK CLUSTER`, and manually replicate the schema definitions of the upstream and downstream to make sure that they are consistent. After that, you need to recreate the TiCDC changefeed.

</CustomContent>

## Example

The following example shows how to restore the newly inserted data:
Expand Down
16 changes: 10 additions & 6 deletions system-variables.md
Original file line number Diff line number Diff line change
Expand Up @@ -1535,16 +1535,20 @@ MPP is a distributed computing framework provided by the TiFlash engine, which a
- Scope: GLOBAL
- Persists to cluster: Yes
- Type: Boolean
- Default value: `OFF`
- This variable is used for an unreleased feature. **Do not change the variable value**.
- Default value: `ON`
- This variable controls whether to enable historical statistics. The default value changes from `OFF` to `ON`, which means that historical statistics are enabled by default.

### `tidb_enable_historical_stats_for_capture`
### tidb_enable_historical_stats_for_capture

> **Warning:**
>
> The feature controlled by this variable is not fully functional in the current TiDB version. Do not change the default value.

- Scope: GLOBAL
- Persists to cluster: Yes
- Type: Boolean
- Default value: `OFF`
- This variable is used for an unreleased feature. **Do not change the variable value**.
- This variable controls whether the information captured by `PLAN REPLAYER CAPTURE` includes historical statistics by default. The default value `OFF` means that historical statistics are not included by default.

### tidb_enable_index_merge <span class="version-mark">New in v4.0</span>

Expand Down Expand Up @@ -1749,8 +1753,8 @@ MPP is a distributed computing framework provided by the TiFlash engine, which a
- Scope: SESSION | GLOBAL
- Persists to cluster: Yes
- Type: Boolean
- Default value: `OFF`
- This variable controls whether to enable the [`PLAN REPLAYER CAPTURE` feature](/sql-plan-replayer.md#use-plan-replayer-capture-to-capture-target-plans). The default value `OFF` means to disable the `PLAN REPLAYER CAPTURE` feature.
- Default value: `ON`
- This variable controls whether to enable the [`PLAN REPLAYER CAPTURE` feature](/sql-plan-replayer.md#use-plan-replayer-capture-to-capture-target-plans). The default value `ON` means to enable the `PLAN REPLAYER CAPTURE` feature.

</CustomContent>

Expand Down
6 changes: 5 additions & 1 deletion tikv-configuration-file.md
Original file line number Diff line number Diff line change
Expand Up @@ -1262,7 +1262,11 @@ Configuration items related to `rocksdb.defaultcf`, `rocksdb.writecf`, and `rock

### `block-cache-size`

+ The cache size of a RocksDB block. Starting from v6.6.0, this configuration is only used to calculate the default value of `storage.block-cache.capacity`.
> **Warning:**
>
> Starting from v6.6.0, this configuration is deprecated.

+ The cache size of a RocksDB block.
+ Default value for `defaultcf`: `Total machine memory * 25%`
+ Default value for `writecf`: `Total machine memory * 15%`
+ Default value for `lockcf`: `Total machine memory * 2%`
Expand Down
2 changes: 1 addition & 1 deletion upgrade-tidb-using-tiup.md
Original file line number Diff line number Diff line change
Expand Up @@ -47,7 +47,7 @@ This section introduces the preparation works needed before upgrading your TiDB

### Step 1: Review compatibility changes

Review [the compatibility changes](/releases/release-6.5.0.md#compatibility-changes) and [deprecated features](/releases/release-6.5.0.md#deprecated-feature) in TiDB v6.5.0 release notes. If any changes affect your upgrade, take actions accordingly.
Review [the compatibility changes](/releases/release-6.6.0.md#compatibility-changes) in TiDB v6.6.0 release notes. If any changes affect your upgrade, take actions accordingly.

### Step 2: Upgrade TiUP or TiUP offline mirror

Expand Down