---
title: "下载和导入同步对象配置 | OceanBase 文档中心"
description: 下载和导入同步对象配置 OceanBase 迁移服务（OceanBase Migration Service，OMS）支持下载数据同步任务的同步对象配置信息，并支持通过导入 CSV 文件的方式实现自动配置和确认同步对象的配置信息，以实现保存任务配置信息和批量、快速配置任务。导入对象功能通常适用于百+对象进行批量重命名…
---
切换语言

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

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

# 下载和导入同步对象配置

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

OceanBase 迁移服务（OceanBase Migration Service，OMS）支持下载数据同步任务的同步对象配置信息，并支持通过导入 CSV 文件的方式实现自动配置和确认同步对象的配置信息，以实现保存任务配置信息和批量、快速配置任务。导入对象功能通常适用于百+对象进行批量重命名和设置操作。

## 导入对象的格式

- 同步 ODP 逻辑表的数据至 OceanBase 数据库 MySQL 兼容模式时，导入的 CSV 文件需要包含的列如下所示：

  源端库名、源端表名、目标端库名、目标端表名、列映射、分片列（分号分割）。
 - 除 ODP 逻辑表至 OceanBase 数据库 MySQL 兼容模式类型的数据同步任务外，其他类型的数据同步任务导入的 CSV 文件需要包含的列如下所示：

  源端库名、源端表名、Topic 名、选择列（分号分割）、列映射、分片列（分号分割）、行过滤条件。

## 下载对象配置

新建源端非 IDB 数据源的数据同步任务后，您可以下载同步对象的配置信息。

#### 注意

源端为 IDB 数据源的数据同步任务，不支持下载对象配置信息。

1. 登录 OMS 控制台。
 2. 在左侧导航栏，单击 **数据同步**。
 3. 在 **数据同步** 页面，单击目标数据同步任务的名称。
 4. 在目标任务的详情页面，单击右上角的 **更多操作** > **下载对象配置**。

## 导入对象配置

OMS 支持导入 CSV 文件的方式进行库表重命名、设置行过滤条件、设置过滤列和设置分片列等操作。您可以下载已有任务的对象配置信息或 CSV 文件模板，根据实际情况修改后导入。

#### 注意

如果您使用 Excel 文件进行编辑，请将其保存为以逗号（,）分割的 CSV 文件再进行导入。

1. 将数据同步任务配置至 **选择同步对象** 步骤。

   详情请参见相应类型的 [数据同步](https://www.oceanbase.com/docs/enterprise-oms-doc-cn-1000000004023000) 任务文档。
 2. 选择 **指定对象** 方式后，单击 **目标端对象** 列表右上角的 **导入对象**。

   #### 注意

   源端为 IDB 数据源的数据同步任务，不支持导入对象。

   ![oms84-zh](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/oms/oms-enterprise/oms84-zh.png)
 3. 在提示框中，单击 **确定**，进入导入同步对象操作框。
 4. 单击 **导入同步对象** 对话框下方的 **导入 CSV 文件**，选择保存在本地的 CSV 文件进行导入。

   您也可以单击对话框下方的 **下载 CSV 模板文件**，下载模板后根据实际情况修改配置信息，然后再单击 **导入 CSV 文件**，导入同步对象。
 5. 导入对象界面会显示 CSV 文件的具体内容，您可以根据实际情况进行编辑。

   #### 说明

      - CSV 文件可以通过 SQL 脚本、手工编辑，以及任务详情页面的 **下载对象配置** 生成。
      - 通过录入与源端不同的库名或者表名来实现库表名映射。  

   ![oms85-zh](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/oms/oms-enterprise/oms85-zh.png)
 6. 单击 **检验合法性**，校验源端类型、行过滤条件是否正确等。如果校验成功，会显示校验成功的表和视图的数量。
 7. 通过合法性的检验后，单击 **确定**，返回数据同步任务的 **选择同步对象** 页面。
 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) 咨询热线