---
title: "OMS 元数据库的主备切换 | OceanBase 文档中心"
description: OMS 元数据库的主备切换 本文为您介绍当 OMS 社区版元数据库的主库出现问题时，如何切换至备库，并完整保留主库的数据。 操作步骤 备份元数据库。手工备份 rm、cm 和 cm_hb 库为 SQL 文件，并确认三个文件的大小不为 0。 mysqldump -hxxx.xxx.xxx.1 -P<port> -u<us…
---
切换语言

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

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

# OMS 元数据库的主备切换

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

[编辑](https://github.com/oceanbase/oms-doc/edit/V4.2.9/zh-CN/1400.faq/1000.deployment/500.switching-between-active-and-standby-databases.md)  

本文为您介绍当 OMS 社区版元数据库的主库出现问题时，如何切换至备库，并完整保留主库的数据。

## 操作步骤

1. 备份元数据库。手工备份 rm、cm 和 cm_hb 库为 SQL 文件，并确认三个文件的大小不为 0。

   ```shell
   mysqldump -hxxx.xxx.xxx.1 -P<port> -u<username> -p<password> --triggers=false oms_cm_hb_regression > /home/admin/oms_cm_hb_regression.sql

   mysqldump -hxxx.xxx.xxx.1 -P<port> -u<username> -p<password> --triggers=false oms_cm_regression > /home/admin/oms_cm_regression.sql

   mysqldump -hxxx.xxx.xxx.1 -P<port> -u<username> -p<password> --triggers=false oms_rm_regression > /home/admin/oms_rm_regression.sql

   ```

   | 参数 | 描述 |
   | --- | --- |
   | -h | 需要导出的主机信息。 |
   | -P | 连接数据库的端口号。 |
   | -u | 指定连接的用户名。 |
   | -p | 连接数据库的密码。 |
   | --triggers | 导出触发器，默认为 false（不导出）。 |
   | oms_cm_hb_regression、oms_cm_regression、oms_rm_regression | 此处为备份 rm、cm 和 cm_hb 库为 SQL 文件，格式为 `库名 > 存储 SQL 文件的路径.sql`，请替换为实际环境中的值。 |
 2. 进入 Docker 容器。

   ```shell
   docker exec -it ${CONTAINER_NAME} bash

   ```
 3. 在 `root` 目录，执行切换元数据库的脚本。

   ```shell
   sh docker_update_meta_db.sh

   ```
 4. 根据提示完成切换流程。每次输入后，通过回车进入下一步。

      1. 在 **开始修改配置元信息库** 步骤，根据界面提示，依次输入元信息数据库的 IP、端口、用户名和密码。

        您可以修改 MySQL 数据库或 OceanBase 社区版的元信息数据库，用于存储 OMS 社区版运行时的元数据信息。
      2. 等待 **修改 OMS 各组件库链接配置文件** 步骤自动执行完成。
      3. 在 **是否需要初始化元数据库表** 步骤，确认是否初始化。

             - 输入 y，会自动在新切换的地址中创建 OMS 社区版元数据需要使用的库表。
             - 输入 n，则不会创建库表。请注意前提是新切换的地址中已存在 OMS 社区版需要使用的库表。
      4. 等待组件重启成功。
 5. 登录 OMS 社区版控制台，确认环境是否正常。

   您还可以查看 `/home/admin/conf/config.yaml` 配置文件，确认元数据库配置已更改为新的元数据库。

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