---
title: "修改高可用功能的配置 | OceanBase 文档中心"
description: 修改高可用功能的配置 本文为您介绍高可用（HA）功能的概念、参数的含义和适用场景，以及如何在 OceanBase 迁移服务（OceanBase Migration Service，OMS）控制台配置高可用参数。 概述 高可用性集群 HA 是保证业务连续性的有效解决方案。在企业用户 7 x 24 小时运行的场景下，如果…
---
切换语言

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

文档反馈![](https://mdn.alipayobjects.com/huamei_22khvb/afts/img/A*L03BS6f-o40AAAAAAAAAAAAADiGDAQ/original) 迁移服务 OMSV 4.3.1 企业版

# 修改高可用功能的配置

更新时间：2026-04-14 15:36:02

本文为您介绍高可用（HA）功能的概念、参数的含义和适用场景，以及如何在 OceanBase 迁移服务（OceanBase Migration Service，OMS）控制台配置高可用参数。

## 概述

高可用性集群 HA 是保证业务连续性的有效解决方案。在企业用户 7 x 24 小时运行的场景下，如果数据同步发生中断（包括分钟级别的短暂中断），会对业务产生影响。

基于多年企业级使用场景的支撑，OceanBase 迁移服务（OceanBase Migration Service，OMS）提供可以秒级恢复的集群高可用架构，能够支持机器、机房粒度，甚至地区数据中心维度的容灾，以确保实现延迟敏感的企业用户的需求。所以发生服务器故障或 OMS 单节点故障时，不会导致整个 OMS 发生故障，该故障节点的任务会分发至其它节点执行。通常情况下，组件故障会分配给其它节点中的 Store 进行拉取。如果发生异常情况，会报错为任务运行异常。

OMS 支持高可用功能的组件包括 Store、Full-Import 和 Incr-Sync。Store HA 的管理粒度为 Subtopic。Store HA 会判断 Subtopic 是否异常，以此来对 Subtopic 下的 Store 进行 HA。所以开启 Store HA 后，并非一定遇到异常的 Store 会生成新的 Store 进行容灾。Store HA 的基本原则如下：

- HA 监测到异常状态的 Store 时，如果该 Store 的最近心跳时间与当前时间的差值不超过容忍的阈值 `checkModuleExceptionIntervalSec`，HA 会判定该异常 Store 是正常的。
 - Subtopic 下存在任意正常的 Store，Store HA 会认为该 Subtopic 正常，其它异常的 Store 均不会有 HA。
 - Subtopic 下不存在正常的 Store 时，分为如下场景：

     - 如果存在待主备切换的 Store，暂时不进行异常 HA，等待 Store 恢复。
     - 如果全部为异常的 Store，且该 Subtopic 下的 Store 数量未达到 HA 允许的阈值 `subtopicStoreNumberThreshold`，则 HA 会触发一个创建新 Store 的工单。否则不会有动作。
     - 如果存在部分异常停止的 Store，目前 HA 无法判断该 Subtopic 下的 Store 到达该状态的原因。

      如果该 Subtopic 下的 Store 数量未达到 HA 允许的阈值 `subtopicStoreNumberThreshold`，则 HA 触发一个创建新 Store 的工单。否则不会有动作。
     - 如果全部为停止的 Store，HA 不会有动作。
     - 目前 HA 会将非异常退出状态的 Store 当作正常停止状态的 Store。

## 高可用 HA 参数的含义

`ha.config` 文件的配置如下：

```yaml
{
  "enable":false,
  "enableHost":false,
  "enableStore":true,
  "perceiveStoreClientCheckpoint":false,
  "enableConnector":true,
  "enableJdbcWriter":true,
  "subtopicStoreNumberThreshold":5,
  "checkRequestIntervalSec":600,
  "checkJdbcWriterIntervalSec":600,
  "checkHostDownIntervalSec":540,
  "checkModuleExceptionIntervalSec":240,
  "clearAbnormalResourceHours":72,
  "refetchStoreIntervalMin":30
  }

```

| 参数 | 描述 | 默认值 |
| --- | --- | --- |
| enable | 是否开启 HA，取值包括 `true` 和 `false`。 | `false` |
| enableHost | 是否开启对 OMS 集群机器节点的高可用。取值包括 `true` 和 `false`。    机器宕机的场景下，高可用触发批量迁移 Incr-Sync 组件实例的工单。 有关 OMS 机器宕机迁移告警的详情，请参见 [oms_host_down OMS 机器宕机告警](https://www.oceanbase.com/docs/enterprise-oms-doc-cn-1000000004023192)。 | `false` |
| enableStore | 是否开启对 Store 组件实例的高可用，取值包括 `true` 和 `false`。 高可用具备支持 Store 主备切换、异常 Store 回收的能力：   - Store 主备切换 当 Subtopic 下存在处于主备切换状态的 Store 时，高可用会创建相应恢复 Store 的工单。 - 异常 Store 回收 当 Subtopic 下存在异常的 Store 时，高可用会判断异常 Store 的最近心跳时间与当前时间的差值是否超过高可用容忍的阈值 `clearAbnormalResourceHours`。 如果超过设置的阈值，则删除该 Store 的工单。 | `true` |
| perceiveStoreClientCheckpoint | 该参数为 Store HA 的高级功能。   - 当 `enable`、`enableStore` 和 `perceiveStoreClientCheckpoint` 均设置为 `true` 时，才会开启 Store HA 的高级功能，即可以根据下游组件的消费能力新建 Store。请注意新建 Store 的前提是 Subtopic 下 Store 数量未超过 `subtopicStoreNumberThreshold` 设置的阈值。     该情况下，如果 Subtopic 下无正常 Store 满足下游组件消费，高可用会以下游组件消费位点回拉 `refetchStoreIntervalMin` 前的 Store。 - 当 `enable` 和 `enableStore` 设置为 `true`，`perceiveStoreClientCheckpoint` 设置为 `false` 时，仅开启 Stroe 的高可用。     该情况下，如果 Subtopic 下存在异常 Store，高可用会以当前时间回拉 `refetchStoreIntervalMin` 前的 Store。 | `false` |
| enableConnector | Incr-Sync 守护开关，取值包括 `true` 和 `false`。`enableConnector` 适用于存在异常 Incr-Sync 的场景。 | `true` |
| enableJdbcWriter | 原 JDBCWriter 守护开关（OMS V4.0.1 之前版本），取值包括 `true` 和 `false`。`enableJDBCWriter` 适用于存在异常 JDBCWriter 的场景。   如果升级前 `enableConnector` 是 `false`，`enableJDBCWriter` 是 `true`，则升级后需要修改 `enableConnector` 为 `true`。 | `true` |
| subtopicStoreNumberThreshold | 高可用在执行处理操作前的校验，能够接受一个 Subtopic 下 Store 数量的最大上限。 | 5 |
| checkRequestIntervalSec | 同一个操作对象高可用工单触发的间隔时间（单位为秒）。 | 600 |
| checkJdbcWriterIntervalSec | 控制异常 Writer HA 的容忍时间。只有当 Writer 异常时，且超过容忍时间不活跃了才会 HA。 | 600 |
| checkHostDownIntervalSec | 针对宕机迁移场景，判断是否宕机的时间间隔，即机器多久未汇报过心跳（单位为秒）。 | 540 |
| checkModuleExceptionIntervalSec | HA 容忍异常 Store 的活跃时间阈值，单位为秒。开启 Store HA 后生效。 | 240 |
| clearAbnormalResourceHours | 使用 Store 的 GmtModfied，判断 Store HA 中清理冗余的异常 Store 的时间间隔（单位为小时）。 | 72 |
| refetchStoreIntervalMin | Store 的回拉时间，单位为分钟。 | 30 |

## 修改高可用 HA 的配置

您可以在 OMS 控制台修改 `ha.config` 文件中的参数：

1. 登录 OMS 控制台。
 2. 在左侧导航栏，单击 **系统管理** > **系统参数**。
 3. 在 **系统参数** 页面，找到 `ha.config`。
 4. 单击该参数名称 **取值** 后的编辑图标。
 5. 在 **修改取值** 对话框中，根据业务需求修改目标参数的取值。
 6. 单击 **确定**。

 上一篇 下一篇 ![有帮助](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) 咨询热线