文档中心

数据库传输服务

源为专有网络 Redis

迁移至专有网络 Redis

本文介绍如何在数据库传输服务 DTS 控制台创建专有网络 Redis 迁移至专有网络 Redis 任务。

前提条件

已自行搭建通过专有网络接入的 Redis 实例，并设置数据库账号和密码。

按需设置源端和目标端信息，具体如下所示：

在使用 VPN 实现数据迁移时，自建数据库所属的本地网络已通过 VPN 网关接入火山引擎。详细操作，请参见搭建云上VPC与云下多数据中心网络互通。

在需要使用专线实现数据迁移时，您需要搭建云上单私有网络和云下单数据中心网络连通的专线连接。详细操作，请参见配置专线连接。

已确认源库和目标库的网络连通性与服务可用性。

注意事项

迁移任务默认进行全量迁移和增量迁移。当源库没有 SYNC 或 PSYNC 权限时，可以选择仅全量迁移。仅全量迁移采用 Scan 方式，通过遍历整个源端数据库的方式，将数据迁移到目标端。Scan 方式会导致源端数据库高负载，请在业务低峰期进行。

当源库为自建 Redis 时，在迁移过程中，请勿对源库或目标库进行重启或主备切换，否则将导致迁移任务失败。

如果不同 DB 映射到相同 DB，当同名 Key 在不同 DB 均存在时，迁移会带来不可预期的结果，例如数据不一致或任务失败等。

迁移过程中，请勿变更实例的配置，否则迁移任务不成功。

在创建专有网络数据迁移任务的过程中，系统会默认在您选择的私有网络内创建数张网卡，网卡会默认挂载到您选择的子网上。网卡的名称格式为 dts_shuttle_********。

您可以通过分片到分片的形式迁移集群版实例。

在全量和增量迁移 Stream 的任务中，请勿在目标数据库实例中进行双写操作，否则可能会导致任务迁移失败。

暂不支持迁移开启 SSL 的实例。

在数据迁移的过程中，若遇到目标库中已存在同键值情况，DTS 不会保留目标端中冲突的数据，即源端的数据将会覆盖掉目标端的数据。

在仅全量迁移场景下，若源端存在大 Key 或网络环境欠佳，可能会出现导出（dump）超时失败的情况。建议将大 Key 进行拆分或删除后重试。若任务仍无法恢复，请提交工单联系技术支持。

迁移至专有网络集群版实例时，集群版实例需支持 Cluster Nodes 命令，否则无法成功创建任务。

在源端实例为集群版专有网络实例时，仅支持迁移 0 号数据库数据。

当目标端连接的实例是专有网络集群版实例时，您需关注以下信息：

专线网络 Redis 集群版实例内每个分片都应属于同一个私有网络和子网。

专线网络 Redis 集群版实例不支持变配和主备切换。

专线网络 Redis 集群版实例的分片 Bind IP 需为内网 IP 而非本地 IP（例如 127.0.0.1）。

专线网络 Redis 集群版实例内所有分片的数据账号密码必须相同。

使用限制

类型	说明
源库限制	带宽要求，源库所属的服务器需具备足够出口带宽，否则将影响数据迁移的速率。当源库中的某些 Key 使用了过期（expire）的策略，可能存在 Key 已过期但未被及时删除的情况，导致目标数据库中查看的 Key 数量比源库的 Key 数量少。在迁移期间，当源库发生扩缩容例如增加或减少分片、规格变配例如扩大内存时，您需重新配置任务。为保障数据一致性，在重新配置任务前，建议先清空已迁移至目标 Redis 实例内的数据。在迁移期间，当源库的连接地址发生变化，导致迁移任务失败时，您需要重新配置任务。当不成功时，您可提交工单联系技术支持，如果长时间未处理，源库会重置 AOF 文件。用于数据迁移的账号需具备以下权限：源库可以执行 sync、psync 和 config get 命令。目标库可以执行写命令。
其他限制	建议源库和目标库的 Redis 的数据库版本保持一致，或者从低版本迁移到高版本以保障兼容性。如果是高版本迁移到低版本，可能存在数据库兼容性或数据丢失问题。在增量数据迁移时，由于目标库在执行脚本时不会明确返回执行结果，对于通过 EVAL 或 EVALSHA 调用的 Lua 脚本，数据库传输服务 DTS 无法确认该类型脚本是否执行成功。数据库传输服务 DTS 在进行全量迁移时，将占用源库和目标库的部分资源，可能会导致数据库服务器负载上升。当数据库业务量较大或服务器规格较低时，可能会加重数据库的压力，甚至会导致数据库服务不可用，以至于数据迁移任务失败。建议在业务低峰期执行数据迁移，您也可以调大源库的 client -output-buffer-limit 的参数值，防止在迁移大 Key 时，缓冲区溢出。目标 Redis 的数据库存储空间需大于源 Redis 数据库占用的存储空间。数据库传输服务 DTS 在使用 psync 和 sync 命令调用传输数据时，会对目标库数据进行覆盖写入，即如果目标库存在相同的 key 时，会先进行 del 操作。在源端或目标端的实例发生连接闪断时，可能会使全量数据重新迁移至目标端，导致数据不一致。如果目标库的数据逐出策略参数 maxmemory-policy 配置为 noeviction 以外的值，可能导致目标库的数据和源库不一致。

在创建迁移任务页面的配置源库及目标库配置向导页面，配置以下参数信息。

类别	参数	说明
无	任务名称	（可选）自定义迁移任务名称。命名规则如下：以中文或字母开头。长度需在 64 个字符内。只能包含中文、字母、数字、下划线（_）和中划线（-）。
无		链路规格	按需选择迁移任务的链路规格，当前支持 Compact、Medium 和 Standard。说明成功创建任务后，不支持修改任务的链路规格。关于链路规格的详细信息，请参见产品规格。
源库配置	选择已有数据源	您可以按需选择是否使用已录入的实例：使用已录入实例：单击选择已有数据源，在选择数据源控制面板，从地域下拉列表中选择目标地域，然后选择目标数据源。支持通过数据源名称和 ID 选择数据源。关于数据源的创建方法，请参见数据源管理。不使用已录入实例：如果不使用已录入的实例，那么您需要配置以下数据库实例信息。
		实例类型	选择 Redis。
		接入方式	选择专有网络 Redis。
		地域	选择目标实例所属地域。
		架构类型	按需选择实例的架构类型，支持选择单机版和集群版。说明如果专有网络 Redis 实例的集群有 Proxy 服务，那么实例的架构类型需要选择单机版。
		主机地址	输入专有网络实例的主机地址。说明当架构类型选择单机版时，需设置该参数。当前仅支持接入 IPV4 地址，暂不支持接入 IPv 6 地址。
		端口	输入专有网络实例的端口号。说明当架构类型选择单机版时，需设置该参数。
		地址	请输入专线连接的私有网络内 Redis 集群各分片中所有分配了 slot 的主节点的 IP:端口，以英文逗号分隔，例如：ip1:port1,ip2:port2,ip3:port3。说明当架构类型选择集群版时，需设置该参数。 Redis 集群各分片中所有分配了 slot 的主节点的IP:端口均需填写到此参数中。
		私有网络	从下拉列表中选择目标实例所在的私有网络，具体如下所示：专线连接：通过专线 CEN 实现数据连通时，选择 CEN 下所属的任意私有网络。 VPN 连接：通过 VPN 实现数据连通时，选择 VPN 网关绑定的私有网络。
		子网	从下拉列表中选择私有网络中的子网。说明在迁移专有网络 Redis 实例时，您需要提前在源端的白名单或安全组策略中，添加子网 IP 段的访问权限。单击查看子网 IP 段查看和复制 IP 段。
		数据库账号	默认账号为 default，您可以根据实际情况设置数据库账号。
		数据库密码	输入源实例数据库账号对应的密码。说明如果专有网络 Redis 实例开启了免密登录，那么您无需输入实例数据库账号对应的密码。
		测试连接	单击测试连接，验证是否成功连接实例。当测试连接失败时，根据失败提示信息修改相关配置后，再次单击测试连接，验证是否可以成功连接实例。具体提示信息如下：连接认证失败，请检查网络是否正常：当出现该报错提示时，请确认网络的连通性。连接认证失败，请检查用户名和密码是否正确：当出现该报错提示时，您需要确认用户名和密码的准确性。连接认证失败，无法正常创建连接，请联系客服：当出现该报错提示时，请提交工单联系技术人员。无效的 IP 地址：当出现该报错提示时，请确认 IP 地址的正确性。专有网络需要子网有 * 个可用 IP，当前私有网络内子网可用 IP 数不足，无法创建任务，请检查私有网络内子网资源：当出现该报错提示时，您需要调整私有网络子网内可用的 IP 数量，以保证目标私有网络内子网内有足够的 IP。
目标库配置	选择已有数据源	您可以按需选择是否使用已录入的实例：使用已录入实例：单击选择已有数据源，在选择数据源控制面板，从地域下拉列表中选择目标地域，然后选择目标数据源。支持通过数据源名称和 ID 选择数据源。关于数据源的创建方法，请参见数据源管理。不使用已录入实例：如果不使用已录入的实例，那么您需要配置以下数据库实例信息。
		实例类型	选择 Redis。
		接入方式	选择专有网络 Redis。
		地域	选择目标实例所属地域。
		架构类型	按需选择实例的架构类型，支持选择单机版和集群版。说明如果专有网络 Redis 实例的集群有 Proxy 服务，那么实例的架构类型需要选择单机版。
		主机地址	输入专有网络实例的主机地址。说明当架构类型选择单机版时，需设置该参数。当前仅支持接入 IPV4 地址，暂不支持接入 IPv 6 地址。
		端口	输入专有网络实例的端口号。说明当架构类型选择单机版时，需设置该参数。
		地址	请输入专线连接的私有网络内 Redis 集群各分片中所有分配了 slot 的主节点的 IP:端口，以英文逗号分隔，例如：ip1:port1,ip2:port2,ip3:port3。说明当架构类型选择集群版时，需设置该参数。 Redis 集群各分片中所有分配了 slot 的主节点的IP:端口均需填写到此参数中。
		私有网络	从下拉列表中选择目标实例所在的私有网络，具体如下所示：专线连接：通过专线 CEN 实现数据连通时，选择 CEN 下所属的任意私有网络。 VPN 连接：通过 VPN 实现数据连通时，选择 VPN 网关绑定的私有网络。
		子网	从下拉列表中选择私有网络中的子网。说明在迁移专有网络 Redis 实例时，您需要提前在源端的白名单或安全组策略中，添加子网 IP 段的访问权限。单击查看子网 IP 段查看和复制 IP 段。
		数据库账号	默认账号为 default，您可以根据实际情况设置数据库账号。
		数据库密码	输入源实例数据库账号对应的密码。说明当您的架构类型选择的是集群版时，多个分片的数据库密码需保持一致，否则连接不成功。如果专有网络 Redis 实例开启了免密登录，那么您无需输入实例数据库账号对应的密码。
		测试连接	单击测试连接，验证是否成功连接实例。当测试连接失败时，根据失败提示信息修改相关配置后，再次单击测试连接，验证是否可以成功连接实例。具体提示信息如下：连接认证失败，请检查网络是否正常：当出现该报错提示时，请确认网络的连通性。连接认证失败，请检查用户名和密码是否正确：当出现该报错提示时，您需要确认用户名和密码的准确性。连接认证失败，无法正常创建连接，请联系客服：当出现该报错提示时，请提交工单联系技术人员。无效的 IP 地址：当出现该报错提示时，请确认 IP 地址的正确性。专有网络需要子网有 * 个可用 IP，当前私有网络内子网可用 IP 数不足，无法创建任务，请检查私有网络内子网资源：当出现该报错提示时，您需要调整私有网络子网内可用的 IP 数量，以保证目标私有网络内子网内有足够的 IP。输入地址非完整的主节点地址：当出现该报错时，您需要检查连接的集群版实例添加的主机地址和端口是否是集群所有主节点的 IP 和端口。
无	项目	（可选）从下拉列表中选择该任务所属项目，默认在 default(默认项目) 下。您也可以单击创建新项目，创建新的项目。详细操作，请参见新建项目。说明关于如何授予子用户访问指定项目下资源的权限操作步骤，请参见修改项目权限。成功创建任务后，如果需要修改实例的所属项目，例如将任务从当前项目移入至其他项目，您可以将资源移入指定项目。项目是一个虚拟的概念，包括一组资源、用户和角色。通过项目可以对一组资源进行统一的查看和管理，并且控制项目内用户和角色对这些资源的权限。
		标签	（可选）单击添加标签，为实例添加标签，标签可帮您实现云资源的分类、云资源的访问控制、账单与成本分摊等。标签由一个键值对（Key-Value）组成，用于标识云资源，可以帮助您从不同维度（例如用途、所有者等）对具有相同特征的云资源进行分类，便于筛选和聚合，从而轻松管理云上资源。关于标签的详细信息，请参见标签概述。标签的键值对规则如下：键支持任何语言、文字、数字、空格或符号（_.:/=+-@）。大小写敏感，且长度在 1~128 个字符内。使用 UTF-8 编码的 Unicode 格式。不支持设置以 volc: 开头的任何形式的 Key，例如 Volc:、VOLC: 等。（可选）值支持任何语言、文字、数字、空格或符号（_.:/=+-@）。大小写敏感，且长度在 0~256 个字符内。使用 UTF-8 编码的 Unicode 格式。说明支持模糊搜索选择已有标签键和标签值。单次最多可给任务绑定 20 个标签。单个任务最多可绑定 50 个标签。同一个资源拥有的标签 Key 不可重复，且一个标签 Key 只有一个值 Value。
		计费方式	当前仅支持按量计费，您无需选择。说明关于计费的详细信息，请参见计费说明。

单击下一步:配置迁移对象。

在配置迁移对象配置向导页面，配置相关参数信息，如下表所示。

说明

迁移任务默认进行全量迁移和增量迁移。

若暂时不需要启动迁移任务，您可以在完成迁移对象配置后，单击页面右下角的保存。

保存后会跳转回迁移任务列表页，此时任务状态为待启动，您可以在合适的时候再配置迁移任务。配置方法，请参见配置迁移任务。

参数	说明
迁移类型	按需选择迁移类型，当前支持全量迁移和增量迁移。其中，默认进行全量迁移和增量迁移，且全量迁移不可去勾选。若仅需要全量迁移，可以去勾选增量迁移。若需要进行不停机迁移，可以同时勾选全量迁移和增量迁移。说明当源库没有 SYNC 或 PSYNC 权限时，可以选择仅全量迁移。仅全量迁移采用 Scan 方式，通过遍历整个源端数据库的方式，将数据迁移到目标端。Scan 方式会导致源端数据库高负载，请在业务低峰期进行。在仅全量迁移场景下，若源端存在大 Key 或网络环境欠佳，可能会出现导出（dump）超时失败的情况。建议将大 Key 进行拆分或删除后重试。若任务仍无法恢复，请提交工单联系技术支持。仅全量迁移时，如果源端数据库不停写，则不保证源端数据和目标端数据一致。
迁移对象	在迁移对象区域中勾选需要迁移的对象，您可以在已选择对象区域中再次确认需要迁移的对象。同时，您可以在已选择对象区域中实现以下操作：重命名库或表：单击目标库后的笔状图标，重命名库。如果在迁移对象区域勾选了整库，则在已选择对象区域仅支持修改库名，且不支持展开该数据库。单击批量映射，可以批量修改库名，更多信息请参见库表批量映射。筛选删除不需要的目标：在已选择对象区域的搜索框内支持模糊搜索，批量删除不需要的数据库等目标。
错误重试时间	在迁移任务中，当源库和目标库断连后导致迁移任务失败时，会立即在指定时间内多次重试连接源库和目标库。取值范围：600~86400，单位：秒(s)。默认值为 600 秒。

最近更新时间：2026.03.16 16:05:35

这个页面对您有帮助吗？

有用

无用