---
title: "新建 TiDB 数据源 | OceanBase 文档中心"
description: 新建 TiDB 数据源 配置好数据源是创建数据迁移项目的前提。启动数据迁移前，您必须新建 TiDB 数据库作为数据源。本文为您介绍如何在 OceanBase 迁移服务（OceanBase Migration Service，OMS）新建 TiDB 数据源。 前提条件 已获取相关数据库的 IP 地址和端口号。 已存在用…
---
切换语言

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

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

# 新建 TiDB 数据源

更新时间：2026-04-14 15:35:47

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

## 前提条件

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

  建议您为数据迁移项目创建一个专属的数据库用户，该用户必须具备相关的数据操作权限。详情请参见 [创建数据库用户](https://www.oceanbase.com/docs/enterprise-oms-doc-cn-10000000001904407)。
 - 如果您需要订阅 TiDB 增量日志，请准备 Kafka 数据源和 Kafka Topic。并且，请根据 [TiDB 官方文档](https://docs.pingcap.com/zh/tidb/dev/manage-ticdc#sink-uri-%E9%85%8D%E7%BD%AE-kafka)，提前创建 TiDB 数据库至 Kafka 的项目。

  #### 注意

  您在 TiDB 数据库中配置的待订阅库表，需要和 OMS 数据迁移项目中配置的库表名保持一致。

## 操作步骤

1. 登录 OMS 控制台。
 2. 在左侧导航栏，单击 **数据源管理**。
 3. 在 **数据源管理** 页面，单击右上角的 **新建数据源**。
 4. 在 **新建数据源** 对话框，选择 **数据源类型** 为 **TiDB**。
 5. 配置各项参数。

   | **参数** | **描述** |
   | --- | --- |
   | 数据源标识 | 建议使用中文、数字和字母的组合。名称中不能包含空格，长度不能超过 32 个字符。 |
   | 地域 | 从下拉列表中选择数据源所属的地域（即部署 OMS 时配置的 `cm_region` 参数）。    **注意：**   - 仅多地域场景下会显示该参数。   - 请确保数据源与地域的映射关系保持一致，否则可能导致迁移同步性能较差。 |
   | 主机 IP | TiDB 角色节点 IP。 |
   | 端口 | TiDB 角色节点 IP 的端口号。 |
   | 用户名 | 用于数据迁移或数据同步的 TiDB 数据库的用户名称。 |
   | 密码 | 数据库用户的密码。 |
   | DB Name（可选） | TiDB 数据库的名称。   **说明**   如果您配置了 DB Name，当数据源作为源端时，数据迁移项目仅支持选择指定 DB Name 下的迁移对象。 |
   | 绑定 Kafka 数据源 | Kafka 提供 OMS 获取 TiDB 增量日志的能力。    - 如果勾选该项，请在下拉列表中选择需要绑定的 **Kafka 数据源** 及其 **Topic**。   - 如果未勾选该项，创建 TiDB 数据库至 OceanBase 数据库 MySQL 租户的数据迁移项目时，无法选择增量同步。 |
   | 备注（可选） | 数据源的备注信息。 |
 6. 单击 **测试连接**，验证 OMS 和数据库的网络连接，以及用户名和密码的有效性。
 7. 测试连接通过后，单击 **确定**。

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