From c11e84722631354a8791a49fdd09c76472a12580 Mon Sep 17 00:00:00 2001 From: Howard Chen Date: Mon, 27 Jul 2026 17:30:29 +0800 Subject: [PATCH 1/6] Improve note. --- tikv-configuration-file.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/tikv-configuration-file.md b/tikv-configuration-file.md index b7251ab6de1f9..485c2b4ed3dd5 100644 --- a/tikv-configuration-file.md +++ b/tikv-configuration-file.md @@ -2422,7 +2422,7 @@ Configuration items related to BR backup. > **Note:** > -> This configuration is introduced to address backup failures caused by S3 rate limiting. This problem has been fixed by [refining the backup data storage structure](/br/br-snapshot-architecture.md#structure-of-backup-files). Therefore, this configuration is deprecated from v6.1.1 and is no longer recommended. +> This configuration was introduced to address backup failures caused by S3 rate limiting. Since this issue has been resolved by [refining the backup data storage structure](/br/br-snapshot-architecture.md), from v6.1.1 onwards, configure this setting with caution. Setting it too large may cause large parts to fail or time out during network jitter. + The part size used when you perform multipart upload to S3 during backup. You can adjust the value of this configuration to control the number of requests sent to S3. + If data is backed up to S3 and the backup file is larger than the value of this configuration item, [multipart upload](https://docs.aws.amazon.com/AmazonS3/latest/API/API_UploadPart.html) is automatically enabled. Based on the compression ratio, the backup file generated by a 96-MiB Region is approximately 10 MiB to 30 MiB. From 3cfe3090017a4977ff3af6e1475fdac098a23286 Mon Sep 17 00:00:00 2001 From: Howard Chen Date: Mon, 27 Jul 2026 17:46:32 +0800 Subject: [PATCH 2/6] Update ref. --- tikv-configuration-file.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/tikv-configuration-file.md b/tikv-configuration-file.md index 485c2b4ed3dd5..9a12d5735e412 100644 --- a/tikv-configuration-file.md +++ b/tikv-configuration-file.md @@ -2422,7 +2422,7 @@ Configuration items related to BR backup. > **Note:** > -> This configuration was introduced to address backup failures caused by S3 rate limiting. Since this issue has been resolved by [refining the backup data storage structure](/br/br-snapshot-architecture.md), from v6.1.1 onwards, configure this setting with caution. Setting it too large may cause large parts to fail or time out during network jitter. +> This configuration was introduced to address backup failures caused by S3 rate limiting. Since this issue has been resolved by [refining the backup data storage structure](/br/br-snapshot-architecture.md#structure-of-backup-files), from v6.1.1 onwards, configure this setting with caution. Setting it too large may cause large parts to fail or time out during network jitter. + The part size used when you perform multipart upload to S3 during backup. You can adjust the value of this configuration to control the number of requests sent to S3. + If data is backed up to S3 and the backup file is larger than the value of this configuration item, [multipart upload](https://docs.aws.amazon.com/AmazonS3/latest/API/API_UploadPart.html) is automatically enabled. Based on the compression ratio, the backup file generated by a 96-MiB Region is approximately 10 MiB to 30 MiB. From 395f58d08acd95615cd547482a65c3490f6d1f6b Mon Sep 17 00:00:00 2001 From: Ginkgoch Date: Tue, 28 Jul 2026 13:03:17 +0800 Subject: [PATCH 3/6] Apply suggestion from @3pointer Co-authored-by: 3pointer --- tikv-configuration-file.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/tikv-configuration-file.md b/tikv-configuration-file.md index 9a12d5735e412..1c688a0e3d82e 100644 --- a/tikv-configuration-file.md +++ b/tikv-configuration-file.md @@ -2422,7 +2422,7 @@ Configuration items related to BR backup. > **Note:** > -> This configuration was introduced to address backup failures caused by S3 rate limiting. Since this issue has been resolved by [refining the backup data storage structure](/br/br-snapshot-architecture.md#structure-of-backup-files), from v6.1.1 onwards, configure this setting with caution. Setting it too large may cause large parts to fail or time out during network jitter. +> This configuration was introduced to address backup failures caused by S3 rate limiting. From v6.1.1 onwards, configure this setting with caution. Setting it too large may cause large parts to fail or time out during network jitter. + The part size used when you perform multipart upload to S3 during backup. You can adjust the value of this configuration to control the number of requests sent to S3. + If data is backed up to S3 and the backup file is larger than the value of this configuration item, [multipart upload](https://docs.aws.amazon.com/AmazonS3/latest/API/API_UploadPart.html) is automatically enabled. Based on the compression ratio, the backup file generated by a 96-MiB Region is approximately 10 MiB to 30 MiB. From 14737e8471a865a4e1124d6ad3dedbf3b8b8dbb7 Mon Sep 17 00:00:00 2001 From: Grace Cai Date: Tue, 28 Jul 2026 17:37:57 +0800 Subject: [PATCH 4/6] Update tikv-configuration-file.md --- tikv-configuration-file.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/tikv-configuration-file.md b/tikv-configuration-file.md index 1c688a0e3d82e..7d3fd36b56f6d 100644 --- a/tikv-configuration-file.md +++ b/tikv-configuration-file.md @@ -2422,7 +2422,7 @@ Configuration items related to BR backup. > **Note:** > -> This configuration was introduced to address backup failures caused by S3 rate limiting. From v6.1.1 onwards, configure this setting with caution. Setting it too large may cause large parts to fail or time out during network jitter. +> This configuration item was introduced to address backup failures caused by S3 rate limiting. For TiDB v6.1.1 and later, configure this value with caution. Setting it too large might cause larger upload parts to fail or time out when the network is unstable. + The part size used when you perform multipart upload to S3 during backup. You can adjust the value of this configuration to control the number of requests sent to S3. + If data is backed up to S3 and the backup file is larger than the value of this configuration item, [multipart upload](https://docs.aws.amazon.com/AmazonS3/latest/API/API_UploadPart.html) is automatically enabled. Based on the compression ratio, the backup file generated by a 96-MiB Region is approximately 10 MiB to 30 MiB. From dff2cd4af9b5a27d6dcd522a54c60a99cbac5343 Mon Sep 17 00:00:00 2001 From: qiancai Date: Tue, 28 Jul 2026 17:47:02 +0800 Subject: [PATCH 5/6] Update tikv-configuration-file.md --- tikv-configuration-file.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/tikv-configuration-file.md b/tikv-configuration-file.md index 7d3fd36b56f6d..a6bda1a6a0113 100644 --- a/tikv-configuration-file.md +++ b/tikv-configuration-file.md @@ -2422,7 +2422,7 @@ Configuration items related to BR backup. > **Note:** > -> This configuration item was introduced to address backup failures caused by S3 rate limiting. For TiDB v6.1.1 and later, configure this value with caution. Setting it too large might cause larger upload parts to fail or time out when the network is unstable. +> This configuration item was introduced to address backup failures caused by S3 rate limiting. Starting from TiDB v6.1.1, configure this value with caution. Setting it too large might cause larger upload parts to fail or time out when the network is unstable. + The part size used when you perform multipart upload to S3 during backup. You can adjust the value of this configuration to control the number of requests sent to S3. + If data is backed up to S3 and the backup file is larger than the value of this configuration item, [multipart upload](https://docs.aws.amazon.com/AmazonS3/latest/API/API_UploadPart.html) is automatically enabled. Based on the compression ratio, the backup file generated by a 96-MiB Region is approximately 10 MiB to 30 MiB. From d7b539bab0a44b3eeab6b590812ee3a77999832d Mon Sep 17 00:00:00 2001 From: Grace Cai Date: Tue, 28 Jul 2026 17:53:38 +0800 Subject: [PATCH 6/6] Update tikv-configuration-file.md --- tikv-configuration-file.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/tikv-configuration-file.md b/tikv-configuration-file.md index a6bda1a6a0113..31a71bef5ac6f 100644 --- a/tikv-configuration-file.md +++ b/tikv-configuration-file.md @@ -2422,7 +2422,7 @@ Configuration items related to BR backup. > **Note:** > -> This configuration item was introduced to address backup failures caused by S3 rate limiting. Starting from TiDB v6.1.1, configure this value with caution. Setting it too large might cause larger upload parts to fail or time out when the network is unstable. +> This configuration item was introduced to address backup failures caused by S3 rate limiting. Starting from TiDB v6.1.1, configure this value with caution. Setting it too large might cause large upload parts to fail or time out when the network is unstable. + The part size used when you perform multipart upload to S3 during backup. You can adjust the value of this configuration to control the number of requests sent to S3. + If data is backed up to S3 and the backup file is larger than the value of this configuration item, [multipart upload](https://docs.aws.amazon.com/AmazonS3/latest/API/API_UploadPart.html) is automatically enabled. Based on the compression ratio, the backup file generated by a 96-MiB Region is approximately 10 MiB to 30 MiB.