文档中心

存储迁移服务

DMS 2.0 迁移指南

创建迁移地址

迁移数据前，您需要在控制台创建源端地址和目标端地址，用于指定数据迁移的起始位置和存放迁移数据的目标存储桶。本文介绍创建迁移地址的操作步骤。

注意事项

每个账号每个地域最多可创建 200 个迁移地址。

前提条件

创建 HTTP 类型的源端地址之前，需要先上传 HTTP/HTTPS 列表文件到源端存储桶。

HTTP/HTTPS 列表文件的格式要求如下：

采用 CSV 格式。

每行表示一个文件，行与行之间用 \n 分割。

每个文件有多个属性项，项与项之间用英文逗号（,）分割。

列表文件配置参数如下表所示。

名称	是否必填	描述
Url	是	DMS 2.0 Agent 使用该链接的 Get 请求下载文件内容，Head 请求获取文件元数据。 Url 项必须要做编码处理，不做编码处理、包含特殊字符可能会导致文件迁移失败。
Key	是	迁移后的 Object Name 为 prefix + 文件名。 Key 项必须要做编码处理，不做编码处理、包含特殊字符可能会导致文件迁移失败。
Size	否	迁移文件的大小，单位为字节（Byte）。该字段用于统计迁移文件的存储量，缺失该字段会导致控制台上无法准去获取存储进度信息。
Crc64	否	该对象的 64 位 CRC 值，根据 ECMA-182 标准计算得出。传入该字段后，DMS 2.0 请求源端时如果源端未返回 CRC64，则会根据该值进行校验。

列表文件配置示例：

https%3A%2F%2Fadms-v2-src.tos-cn-beijing-sdv.volces.com%2F000.txt,000.txt,276,5750220731083372667​
https%3A%2F%2Fadms-v2-src.tos-cn-beijing-sdv.volces.com%2F%E6%B5%8B%E8%AF%95%2Fdms.png,%E6%B5%8B%E8%AF%95,876,2750220731083372667​

创建源端地址

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

在左侧导航栏，选择 DMS2.0 > 地址管理。

在地址管理页面顶部导航栏，选择地域。

单击创建地址。

在创建地址面板，配置基础参数。

参数	说明
名称	设置地址名称，命名规则如下： 3~32 个字符之间。只能包含小写字母、数字、中划线（-）。名称不能以中划线（-）开头或结尾。
属性	选择源端地址。
类型	选择源端类型，说明如下： LocalFS：源端为本地文件系统。 S3：源端为兼容 S3 协议的对象存储。 S3Directory：源端为兼容 S3 协议，并采用文件语义的对象存储。 HTTP：源端为兼容 HTTP/HTTPS 协议的对象存储。 HDFS：源端为 Hadoop 分布式文件系统。

在创建地址面板，配置存储空间参数，不同类型的源端对象存储，存储空间的配置参数不同，具体说明如下：

LocalFS 类型的存储空间配置

参数
说明
迁移路径
设置待迁移数据在源端的存放路径。

S3 和 S3Ddirectory 类型的存储空间配置

参数	说明
数据源	选择具体的数据源，说明如下：阿里云：将阿里云上的数据迁移至火山引擎对象存储 TOS。腾讯云：将腾讯云上的数据迁移至火山引擎对象存储 TOS。华为云：将华为云上的数据迁移至火山引擎对象存储 TOS。对象存储-火山引擎：将火山引擎对象存储的数据迁移至火山引擎对象存储 TOS。其他 S3 协议存储：将兼容 S3 协议，并支持 AWS Signature V4 鉴权的对象存储的数据迁移至火山引擎对象存储 TOS。
Access Key ID	用于访问源端对象存储的 AccessKey ID。
Access Key Secret	用于访问源端对象存储的 AccessKey Secret。
源端桶选择方式	设置选择源端桶的方式，说明如下：获取可选源端桶并选择：经过您的授权，DMS 直接读取源端存储桶列表。您无需填写信息，单击刷新加载源端桶列表后，即可在源端桶名的列表中选择存储桶。注意设置源端桶选择方式为获取可选源端桶并选择后，DMS 会默认使用源端对象存储的公网域名传输数据，可能会在源端产生公网流出流量费用。输入源端桶名称：手动输入源端桶名、源端 Region、Endpoint 信息。
源端桶名	指定待迁移的源端对象存储桶名称。
源端 Region	指定待迁移的源端对象存储桶所属地域。
Endpoint	指定源端对象存储的访问域名，地址前需要输入 http:// 或 https://。注意仅支持源端对象存储默认分配的访问域名，不支持自定义域名、AP 域名等其他域名。请勿携带存储桶名称，否则会导致源端连接失败。

HTTP 类型的存储空间配置

参数	说明
Access Key ID	用于访问源端对象存储的 AccessKey ID。
Access Key Secret	用于访问源端对象存储的 AccessKey Secret。
源端桶名	指定待迁移的源端对象存储桶名称。
源端文件名	指定待迁移的源端对象文件名称。

HDFS 类型的存储空间配置

参数	说明
NameNode URI	设置 NameNode URI，格式：scheme://namenode-host:port。 Scheme：文件系统实现协议，取值为 hdfs。 Namenode-host：Active NameNode 的主机名或 IP 地址。HA 集群里通常是逻辑名（如 mycluster）。 Port：文件系统监听端口，默认 8020。
迁移路径	设置待迁移数据在源端的存放路径。
认证类型	设置身份验证方式。无：不设置任何验证。简单（默认）：通过用户名进行简单认证。 Kerberos：强身份验证，依赖 Kerberos KDC。
用户名	设置访问 HDFS 的用户名称。

完成设置后，单击确定。

创建目的端地址

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

在左侧导航栏，选择 DMS2.0 > 地址管理。

在地址管理页面顶部导航栏，选择地域。

单击创建地址。

在创建地址面板，配置如下参数。

参数	说明
名称	设置地址名称。
属性	选择目标端地址。
类型	当前仅支持将文件迁移到火山引擎 TOS，因此只能选择对象存储-火山引擎。
AK	用于访问目标端对象存储的 Access Key ID。
SK	用于访问目标端对象存储的 Secret Access Key。
桶名	选择用于存放迁移数据的目标存储桶。
Region	默认显示存储桶所属地域。

完成设置后，单击确定。