---
title: "设置日志同步限速 - OceanBase 数据库 V4.6.0 | OceanBase 文档中心"
description: 设置日志同步限速 备库与主库之间的带宽在某些业务场景中（例如，跨 Region 容灾场景）是一种稀缺资源，需要合理使用并进行适当限速。 OceanBase 数据库提供了以下两个集群级配置项用于备库的限速： standby_fetch_log_bandwidth_limit ：用于设置备租户所在集群中，可用于备租户从主…
---
切换语言

- 中文站 - 简体中文
- International - English
- 日本站 - 日本語

文档反馈![](https://mdn.alipayobjects.com/huamei_22khvb/afts/img/A*P8CuR4UJ_FkAAAAAAAAAAAAADiGDAQ/original) OceanBase 数据库分布式版 - V 4.6.0

# 设置日志同步限速

更新时间：2026-06-20 18:12:54

[编辑](https://github.com/oceanbase/oceanbase-doc/edit/V4.6.0/zh-CN/600.manage/400.high-availability/300.physical-standby-database-disaster-recovery/300.log-transport-service/700.set-log-synchronization-speed-limit.md)  

备库与主库之间的带宽在某些业务场景中（例如，跨 Region 容灾场景）是一种稀缺资源，需要合理使用并进行适当限速。

OceanBase 数据库提供了以下两个集群级配置项用于备库的限速：

- `standby_fetch_log_bandwidth_limit`：用于设置备租户所在集群中，可用于备租户从主租户或源端租户进行日志同步的所有带宽的总和。该配置项的取值范围为 [0, 10000G]，默认值为 `0`，表示不对带宽进行限制。该配置项修改后立即生效。

  修改配置项 `standby_fetch_log_bandwidth_limit` 的值后，OceanBase 数据库内部会使用一套自适应的分配策略，在集群的多个 OBServer 节点之间再分配单个节点可用的合适的带宽上限值，以便达到带宽资源的利用率最大化。
 - `_server_standby_fetch_log_bandwidth_limit`：用于设置备租户所在集群的单个 OBServer 节点中，可用于备租户从主租户或源端租户进行日志同步的带宽。该配置项的取值范围为 [0, 1000G]，默认值为 `0`，表示不按照 Server 级进行限速，使用基于配置项 `standby_fetch_log_ratelimit` 分配得到的带宽。该配置项修改后立即生效。

  修改配置项 `_server_standby_fetch_log_bandwidth_limit` 的值后，设置了限速的 OBServer 节点将会优先使用此限速值，同时 `standby_fetch_log_bandwidth_limit` 所配置的限速值将分配给其余的 OBServer 节点使用，即如果同时设置了配置项 `standby_fetch_log_bandwidth_limit` 和 `_server_standby_fetch_log_bandwidth_limit`，则集群可使用的总带宽值为两者之和。

## 注意事项

- 不建议将备租户的带宽限速值设置得特别小，生产环境下需要评估设置限速可能带来的业务影响，例如，备库限速可能会导致备库持续落后、日志断流等。
 - 在 OceanBase 数据库中，名称以 "_" 开头的配置项称为隐藏配置项，仅供开发人员在故障排查或紧急运维时使用。

## 设置方法

1. 使用 `root` 用户登录备租户所在集群的 `sys` 租户。
 2. 执行以下命令，设置备租户的限速值。

      - 设置集群的总可用带宽

       ```sql
       ALTER SYSTEM [SET] standby_fetch_log_bandwidth_limit = value;

       ```

       示例如下：

       ```shell
       obclient(root@sys)[(none)]> ALTER SYSTEM SET standby_fetch_log_bandwidth_limit = '50M';

       ```
      - 设置单个 OBServer 节点的可用带宽

       ```sql
       ALTER SYSTEM [SET] _server_standby_fetch_log_bandwidth_limit = value SERVER [=] 'svr_ip:svr_port';

       ```

       语句使用说明：

            - `svr_ip`：待设置的 OBServer 节点的 IP。
            - `svr_port`：待设置的 OBServer 节点的 RPC 端口号。
            - 仅支持指定一个 OBServer 节点。

       示例如下：

       ```shell
       obclient(root@sys)[(none)]> ALTER SYSTEM SET _server_standby_fetch_log_bandwidth_limit = '30M' SERVER = 'xx.xx.xx.xx:17854';

       ```

## 相关文档

- [查看集群配置项](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000005682473)
 - [修改集群配置项](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000005682476)

 上一篇 下一篇 ![有帮助](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*y6ocSqN8cqsAAAAAAAAAAAAAARQnAQ)![无帮助](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*BG9IQJyLHF8AAAAAAAAAAAAAARQnAQ)![反馈](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*eTWdQKCRKHwAAAAAAAAAAAAAARQnAQ)[AI](https://www.oceanbase.com/obi) 咨询热线