---
title: rebuild_replica_data_lag_threshold 参数说明-OceanBase数据库使用指南
description: 了解OceanBase数据库在实际应用中关于rebuild_replica_data_lag_threshold 参数说明相关的常见问题和使用技巧，帮助您快速解决rebuild_replica_data_lag_threshold 参数说明的难题。
image: https://mdn.alipayobjects.com/huamei_22khvb/afts/img/A*OSPzQ6GUQF4AAAAAQHAAAAgAeiGDAQ/original
---
切换语言

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

划线反馈

# rebuild_replica_data_lag_threshold 参数说明

更新时间：2026-06-04 09:56

适用版本： V2.1.x、V2.2.x、V3.1.x、V3.2.x 内容类型：TechNote  

当节点故障重启时，OBServer 需要进行未落盘分区数据的 clog 回放，但如果该节点的分区数据副本和其他节点差很多数据时，回放时间会很长，会导致节点一直无法上线同时更新 start service。这种情况下可以通过 rebuild 副本重建的方式来拉起副本间的差异数据。

Rebuild 副本重建指的是当集群中某个副本落后数据量很大，拉日志、回放日志的方式太慢时，落后副本从源端直接拷贝数据。

由于 OceanBase 数据库的 clog 日志文件是本机所有 partition 混写的，每个 clog 文件 64MB，目的端落后多少日志量作为触发 rebuild 的阈值比较合适是无法确定的，所以提供了 rebuild_replica_data_lag_threshold 参数来供用户根据实际情况自行调整。

**参数：** `rebuild_replica_data_lag_threshold`（默认值为 0，表示不触发副本重建）。

**该参数含义：** 控制 rebuild 的触发条件，目的端至少落后多少数据量才能触发 rebuild。

```shell
alter system set rebuild_replica_data_lag_threshold='1G';

```

## 影响租户

影响 OceanBase 数据库中的 SYS 租户和 Oracle 租户以及 MySQL 租户。

## 适用版本

OceanBase 数据库 V2.x、V3.x 版本。

上一篇

[公有云 OBServer 节点频繁 inactive](https://www.oceanbase.com/knowledge-base/oceanbase-database-1000000002382059)

下一篇

[添加 observer 节点报错 Server state or role not the same as expected](https://www.oceanbase.com/knowledge-base/oceanbase-database-1000000002395682) ![有帮助](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) 咨询热线