com.gpudb

Class GenericRecord

java.lang.Object

com.gpudb.RecordBase

com.gpudb.GenericRecord

All Implemented Interfaces:

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

public final class GenericRecord
extends RecordBase
implements Serializable

An object that contains Record data based on a GPUdb Type specified at runtime. GPUdb functions that return non-dynamic data will use generic records by default in the absence of a specified type descriptor or known type.

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
GenericRecord(Type type) Creates a new generic record based on the specified GPUdb Type.

Method Summary

Modifier and Type	Method and Description
Object	get(int index) Returns the value of the specified field.
Type	getType() Returns the GPUdb Type of the record.
void	put(int index, Object value) Sets the value of the specified field.
void	putDateTime(int index, Object value) For string columns with date, time, or datetime property, parse the string and convert to the appropriate Kinetica format using the system timezone.
void	putDateTime(int index, Object value, TimeZone timezone) For string columns with date, time, or datetime property, parse the string and convert to the appropriate Kinetica format using the given timezone (system timezone if none given).
void	putDateTime(String name, Object value) For string columns with date, time, or datetime property, parse the string and convert to the appropriate Kinetica format using the system timezone.
void	putDateTime(String name, Object value, TimeZone timezone) For string columns with date, time, or datetime property, parse the string and convert to the appropriate Kinetica format using the given timezone (system timezone if none given).

Methods inherited from class com.gpudb.RecordBase

equals, get, getBytes, getBytes, getDataMap, getDouble, getDouble, getFloat, getFloat, getInt, getInt, getLong, getLong, getSchema, getString, getString, hashCode, put, toString

Methods inherited from class java.lang.Object

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

Constructor Detail

GenericRecord

public GenericRecord(Type type)

Creates a new generic record based on the specified GPUdb Type. Note that generic records can also be created using Type.newInstance().

Parameters:

type - the GPUdb type

Method Detail

getType

public Type getType()

Description copied from interface: Record

Returns the GPUdb Type of the record.

Specified by:

getType in interface Record

Returns:

the GPUdb type

get

public Object get(int index)

Description copied from interface: Record

Returns the value of the specified field.

Specified by:

get in interface Record

Specified by:

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

Parameters:

index - the index of the field

Returns:

the value of the field

put

public void put(int index,
                Object value)

Description copied from interface: Record

Sets the value of the specified field.

Specified by:

put in interface Record

Specified by:

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

Parameters:

index - the index of the field

value - the new value

putDateTime

public void putDateTime(String name,
                        Object value)
                 throws GPUdbException

For string columns with date, time, or datetime property, parse the string and convert to the appropriate Kinetica format using the system timezone. If the column is not of a relevant type, set the value without any parsing (so that any string or other typed values can be set using this method without resorting to first check the column's type before calling it). Caveat is that due to string manipulation, this is considerably slower than put(int, java.lang.Object). So, use this method only if you know that a non-Kinetica date/time/datetime format is being used.

Parameters:

name - The name of the column.

value - The value to be parsed (based on the given column's type).

Throws:

GPUdbException - if an error occurs during the operation.

putDateTime

public void putDateTime(String name,
                        Object value,
                        TimeZone timezone)
                 throws GPUdbException

For string columns with date, time, or datetime property, parse the string and convert to the appropriate Kinetica format using the given timezone (system timezone if none given). If the column is not of a relevant type, set the value without any parsing (so that any string or other typed values can be set using this method without resorting to first check the column's type before calling it). Caveat is that due to string manipulation, this is considerably slower than put(int, java.lang.Object). So, use this method only if you know that a non-Kinetica date/time/datetime format is being used.

Parameters:

name - The name of the column.

value - The value to be parsed (based on the given column's type).

timezone - Optional parameter specifying the timezone to use for parsing the given value. If null, the system timezone is used.

Throws:

GPUdbException - if an error occurs during the operation.

putDateTime

public void putDateTime(int index,
                        Object value)
                 throws GPUdbException

For string columns with date, time, or datetime property, parse the string and convert to the appropriate Kinetica format using the system timezone. If the column is not of a relevant type, throw an error. Caveat is that due to string manipulation, this is considerably slower than put(int, java.lang.Object). So, use this method only if you know that a non-Kinetica date/time/datetime format is being used.

Parameters:

index - The index of the column.

value - The value to be parsed (based on the given column's type).

Throws:

GPUdbException - if an error occurs during the operation.

putDateTime

public void putDateTime(int index,
                        Object value,
                        TimeZone timezone)
                 throws GPUdbException

For string columns with date, time, or datetime property, parse the string and convert to the appropriate Kinetica format using the given timezone (system timezone if none given). If the column is not of a relevant type, set the value without any parsing (so that any string or other typed values can be set using this method without resorting to first check the column's type before calling it). Caveat is that due to string manipulation, this is considerably slower than put(int, java.lang.Object). So, use this method only if you know that a non-Kinetica date/time/datetime format is being used. The following patterns are accepted for date and datetime columns: 1) yyyy[-][/][.]MM[-][/][.]dd[ ]['T'][HH:mm[:ss][.S[S][S][S][S][S]][ ][XXX][Z][z][VV][x]] 2) MM[-][/][.]dd[-][/][.]yyyy[ ]['T'][HH:mm[:ss][.S[S][S][S][S][S]][ ][XXX][Z][z][VV][x]] 3) dd[-][/][.]MM[-][/][.]yyyy[ ]['T'][HH:mm[:ss][.S[S][S][S][S][S]][ ][XXX][Z][z][VV][x]] The following pattern is accepted by time-type columns: HH:mm[:ss][.S[S][S][S][S][S]][ ][XXX][Z][z][VV][x] In other words, the date component can be any of YMD, MDY, or DMY pattern withh '-', '.', or '/' as the separator. And, the time component must have hours and minutes, but can optionally have seconds, fraction of a second (up to six digits) and some form of a timezone identifier.

Parameters:

index - The index of the column.

value - The value to be parsed (based on the given column's type).

timezone - Optional parameter specifying the timezone to use for parsing the given value. If null, the system timezone is used.

Throws:

GPUdbException - if an error occurs during the operation.