From 8664bfbfccf9422b4ed4acebfb7b72234e1d6277 Mon Sep 17 00:00:00 2001 From: 3pointer Date: Fri, 21 Jun 2024 09:40:18 +0800 Subject: [PATCH] This is an automated cherry-pick of #17705 Signed-off-by: ti-chi-bot --- br/backup-and-restore-use-cases.md | 4 ++-- br/br-snapshot-guide.md | 6 +++++- br/br-snapshot-manual.md | 2 +- 3 files changed, 8 insertions(+), 4 deletions(-) diff --git a/br/backup-and-restore-use-cases.md b/br/backup-and-restore-use-cases.md index 665a77b33d42..441a8f28ec42 100644 --- a/br/backup-and-restore-use-cases.md +++ b/br/backup-and-restore-use-cases.md @@ -119,7 +119,7 @@ checkpoint[global]: 2022-05-13 11:31:47.2 +0800; gap=4m53s ```shell tiup br backup full --pd="${PD_IP}:2379" \ --storage='s3://tidb-pitr-bucket/backup-data/snapshot-20220514000000' \ - --backupts='2022/05/14 00:00:00' + --backupts='2022/05/14 00:00:00 +08:00' ``` - 在 2022/05/16 00:00:00 执行一次快照备份： @@ -127,7 +127,7 @@ checkpoint[global]: 2022-05-13 11:31:47.2 +0800; gap=4m53s ```shell tiup br backup full --pd="${PD_IP}:2379" \ --storage='s3://tidb-pitr-bucket/backup-data/snapshot-20220516000000' \ - --backupts='2022/05/16 00:00:00' + --backupts='2022/05/16 00:00:00 +08:00' ``` ## 执行 PITR diff --git a/br/br-snapshot-guide.md b/br/br-snapshot-guide.md index ca4e7a6077dc..9b051b7c2d21 100644 --- a/br/br-snapshot-guide.md +++ b/br/br-snapshot-guide.md @@ -25,14 +25,18 @@ summary: 了解如何使用 br 命令行工具进行 TiDB 快照备份与恢复 ```shell tiup br backup full --pd "${PD_IP}:2379" \ - --backupts '2022-09-08 13:30:00' \ + --backupts '2022-09-08 13:30:00 +08:00' \ --storage "s3://backup-101/snapshot-202209081330?access-key=${access-key}&secret-access-key=${secret-access-key}" \ --ratelimit 128 \ ``` 以上命令中： +<<<<<<< HEAD - `--backupts`：快照对应的物理时间点，格式可以是 [TSO](/glossary.md#tso) 或者时间戳，例如 `400036290571534337` 或者 `2018-05-11 01:42:23`。如果该快照的数据被垃圾回收 (GC) 了，那么 `br backup` 命令会报错并退出。如果你没有指定该参数，那么 br 会选取备份开始的时间点所对应的快照。 +======= +- `--backupts`：快照对应的物理时间点，格式可以是 [TSO](/glossary.md#tso) 或者时间戳，例如 `400036290571534337` 或者 `2018-05-11 01:42:23 +08:00`。如果该快照的数据被垃圾回收 (GC) 了，那么 `tiup br backup` 命令会报错并退出。使用日期方式备份时，建议同时指定时区，否则 br 默认使用本地时间构造时间戳，可能导致备份时间点错误。如果你没有指定该参数，那么 br 会选取备份开始的时间点所对应的快照。 +>>>>>>> 982407cf9c (backup: add time zone in examples (#17705)) - `--storage`：数据备份到的存储地址。快照备份支持以 Amazon S3、Google Cloud Storage、Azure Blob Storage 为备份存储，以上命令以 Amazon S3 为示例。详细存储地址格式请参考[外部存储服务的 URI 格式](/external-storage-uri.md)。 - `--ratelimit`：**每个 TiKV** 备份数据的速度上限，单位为 MiB/s。 diff --git a/br/br-snapshot-manual.md b/br/br-snapshot-manual.md index 9be09e4ebd97..e893ac9e0501 100644 --- a/br/br-snapshot-manual.md +++ b/br/br-snapshot-manual.md @@ -34,7 +34,7 @@ summary: 介绍备份与恢复 TiDB 集群快照的命令行。 ```shell br backup full \ --pd "${PD_IP}:2379" \ - --backupts '2022-09-08 13:30:00' \ + --backupts '2022-09-08 13:30:00 +08:00' \ --storage "s3://${backup_collection_addr}/snapshot-${date}?access-key=${access-key}&secret-access-key=${secret-access-key}" \ --ratelimit 128 \ --log-file backupfull.log