迁移实施
本文介绍数据迁移的注意事项、迁移限制说明和操作步骤。
注意事项
使用在线迁移服务迁移数据时需要注意以下事项:
在线迁移服务使用源站存储服务提供商公开的标准接口来访问源数据,其行为依赖于源站存储服务提供商的具体实现。
在线迁移会占用源地址和目的地址的资源,可能会影响业务正常运行。若您的业务比较重要,请提前做好评估后对迁移任务设置限速,或在空闲时间启动迁移任务。
在线迁移前会检查源地址和目的地址的文件,但是若您源和目的地址有相同文件名的文件,且在迁移任务中配置了覆盖方式为覆盖,迁移时会直接覆盖目的地址的文件。若两个文件内容不同,必须更改文件名或做好备份。
在线迁移会保留源文件的最后修改时间属性,如果目的Bucket设置了生命周期规则,且迁移后文件处于该生命周期规则生效的时间范围内,则该文件可能会在规则生效时被删除或转为指定的归档类型。
迁移限制说明
目前仅支持单次迁移单个Bucket数据,无法将整个账号的数据一次性迁移。
AWS S3清单迁移数据的属性说明如下:
支持迁移的属性:x-amz-meta-*、LastModifyTime ,Content-Type,Cache-Control,Content-Encoding,Content-Disposition。Content-Language 、Expires。
不支持迁移的属性(包括但不限于):StorageClass、Acl、服务端加密、标签Tagging等。
说明不支持迁移的属性包括但不限于以上列举的内容,其他未列举的属性行为暂无法确定,以实际迁移完成的内容为准。
步骤一:选择地域
使用创建的RAM用户登录阿里云在线迁移服务管理控制台。
在顶部菜单栏左上角处,选择源数据所在的地域,如下图所示。
重要不同地域内的数据地址和迁移任务不通用,请谨慎选择。
优先选择源数据所在的地域,如果没有源数据所在地对应的地域,请尽可能选择接近源数据所在的地域创建迁移任务。
跨境迁移时,推荐您开启传输加速,提高迁移速度。开启了传输加速的Bucket会收取传输加速费用。关于传输加速的更多信息,请参见传输加速。
步骤二:创建源地址
在左侧导航栏,选择在线迁移服务 > 地址管理,单击新建地址。
在创建数据地址面板,配置如下参数,然后单击确认。
参数
是否必选
说明
名称
是
输入源数据地址名称。名称命名规则如下:
名称不能为空,长度为3~63个字符。
支持英文小写字母、数字和特殊字符短划线(-)和下划线(_),且区分大小写。
UTF-8编码并且不能以短划线(-)和下划线(_)开头。
类型
是
选择AWS S3 Inventory。
域名
是
输入AWS S3的访问域名。更多信息,请参见Amazon S3终端节点。
重要链接文档仅供参考,由于源站变更,文档可能已经过时。
AccessKeyId
是
输入创建的IAM用户的访问密钥,用于AWS S3进行身份识,确认该用户是否有读取源数据的权限。
SecretAccessKey
是
存储桶(Bucket)
是
输入待迁移数据所在的AWS S3存储桶名称。
说明存储桶名称要求开头和结尾不带空格、换行、制表符等非法字符。
列表位置
是
选择清单所在的存储空间,选择AWS S3。
列表域名
是
当列表位置选择AWS S3时,输入AWS S3清单的访问域名。更多信息,请参见Amazon S3终端节点。
重要链接文档仅供参考,由于源站变更,文档可能已经过时。
列表存储桶(Bucket)
是
输入待迁移数据清单列表所在的存储桶(Bucket)名称。
列表路径
是
当列表位置选择AWS S3时,输入AWS S3清单manifest.json文件所在的路径。
列表AccessKeyId
是
当列表位置选择AWS S3时,输入用于访问AWS S3清单的密钥,迁移完成后删除。
列表SecretAccessKey
是
通道
否
选择需要使用的通道名称。
重要仅通过专线或VPN迁移数据上云、自建存储数据迁移上云需要使用该参数。
代理
否
选择需要使用的代理名称。
重要仅通过专线或VPN迁移数据上云、自建存储数据迁移上云需要使用该参数。
指定通道下,最多可同时选择30个代理。
步骤三:创建目的地址
在左侧导航栏,选择在线迁移服务 > 地址管理,单击新建地址。
在新建地址面板,配置如下参数,然后单击确定。
参数
是否必选
说明
名称
是
输入目的数据地址名称。名称命名规则如下:
名称不能为空,长度为3~63个字符。
支持英文小写字母、数字和特殊字符短划线(-)和下划线(_),且区分大小写。
UTF-8编码并且不能以短划线(-)和下划线(_)开头。
类型
是
选择Alibaba OSS。
区域
否
选择目的地址所在的地域,例如华东1(杭州)。
AccessKeyId
是
输入创建的RAM用户的AccessKey,用于OSS进行身份识别,确认该用户是否有写入迁移数据的权限。
SecretAccessKey
是
存储桶(Bucket)
是
输入迁移目的所在的存储桶(Bucket)名称。
前缀
否
您可以指定数据路径前缀将源数据迁移至指定目录下。格式要求不能以正斜线(/)开头,必须以正斜线(/)结尾,例如
data/to/oss/
。指定前缀:例如设置源数据地址前缀为
example/src/
,此路径下有文件example.jpg,设置目的数据地址前缀为example/dest/
,则迁移后文件example.jpg的完整路径为example/dest/example.jpg
。不指定前缀:不设置数据路径前缀时,会将源数据迁移至目的Bucket的根目录。
通道
否
选择需要使用的通道名称。
重要仅通过专线或VPN迁移数据上云、自建存储数据迁移上云需要使用该参数。
代理
否
选择需要使用的代理名称。
重要仅通过专线或VPN迁移数据上云、自建存储数据迁移上云需要使用该参数。
指定通道下,最多可同时选择30个代理。
步骤四:创建迁移任务
在左侧导航栏,选择在线迁移服务 > 迁移任务,单击新建任务。
在选择地址页面,配置如下参数,然后单击下一步。
参数
是否必选
说明
名称
是
输入迁移任务名称。名称命名规则如下:
名称不能为空,长度为3~63个字符。
支持英文小写字母、数字和特殊字符短划线(-)和下划线(_),且区分大小写。
UTF-8编码并且不能以短划线(-)和下划线(_)开头。
源地址
是
选择已创建的源地址。
目的地址
是
选择已创建的目的地址。
在配置任务页面,配置如下参数。
参数
是否必选
说明
迁移带宽
否
选择迁移带宽。
默认:默认最大带宽,实际速度取决于文件大小和文件数量。
指定上限:根据控制台提示指定具体的带宽上限。
重要实际迁移带宽与数据源、网络、目的限流、文件大小等因素有关,不一定能达到指定上限。
请您评估数据源、迁移目的、业务情况、网络带宽等,并根据实际情况选择合理数值,限流不恰当可能会影响业务的正常运行。
每秒迁移文件数
否
选择每秒迁移文件数。
默认:默认每秒迁移文件数。
指定上限:根据控制台提示指定具体的每秒迁移文件数。
重要实际迁移带宽与数据源、网络、目的限流、文件大小等因素有关,不一定能达到指定上限。
请您评估数据源、迁移目的、业务情况、网络带宽等,并根据实际情况选择合理数值,限流不恰当可能会影响业务的正常运行。
覆盖方式
否
选择同名文件的覆盖方式。
不覆盖:不迁移该文件。
全部覆盖:源地址中的文件会覆盖目的地址中的文件。
根据最后修改时间覆盖:
当源地址中的文件最后修改时间晚于目的地址中的文件最后修改时间时,目的地址中的文件会被覆盖。
当源地址中的文件最后修改时间与目的地址中的文件最后修改时间相同时,若二者的Size和Content-Type有一项不同,则目的地址中的文件会被覆盖。
根据最后修改时间覆盖无法严格保证一定不会覆盖更新的文件,存在旧文件覆盖新文件的风险。
若您选择根据最后修改时间覆盖的覆盖方式,请务必确保源端文件能返回最后修改时间、Size、Content-Type等信息,否则覆盖策略可能失效,产生非预期的迁移结果。
警告迁移日志
是
迁移日志推送方式。
不推送(默认):不推送迁移日志。
推送:将迁移日志推送至日志服务SLS,可在SLS上查看迁移日志。
仅推送文件错误日志:仅将错误迁移日志推送至日志服务SLS,可在SLS上查看错误迁移日志。
当选择推送或仅推送文件错误日志时,在线迁移服务会在日志服务SLS中创建名称为aliyun-oss-import-log-阿里云账号ID-当前控制台地域的Project,例如aliyun-oss-import-log-137918634953****-cn-hangzhou。
重要请务必完成以下操作后,再选择推送或仅推送文件错误日志,否则可能会导致迁移任务异常。
已开通SLS服务。
已在日志服务授权项授权页面中同意授权。
日志服务授权
否
当迁移日志选择推送或仅推送文件错误日志时出现该选项。
单击授权进入云资源访问授权页面,页面会对应创建AliyunOSSImportSlsAuditRole角色,并对角色做授权,请单击同意授权完成授权。
文件名
否
文件名过滤器。
支持包含和排除两种过滤规则,请参见RE2库的正则表达式语法(仅支持部分表达式语法)。例如:
.*\.jpg$表示以.jpg结尾的所有文件。
^file.*默认表示根目录下以file开头的所有文件。
如果源数据地址设置了前缀,例如源数据地址前缀为data/to/oss/,则需要使用^data/to/oss/file.*来匹配指定前缀下以file开头的所有文件。
.*/picture/.*表示匹配某一级为picture的子目录。
重要当过滤规则为包含时,符合规则的文件都会被迁移,如果有多条规则,符合任意一个条件的文件都会被迁移。
例如2个文件picture.jpg和picture.png,设置一条包含规则过滤.*\.jpg$,此时只会迁移picture.jpg文件,如果同时也设置了包含规则过滤.*\.png$,则2个文件都会被迁移。
当过滤规则为排除时,符合规则的文件都不会被迁移,如果有多条规则,符合任意一个条件的文件都不会被迁移。
例如2个文件picture.jpg和picture.png,设置一条排除规则过滤.*\.jpg$,此时只会迁移picture.png,如果同时也设置了排除规则过滤.*\.png$,则2个文件都不会被迁移。
排除规则优先。当一个文件既在排除规则中又在包含规则中,则文件不会被迁移。
例如文件file.txt,设置排除规则过滤.*\.txt$文件,并同时设置包含规则过滤file.*,则此时file.txt文件不会被迁移。
文件修改时间
否
文件最后一次修改时间过滤器。
可指定文件最后一次修改时间作为过滤规则。如果指定了时间范围,则只迁移文件最后一次修改时间在指定时间范围内的文件,具体规则如下。
当仅指定开始时间为2019年01月01日,不指定结束时间时,则只迁移文件最后一次修改时间晚于等于2019年01月01日的文件。
当仅指定结束时间为2022年01月01日,不指定开始时间时,则只迁移文件最后一次修改时间早于等于2022年01月01日的文件。
当指定开始时间为2019年01月01日,结束时间为2022年01月01日,则迁移文件最后一次修改时间范围在晚于等于2019年01月01日,且早于等于2022年01月01日的文件。
执行时间
否
选择迁移任务的执行时间。
立即执行:立即执行当前任务。
指定执行时间:指定任务执行期间每天的执行时间段。默认会在指定的起始时间启动任务,在指定的停止时间开始暂停任务。
阅读在线迁移服务协议,选中我已理解并确认,合规承诺声明且当迁移任务完成时,我有确认迁移数据一致性的义务和责任,然后单击下一步。
检查配置信息,确认无误后,单击确定,等待迁移任务执行。
步骤五:校验数据
迁移服务仅负责数据的迁移,无法保证数据的一致性和完整性。迁移任务完成后,请您全量校验迁移的数据,务必自行做好源端和目的端数据一致性校验。
请您务必在迁移任务完成后,校验目的端迁移数据。您在删除源数据前,未校验目的端迁移数据无误,导致数据丢失所引起的一切损失和后果均由您自行承担。