You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@iotdb.apache.org by cr...@apache.org on 2025/12/26 03:15:29 UTC

(iotdb-docs) branch main updated: Add param sink.mark as general write request to data sync (#810)

This is an automated email from the ASF dual-hosted git repository.

critas pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/iotdb-docs.git


The following commit(s) were added to refs/heads/main by this push:
     new 890103b0 Add param sink.mark as general write request to data sync (#810)
890103b0 is described below

commit 890103b06057de4e051975846373a8f1abcc6e67
Author: leto-b <bi...@timecho.com>
AuthorDate: Fri Dec 26 11:15:24 2025 +0800

    Add param sink.mark as general write request to data sync (#810)
    
    * add sink.batch.max-delay-ms
    
    * add sink.mark-as-general-write-request
---
 .../Master/Table/User-Manual/Data-Sync_apache.md   |  4 +--
 .../Master/Table/User-Manual/Data-Sync_timecho.md  | 34 ++++++++++++----------
 .../latest-Table/User-Manual/Data-Sync_apache.md   |  4 +--
 .../latest-Table/User-Manual/Data-Sync_timecho.md  |  3 ++
 .../Master/Table/User-Manual/Data-Sync_apache.md   |  4 +--
 .../Master/Table/User-Manual/Data-Sync_timecho.md  |  3 ++
 .../latest-Table/User-Manual/Data-Sync_apache.md   |  4 +--
 .../latest-Table/User-Manual/Data-Sync_timecho.md  |  3 ++
 8 files changed, 36 insertions(+), 23 deletions(-)

diff --git a/src/UserGuide/Master/Table/User-Manual/Data-Sync_apache.md b/src/UserGuide/Master/Table/User-Manual/Data-Sync_apache.md
index 9f49fff3..96141ff1 100644
--- a/src/UserGuide/Master/Table/User-Manual/Data-Sync_apache.md
+++ b/src/UserGuide/Master/Table/User-Manual/Data-Sync_apache.md
@@ -503,7 +503,7 @@ pipe_all_sinks_rate_limit_bytes_per_second=-1
 | password                    | Password for the username.                                                                                                                                                                                                                                                                                                                                                                                                                                                   [...]
 | batch.enable                | Enables batch mode for log transmission to improve throughput and reduce IOPS.                                                                                                                                                                                                                                                                                                                                                                                               [...]
 | batch.max-delay-seconds     | Maximum delay (in seconds) for batch transmission.                                                                                                                                                                                                                                                                                                                                                                                                                           [...]
-| batch.max-delay-ms          | Maximum delay (in ms) for batch transmission. (Available since v2.0.5.1)                                                                                                                                                                                                                                                                                                                                                                                                     [...]
+| batch.max-delay-ms          | Maximum delay (in ms) for batch transmission. (Available since v2.0.5)                                                                                                                                                                                                                                                                                                                                                                                                       [...]
 | batch.size-bytes            | Maximum batch size (in bytes) for batch  transmission.                                                                                                                                                                                                                                                                                                                                                                                                                       [...]
 | compressor                  | The selected RPC compression algorithm. Multiple algorithms can be configured and will be adopted in sequence for each request.                                                                                                                                                                                                                                                                                                                                              [...]
 | compressor.zstd.level       | When the selected RPC compression algorithm is zstd, this parameter can be used to additionally configure the compression level of the zstd algorithm.                                                                                                                                                                                                                                                                                                                       [...]
@@ -522,7 +522,7 @@ pipe_all_sinks_rate_limit_bytes_per_second=-1
 | password                    | Password for the username.                                                                                                                                                                                                                                                                                                                                                                                                                                                   [...]
 | batch.enable                | Enables batch mode for log transmission to improve throughput and reduce IOPS.                                                                                                                                                                                                                                                                                                                                                                                               [...]
 | batch.max-delay-seconds     | Maximum delay (in seconds) for batch transmission.                                                                                                                                                                                                                                                                                                                                                                                                                           [...]
-| batch.max-delay-ms          | Maximum delay (in ms) for batch transmission. (Available since v2.0.5.1)                                                                                                                                                                                                                                                                                                                                                                                                     [...]
+| batch.max-delay-ms          | Maximum delay (in ms) for batch transmission. (Available since v2.0.5)                                                                                                                                                                                                                                                                                                                                                                                                       [...]
 | batch.size-bytes            | Maximum batch size (in bytes) for batch  transmission.                                                                                                                                                                                                                                                                                                                                                                                                                       [...]
 | compressor                  | The selected RPC compression algorithm. Multiple algorithms can be configured and will be adopted in sequence for each request.                                                                                                                                                                                                                                                                                                                                              [...]
 | compressor.zstd.level       | When the selected RPC compression algorithm is zstd, this parameter can be used to additionally configure the compression level of the zstd algorithm.                                                                                                                                                                                                                                                                                                                       [...]
diff --git a/src/UserGuide/Master/Table/User-Manual/Data-Sync_timecho.md b/src/UserGuide/Master/Table/User-Manual/Data-Sync_timecho.md
index 861a30e4..b75ebccf 100644
--- a/src/UserGuide/Master/Table/User-Manual/Data-Sync_timecho.md
+++ b/src/UserGuide/Master/Table/User-Manual/Data-Sync_timecho.md
@@ -580,21 +580,23 @@ pipe_all_sinks_rate_limit_bytes_per_second=-1
 
 #### iotdb-thrift-sink
 
-| **Parameter**               | **Description**                                                                                                                                                                                                                                                                                                                                                                                                                                                              [...]
-|:----------------------------|:---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- [...]
-| sink                        | iotdb-thrift-sink or iotdb-thrift-async-sink                                                                                                                                                                                                                                                                                                                                                                                                                                 [...]
-| node-urls                   | URLs of the DataNode service ports on the target IoTDB. (please note that the synchronization task does not support forwarding to its own service).                                                                                                                                                                                                                                                                                                                          [...]
-| user/username                | username for connecting to the target IoTDB. Must have appropriate permissions.                                                                                                                                                                                                                                                                                                                                                                                             [...]
-| password                    | Password for the username.                                                                                                                                                                                                                                                                                                                                                                                                                                                   [...]
-| batch.enable                | Enables batch mode for log transmission to improve throughput and reduce IOPS.                                                                                                                                                                                                                                                                                                                                                                                               [...]
-| batch.max-delay-seconds     | Maximum delay (in seconds) for batch transmission.                                                                                                                                                                                                                                                                                                                                                                                                                           [...]
-| batch.max-delay-ms          | Maximum delay (in ms) for batch transmission. (Available since v2.0.5)                                                                                                                                                                                                                                                                                                                                                                                                       [...]
-| batch.size-bytes            | Maximum batch size (in bytes) for batch  transmission.                                                                                                                                                                                                                                                                                                                                                                                                                       [...]
-| compressor                  | The selected RPC compression algorithm. Multiple algorithms can be configured and will be adopted in sequence for each request.                                                                                                                                                                                                                                                                                                                                              [...]
-| compressor.zstd.level       | When the selected RPC compression algorithm is zstd, this parameter can be used to additionally configure the compression level of the zstd algorithm.                                                                                                                                                                                                                                                                                                                       [...]
-| rate-limit-bytes-per-second | The maximum number of bytes allowed to be transmitted per second. The compressed bytes (such as after compression) are calculated. If it is less than 0, there is no limit.                                                                                                                                                                                                                                                                                                  [...]
-| load-tsfile-strategy        | When synchronizing file data, ​​whether the receiver waits for the local load tsfile operation to complete before responding to the sender​​:<br>​​sync​​: Wait for the local load tsfile operation to complete before returning the response.<br>​​async​​: Do not wait for the local load tsfile operation to complete; return the response immediately.                                                                                                                   [...]
-| format                      | The payload formats for data transmission include the following options:<br>  - hybrid: The format depends on what is passed from the processor (either tsfile or tablet), and the sink performs no conversion.<br> - tsfile: Data is forcibly converted to tsfile format before transmission. This is suitable for scenarios like data file backup.<br> - tablet: Data is forcibly converted to tsfile format before transmission. This is useful for data synchronization  [...]
+
+| **Parameter**               | **Description**                                                                                                                                                                                                                                                                                                                                                                                                                                                              [...]
+|:----------------------------|:---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- [...]
+| sink                        | iotdb-thrift-sink or iotdb-thrift-async-sink                                                                                                                                                                                                                                                                                                                                                                                                                                 [...]
+| node-urls                   | URLs of the DataNode service ports on the target IoTDB. (please note that the synchronization task does not support forwarding to its own service).                                                                                                                                                                                                                                                                                                                          [...]
+| user/usename                | Usename for connecting to the target IoTDB. Must have appropriate permissions.                                                                                                                                                                                                                                                                                                                                                                                               [...]
+| password                    | Password for the username.                                                                                                                                                                                                                                                                                                                                                                                                                                                   [...]
+| batch.enable                | Enables batch mode for log transmission to improve throughput and reduce IOPS.                                                                                                                                                                                                                                                                                                                                                                                               [...]
+| batch.max-delay-seconds     | Maximum delay (in seconds) for batch transmission.                                                                                                                                                                                                                                                                                                                                                                                                                           [...]
+| batch.max-delay-ms          | Maximum delay (in ms) for batch transmission. (Available since v2.0.5)                                                                                                                                                                                                                                                                                                                                                                                                       [...]
+| batch.size-bytes            | Maximum batch size (in bytes) for batch  transmission.                                                                                                                                                                                                                                                                                                                                                                                                                       [...]
+| compressor                  | The selected RPC compression algorithm. Multiple algorithms can be configured and will be adopted in sequence for each request.                                                                                                                                                                                                                                                                                                                                              [...]
+| compressor.zstd.level       | When the selected RPC compression algorithm is zstd, this parameter can be used to additionally configure the compression level of the zstd algorithm.                                                                                                                                                                                                                                                                                                                       [...]
+| rate-limit-bytes-per-second | The maximum number of bytes allowed to be transmitted per second. The compressed bytes (such as after compression) are calculated. If it is less than 0, there is no limit.                                                                                                                                                                                                                                                                                                  [...]
+| load-tsfile-strategy        | When synchronizing file data, ​​whether the receiver waits for the local load tsfile operation to complete before responding to the sender​​:<br>​​sync​​: Wait for the local load tsfile operation to complete before returning the response.<br>​​async​​: Do not wait for the local load tsfile operation to complete; return the response immediately.                                                                                                                   [...]
+| format                      | The payload formats for data transmission include the following options:<br>  - hybrid: The format depends on what is passed from the processor (either tsfile or tablet), and the sink performs no conversion.<br> - tsfile: Data is forcibly converted to tsfile format before transmission. This is suitable for scenarios like data file backup.<br> - tablet: Data is forcibly converted to tsfile format before transmission. This is useful for data synchronization  [...]
+| mark-as-general-write-request | This parameter controls whether data forwarded by external pipes can be synchronized between dual-active pipes (configured on the sender side of dual-active external pipes). (Available since v2.0.5) | Boolean: true / false. True: can synchronize; False: cannot synchronize; | Optional | False |
 
 
 #### iotdb-air-gap-sink
@@ -630,6 +632,8 @@ pipe_all_sinks_rate_limit_bytes_per_second=-1
 | ssl.trust-store-path        | Path to the trust store certificate for SSL connection.                                                                                                                                                                                                                                                                                                                                                                                                                      [...]
 | ssl.trust-store-pwd         | Password for the trust store certificate.                                                                                                                                                                                                                                                                                                                                                                                                                                    [...]
 | format                      | The payload formats for data transmission include the following options:<br>  - hybrid: The format depends on what is passed from the processor (either tsfile or tablet), and the sink performs no conversion.<br> - tsfile: Data is forcibly converted to tsfile format before transmission. This is suitable for scenarios like data file backup.<br> - tablet: Data is forcibly converted to tsfile format before transmission. This is useful for data synchronization  [...]
+| mark-as-general-write-request | This parameter controls whether data forwarded by external pipes can be synchronized between dual-active pipes (configured on the sender side of dual-active external pipes).(Available since v2.0.5)  | Boolean: true / false. True: can synchronize; False: cannot synchronize; | Optional | False |
+
 
 
 #### write-back-sink
diff --git a/src/UserGuide/latest-Table/User-Manual/Data-Sync_apache.md b/src/UserGuide/latest-Table/User-Manual/Data-Sync_apache.md
index ce3acc79..0f88e1b3 100644
--- a/src/UserGuide/latest-Table/User-Manual/Data-Sync_apache.md
+++ b/src/UserGuide/latest-Table/User-Manual/Data-Sync_apache.md
@@ -503,7 +503,7 @@ pipe_all_sinks_rate_limit_bytes_per_second=-1
 | password                    | Password for the username.                                                                                                                                                                                                                                                                                                                                                                                                                                                   [...]
 | batch.enable                | Enables batch mode for log transmission to improve throughput and reduce IOPS.                                                                                                                                                                                                                                                                                                                                                                                               [...]
 | batch.max-delay-seconds     | Maximum delay (in seconds) for batch transmission.                                                                                                                                                                                                                                                                                                                                                                                                                           [...]
-| batch.max-delay-ms          | Maximum delay (in ms) for batch transmission. (Available since v2.0.5.1)                                                                                                                                                                                                                                                                                                                                                                                                     [...]
+| batch.max-delay-ms          | Maximum delay (in ms) for batch transmission. (Available since v2.0.5)                                                                                                                                                                                                                                                                                                                                                                                                       [...]
 | batch.size-bytes            | Maximum batch size (in bytes) for batch  transmission.                                                                                                                                                                                                                                                                                                                                                                                                                       [...]
 | compressor                  | The selected RPC compression algorithm. Multiple algorithms can be configured and will be adopted in sequence for each request.                                                                                                                                                                                                                                                                                                                                              [...]
 | compressor.zstd.level       | When the selected RPC compression algorithm is zstd, this parameter can be used to additionally configure the compression level of the zstd algorithm.                                                                                                                                                                                                                                                                                                                       [...]
@@ -522,7 +522,7 @@ pipe_all_sinks_rate_limit_bytes_per_second=-1
 | password                    | Password for the username.                                                                                                                                                                                                                                                                                                                                                                                                                                                   [...]
 | batch.enable                | Enables batch mode for log transmission to improve throughput and reduce IOPS.                                                                                                                                                                                                                                                                                                                                                                                               [...]
 | batch.max-delay-seconds     | Maximum delay (in seconds) for batch transmission.                                                                                                                                                                                                                                                                                                                                                                                                                           [...]
-| batch.max-delay-ms          | Maximum delay (in ms) for batch transmission. (Available since v2.0.5.1)                                                                                                                                                                                                                                                                                                                                                                                                     [...]
+| batch.max-delay-ms          | Maximum delay (in ms) for batch transmission. (Available since v2.0.5)                                                                                                                                                                                                                                                                                                                                                                                                       [...]
 | batch.size-bytes            | Maximum batch size (in bytes) for batch  transmission.                                                                                                                                                                                                                                                                                                                                                                                                                       [...]
 | compressor                  | The selected RPC compression algorithm. Multiple algorithms can be configured and will be adopted in sequence for each request.                                                                                                                                                                                                                                                                                                                                              [...]
 | compressor.zstd.level       | When the selected RPC compression algorithm is zstd, this parameter can be used to additionally configure the compression level of the zstd algorithm.                                                                                                                                                                                                                                                                                                                       [...]
diff --git a/src/UserGuide/latest-Table/User-Manual/Data-Sync_timecho.md b/src/UserGuide/latest-Table/User-Manual/Data-Sync_timecho.md
index 4a0e0bb6..cc7635c0 100644
--- a/src/UserGuide/latest-Table/User-Manual/Data-Sync_timecho.md
+++ b/src/UserGuide/latest-Table/User-Manual/Data-Sync_timecho.md
@@ -595,6 +595,7 @@ pipe_all_sinks_rate_limit_bytes_per_second=-1
 | rate-limit-bytes-per-second | The maximum number of bytes allowed to be transmitted per second. The compressed bytes (such as after compression) are calculated. If it is less than 0, there is no limit.                                                                                                                                                                                                                                                                                                  [...]
 | load-tsfile-strategy        | When synchronizing file data, ​​whether the receiver waits for the local load tsfile operation to complete before responding to the sender​​:<br>​​sync​​: Wait for the local load tsfile operation to complete before returning the response.<br>​​async​​: Do not wait for the local load tsfile operation to complete; return the response immediately.                                                                                                                   [...]
 | format                      | The payload formats for data transmission include the following options:<br>  - hybrid: The format depends on what is passed from the processor (either tsfile or tablet), and the sink performs no conversion.<br> - tsfile: Data is forcibly converted to tsfile format before transmission. This is suitable for scenarios like data file backup.<br> - tablet: Data is forcibly converted to tsfile format before transmission. This is useful for data synchronization  [...]
+| mark-as-general-write-request | This parameter controls whether data forwarded by external pipes can be synchronized between dual-active pipes (configured on the sender side of dual-active external pipes). | Boolean: true / false. True: can synchronize; False: cannot synchronize; | Optional | False |
 
 #### iotdb-air-gap-sink
 
@@ -629,6 +630,8 @@ pipe_all_sinks_rate_limit_bytes_per_second=-1
 | ssl.trust-store-path        | Path to the trust store certificate for SSL connection.                                                                                                                                                                                                                                                                                                                                                                                                                      [...]
 | ssl.trust-store-pwd         | Password for the trust store certificate.                                                                                                                                                                                                                                                                                                                                                                                                                                    [...]
 | format                      | The payload formats for data transmission include the following options:<br>  - hybrid: The format depends on what is passed from the processor (either tsfile or tablet), and the sink performs no conversion.<br> - tsfile: Data is forcibly converted to tsfile format before transmission. This is suitable for scenarios like data file backup.<br> - tablet: Data is forcibly converted to tsfile format before transmission. This is useful for data synchronization  [...]
+| mark-as-general-write-request | This parameter controls whether data forwarded by external pipes can be synchronized between dual-active pipes (configured on the sender side of dual-active external pipes).(Available since v2.0.5)  | Boolean: true / false. True: can synchronize; False: cannot synchronize; | Optional | False |
+
 
 
 #### write-back-sink
diff --git a/src/zh/UserGuide/Master/Table/User-Manual/Data-Sync_apache.md b/src/zh/UserGuide/Master/Table/User-Manual/Data-Sync_apache.md
index a328e2f7..bdeccdb1 100644
--- a/src/zh/UserGuide/Master/Table/User-Manual/Data-Sync_apache.md
+++ b/src/zh/UserGuide/Master/Table/User-Manual/Data-Sync_apache.md
@@ -493,7 +493,7 @@ pipe_all_sinks_rate_limit_bytes_per_second=-1
 | password                    | 连接接收端使用的用户名对应的密码,同步要求该用户具备相应的操作权限                                                                                                                                                            | String                                                                     | 选填       | root         |
 | batch.enable                | 是否开启日志攒批发送模式,用于提高传输吞吐,降低 IOPS                                                                                                                                                                | Boolean: true, false                                                       | 选填       | true         |
 | batch.max-delay-seconds     | 在开启日志攒批发送模式时生效,表示一批数据在发送前的最长等待时间(单位:s)                                                                                                                                                       | Integer                                                                    | 选填       | 1            |
-| batch.max-delay-ms          | 在开启日志攒批发送模式时生效,表示一批数据在发送前的最长等待时间(单位:ms)(V2.0.5.1及以后版本支持)                                                                                                                                                      | Integer                                                                    | 选填     | 1            |
+| batch.max-delay-ms          | 在开启日志攒批发送模式时生效,表示一批数据在发送前的最长等待时间(单位:ms)(V2.0.5及以后版本支持)                                                                                                                                                      | Integer                                                                    | 选填     | 1            |
 | batch.size-bytes            | 在开启日志攒批发送模式时生效,表示一批数据最大的攒批大小(单位:byte)                                                                                                                                                        | Long                                                                       | 选填       | 16*1024*1024 |
 | compressor                  | 所选取的 rpc 压缩算法,可配置多个,对每个请求顺序采用                                                                                                                                                                | String: snappy / gzip / lz4 / zstd / lzma2                                 | 选填       | ""           |
 | compressor.zstd.level       | 所选取的 rpc 压缩算法为 zstd 时,可使用该参数额外配置 zstd 算法的压缩等级                                                                                                                                                | Int: [-131072, 22]                                                         | 选填       | 3            |
@@ -512,7 +512,7 @@ pipe_all_sinks_rate_limit_bytes_per_second=-1
 | password                    | 连接接收端使用的用户名对应的密码,同步要求该用户具备相应的操作权限                                                                                                                                                            | String                                                                           | 选填     | root         |
 | batch.enable                | 是否开启日志攒批发送模式,用于提高传输吞吐,降低 IOPS                                                                                                                                                                | Boolean: true, false                                                             | 选填     | true         |
 | batch.max-delay-seconds     | 在开启日志攒批发送模式时生效,表示一批数据在发送前的最长等待时间(单位:s)                                                                                                                                                       | Integer                                                                          | 选填     | 1            |
-| batch.max-delay-ms          | 在开启日志攒批发送模式时生效,表示一批数据在发送前的最长等待时间(单位:ms)(V2.0.5.1及以后版本支持)                                                                                                                                                      | Integer                                                                    | 选填     | 1            |
+| batch.max-delay-ms          | 在开启日志攒批发送模式时生效,表示一批数据在发送前的最长等待时间(单位:ms)(V2.0.5及以后版本支持)                                                                                                                                                      | Integer                                                                    | 选填     | 1            |
 | batch.size-bytes            | 在开启日志攒批发送模式时生效,表示一批数据最大的攒批大小(单位:byte)                                                                                                                                                        | Long                                                                             | 选填     | 16*1024*1024 |
 | compressor                  | 所选取的 rpc 压缩算法,可配置多个,对每个请求顺序采用                                                                                                                                                                | String: snappy / gzip / lz4 / zstd / lzma2                                       | 选填     | ""           |
 | compressor.zstd.level       | 所选取的 rpc 压缩算法为 zstd 时,可使用该参数额外配置 zstd 算法的压缩等级                                                                                                                                                | Int: [-131072, 22]                                                               | 选填     | 3            |
diff --git a/src/zh/UserGuide/Master/Table/User-Manual/Data-Sync_timecho.md b/src/zh/UserGuide/Master/Table/User-Manual/Data-Sync_timecho.md
index 2f522b8f..db225e09 100644
--- a/src/zh/UserGuide/Master/Table/User-Manual/Data-Sync_timecho.md
+++ b/src/zh/UserGuide/Master/Table/User-Manual/Data-Sync_timecho.md
@@ -588,6 +588,8 @@ pipe_all_sinks_rate_limit_bytes_per_second=-1
 | rate-limit-bytes-per-second | 每秒最大允许传输的 byte 数,计算压缩后的 byte(如压缩),若小于 0 则不限制                                                                                                                                                 | Double:  [Double.MIN_VALUE, Double.MAX_VALUE]                              | 选填     | -1           |
 | load-tsfile-strategy        | 文件同步数据时,接收端请求返回发送端前,是否等待接收端本地的 load tsfile 执行结果返回。<br>sync:等待本地的 load tsfile 执行结果返回;<br>async:不等待本地的 load tsfile 执行结果返回。                                                                     | String: sync / async                        | 选填      | sync     |
 | format                      | 数据传输的payload格式, 可选项包括:<br>  - hybrid: 取决于 processor 传递过来的格式(tsfile或tablet),sink不做任何转换。<br> - tsfile:强制转换成tsfile发送,可用于数据文件备份等场景。<br> - tablet:强制转换成tsfile发送,可用于发送端/接收端数据类型不完全兼容时的数据同步(以减少报错)。 | String: hybrid / tsfile / tablet    | 选填    | hybrid |
+| mark-as-general-write-request | 该参数可控制双活 pipe 之间能否同步外部 pipe 转发的数据(配置到双活外部 pipe 的发送端)(V2.0.5及以后版本支持) | Boolean: true / false。True:能同步;False:不能同步; | 选填       | False    |
+
 
 
 #### iotdb-air-gap-sink
@@ -623,6 +625,7 @@ pipe_all_sinks_rate_limit_bytes_per_second=-1
 | ssl.trust-store-path        | 连接目标端 DataNode 所需的 trust store 证书路径                                                                                                                                                          | String.Example: '127.0.0.1:6667,127.0.0.1:6668,127.0.0.1:6669', '127.0.0.1:6667' | 必填     | -            |
 | ssl.trust-store-pwd         | 连接目标端 DataNode 所需的 trust store 证书密码                                                                                                                                                          | Integer                                                                          | 必填     | -            |
 | format                      | 数据传输的payload格式, 可选项包括:<br>  - hybrid: 取决于 processor 传递过来的格式(tsfile或tablet),sink不做任何转换。<br> - tsfile:强制转换成tsfile发送,可用于数据文件备份等场景。<br> - tablet:强制转换成tsfile发送,可用于发送端/接收端数据类型不完全兼容时的数据同步(以减少报错)。 | String: hybrid / tsfile / tablet       | 选填    | hybrid |
+| mark-as-general-write-request | 该参数可控制双活 pipe 之间能否同步外部 pipe 转发的数据(配置到双活外部 pipe 的发送端) | Boolean: true / false。True:能同步;False:不能同步; | 选填       | False    |
 
 #### write-back-sink
 
diff --git a/src/zh/UserGuide/latest-Table/User-Manual/Data-Sync_apache.md b/src/zh/UserGuide/latest-Table/User-Manual/Data-Sync_apache.md
index 8eeac6d2..f42ef1c2 100644
--- a/src/zh/UserGuide/latest-Table/User-Manual/Data-Sync_apache.md
+++ b/src/zh/UserGuide/latest-Table/User-Manual/Data-Sync_apache.md
@@ -493,7 +493,7 @@ pipe_all_sinks_rate_limit_bytes_per_second=-1
 | password                    | 连接接收端使用的用户名对应的密码,同步要求该用户具备相应的操作权限                                                                                                                                                            | String                                                                     | 选填       | root         |
 | batch.enable                | 是否开启日志攒批发送模式,用于提高传输吞吐,降低 IOPS                                                                                                                                                                | Boolean: true, false                                                       | 选填       | true         |
 | batch.max-delay-seconds     | 在开启日志攒批发送模式时生效,表示一批数据在发送前的最长等待时间(单位:s)                                                                                                                                                       | Integer                                                                    | 选填       | 1            |
-| batch.max-delay-ms          | 在开启日志攒批发送模式时生效,表示一批数据在发送前的最长等待时间(单位:ms) (V2.0.5.1及以后版本支持)                                                                                                                                    | Integer                                                                    | 选填     | 1            |
+| batch.max-delay-ms          | 在开启日志攒批发送模式时生效,表示一批数据在发送前的最长等待时间(单位:ms) (V2.0.5及以后版本支持)                                                                                                                                    | Integer                                                                    | 选填     | 1            |
 | batch.size-bytes            | 在开启日志攒批发送模式时生效,表示一批数据最大的攒批大小(单位:byte)                                                                                                                                                        | Long                                                                       | 选填       | 16*1024*1024 |
 | compressor                  | 所选取的 rpc 压缩算法,可配置多个,对每个请求顺序采用                                                                                                                                                                | String: snappy / gzip / lz4 / zstd / lzma2                                 | 选填       | ""           |
 | compressor.zstd.level       | 所选取的 rpc 压缩算法为 zstd 时,可使用该参数额外配置 zstd 算法的压缩等级                                                                                                                                                | Int: [-131072, 22]                                                         | 选填       | 3            |
@@ -512,7 +512,7 @@ pipe_all_sinks_rate_limit_bytes_per_second=-1
 | password                    | 连接接收端使用的用户名对应的密码,同步要求该用户具备相应的操作权限                                                                                                                                                            | String                                                                           | 选填     | root         |
 | batch.enable                | 是否开启日志攒批发送模式,用于提高传输吞吐,降低 IOPS                                                                                                                                                                | Boolean: true, false                                                             | 选填     | true         |
 | batch.max-delay-seconds     | 在开启日志攒批发送模式时生效,表示一批数据在发送前的最长等待时间(单位:s)                                                                                                                                                       | Integer                                                                          | 选填     | 1            |
-| batch.max-delay-ms          | 在开启日志攒批发送模式时生效,表示一批数据在发送前的最长等待时间(单位:ms)(V2.0.5.1及以后版本支持)                                                                                                                                                      | Integer                                                                    | 选填     | 1            |
+| batch.max-delay-ms          | 在开启日志攒批发送模式时生效,表示一批数据在发送前的最长等待时间(单位:ms)(V2.0.5及以后版本支持)                                                                                                                                                      | Integer                                                                    | 选填     | 1            |
 | batch.size-bytes            | 在开启日志攒批发送模式时生效,表示一批数据最大的攒批大小(单位:byte)                                                                                                                                                        | Long                                                                             | 选填     | 16*1024*1024 |
 | compressor                  | 所选取的 rpc 压缩算法,可配置多个,对每个请求顺序采用                                                                                                                                                                | String: snappy / gzip / lz4 / zstd / lzma2                                       | 选填     | ""           |
 | compressor.zstd.level       | 所选取的 rpc 压缩算法为 zstd 时,可使用该参数额外配置 zstd 算法的压缩等级                                                                                                                                                | Int: [-131072, 22]                                                               | 选填     | 3            |
diff --git a/src/zh/UserGuide/latest-Table/User-Manual/Data-Sync_timecho.md b/src/zh/UserGuide/latest-Table/User-Manual/Data-Sync_timecho.md
index c49046c9..2a5cd4d3 100644
--- a/src/zh/UserGuide/latest-Table/User-Manual/Data-Sync_timecho.md
+++ b/src/zh/UserGuide/latest-Table/User-Manual/Data-Sync_timecho.md
@@ -589,6 +589,8 @@ pipe_all_sinks_rate_limit_bytes_per_second=-1
 | rate-limit-bytes-per-second | 每秒最大允许传输的 byte 数,计算压缩后的 byte(如压缩),若小于 0 则不限制                                                                                                                                                 | Double:  [Double.MIN_VALUE, Double.MAX_VALUE]                              | 选填     | -1           |
 | load-tsfile-strategy        | 文件同步数据时,接收端请求返回发送端前,是否等待接收端本地的 load tsfile 执行结果返回。<br>sync:等待本地的 load tsfile 执行结果返回;<br>async:不等待本地的 load tsfile 执行结果返回。                                                                     | String: sync / async                        | 选填      | sync     |
 | format                      | 数据传输的payload格式, 可选项包括:<br>  - hybrid: 取决于 processor 传递过来的格式(tsfile或tablet),sink不做任何转换。<br> - tsfile:强制转换成tsfile发送,可用于数据文件备份等场景。<br> - tablet:强制转换成tsfile发送,可用于发送端/接收端数据类型不完全兼容时的数据同步(以减少报错)。 | String: hybrid / tsfile / tablet    | 选填    | hybrid |
+| mark-as-general-write-request | 该参数可控制双活 pipe 之间能否同步外部 pipe 转发的数据(配置到双活外部 pipe 的发送端)(V2.0.5及以后版本支持) | Boolean: true / false。True:能同步;False:不能同步; | 选填       | False    |
+
 
 
 #### iotdb-air-gap-sink
@@ -624,6 +626,7 @@ pipe_all_sinks_rate_limit_bytes_per_second=-1
 | ssl.trust-store-path        | 连接目标端 DataNode 所需的 trust store 证书路径                                                                                                                                                          | String.Example: '127.0.0.1:6667,127.0.0.1:6668,127.0.0.1:6669', '127.0.0.1:6667' | 必填     | -            |
 | ssl.trust-store-pwd         | 连接目标端 DataNode 所需的 trust store 证书密码                                                                                                                                                          | Integer                                                                          | 必填     | -            |
 | format                      | 数据传输的payload格式, 可选项包括:<br>  - hybrid: 取决于 processor 传递过来的格式(tsfile或tablet),sink不做任何转换。<br> - tsfile:强制转换成tsfile发送,可用于数据文件备份等场景。<br> - tablet:强制转换成tsfile发送,可用于发送端/接收端数据类型不完全兼容时的数据同步(以减少报错)。 | String: hybrid / tsfile / tablet       | 选填    | hybrid |
+| mark-as-general-write-request | 该参数可控制双活 pipe 之间能否同步外部 pipe 转发的数据(配置到双活外部 pipe 的发送端) | Boolean: true / false。True:能同步;False:不能同步; | 选填       | False    |
 
 #### write-back-sink