com.gpudb.protocol

Class CreateJobRequest

java.lang.Object

com.gpudb.protocol.CreateJobRequest

All Implemented Interfaces:

org.apache.avro.generic.GenericContainer, org.apache.avro.generic.IndexedRecord

public class CreateJobRequest
extends Object
implements org.apache.avro.generic.IndexedRecord

A set of parameters for GPUdb.createJob(CreateJobRequest).

Create a job which will run asynchronously. The response returns a job ID, which can be used to query the status and result of the job. The status and the result of the job upon completion can be requested by GPUdb.getJob(GetJobRequest).

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	CreateJobRequest.Options Optional parameters.
static class	CreateJobRequest.RequestEncoding The encoding of the request payload for the job.

Constructor Summary

Constructors

Constructor and Description
CreateJobRequest() Constructs a CreateJobRequest object with default parameters.
CreateJobRequest(String endpoint, String requestEncoding, ByteBuffer data, String dataStr, Map<String,String> options) Constructs a CreateJobRequest object with the specified parameters.

Method Summary

Modifier and Type	Method and Description
boolean	equals(Object obj)
Object	get(int index) This method supports the Avro framework and is not intended to be called directly by the user.
static org.apache.avro.Schema	getClassSchema() This method supports the Avro framework and is not intended to be called directly by the user.
ByteBuffer	getData()
String	getDataStr()
String	getEndpoint()
Map<String,String>	getOptions()
String	getRequestEncoding()
org.apache.avro.Schema	getSchema() This method supports the Avro framework and is not intended to be called directly by the user.
int	hashCode()
void	put(int index, Object value) This method supports the Avro framework and is not intended to be called directly by the user.
CreateJobRequest	setData(ByteBuffer data)
CreateJobRequest	setDataStr(String dataStr)
CreateJobRequest	setEndpoint(String endpoint)
CreateJobRequest	setOptions(Map<String,String> options)
CreateJobRequest	setRequestEncoding(String requestEncoding)
String	toString()

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

CreateJobRequest

public CreateJobRequest()

Constructs a CreateJobRequest object with default parameters.

CreateJobRequest

public CreateJobRequest(String endpoint,
                        String requestEncoding,
                        ByteBuffer data,
                        String dataStr,
                        Map<String,String> options)

Constructs a CreateJobRequest object with the specified parameters.

Parameters:

endpoint - Indicates which endpoint to execute, e.g. '/alter/table'.

requestEncoding - The encoding of the request payload for the job. Supported values:

• BINARY
• JSON
• SNAPPY

The default value is BINARY.

data - Binary-encoded payload for the job to be run asynchronously. The payload must contain the relevant input parameters for the endpoint indicated in endpoint. Please see the documentation for the appropriate endpoint to see what values must (or can) be specified. If this parameter is used, then requestEncoding must be binary or snappy.

dataStr - JSON-encoded payload for the job to be run asynchronously. The payload must contain the relevant input parameters for the endpoint indicated in endpoint. Please see the documentation for the appropriate endpoint to see what values must (or can) be specified. If this parameter is used, then requestEncoding must be json.

options - Optional parameters.

• REMOVE_JOB_ON_COMPLETE: Supported values:
  • TRUE
  • FALSE
• JOB_TAG: Tag to use for submitted job. The same tag could be used on backup cluster to retrieve response for the job. Tags can use letter, numbers, '_' and '-'

The default value is an empty Map.

Method Detail

getClassSchema

public static org.apache.avro.Schema getClassSchema()

This method supports the Avro framework and is not intended to be called directly by the user.

Returns:

the schema for the class.

getEndpoint

public String getEndpoint()

Returns:

Indicates which endpoint to execute, e.g. '/alter/table'.

setEndpoint

public CreateJobRequest setEndpoint(String endpoint)

Parameters:

endpoint - Indicates which endpoint to execute, e.g. '/alter/table'.

Returns:

this to mimic the builder pattern.

getRequestEncoding

public String getRequestEncoding()

Returns:

The encoding of the request payload for the job. Supported values:

• BINARY
• JSON
• SNAPPY

The default value is BINARY.

setRequestEncoding

public CreateJobRequest setRequestEncoding(String requestEncoding)

Parameters:

requestEncoding - The encoding of the request payload for the job. Supported values:

• BINARY
• JSON
• SNAPPY

The default value is BINARY.

Returns:

this to mimic the builder pattern.

getData

public ByteBuffer getData()

Returns:

Binary-encoded payload for the job to be run asynchronously. The payload must contain the relevant input parameters for the endpoint indicated in endpoint. Please see the documentation for the appropriate endpoint to see what values must (or can) be specified. If this parameter is used, then requestEncoding must be binary or snappy.

setData

public CreateJobRequest setData(ByteBuffer data)

Parameters:

data - Binary-encoded payload for the job to be run asynchronously. The payload must contain the relevant input parameters for the endpoint indicated in endpoint. Please see the documentation for the appropriate endpoint to see what values must (or can) be specified. If this parameter is used, then requestEncoding must be binary or snappy.

Returns:

this to mimic the builder pattern.

getDataStr

public String getDataStr()

Returns:

JSON-encoded payload for the job to be run asynchronously. The payload must contain the relevant input parameters for the endpoint indicated in endpoint. Please see the documentation for the appropriate endpoint to see what values must (or can) be specified. If this parameter is used, then requestEncoding must be json.

setDataStr

public CreateJobRequest setDataStr(String dataStr)

Parameters:

dataStr - JSON-encoded payload for the job to be run asynchronously. The payload must contain the relevant input parameters for the endpoint indicated in endpoint. Please see the documentation for the appropriate endpoint to see what values must (or can) be specified. If this parameter is used, then requestEncoding must be json.

Returns:

this to mimic the builder pattern.

getOptions

public Map<String,String> getOptions()

Returns:

Optional parameters.

• REMOVE_JOB_ON_COMPLETE: Supported values:
  • TRUE
  • FALSE
• JOB_TAG: Tag to use for submitted job. The same tag could be used on backup cluster to retrieve response for the job. Tags can use letter, numbers, '_' and '-'

The default value is an empty Map.

setOptions

public CreateJobRequest setOptions(Map<String,String> options)

Parameters:

options - Optional parameters.

• REMOVE_JOB_ON_COMPLETE: Supported values:
  • TRUE
  • FALSE
• JOB_TAG: Tag to use for submitted job. The same tag could be used on backup cluster to retrieve response for the job. Tags can use letter, numbers, '_' and '-'

The default value is an empty Map.

Returns:

this to mimic the builder pattern.

getSchema

public org.apache.avro.Schema getSchema()

This method supports the Avro framework and is not intended to be called directly by the user.

Specified by:

getSchema in interface org.apache.avro.generic.GenericContainer

Returns:

the schema object describing this class.

get

public Object get(int index)

This method supports the Avro framework and is not intended to be called directly by the user.

Specified by:

get in interface org.apache.avro.generic.IndexedRecord

Parameters:

index - the position of the field to get

Returns:

value of the field with the given index.

Throws:

IndexOutOfBoundsException

put

public void put(int index,
                Object value)

This method supports the Avro framework and is not intended to be called directly by the user.

Specified by:

put in interface org.apache.avro.generic.IndexedRecord

Parameters:

index - the position of the field to set

value - the value to set

Throws:

IndexOutOfBoundsException

equals

public boolean equals(Object obj)

Overrides:

equals in class Object

toString

public String toString()

Overrides:

toString in class Object

hashCode

public int hashCode()

Overrides:

hashCode in class Object