Status

...

...

...

...

...

Please keep the discussion on the mailing list rather than commenting on the wiki (wiki discussions get unwieldy fast).

Motivation

Hash-based blocking shuffle and sort-merge based blocking shuffle are two main blocking shuffle implementations wildly adopted by existing distributed data processing frameworks. Hash-based implementation writes data sent to different reducer tasks into separate files concurrently while sort-merge based approach writes those data together into a single file and merges those small files into bigger ones. Compared to sort-merge based approach, hash-based approach has several weak points when it comes to running large scale batch jobs:

1. Stability: For high parallelism (tens of thousands) batch job, current hash-based blocking shuffle implementation writes too many files concurrently which gives high pressure to the file system, for example, maintenance of too many file metas, exhaustion of inodes or file descriptors. All of these can be potential stability issues. Sort-Merge based blocking shuffle don’t have the problem because for one result partition, only one file is written at the same time.
2. Performance: Large amounts of small shuffle files and random IO can influence shuffle performance a lot especially for hdd (for ssd, sequential read is also important because of read ahead and cache)HDD. For batch jobs processing massive data, small amount of data per subpartition is common because of high parallelism. Besides, data skew is another cause of small subpartition files. By merging writing data of all subpartitions together in one file and leveraging IO scheduling, more sequential read can be achieved.
3. Resource: For current hash-based implementation, each subpartition needs at least one buffer. For large scale batch shuffles, the memory consumption can be huge. For example, we need at least 320M network memory per result partition if parallelism is set to 10000 and because of the huge network consumption, it is hard to config the network memory for large scale batch job and  sometimes parallelism can not be increased just because of insufficient network memory  which leads to bad user experience.

By introducing the sort-merge based approach blocking shuffle implementation to Flink, we can improve Flink’s capability of running large scale batch jobs.

Public Interfaces

Several new config options will be added to control the behavior of the sort-merge based blocking shuffle and by disable sort-merge based blocking shuffle by default, the default behavior of blocking shuffle stays unchanged.

taskmanager.network.sort-shuffle.

min-buffers

Minimum number of

 network

 buffers required per sort-merge blocking result partition.

taskmanager.network.sort-shuffle.

min-parallelism

Parallelism threshold to switch between 

sort-merge based blocking

 shuffle and the default hash-based blocking shuffle.

taskmanager.memory.framework.off-heap.batch-shuffle.size

Size of direct memory used by blocking shuffle for shuffle data read.

A fixed number of network A fixed number of network buffers per result partition makes the memory consumption decoupled with parallelism which is more friendly for large scale batch jobs.

Proposed Changes

Image Removed

Image Added

1. Each result partition holds a We have SortBuffer, serialized records and events will be appended to the SortBuffer until the it is full or EOF reached.
2. Then the PartitionedFileWriter will spill all data in the SortBuffer as one PartitionedFile in subpartition index order and at the same time partition offset information will be also saved.
3. MergePolicy will collect information of all spilled PartitionedFiles and select a subset or all files to be merged according to the number of files and the file size.
4. PartitionedFileMerger then merges all the selected PartitionedFiles into one PartitionedFile.
5. After the SortMergeResultPartition is finished, the After the SortMergeResultPartition is finished, the consumer task can request the partition data, a SortMergePartitionReader will be created to read the corresponding data.

Main Components

1. The IO scheduler will schedule all the shuffle data reads in IO friendly order, i.e. reading shuffle data file sequentially.

Main Components

SortBuffer: Data of different channels SortBuffer: Data of different channels can be appended to a SortBuffer and after the SortBuffer is finished, the appended data can be copied from it in channel index order.

public interface SortBuffer {

    /**
     * Appends data of the specified channel to this {@link SortBuffer} and returns true if all
  bytes of
  * bytes *of the source buffer is copied to this {@link SortBuffer} successfully, otherwise if
  returns false,
  * returns *false, nothing will be copied.
     */
    boolean append(ByteBuffer source, int targetChannel, Buffer.DataType dataType)
 throws IOException;
   /**
    *    throws IOException;

    /**
     * Copies data in this {@link SortBuffer} to the target {@link MemorySegment} in channel index
 order
    * order and returns {@link BufferWithChannel} which contains the copied data and the
 corresponding  channel
  * corresponding *channel index.
     */
    BufferWithChannel copyDatacopyIntoSegment(MemorySegment target);

    /**
    * Returns the number of records written to this {@link SortBuffer}.
    */
    long numRecords();

    /**
    * Returns the number of bytes written to this {@link SortBuffer}. */
    */
   long numBytes();

    /**
    * Returns true if there is still data can be consumed in this {@link SortBuffer}.
    */
    boolean hasRemaining();

    /**
    * Finishes this {@link SortBuffer} which means no record can be appended any more.
    */
    void finish();

    /**
    * Releases Whether this {@link SortBuffer} whichis releasesfinished allor resourcesnot.
    */
    voidboolean releaseisFinished();
}

PartitionedFile: Persistent file type of SortMergeResultPartition and it stores data of all subpartitions in subpartition index order.

...

    /** Releases this {@link SortBuffer} which releases all resources. */
   public Pathvoid getDataFilerelease();

    /**
 Whether this {@link *SortBuffer} Returnsis thereleased startingor offset of the given subpartition in this {@link PartitionedFile}.
    */
not. */
    boolean isReleased();
}

PartitionedFile: Persistent file type of SortMergeResultPartition and it stores data of all subpartitions in subpartition index order.

public class PartitionedFile {

    public longPath getStartingOffsetgetDataFilePath(int subpartitionIndex);

    public Path getIndexFilePath();

    public int getNumRegions();

    /**
     * ReturnsGets the numberindex of buffersentry of the giventarget subpartitionregion inand thissubpartition {@link PartitionedFile}.
either from the index data cache    */
   public  int* getNumBuffers(int subpartitionIndex);
   public void deleteQuietly();
}

PartitionedFileWriter: File writer to write buffers to PartitionedFile in subpartition order.

public class PartitionedFileWriter {

or the index data file.
     */   /**
    *public Opensvoid a {@link PartitionedFile} for writing.
getIndexEntry(FileChannel indexFile, ByteBuffer target, int region, int subpartition)
            throws IOException;    */

    public void opendeleteQuietly();
}

PartitionedFileWriter: File writer to write buffers to PartitionedFile in subpartition order.

public class PartitionedFileWriter implements AutoCloseable { throws IOException;

    /**
     * WritesPersists athe {@linkregion Buffer}index of the given subpartition to the opened {@link PartitionedFile}.
 current data region and starts a new region to write.
     *
     * <p>Note: The caller is responsible for recycling the target buffer and releasing the failed
    * {@link PartitionedFile} if any
     * exception occurs.
     */
   public void writeBuffer(Buffer target, int subpartitionIndex) throws IOException;
   /**
    * Finishes the current {@link PartitionedFile} which closes the file channel and constructs* @param isBroadcastRegion Whether it's a broadcast region. See {@link #isBroadcastRegion}.
     */
    public void startNewRegion(boolean isBroadcastRegion) throws IOException;

    * the corresponding {/**@link PartitionedFile.PartitionedFileIndex}.
    *
    * <p>Note:Writes Thea callerlist isof responsible for releasing the failed{@link Buffer}s to this {@link PartitionedFile} if any
. It guarantees that after
     * exceptionthe occurs.
return of this  */
   public PartitionedFile finish() throws IOException;
   /**
    * Used to close and delete the failed {@link PartitionedFile} when any exception occurs.
    */
   public void releaseQuietly();
}

PartitionedFileReader: Reader which can read all data of the target subpartition from a PartitionedFile.

public class PartitionedFileReader implements AutoCloseable {

method, the target buffers can be released. In a data region, all data of
     * the same subpartition must be written together.
     *
     * <p>Note: The caller is responsible for recycling the target buffers and releasing the failed
     * {@link PartitionedFile} if any exception occurs.
     */
    public void writeBuffers(List<BufferWithChannel> bufferWithChannels) throws IOException;

    /**
     * Finishes writing the {@link PartitionedFile} which closes the file channel and returns the
     * corresponding {@link PartitionedFile}.
     *
     * <p>Note: The caller is responsible for releasing the failed {@link PartitionedFile} if any
     * exception occurs.
     */
    public PartitionedFile finish() throws IOException;

    /** Used to close and delete the failed {@link PartitionedFile} when any exception occurs. */
    public void releaseQuietly();

    @Override
    public void close() throws IOException;
}

PartitionedFileReader: Reader which can read all data of the target subpartition from a PartitionedFile.

class PartitionedFileReader {

    /**
     * Reads a buffer from the current region of the target {@link PartitionedFile} and moves the
     * read position forward.
     *
     * <p>Note: The caller is responsible for recycling the target buffer if any exception occurs.
     *
     * @param target The target {@link MemorySegment} to read data to.
     * @param recycler The {@link BufferRecycler} which is responsible to recycle the target buffer.
     * @return A {@link Buffer} containing the data read.
     */
    @Nullable
    public Buffer readCurrentRegion(MemorySegment target, BufferRecycler recycler) throws IOException;

    public boolean hasRemaining() throws IOException;

    /** Gets read priority of this file reader. Smaller value indicates higher priority. */
    public long getPriority();
}

SortMergeResultPartition: Entry point of sort-merge based blocking shuffle. (Override methods are inherited from ResultPartition)

public class SortMergeResultPartition extends ResultPartition {

    @Override
    public void setup() throws IOException;

    @Override
    protected void releaseInternal();

    @Override
    public void emitRecord(ByteBuffer record, int targetSubpartition) throws IOException;

    @Override
    public void broadcastRecord(ByteBuffer record) throws IOException;

    @Override
    public void broadcastEvent(AbstractEvent event, boolean isPriorityEvent) throws IOException;

    /**
     * Spills the large record into the target {@link PartitionedFile} as a separate data region.
     */
    private void writeLargeRecord(
            ByteBuffer record, int targetSubpartition, DataType dataType, boolean isBroadcast)
            throws IOException;

    @Override
    public void finish() throws IOException;

    @Override
    /**
    * Opens the given {@link PartitionedFile} and moves read position to the starting offset of the
    * target subpartition.
    */
   public void open() throws IOException;
   /**
    * Reads a buffer from the {@link PartitionedFile} and moves the read position forward.
    *
    * <p>Note: The caller is responsible for recycling the target buffer if any exception occurs.
    */
   @Nullable
   public Buffer readBuffer(MemorySegment target, BufferRecycler recycler) throws IOException;
   public boolean hasRemaining();
   @Override
   public void close();

 throws   IOException;
}

SortMergeResultPartition: Entry point of sort-merge based blocking shuffle. (Override methods are inherited from ResultPartition)

public class SortMergeResultPartition extends ResultPartition {
   @Override
   protected void releaseInternal();
   @Override
   public void emitRecord(ByteBuffer record, int targetSubpartition)@Override
    public ResultSubpartitionView createSubpartitionView(
            int subpartitionIndex, BufferAvailabilityListener availabilityListener)
            throws IOException;

    @Override
    public void broadcastRecordflushAll(ByteBuffer record) throws IOException;

    @Override
    public void broadcastEventflush(AbstractEvent event, boolean isPriorityEvent) throws IOException;int subpartitionIndex);

    @Override
   /**
 public CompletableFuture<?> getAvailableFuture();

 * Spills the large@Override
 record into a separatepublic {@link PartitionedFile}.int getNumberOfQueuedBuffers();

    */@Override
    public privateint void getNumberOfQueuedBuffers(int targetSubpartition);
}

SortMergePartitionReader: Subpartition data reader for SortMergeResultPartition. (Override methods are mainly inherited from ResultSubpartitionView)

public class SortMergeSubpartitionReader
writeLargeRecord(
          implements ByteBuffer recordResultSubpartitionView, intComparable<SortMergeSubpartitionReader> targetSubpartition,{

 DataType dataType) throws IOException;
   void releaseReader(SortMergePartitionReader reader);
@Nullable
    @Override
   public void finish() throws IOException;
   @Override
   public voidBufferAndBacklog closegetNextBuffer();

    /** This @Override
method is called publicby the ResultSubpartitionViewIO createSubpartitionView(
thread of {@link SortMergeResultPartitionReadScheduler}. */
    public boolean intreadBuffers(Queue<MemorySegment> subpartitionIndexbuffers, BufferAvailabilityListenerBufferRecycler listener) throws IOException;
   @Override
recycler) throws IOException;

    public CompletableFuture<?> getReleaseFuture();

    public void flushAllfail(Throwable throwable);

    @Override
    public void flushnotifyDataAvailable(int subpartitionIndex);

    @Override
   public CompletableFuture<?> getAvailableFuture();
}

SortMergePartitionReader: Subpartition data reader for link SortMergeResultPartition. (Override methods are inherited from ResultSubpartitionView and BufferRecycler)

public

...

   @Nullable
 int compareTo(SortMergeSubpartitionReader that);

    @Override
    public BufferAndBacklogvoid getNextBufferreleaseAllResources() throws IOException;

    @Override
    public voidboolean notifyDataAvailableisReleased();

    @Override
    public void recycleresumeConsumption(MemorySegment segment);

    @Override
    public voidThrowable releaseAllResourcesgetFailureCause();

    @Override
    public boolean isAvailable(int numCreditsAvailable);

    @Override
    public int unsynchronizedGetNumberOfQueuedBuffers();
}

The interface of SortBuffer and PartitionedFileMergerSortBuffer is flexible enough and new requirements like sortsorting by record can be also implemented easily if needed.

Further Optimization

IO Scheduling

As we discussed above, writing data of all subpartitions together in one file makes it more friendly for sequential read and write which can already improve the IO performance a lot. Besides, we can even further improve the IO performance by scheduling the reading and writing IO requests (especially helpful for reading). When shuffling data, the sequential read is restricted by the amount of data of each subpartition, the size of the read buffer and the available credits of the consumer task. The data read pattern can be summarized as reading a chunk of data from different subpartitions in parallel. After data of all subpartitions is spilled to one file in subpartition index order, we can rearrange the data read requests and always serve the data in subpartition order and read as much data in one request. By scheduling the read requests, more sequential reads can be achieved and in the best cases, a data file can be read totally in a sequential way.

Data Compression

Data compression has been implemented for the default hash-based blocking shuffle, which improves the tpcTPC-ds DS benchmark performance by about 30%. We can also implement data compression for sort-merge based blocking shuffle.

Broadcast Optimization

For the result partition using the broadcast partitioner, we can copy the serialized record only once to the SortBuffer and write only one copy of the data to disk which can reduce CPU usage and file IO a lot.

Multiple Disks Load Balance

If there are multiple disks, load balance is important for good performance. The simplest way to achieve load balance is rebalance disk selection.

Restrict Concurrent Partition Requests (Not implemented

...

in FLIP)

For large scale batch jobs, a large number of network connections will be established, which may incur stability issues. We can restrict the number of concurrent partition requests to relieve the issue. Besides, restricting concurrent partition requests can increase the number of network buffers can be used per remote channel, that is, more credits per channel which is helpful for the shuffle reader to read sequentially. (As we mentioned above, the number of available credits can influence sequential read because we can not read more buffers than the consumer can process)

Implement External/Remote Shuffle Service (Not implemented

...

in FLIP)

Implementing a stand-alone shuffle service can further improve the shuffle IO performance because it is a centralized service and can collect more information which can lead to more optimized actions. For example, better node-level load balance, better disk-level load balance, further file merging, node-level IO scheduling and shared read/write buffer and thread pool. It can be introduced in a separated FLIP.

Implementation and Test Plan

Step #1: Implement Basic Shuffle Logic

...

and Data Compression

...

Basic shuffle logic and data compression will be implemented first, which can make the sort-merge based blocking shuffle available for usage. Main components include 1) SortBuffer and a hash-based data clustering implementation; 2) PartitionedFile together with the corresponding writer (PartitionedFileWriter) and reader (PartitionedFileReader); 3) SortMergeResultPartition and the subpartition data reader SortMergePartitionReader. We will introduce this components separately. For data compression, by reusing the facilities implemented for the existing BoundedBlockingResultPartition, only very small change is needed. Tests will include both unit tests, IT cases and real job test on a cluster. Besides, IO scheduling can improve the shuffle performance a lot so we also need to implement it.

Step #2:

...

Implement IO Scheduling Other Optimizations

File merge IO scheduling and other optimizations can be implemented as the second step. Main components include MergePolicy, PartitionedFileMerge, IOScheduler and PartitionRequestManagerIO scheduler and buffer pool for batch shuffle. Tests will include both unit tests, IT cases and real job test on a cluster.

Compatibility, Deprecation, and Migration Plan

The default behavior of Flink stays unchanged. Nothing need to do when migrating to new Flink version.

Appendix

Sort by Subpartition Index

Our goal is to cluster data belonging to the same subpartition together and sort is a nature approach. However, we do not need a generic sort implementation. Given that the subpartition index is a sequence of continuous integers from 0, bucket sort combining linked list is a simpler and more efficient way. Each subpartition takes a bucket and each bucket points to the first record in the binary SortBuffer. Each record also has a pointer pointing to the next record belonging to the same subpartition. The following picture shows how it works:

...