文档中心

存储迁移服务

DMS 2.0 迁移指南

创建迁移任务

您可以创建 DMS 2.0 半托管模式的迁移任务，将数据迁移到火山引擎 TOS。任务创建完成后，Agent 会按照迁移任务的配置执行数据迁移操作。本文介绍创建迁移任务的前提条件、操作步骤等内容。

前提条件

已创建代理组，并确保代理组的运行状态正常。具体操作，请参见创建代理组。

已在本地服务器安装 Agent，具体操作，请参见部署代理。

已创建迁移地址，具体操作，请参见创建迁移地址。

注意事项

每个账号每个地域最多可创建 100 个迁移任务。

创建迁移任务

登录存储迁移服务控制台。

在左侧导航栏，选择 DMS2.0 > 迁移任务。

在迁移任务页面顶部导航栏，选择地域。

说明

DMS 当前不支持跨地域迁移，迁移任务必须与目标存储桶位于同一地域。为确保迁移任务正常执行，您需要在目标存储桶所在地域创建迁移任务。

单击创建任务。

在选择服务类型的配置向导中，配置如下代理参数。

参数	说明
任务名称	设置迁移任务的名称，命名规则如下： 3~32 个字符之间。只能包含小写字母、数字、中划线（-）。名称不能以中划线（-）开头或结尾。
服务类型	默认为半托管。
代理组	选择代理组。

单击下一步，选择源端地址和目的端地址。

单击下一步，配置如下任务参数。

参数	说明
覆盖策略	指定当源端和目的端出现同名文件时的覆盖策略，策略说明如下：不覆盖：针对同名文件，不做任何判断，直接跳过。覆盖：针对同名文件，不做任何判断，直接用源端覆盖目的端。根据最后修改时间覆盖：当源端和目标端出现同名文件时，根据文件的 lastmodify 字段（最后修改时间）判断是否进行覆盖，仅当源端文件的最后修改时间晚于目的端文件最后修改时间时执行覆盖。
文件存储方式	设置文件迁移至 TOS 的存储类型，支持选择全部使用标准存储、保持原存储属性、全部使用低频存储、全部使用归档闪回存储、全部使用智能分层存储、全部使用归档存储、全部使用冷归档存储、全部使用深度冷归档存储。关于 TOS 存储类型的详细介绍，请参见存储类型。以下为保持原存储属性和全部使用智能分层的参数说明：保持原存储属性：迁移至 TOS 时，文件会默认继承存储桶的存储类型。全部使用智能分层：迁移至 TOS 时，文件将保存至智能分层高频访问层。
软链接迁移策略	软链接文件迁移策略，可选不迁移软链接文件或将软链接文件以独立文件的形式迁移到 TOS。
是否推送迁移报告	是否在数据迁移完成后生成迁移报告，并将其存储到数据迁移的目标存储桶。
目标前缀	设置数据在存储桶中的存储路径。说明存储路径必须以斜杠（/）结尾，例如 test/。仅 v1.0.9 及以上版本的 DMS Agent 支持目标前缀功能。您可以执行 ./dms_agent -v 命令，查看当前所使用的 DMS Agent 版本。如果您的版本低于 v1.0.9，建议您升级 DMS Agent，具体操作，请参见停止、卸载和升级。
回调配置	是否启用回调通知，默认关闭。开启时需配置以下信息：回调地址：接收回调的业务方地址，必须以 http:// 或 https:// 开头，生产环境建议使用 HTTPS。订阅回调状态：订阅的任务终态，默认选择完成和失败。自定义回调参数：业务自定义透传参数，以参数名/参数值形式随回调请求发送，用于携带业务标识、租户信息等便于接收端路由与幂等。
过滤方式	指定文件迁移范围，支持通过以下方式指定待迁移的文件：前缀：通过文件前缀来指定文件迁移范围。设置文件名前缀后，将只仅迁移指定前缀的文件。可以设置多个前缀，最多支持设置 10 个文件前缀。例如迁移 user/data 目录下的所有文件，则需要设置文件前缀为 user/data/。列表文件：将待迁移的文件名称或目录名称记录在列表文件中，然后将列表文件上传到对象存储。选择列表文件的过滤方式后，您需要填写列表文件所属存储桶的 Access Key ID、Secret Access Key ，然后选择列表文件存储桶、列表文件。完成配置后，将仅迁移列表文件中指定的文件。列表文件约束限制如下：列表文件必须为 txt 格式。列表文件中每一行是一个文件，多个文件请换行输入。列表文件中的文件名称需要符合 UTF-8 编码规则。
迁移文件时间范围	按照文件最后一次修改时间来筛选需要迁移的文件，默认为迁移全部，参数说明如下：迁移全部：迁移所有文件。指定时间范围：筛选需要迁移的文件，支持三种指定方式，说明如下：指定起始时间：仅指定开始日期，结束日期置空，表示仅迁移最后一次修改时间晚于该日期的文件。指定结束时间：仅指定结束日期，开始日期置空，表示仅迁移最后一次修改时间早于该日期的文件。指定时间范围：指定开始日期和结束日期，表示仅迁移最后一次修改时间处于该时间范围内的文件。说明文件前缀、列表文件和文件最后修改时间为与的关系。如果同时设置过滤方式（文件前缀或列表文件）和文件最后修改时间，系统将迁移同时满足这两个条件的文件：指定文件，且最后修改时间在指定时间范围内的文件。

单击下一步，检查迁移任务的各项参数。

参数检查无误后，阅读并勾选存储产品和服务条款，单击提交。

查看迁移结果

任务创建完成后，Agent 会按照迁移任务的配置执行数据迁移操作。当任务状态由运行中转为已完成，说明迁移已完成。您可以在目标存储桶中的根目录查看迁移的数据，也可以查看迁移任务的统计数据、迁移文件的详细信息，说明如下：

查看迁移任务的统计数据

在迁移任务页面，单击目标任务的名称，在任务详情页面查看迁移存储量、迁移文件数量、预估剩余迁移时间等信息。

查看迁移文件的详细信息

如果创建迁移任务时开启了推送迁移报告功能，数据迁移完成后，DMS 生成迁移报告，并存储到数据迁移的目标存储桶。详细介绍，请参见查看迁移报告。