本场景介绍如何在数据库传输服务 DTS 控制台创建专有网络 Milvus 同步至火山引擎版 Milvus。 ## 前提条件 * 已创建向量数据库 Milvus 版数据库实例。详细操作，请参见[创建实例](https://www.volcengine.com/docs/85665/1563970)。 * 按需设置源端信息，具体如下所示： * 在使用 VPN 实现数据同步时，自建数据库所属的本地网络已通过 VPN 网关接入火山引擎。详细操作，请参见搭建云上VPC与云下多数据中心网络互通。 * 在需要使用专线实现数据同步时，您需要搭建云上单私有网络和云下单数据中心网络连通的专线连接。详细操作，请参见配置专线连接。 * 当您的实例是通过专有网络连接时，专有网络的子网需要和源端或目标端的数据库有连通，同时为了能让 DTS 可以正常访问专有网络的实例，您需要将该子网网段加入到源端或目标端数据库的白名单或安全组规则中。更多信息，请参见[添加 DTS 服务器的 IP 地址段](https://www.volcengine.com/docs/6390/1251506?lang=zh)。 * 已确认源端和目标端的网络连通性与服务可用性。 ## 注意事项 * 目前该功能仅对华南 1（广州）、华东 2（上海）、华北 2（北京）和亚太东南（柔佛）地域开放。 * Milvus 数据库支持 `Insert` 和 `Upsert` 两种写入方式，更多信息，请参见 [Milvus 主字段和自动识别](https://milvus.io/docs/zh/primary-field.md#Overview)。在同步数据时，`Insert` 和 `Upsert` 两种写入方式的区别和适用场景如下。 * `Insert`：使用 `Insert` 命令直接插入数据，适用于 Collection 开启 AutoID 且源端与目标端数据（含主键）一致的场景。当 DTS 重启或重复拉取数据时，可能会造成目标端数据冗余。 * `Upsert`：使用 `Upsert` 命令直接插入数据或更新现有数据。适用于更新现有数据，Collection 未开启 AutoID，或 Collection 开启 AutoID 但业务或校验不依赖主键的场景。当 DTS 重启或重复拉取数据时，可能会导致主键不一致，影响依赖主键的业务或校验。 * 同步过程中，请勿变更实例的配置，否则同步任务不成功。 * 暂不支持同步开启 SSL 的实例。 ## 使用限制 |**类型** |**说明** | |---|---| |源库限制 |* 数据库版本：当前支持 2.5、2.6 的 Milvus 引擎版本。

* 带宽要求，源库所属的服务器需具备足够出口带宽，否则将影响数据同步的速率。 | |目标库限制 |Milvus 引擎版本为 2.5、2.6。 | |其他限制 |* 当前暂不支持 Role/User 权限同步。

* 建议源库和目标库的 Milvus 版本保持一致，或者从低版本同步至高版本以保障兼容性。如果是高版本同步至低版本，可能存在数据库兼容性或数据丢失问题。

* 执行数据同步前需评估源库和目标库的性能，建议在业务低峰期执行数据同步。否则全量数据同步时 DTS 占用源和目标库一定的读写资源，可能会导致数据库的负载上升。

* 在同步过程中，目标数据库可能会产生大量日志或数据文件，导致目标库的磁盘使用量显著增加。建议您在同步前，检查并配置目标数据库的日志保留策略或数据清理机制，避免占用过多存储空间。 | ## 账号最小权限说明 |**数据库** |**权限** | |---|---| |源库 |Root 权限或授予 ClusterAdmin、DatabaseAdmin 和 CollectionAdmin 的 User 权限。 | |目标库 |Root 权限或授予 ClusterAdmin、DatabaseAdmin 和 CollectionAdmin 的 User 权限。 | ## 支持的同步架构 * 一对一单向同步 * 一对多单向同步 * 多对一单向同步 * 级联单向同步关于数据库传输服务 DTS 支持的同步拓扑类型和使用说明，请参见[数据同步拓扑](https://www.volcengine.com/docs/6390/118849)。 ## 操作步骤 1. 登录 [DTS 控制台](https://console.volcengine.com/dts)。 2. 在顶部菜单栏，选择项目和地域。 3. 在左侧导航栏，单击**数据同步**。 4. 在**同步任务列表**页面，单击**创建任务**。 5. 在**创建同步任务**页面的**配置源库及目标库**配置向导页面，配置以下参数信息。 |**类别** |**参数** |**说明** | |---|---|---| |**基本信息** |**任务名称** |（可选）自定义同步任务名称。长度需在 256 个字符内。

若未进行设置，系统将按照命名规则，默认生成一个以 dts\- 开头命名的任务。 | ||**链路规格** |按需选择同步任务的链路规格，当前支持 **Compact**、**Medium** 和 **Standard**。

成功创建任务后，不支持修改任务的链路规格。关于链路规格的详细信息，请参见[产品规格](https://www.volcengine.com/docs/6390/79112)。 | ||**同步拓扑** |根据业务需要选择同步拓扑，当前 Milvus 数据库仅支持**单向同步**。

关于同步拓扑的更多信息，请参见[数据同步拓扑](https://www.volcengine.com/docs/6390/118849)。 | |**源库配置** |**选择已有数据源** |当前暂不支持在数据源中录入 Milvus 相关实例信息，您需要配置以下数据库实例信息。 | ||**实例类型** |选择 **Milvus**。 | ||**接入方式** |接入方式选择 **EndpointExpressMilvus**。 | ||**地域** |按需选择目标实例的地域。 | ||**地址** |输入目标实例的地址，支持输入多个地址使用英文逗号（,）隔开。 | ||**私有网络** |从下拉列表中选择目标私有网络，具体如下所示：

* 专线连接：通过专线 CEN 实现数据连通时，选择 CEN 下所属的任意私有网络。

* VPN 连接：通过 VPN 实现数据连通时，选择 VPN 网关绑定的私有网络。 | ||**子网** |从下拉列表中选择私有网络中的子网。

在同步专有网络 Milvus 实例时，您需要提前在源端的白名单或安全组策略中，添加子网 IP 段的访问权限。单击**查看子网 IP 段**查看和复制 IP 段。 | ||**数据库账号** |输入需要进行数据同步的数据库账号。 | ||**数据库密码** |输入对应账号的密码。 | ||**测试连接** |单击**测试连接**，验证是否成功连接实例。

当测试连接失败时，根据失败提示信息修改相关配置后，再次单击**测试连接**，验证是否可以成功连接实例。具体提示信息如下：

* **连接认证失败，请检查网络是否正常**：当出现该报错提示时，请确认网络的连通性。

* **连接认证失败，请检查用户名和密码是否正确**：当出现该报错提示时，您需要确认用户名和密码的准确性。

* **连接认证失败，无法正常创建连接，请联系客服**：当出现该报错提示时，请[提交工单](https://console.volcengine.com/workorder/create)联系技术人员。

* **无效的 IP 地址**：当出现该报错提示时，请确认 IP 地址的正确性。

* **专有网络需要子网有 \* 个可用 IP，当前私有网络内子网可用 IP 数不足，无法创建任务，请检查私有网络内子网资源**：当出现该报错提示时，您需要调整私有网络子网内可用的 IP 数量，以保证目标私有网络内子网内有足够的 IP。 | |**目标库配置** |**选择已有数据源** |当前暂不支持在数据源中录入 Milvus 相关实例信息，您需要配置以下数据库实例信息。 | ||**实例类型** |选择 **Milvus**。 | ||**接入方式** |接入方式选择 **EndpointVolcMilvus**。 | ||**地域** |按需选择目标实例的地域。 | ||**Milvus 实例** |从下拉列表中选择目标实例，支持模糊搜索。 | ||**数据库账号** |输入需要进行数据同步的数据库账号。 | ||**数据库密码** |输入对应账号的密码。 | ||**测试连接** |单击**测试连接**，验证是否成功连接实例。当测试连接失败时，根据失败提示信息修改相关配置后，再次单击**测试连接**，验证是否可以成功连接实例。具体提示信息如下：

* **连接认证失败，请检查用户名和密码是否正确**：当出现该报错提示时，您需要确认用户名和密码的准确性。

* **连接认证失败，无法正常创建连接，** **请联系客服**：当出现该报错提示时，请[提交工单](https://console.volcengine.com/workorder/create)联系技术支持。 | |**Project 与计费**

|**项目** |（可选）从下拉列表中选择该任务所属项目，默认在 **default(默认项目)** 下。您也可以单击**创建新项目**，创建新的项目。详细操作，请参见[新建项目](https://www.volcengine.com/docs/6649/94336#%E6%96%B0%E5%BB%BA%E9%A1%B9%E7%9B%AE)。

* 关于如何授予子用户访问指定项目下资源的权限操作步骤，请参见[修改项目权限](https://www.volcengine.com/docs/6649/173422#%E4%BF%AE%E6%94%B9%E9%A1%B9%E7%9B%AE%E6%9D%83%E9%99%90)。

* 成功创建任务后，如果需要修改实例的所属项目，例如将任务从当前项目移入至其他项目，您可以将资源移入指定项目。

* 项目是一个虚拟的概念，包括一组资源、用户和角色。通过项目可以对一组资源进行统一的查看和管理，并且控制项目内用户和角色对这些资源的权限。 | ||**标签** |（可选）单击**添加标签**，为实例添加标签。标签可帮您实现云资源的分类、云资源的访问控制、账单与成本分摊等。标签由一个键值对（Key\-Value）组成，用于标识云资源，可以帮助您从不同维度（例如用途、所有者等）对具有相同特征的云资源进行分类，便于筛选和聚合，从而轻松管理云上资源。关于标签的详细信息，请参见[标签概述](https://www.volcengine.com/docs/6649/189377)。标签的键值对规则如下：

* 键

* 支持任何语言、文字、数字、空格或符号（_.:/=+\-@）。

* 大小写敏感，且长度在 1~128 个字符内。

* 使用 UTF\-8 编码的 Unicode 格式。

* 不支持设置以 volc: 开头的任何形式的 Key，例如 Volc:、VOLC: 等。

* （可选）值

* 支持任何语言、文字、数字、空格或符号（_.:/=+\-@）。

* 大小写敏感，且长度在 0~256 个字符内。

* 使用 UTF\-8 编码的 Unicode 格式。

* 支持模糊搜索选择已有标签键和标签值。

* 单次最多可给任务绑定 20 个标签。单个任务最多可绑定 50 个标签。

* 同一个资源拥有的标签 Key 不可重复，且一个标签 Key 只有一个值 Value。 | ||**计费方式** |按需选择计费方式，当前支持**按量计费**和**包年包月**两种计费方式。

关于计费的详细信息，请参见[计费说明](https://www.volcengine.com/docs/6390/79114)。 | ||**购买时长** |按需选择包年包月的购买时长。

在**计费方式**选择**包年包月**时，支持设置购买时长，同时您还可以勾选**到期自动续费**，系统会在任务到期前自动续费。 | 6. 单击**下一步:配置同步对象**。 7. 在**配置同步对象**配置向导页面，配置以下参数信息。 |**参数** ||**说明** | |---|---|---| |**同步类型** ||当前仅支持选择全量初始化。 | |**写入方式** ||按需选择数据写入方式，两种写入方式的区别和适用场景如下。

* `Insert`：使用 `Insert` 写入数据时，Milvus 不检查目标端主键的唯一性，直接写入数据。Insert 写入方式适用于 Collection 开启 AutoID 且源端与目标端数据（含主键）一致的场景。当 DTS 重启或重复拉取数据时，可能会造成目标端数据冗余。

* `Upsert`：使用 `Upsert` 写入数据时，Milvus 检查目标端是否已存在该主键，当不存在该主键时，直接写入；如果存在该主键，将删除原数据，然后写入新的数据。当 Collection 开启 AutoID 时，Milvus 忽略原数据的主键信息，并为其生成新的主键。Upsert 写入方式适用于更新现有数据，且 Collection 未开启 AutoID，或 Collection 开启 AutoID 但业务或校验不依赖主键的场景。当 DTS 重启或重复拉取数据时，可能会导致主键不一致，影响依赖主键的业务或校验。

Milvus 是否开启 AutoID，与写入方式的选择，对业务造成的影响区别较大，更多信息，请参见 [Milvus 主字段和自动识别](https://milvus.io/docs/zh/primary-field.md#Overview)。 | |**同步对象** ||选择需要同步的对象，支持通过**普通搜索**和**全局搜索**方式查询目标对象。同时，您可以在**已选择对象**区域中实现以下操作：

* 重命名库或表：单击目标库、表和视图后的笔状图标，重命名库、表和视图。如果在**同步对象**区域勾选了整库，则在**已选择对象**区域仅支持修改库名，且不支持展开该数据库。单击**批量映射**，可以批量修改库或表名，更多信息请参见[库表批量映射](https://www.volcengine.com/docs/6390/1811821)。

* 筛选删除不需要的目标：在**已选择对象**区域的搜索框内支持模糊搜索，批量删除不需要的数据库、表等目标。

在**同步对象**或**已选择对象**区域支持通过正则表达式搜索目标对象。 | |**高级配置** |**错误重试时间** |在同步任务中，当源库和目标库断连后导致同步任务失败时，会立即在指定时间内多次重试连接源库和目标库。取值范围：600~86400，单位：秒(s)。默认值为 600 秒。 | 8. 单击**预检查**。 9. （可选）当创建的任务已有预检查时，您可以根据以下提示确认是否重新发起预检查，当需要重新发起预检查时，请在**是否重新发起预检查**对话框，单击**确定**。 * 若源端和目标端的数据库实例未做修改，则无需再次发起预检查。 * 如果修改了源端、目标端的数据库实例信息或同步任务的参数配置，那么建议您重新发起预检查，否则可能会导致任务启动失败或者任务中断。 10. 在**预检查**配置向导页面，根据检查结果执行以下操作： * 单击预检查结果**操作**列的**详情**，查看详细的告警和失败信息，并根据告警或失败信息修改库表后，单击**重试**。 * 单击**操作**列的**忽略**，忽略本次告警继续启动同步任务。同时，也可以单击**忽略全部**，一键忽略全部告警信息。 * 选择**忽略**告警并启动同步任务，可能导致数据不一致，带来业务风险。 * 关于预检查的具体说明，请参见[预检查项](https://www.volcengine.com/docs/6390/1863301?lang=zh)。 11. 在**预检查**页面右下角，单击**确认订单**。 12. 根据创建任务的计费类型，选择配置方式： * 按量付费在**确认订单**配置向导页面，再次确认配置信息。阅读《数据库产品和服务条款》并勾选**我已阅读并同意《数据库产品和服务条款》** ，然后单击**创建并启动任务**。 * 包年包月 1. 在**确认订单**配置向导页面，再次确认配置信息。阅读《数据库产品和服务条款》并勾选**我已阅读并同意《数据库产品和服务条款》** ，然后单击**创建并启动任务**。 2. 在**确认订单信息**配置向导页面，确认任务的计费信息。 3. （可选）单击**代金券兑换**，在**代金券兑换**对话框，输入代金券兑换码后单击**兑换**。 4. （可选）在代金券区域，按需勾选可用代金券，单次仅支持选中一张，即可抵扣部分费用。也可不使用代金券。 5. 单击**下一步**。在**支付完成**配置向导页面，显示**支付成功**则任务创建成功。成功创建数据同步任务后，您可以返回 DTS 控制台，在数据同步任务列表查看数据同步任务的信息。 ## 相关 API |**API** |**描述** | |---|---| |[CreateTransmissionTask](https://www.volcengine.com/docs/6390/76168?lang=zh) |调用 CreateTransmissionTask 接口创建数据库传输服务任务。 | |[ModifyTransmissionTask](https://www.volcengine.com/docs/6390/76196?lang=zh) |调用 ModifyTransmissionTask 接口修改传输任务。 |