[HADOOP-14999] AliyunOSS: provide one asynchronous multi-part based uploading mechanism

• Type: Sub-task
• Status: Resolved
• Priority: Major
• Resolution: Fixed
• Affects Version/s: 3.0.0-beta1
• Fix Version/s: 2.10.0, 2.9.1, 3.2.0, 3.1.1, 3.0.3
• Component/s: fs/oss
• Assignee: Genmao Yu
• Reporter: Genmao Yu
• Created: 01/Nov/17 01:56
• Updated: 30/Oct/18 12:45
• Resolved: 13/Apr/18 02:25

Description

This mechanism is designed for uploading file in parallel and asynchronously:

• improve the performance of uploading file to OSS server. Firstly, this mechanism splits result to multiple small blocks and upload them in parallel. Then, getting result and uploading blocks are asynchronous.
• avoid buffering too large result into local disk. To cite an extreme example, there is a task which will output 100GB or even larger, we may need to output this 100GB to local disk and then upload it. Sometimes, it is inefficient and limited to disk space.

This patch reuse SemaphoredDelegatingExecutor as executor service and depends on HADOOP-15039.

Attached asynchronous_file_uploading.pdf illustrated the difference between previous AliyunOSSOutputStream and AliyunOSSBlockOutputStream, i.e. this asynchronous multi-part based uploading mechanism.

1. AliyunOSSOutputStream: we need to output the whole result to local disk before we can upload it to OSS. This will poses two problems：

• if the output file is too large, it will run out of the local disk.
• if the output file is too large, task will wait long time to upload result to OSS before finish, wasting much compute resource.

2. AliyunOSSBlockOutputStream: we cut the task output into small blocks, i.e. some small local file, and each block will be packaged into a uploading task. These tasks will be submitted into SemaphoredDelegatingExecutor. SemaphoredDelegatingExecutor will upload this blocks in parallel, this will improve performance greatly.

3. Each task will retry 3 times to upload block to Aliyun OSS. If one of those tasks failed, the whole file uploading will failed, and we will abort current uploading.

Issue Links

• is related to: HADOOP-15607 AliyunOSS: fix duplicated partNumber issue in AliyunOSSBlockOutputStream
• is related to: HADOOP-15868 AliyunOSS: update document for properties of multiple part download, multiple part upload and directory copy
• relates to: HADOOP-15039 Move SemaphoredDelegatingExecutor to hadoop-common