From e9b227752215a63082c901b644350bd63374a4ff 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 c2aa97ba40c22..33c9faae27277 100644 --- a/tikv-configuration-file.md +++ b/tikv-configuration-file.md @@ -2421,7 +2421,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 959ba85493c37585d5805bb6ea2de1c0b8d95ad3 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 33c9faae27277..0656c0a5e0576 100644 --- a/tikv-configuration-file.md +++ b/tikv-configuration-file.md @@ -2421,7 +2421,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 13e708e72a95ed63e2464406e47719c0697ff669 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 0656c0a5e0576..6b7b485b59f1d 100644 --- a/tikv-configuration-file.md +++ b/tikv-configuration-file.md @@ -2421,7 +2421,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 115af0184784036f729e1740fb5f6debdea61433 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 6b7b485b59f1d..78abc28e32f40 100644 --- a/tikv-configuration-file.md +++ b/tikv-configuration-file.md @@ -2421,7 +2421,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 0d5fde5c8d54151f7e6c5c2453ff6fb152ee13b9 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 78abc28e32f40..06e486a18773a 100644 --- a/tikv-configuration-file.md +++ b/tikv-configuration-file.md @@ -2421,7 +2421,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 cf4cb3317da90e4108d436abfc2f6f24f854618f 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 06e486a18773a..c24fd0da5254f 100644 --- a/tikv-configuration-file.md +++ b/tikv-configuration-file.md @@ -2421,7 +2421,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.