tachyon.thrift

Interface WorkerService.Iface

All Known Implementing Classes:

WorkerService.Client

Enclosing class:

WorkerService

public static interface WorkerService.Iface

Method Summary

Methods

Modifier and Type	Method and Description
void	accessBlock(long blockId)
boolean	asyncCheckpoint(long fileId)
void	cacheBlock(long sessionId, long blockId) Used to cache a block into Tachyon space, worker will move the temporary block file from session folder to data folder, and update the space usage information related.
void	cancelBlock(long sessionId, long blockId) Used to cancel a block which is being written.
String	lockBlock(long blockId, long sessionId) Lock the file in Tachyon's space while the session is reading it, and the path of the block file locked will be returned, if the block file is not found, FileDoesNotExistException will be thrown.
void	persistFile(long fileId, long nonce, String path)
boolean	promoteBlock(long blockId) Used to promote block on under storage layer to top storage layer when there are more than one storage layers in Tachyon's space.
String	requestBlockLocation(long sessionId, long blockId, long initialBytes) Used to allocate location and space for a new coming block, worker will choose the appropriate storage directory which fits the initial block size by some allocation strategy, and the temporary file path of the block file will be returned.
boolean	requestSpace(long sessionId, long blockId, long requestBytes) Used to request space for some block file.
void	sessionHeartbeat(long sessionId, List<Long> metrics) Local session send heartbeat to local worker to keep its temporary folder.
boolean	unlockBlock(long blockId, long sessionId) Used to unlock a block after the block is accessed, if the block is to be removed, delete the block file.

Method Detail

accessBlock

void accessBlock(long blockId)
                 throws org.apache.thrift.TException

Throws:

org.apache.thrift.TException

asyncCheckpoint

boolean asyncCheckpoint(long fileId)
                        throws TachyonTException,
                               org.apache.thrift.TException

Throws:

TachyonTException

org.apache.thrift.TException

cacheBlock

void cacheBlock(long sessionId,
              long blockId)
                throws TachyonTException,
                       ThriftIOException,
                       org.apache.thrift.TException

Used to cache a block into Tachyon space, worker will move the temporary block file from session folder to data folder, and update the space usage information related. then update the block information to master.

Parameters:

sessionId -

blockId -

Throws:

TachyonTException

ThriftIOException

org.apache.thrift.TException

cancelBlock

void cancelBlock(long sessionId,
               long blockId)
                 throws TachyonTException,
                        ThriftIOException,
                        org.apache.thrift.TException

Used to cancel a block which is being written. worker will delete the temporary block file and the location and space information related, then reclaim space allocated to the block.

Parameters:

sessionId -

blockId -

Throws:

TachyonTException

ThriftIOException

org.apache.thrift.TException

lockBlock

String lockBlock(long blockId,
               long sessionId)
                 throws TachyonTException,
                        org.apache.thrift.TException

Lock the file in Tachyon's space while the session is reading it, and the path of the block file locked will be returned, if the block file is not found, FileDoesNotExistException will be thrown.

Parameters:

blockId -

sessionId -

Throws:

TachyonTException

org.apache.thrift.TException

persistFile

void persistFile(long fileId,
               long nonce,
               String path)
                 throws TachyonTException,
                        org.apache.thrift.TException

Throws:

TachyonTException

org.apache.thrift.TException

promoteBlock

boolean promoteBlock(long blockId)
                     throws TachyonTException,
                            ThriftIOException,
                            org.apache.thrift.TException

Used to promote block on under storage layer to top storage layer when there are more than one storage layers in Tachyon's space. return true if the block is successfully promoted, false otherwise.

Parameters:

blockId -

Throws:

TachyonTException

ThriftIOException

org.apache.thrift.TException

requestBlockLocation

String requestBlockLocation(long sessionId,
                          long blockId,
                          long initialBytes)
                            throws TachyonTException,
                                   ThriftIOException,
                                   org.apache.thrift.TException

Used to allocate location and space for a new coming block, worker will choose the appropriate storage directory which fits the initial block size by some allocation strategy, and the temporary file path of the block file will be returned. if there is no enough space on Tachyon storage OutOfSpaceException will be thrown, if the file is already being written by the session, FileAlreadyExistsException will be thrown.

Parameters:

sessionId -

blockId -

initialBytes -

Throws:

TachyonTException

ThriftIOException

org.apache.thrift.TException

requestSpace

boolean requestSpace(long sessionId,
                   long blockId,
                   long requestBytes)
                     throws TachyonTException,
                            org.apache.thrift.TException

Used to request space for some block file. return true if the worker successfully allocates space for the block on block’s location, false if there is no enough space, if there is no information of the block on worker, FileDoesNotExistException will be thrown.

Parameters:

sessionId -

blockId -

requestBytes -

Throws:

TachyonTException

org.apache.thrift.TException

sessionHeartbeat

void sessionHeartbeat(long sessionId,
                    List<Long> metrics)
                      throws org.apache.thrift.TException

Local session send heartbeat to local worker to keep its temporary folder. It also sends client metrics to the worker.

Parameters:

sessionId -

metrics -

Throws:

org.apache.thrift.TException

unlockBlock

boolean unlockBlock(long blockId,
                  long sessionId)
                    throws org.apache.thrift.TException

Used to unlock a block after the block is accessed, if the block is to be removed, delete the block file. return true if successfully unlock the block, return false if the block is not found or failed to delete the block.

Parameters:

blockId -

sessionId -

Throws:

org.apache.thrift.TException