断点续传上传
断点续传上传将要上传的文件分成若干个分片(Part)分别上传,所有分片都上传完成后,将所有分片合并成完整的文件,完成整个文件的上传。
您可以通过oss2.resumable_upload方法断点续传上传指定文件,该方法包含以下参数:
参数 | 描述 | 是否必需 | 默认值 |
---|---|---|---|
bucket | 存储空间名称 | 是 | 无 |
key | 文件名称 | 是 | 无 |
filename | 待上传的本地文件名称 | 是 | 无 |
store | 指定保存断点信息的目录 | 否 | HOME目录下建立的.py-oss-upload目录 |
headers | HTTP头部 | 否 | 无 |
multipart_threshold | 文件长度大于该值时,则用分片上传 | 否 | 10MB |
part_size | 分片大小 | 否 | 自动计算 |
progress_callback | 上传进度回调函数 | 否 | 无 |
num_threads | 并发上传的线程数 | 否 | 1 |
以下代码用于断点续传上传:
# -*- coding: utf-8 -*-
import oss2
# 阿里云主账号AccessKey拥有所有API的访问权限,风险很高。强烈建议您创建并使用RAM账号进行API访问或日常运维,请登录 https://ram.console.aliyun.com 创建RAM账号。
auth = oss2.Auth('<yourAccessKeyId>', '<yourAccessKeySecret>')
# Endpoint以杭州为例,其它Region请按实际情况填写。
bucket = oss2.Bucket(auth, 'http://oss-cn-hangzhou.aliyuncs.com', '<yourBucketName>')
# 当文件长度大于或等于可选参数multipart_threshold(默认值为10MB)时,会使用分片上传。如未使用参数store指定目录,则会在HOME目录下建立.py-oss-upload目录来保存断点信息。
oss2.resumable_upload(bucket, '<yourObjectName>', '<yourLocalFile>')
Python SDK 2.1.0以上版本支持设置可选参数进行断点续传上传,代码如下:
# 如使用store指定了目录,则保存断点信息在指定目录中。如使用num_threads设置上传并发数,请将oss2.defaults.connection_pool_size设成大于或等于线程数。默认线程数为1。
oss2.resumable_upload(bucket, '<yourObjectName>', '<yourLocalFile>',
store=oss2.ResumableStore(root='/tmp'),
multipart_threshold=100*1024,
part_size=100*1024,
num_threads=4)
断点续传详情请参见开发指南中的断点续传。
说明
- 断点续传内部使用了多线程,调用时无需在外面封装多线程,否则可能导致数据重复传输。
- 网络情况较好时,建议增大分片大小。反之,减小分片大小。
版权声明
本文仅代表作者观点,不代表本站立场。
本文系作者授权发表,未经许可,不得转载。
评论