From 3e71bc6ec039423dbe3afadd6e2223949669ccc2 Mon Sep 17 00:00:00 2001 From: doc-claw-bot Date: Tue, 17 Nov 2026 13:16:30 +0000 Subject: [PATCH] docs: clarify BR statistics backup and restore flags --- br/br-snapshot-guide.md | 2 +- br/br-snapshot-manual.md | 2 +- faq/backup-and-restore-faq.md | 2 +- 3 files changed, 3 insertions(+), 3 deletions(-) diff --git a/br/br-snapshot-guide.md b/br/br-snapshot-guide.md index caa0e5a4a2910..a7066f855867d 100644 --- a/br/br-snapshot-guide.md +++ b/br/br-snapshot-guide.md @@ -173,7 +173,7 @@ When you perform a snapshot backup, BR backs up system tables as tables with the **BR does not restore the following system tables:** -- Statistics tables (`mysql.stat_*`). But statistics can be restored. See [Back up statistics](/br/br-snapshot-manual.md#back-up-statistics). +- Statistics tables (`mysql.stats_*`). However, statistics can still be restored separately. BR backs up statistics only when `--ignore-stats=false` and restores them according to `--load-stats`. See [Back up statistics](/br/br-snapshot-manual.md#back-up-statistics). - System variable tables (`mysql.tidb` and `mysql.global_variables`) - Other system tables diff --git a/br/br-snapshot-manual.md b/br/br-snapshot-manual.md index 0226fcddb1964..41d24376edf86 100644 --- a/br/br-snapshot-manual.md +++ b/br/br-snapshot-manual.md @@ -182,7 +182,7 @@ tiup br restore full \ In the preceding command: -- `--with-sys-table`: BR restores **data in some system tables**, including account permission data and SQL bindings, and statistics (see [Back up statistics](/br/br-snapshot-manual.md#back-up-statistics)). However, it does not restore statistics tables (`mysql.stat_*`) and system variable tables (`mysql.tidb` and `mysql.global_variables`). For more information, see [Restore tables in the `mysql` schema](/br/br-snapshot-guide.md#restore-tables-in-the-mysql-schema). +- `--with-sys-table`: BR restores **data in some system tables**, including account permission data and SQL bindings. Statistics are controlled separately: BR backs them up only when `--ignore-stats=false` and restores them according to `--load-stats`. The `--with-sys-table` option does not restore the statistics tables (`mysql.stats_*`) or the system variable tables (`mysql.tidb` and `mysql.global_variables`). For more information, see [Restore tables in the `mysql` schema](/br/br-snapshot-guide.md#restore-tables-in-the-mysql-schema). - `--ratelimit`: The maximum speed **per TiKV** performing restore tasks. The unit is in MiB/s. - `--log-file`: The target file where the `br` log is written. diff --git a/faq/backup-and-restore-faq.md b/faq/backup-and-restore-faq.md index 453da3c5912a9..6bb31cce82379 100644 --- a/faq/backup-and-restore-faq.md +++ b/faq/backup-and-restore-faq.md @@ -282,7 +282,7 @@ br restore full -f 'mysql.usertable' -s $external_storage_url --with-sys-table Note that even if you configure [table filter](/table-filter.md#syntax), **BR does not restore the following system tables**: -- Statistics tables (`mysql.stat_*`). But statistics can be restored. See [Back up statistics](/br/br-snapshot-manual.md#back-up-statistics). +- Statistics tables (`mysql.stats_*`). However, statistics can still be restored separately. BR backs up statistics only when `--ignore-stats=false` and restores them according to `--load-stats`. See [Back up statistics](/br/br-snapshot-manual.md#back-up-statistics). - System variable tables (`mysql.tidb`, `mysql.global_variables`) - Other system tables. For more details, see [Restore tables in the `mysql` schema system tables](/br/br-snapshot-guide.md#restore-tables-in-the-mysql-schema).