Class GPUdbRecord

class gpudb.GPUdbRecord(record\_type, column\_values)

Represent the data for a given record in GPUdb. Has convenience functions for encoding/decoding the data.

Create a GPUdbRecord object which holds the data for a given record.

Parameters

record\_type (GPUdbRecordType) –

A GPUdbRecordType object that describes the columns of this record.

column\_values (dict or list) –

Either a dict or a list that contains the values for the columns. In either case, must contain values for ALL columns. If a list, then the columns must be in the correct order.

static decode\_binary\_data(record\_type, binary\_data)

Decode binary encoded data (generally returned by GPUdb) using the schema for the data. Return the decoded data.

Parameters

record\_type (str or RecordType) –

If string, then the schema string for the record type, or a RecordType object representing the type.

binary\_data (obj or list) –

The binary encoded data. Could be a single object or a list of data.

Returns

The decoded data (a single object or a list)

static decode\_dynamic\_binary\_data(record\_type, binary\_data)

Decode binary encoded data (generally returned by GPUdb) using the schema for the data. Return the decoded data.

Parameters

record\_type (str or RecordType) –

If string, then the schema string for the record type, or a RecordType object representing the type.

binary\_data (obj or list) –

The binary encoded data. Could be a single object or a list of data.

Returns

The decoded data (a single object or a list)

static decode\_json\_string\_data(json\_string\_data)

Decode binary encoded data in string form (generally returned by GPUdb). Return the decoded data.

Parameters

json\_string\_data (str) –

The stringified JSON encoded data. Could be a single object or a list of data.

Returns

The decoded data (a single object or a list)

static decode\_dynamic\_json\_data\_column\_major(dynamic\_json\_data, dynamic\_schema)

Decode JSON encoded data (generally returned by GPUdb) using the embedded dynamic schema for the data. Return the decoded data.

Parameters

dynamic\_json\_data (dict) –

The JSON encoded data with a dynamic schema.

dynamic\_schema (str) –

The schema string for the data

Returns

The decoded data (a single object or a list)

static decode\_dynamic\_json\_data\_row\_major(dynamic\_json\_data, dynamic\_schema)

Decode JSON encoded data (generally returned by GPUdb) using the embedded dynamic schema for the data. Return the decoded data.

Parameters

dynamic\_json\_data (dict) –

The JSON encoded data with a dynamic schema.

dynamic\_schema (str) –

The schema string for the data

Returns

The decoded data in row-format (a single object or a list)

static convert\_data\_col\_major\_to\_row\_major(col\_major\_data, col\_major\_schema\_str)

Given some column major data, convert it to row major data.

Parameters

col\_major\_data (OrderedDict) –

An OrderedDict of arrays containing the data by column names.

col\_major\_schema\_str (str) –

A JSON schema string describing the column major data.

Returns

A list of GPUdbRecord objects.

static transpose\_data\_to\_col\_major(row\_major\_data)

Given some row major data, convert it to column major data.

Parameters

row\_major\_data (list of Record or collections.OrderedDicts) –

A list of Record or collections.OrderedDicts objects containing the data.

Returns

A dict of lists where the keys are column names and the values are –

lists (containing the values for the pertinent column of all the records)

property record\_type

The type for this record.

property column\_values

The values for this record.

property data

The values for this record.

property binary\_data

The binary encoded values for this record.

property json\_data\_string

The stringified JSON encoded values for this record.

keys()

Return a list of the column names of the record.

values()

Return a list of the values of the record.

insert\_record(gpudb, table\_name, encoding='binary', options=None)

Insert this record into GPUdb.

Parameters

gpudb (GPUdb) –

A GPUdb client handle.

table\_name (str) –

The name of the table into which we need to insert the record.

encoding (str) –

Optional encoding with which to perform the insertion. Default is binary encoding.

options (dict) –

Optional parameter. If given, use the options for the insertion function.

Returns

The response from GPUdb.