---
title: "新建 OceanBase 单机数据源 | OceanBase 文档中心"
description: 新建 OceanBase 单机数据源 配置好数据源是创建数据迁移任务的前提。启动数据迁移任务前，您必须新建 OceanBase 数据库作为源端或者目标端的数据源。本文为您介绍如何在 OceanBase 迁移服务（OceanBase Migration Service，OMS）中新建 OceanBase 单机数据源。 …
---
切换语言

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

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

# 新建 OceanBase 单机数据源

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

配置好数据源是创建数据迁移任务的前提。启动数据迁移任务前，您必须新建 OceanBase 数据库作为源端或者目标端的数据源。本文为您介绍如何在 OceanBase 迁移服务（OceanBase Migration Service，OMS）中新建 OceanBase 单机数据源。

## 前提条件

- 已获取相关数据库的服务地址和端口号。
 - 已存在用于数据迁移的数据库用户。

  建议您为数据迁移任务创建一个专属的数据库用户，该用户必须具备相关的数据操作权限。详情请参见 [创建数据库用户](https://www.oceanbase.com/docs/enterprise-oms-doc-cn-1000000004023065)。

## 操作步骤

1. 登录 OMS 控制台。
 2. 在左侧导航栏，单击 **数据源管理**。
 3. 在 **数据源管理** 页面，单击右上角的 **新建数据源**。

   ![data-source5-zh](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/oms/oms-enterprise/data-source5-zh.png)
 4. 在 **新建数据源** 对话框，选择 **数据源类型** 为 **OceanBase**。
 5. 选择 **单机数据源**，配置各项参数。

   ![migration-45-zh](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/oms/oms-enterprise/migration-45-zh.png)

   | **参数** | **描述** |
   | --- | --- |
   | 数据源标识 | 建议使用中文、数字和字母的组合。名称中不能包含空格，长度不能超过 32 个字符。   **注意：**   数据源标识在 OMS 系统内是全局唯一的。 |
   | 地域 | 从下拉列表中选择数据源所属的地域。    **注意：**   - 仅多地域场景下会显示该参数。   - 请确保数据源与地域的映射关系保持一致，否则可能导致迁移同步性能较差。 |
   | 租户类型 | OceanBase 数据库的租户类型，目前支持 Oracle 和 MySQL 两种兼容模式的租户。 |
   | 输入方式 | 包括 **手动输入** 和 **命令行连接串**：    - **手动输入**：手动输入 OceanBase 数据库的主机 IP 和端口。   - **命令行连接串**：输入命令行连接串。 |
   | 命令行连接串 | 该参数仅选择 **输入方式** 为 **命令行连接串** 时显示。支持输入一段式或三段式，输入后会自动填充 **服务地址** 和 **端口**。命令行连接串示例：    - 一段式      `mysql -ht5zxxxx.oceanbase.aliyuncs.com -utest -P3306 -c -A -p`   - 三段式      `obclient -hxxx.xxx.xxx.xxx -P2891 -uuser@tenant#cluster -p` |
   | 主机 IP | 数据库宿主机的 IP。 |
   | 端口 | 数据库宿主机 IP 的端口号。 |
   | 租户名 | OceanBase 数据库租户的名称。 |
   | 数据库用户名 | 用于数据迁移或数据同步的 OceanBase 数据库用户名称。建议您为数据迁移或同步任务创建单独的数据库用户。 |
   | 数据库密码 | 数据库用户的密码。 |
   | 备注（可选） | 数据源的备注信息。 |
 6. （可选）在 **新建数据源** 对话框，单击 **高级选项** 右侧的 **展开**，根据业务需求配置相应参数。

   ![migration-46-zh](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/oms/oms-enterprise/migration-46-zh.png)

   | 参数 | 描述 |
   | --- | --- |
   | DRC 用户用户名（可选） | 该用户主要用于读取 OceanBase 数据库增量日志和数据库对象结构信息，请在业务集群 sys 租户下创建该用户。 |
   | 密码（可选） | drc_user 用户对应的密码。 |
   | __OCEANBASE_INNER_DRC_USER 密码（可选） | 本用户主要用于 OceanBase 数据库内无唯一键表的数据迁移。请注意：您需要在当前数据源所在的租户下创建本用户。 |

      - 创建以 OceanBase 物理数据源为源端的数据迁移/数据同步任务时：

            - 结构迁移/结构同步、增量同步需要输入用户名和密码。
            - 迁移无唯一键表时，需要输入 `__OCEANBASE_INNER_DRC_USER` 用户的密码。
      - 创建以 OceanBase 物理数据源为目标端的数据迁移任务时，反向增量需要输入用户名和密码。
 7. 单击 **测试连接**，验证 OMS 和数据源的网络连接，以及用户名和密码的有效性。
 8. 测试连接通过后，单击 **确定**。

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