com.gpudb.protocol

Class AggregateHistogramRequest

java.lang.Object

com.gpudb.protocol.AggregateHistogramRequest

All Implemented Interfaces:

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

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

A set of parameters for GPUdb.aggregateHistogram(AggregateHistogramRequest).

Performs a histogram calculation given a table, a column, and an interval function. The interval is used to produce bins of that size and the result, computed over the records falling within each bin, is returned. For each bin, the start value is inclusive, but the end value is exclusive--except for the very last bin for which the end value is also inclusive. The value returned for each bin is the number of records in it, except when a column name is provided as a value_column. In this latter case the sum of the values corresponding to the value_column is used as the result instead. The total number of bins requested cannot exceed 10,000.

NOTE: The Kinetica instance being accessed must be running a CUDA (GPU-based) build to service a request that specifies a value_column option.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	AggregateHistogramRequest.Options Optional parameters.

Constructor Summary

Constructors

Constructor and Description
AggregateHistogramRequest() Constructs an AggregateHistogramRequest object with default parameters.
AggregateHistogramRequest(String tableName, String columnName, double start, double end, double interval, Map<String,String> options) Constructs an AggregateHistogramRequest 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.
String	getColumnName()
double	getEnd()
double	getInterval()
Map<String,String>	getOptions()
org.apache.avro.Schema	getSchema() This method supports the Avro framework and is not intended to be called directly by the user.
double	getStart()
String	getTableName()
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.
AggregateHistogramRequest	setColumnName(String columnName)
AggregateHistogramRequest	setEnd(double end)
AggregateHistogramRequest	setInterval(double interval)
AggregateHistogramRequest	setOptions(Map<String,String> options)
AggregateHistogramRequest	setStart(double start)
AggregateHistogramRequest	setTableName(String tableName)
String	toString()

Methods inherited from class java.lang.Object

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

Constructor Detail

AggregateHistogramRequest

public AggregateHistogramRequest()

Constructs an AggregateHistogramRequest object with default parameters.

AggregateHistogramRequest

public AggregateHistogramRequest(String tableName,
                                 String columnName,
                                 double start,
                                 double end,
                                 double interval,
                                 Map<String,String> options)

Constructs an AggregateHistogramRequest object with the specified parameters.

Parameters:

tableName - Name of the table on which the operation will be performed. Must be an existing table or collection.

columnName - Name of a column or an expression of one or more column names over which the histogram will be calculated.

start - Lower end value of the histogram interval, inclusive.

end - Upper end value of the histogram interval, inclusive.

interval - The size of each bin within the start and end parameters.

options - Optional parameters.

• VALUE_COLUMN: The name of the column to use when calculating the bin values (values are summed). The column must be a numerical type (int, double, long, float).

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.

getTableName

public String getTableName()

Returns:

Name of the table on which the operation will be performed. Must be an existing table or collection.

setTableName

public AggregateHistogramRequest setTableName(String tableName)

Parameters:

tableName - Name of the table on which the operation will be performed. Must be an existing table or collection.

Returns:

this to mimic the builder pattern.

getColumnName

public String getColumnName()

Returns:

Name of a column or an expression of one or more column names over which the histogram will be calculated.

setColumnName

public AggregateHistogramRequest setColumnName(String columnName)

Parameters:

columnName - Name of a column or an expression of one or more column names over which the histogram will be calculated.

Returns:

this to mimic the builder pattern.

getStart

public double getStart()

Returns:

Lower end value of the histogram interval, inclusive.

setStart

public AggregateHistogramRequest setStart(double start)

Parameters:

start - Lower end value of the histogram interval, inclusive.

Returns:

this to mimic the builder pattern.

getEnd

public double getEnd()

Returns:

Upper end value of the histogram interval, inclusive.

setEnd

public AggregateHistogramRequest setEnd(double end)

Parameters:

end - Upper end value of the histogram interval, inclusive.

Returns:

this to mimic the builder pattern.

getInterval

public double getInterval()

Returns:

The size of each bin within the start and end parameters.

setInterval

public AggregateHistogramRequest setInterval(double interval)

Parameters:

interval - The size of each bin within the start and end parameters.

Returns:

this to mimic the builder pattern.

getOptions

public Map<String,String> getOptions()

Returns:

Optional parameters.

• VALUE_COLUMN: The name of the column to use when calculating the bin values (values are summed). The column must be a numerical type (int, double, long, float).

The default value is an empty Map.

setOptions

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

Parameters:

options - Optional parameters.

• VALUE_COLUMN: The name of the column to use when calculating the bin values (values are summed). The column must be a numerical type (int, double, long, float).

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