本场景介绍如何在数据库传输服务 DTS 控制台创建火山引擎版 Redis 迁移至火山引擎版 Redis 任务。
已创建缓存数据库 Redis 版数据库和设置默认账号 default 的密码。详细操作，请参见创建实例和设置默认账号密码。
创建数据迁移任务之前，请确认源库和目标库的网络连通性与服务可用性。
(可选)根据预检查项中的说明，检查源端和目标端中各迁移对象。更多详情，请参见预检查项（Redis）。
迁移任务默认进行全量迁移和增量迁移。
在预检查时，如果选择忽略告警并启动迁移任务，可能会导致数据不一致，带来业务风险，需谨慎操作。
由于缓存数据库 Redis 版的单节点实例未开启 AOF 持久化，因此无法使用数据库传输服务 DTS 迁移此类型实例。
在全量和增量迁移 Stream 的任务中，请勿在目标数据库实例中进行双写操作，否则可能会导致任务迁移失败。
暂不支持迁移开启 SSL 的实例。
迁移过程中，请勿变更实例的配置，否则迁移任务不成功。
在数据迁移的过程中，若遇到目标库中已存在同键值情况，DTS 不会保留目标端中冲突的数据，即源端的数据将会覆盖掉目标端的数据。
缓存数据库 Redis 企业版当前处于邀测阶段，如需迁移至缓存数据库 Redis 企业版，请提交工单申请服务。关于缓存数据库 Redis 企业版的详细信息，请参见什么是缓存数据库 Redis 企业版。
暂不支持在华东2（上海）和华北2（北京）地域下创建火山引擎 Redis 版到火山引擎 Redis 版的迁移任务，如需创建请提交工单联系技术支持。
| 类型 | 说明 |
|---|---|
源库限制 |
|
其他限制 |
|
APPEND
BITOP、BLPOP、BRPOP、BRPOPLPUSH
DECR、DECRBY、DEL
EVAL、EVALSHA、EXPIRE、EXPIREAT
GEOADD、GETSET
HDEL、HINCRBY、HINCRBYFLOAT、HMSET、HSET、HSETNX
INCR、INCRBY、INCRBYFLOAT
LINSERT、LPOP、LPUSH、LPUSHX、LREM、LSET、LTRIM
MOVE、MSET、MSETNX
PERSIST、PEXPIRE、PEXPIREAT、PFADD、PFMERGE、PSETEX、PUBLISH
RENAME、RENAMENX、RESTORE、RPOP、RPOPLPUSH、RPUSH、RPUSHX
SADD、SDIFFSTORE、SELECT、SET、SETBIT、SETEX、SETNX、SETRANGE、SINTERSTORE、SMOVE、SPOP、SREM、SUNIONSTORE
ZADD、ZINCRBY、ZINTERSTORE、ZREM、ZREMRANGEBYLEX、ZUNIONSTORE、ZREMRANGEBYRANK、ZREMRANGEBYSCORE
说明
Redis 7.0 暂不支持 Function 相关命令。
登录 DTS 控制台。
在顶部菜单栏，选择项目和地域。
在左侧导航栏，单击数据迁移。
在迁移任务列表页面，单击创建任务。
在创建迁移任务页面的配置源库及目标库配置向导页面，配置以下参数信息。
| 类别 | 参数 | 说明 |
|---|---|---|
无 | 任务名称 | （可选）自定义迁移任务名称。命名规则如下：
|
链路规格 | 按需选择迁移任务的链路规格，当前支持 Compact 和 Standard。 说明 成功创建任务后，不支持修改任务的链路规格。关于链路规格的详细信息，请参见产品规格。 | |
源库配置 | 选择已有数据源 | 您可以按需选择是否使用已录入的实例：
|
| 实例类型 | 选择 Redis。 | |
| 接入方式 | 选择火山引擎版 Redis。 | |
| 地域 | 选择目标实例所属地域。 | |
是否跨火山引擎账号 | 按需选择是否跨账号传输数据，取值如下：
| |
| 跨账号 ID | 输入源库所属的火山引擎账号 ID。 | |
| 跨账号角色 | 输入已授权 DTS 访问跨账号资源的 IAM 角色。 | |
Redis 实例 | 在下拉列表中选择缓存数据库 Redis 的目标实例。 说明 您也可以通过实例 ID 或名称搜索目标实例。 | |
| 数据库账号 | 默认账号为 default，您可以根据实际情况设置数据库账号。 | |
数据库密码 | 输入源实例数据库账号对应的密码。 说明 在缓存数据库 Redis 版的实例开启免密访问时，无需输入密码即可成功访问目标实例。关于开启免密访问的详细操作，请参见免密访问。 | |
测试链接 | 单击测试链接，验证是否成功连接实例。 当测试连接失败时，根据失败提示信息修改相关配置后，再次单击测试连接，验证是否可以成功连接实例。具体提示信息如下：
| |
目标库配置 | 选择已有数据源 | 您可以按需选择是否使用已录入的实例：
|
实例类型 | 选择 Redis。 | |
| 接入方式 | 选择火山引擎版 Redis。 | |
| 地域 | 选择目标实例所属地域。 | |
Redis 实例 | 在下拉列表中选择缓存数据库 Redis 的目标实例。 说明 您也可以通过实例 ID 或名称搜索目标实例。 | |
| 数据库账号 | 默认账号为 default，您可以根据实际情况设置数据库账号。 | |
数据库密码 | 输入源实例数据库账号对应的密码。 说明 在缓存数据库 Redis 版的实例开启免密访问时，无需输入密码即可成功访问目标实例。关于开启免密访问的详细操作，请参见免密访问。 | |
测试链接 | 单击测试链接，验证是否成功连接实例。
| |
无 | 项目 | （可选）从下拉列表中选择该任务所属项目，默认在 default(默认项目) 下。您也可以单击创建新项目，创建新的项目。详细操作，请参见新建项目。 |
标签 | （可选）单击添加标签，为实例添加标签，标签可帮您实现云资源的分类、云资源的访问控制、账单与成本分摊等。标签由一个键值对（Key-Value）组成，用于标识云资源，可以帮助您从不同维度（例如用途、所有者等）对具有相同特征的云资源进行分类，便于筛选和聚合，从而轻松管理云上资源。关于标签的详细信息，请参见标签概述。标签的键值对规则如下：
说明
| |
计费方式 | 当前仅支持按量计费，您无需选择。 说明 关于计费的详细信息，请参见计费说明。 |
单击下一步:配置迁移对象。
在配置迁移对象配置向导页面，配置相关参数信息，如下表所示。
说明
迁移任务默认进行全量迁移和增量迁移。
若暂时不需要启动迁移任务，您可以在完成迁移对象配置后，单击页面右下角的保存。
保存后会跳转回迁移任务列表页，此时任务状态为待启动，您可以在合适的时候再配置迁移任务。配置方法，请参见配置迁移任务。
| 参数 | 说明 |
|---|---|
迁移对象 | 在迁移对象区域中勾选需要迁移的对象，您可以在已选择对象区域中再次确认需要迁移的对象。 说明 默认进行全量迁移和增量迁移。 |
| 错误重试时间 | 在迁移任务中，当源库和目标库断连后导致迁移任务失败时，会立即在指定时间内多次重试连接源库和目标库。取值范围：600~86400，单位：秒(s)。默认值为 600 秒。 |
单击预检查。
（可选）当创建的任务已有预检查时，您可以根据以下提示确认是否重新发起预检查，当需要重新发起预检查时，请在是否重新发起预检查对话框，单击确定。
若源端和目标端的数据库实例未做修改，则无需再次发起预检查。
如果修改了源端、目标端的数据库实例信息或迁移任务的参数配置，那么建议您重新发起预检查，否则可能会导致任务启动失败或者任务中断。
在预检查配置向导页面，根据检查结果执行以下操作：
单击预检查结果操作列的详情，查看详细的告警和失败信息，并根据告警或失败信息修改库表后，单击重试。
单击操作列的忽略，忽略本次告警继续启动迁移任务。同时，也可以单击忽略全部，一键忽略全部告警信息。
说明
选择忽略告警并启动迁移任务，可能导致数据不一致，带来业务风险。
关于预检查的具体说明，请参见预检查项。
在预检查页面右下角，单击确认订单。
在确认订单配置向导页面，再次确认配置信息。阅读《数据库产品和服务条款》并勾选我已阅读并同意《数据库产品和服务条款》，然后单击创建并启动任务。
成功创建数据迁移任务后，您可以返回数据库传输服务 DTS 控制台，在数据迁移任务列表查看数据迁移任务的信息。更多信息，请参见查看迁移任务。
| API | 描述 |
|---|---|
| CreateTransmissionTask | 调用 CreateTransmissionTask 接口创建数据库传输服务任务。 |
| ModifyTransmissionTask | 调用 ModifyTransmissionTask 接口修改传输任务。 |