GPUdb C++ API  Version 5.2.0.0
gpudb::GetRecordsFromCollectionRequest Struct Reference

A set of input parameters for getRecordsFromCollectionRaw(const GetRecordsFromCollectionRequest&) const. More...

#include <gpudb/protocol/get_records_from_collection.h>

Public Member Functions

 GetRecordsFromCollectionRequest ()
 Constructs a GetRecordsFromCollectionRequest object with default parameter values. More...
 
 GetRecordsFromCollectionRequest (const std::string &tableName, const int64_t offset, const int64_t limit, const std::map< std::string, std::string > &options)
 Constructs a GetRecordsFromCollectionRequest object with the specified parameters. More...
 
 GetRecordsFromCollectionRequest (const std::string &tableName, const int64_t offset, const int64_t limit, const std::string &encoding, const std::map< std::string, std::string > &options)
 Constructs a GetRecordsFromCollectionRequest object with the specified parameters. More...
 

Public Attributes

std::string tableName
 
int64_t offset
 
int64_t limit
 
std::string encoding
 
std::map< std::string, std::string > options
 

Detailed Description

A set of input parameters for getRecordsFromCollectionRaw(const GetRecordsFromCollectionRequest&) const.

Retrieves records from a collection. The operation can optionally return the record IDs which can be used in certain queries such as deleteRecords(const DeleteRecordsRequest&) const.

This operation supports paging through the data via the offset and limit parameters.

Note that when using the Java API, it is not possible to retrieve records from join tables using this operation.

Definition at line 26 of file get_records_from_collection.h.

Constructor & Destructor Documentation

gpudb::GetRecordsFromCollectionRequest::GetRecordsFromCollectionRequest ( )
inline

Constructs a GetRecordsFromCollectionRequest object with default parameter values.

Definition at line 33 of file get_records_from_collection.h.

gpudb::GetRecordsFromCollectionRequest::GetRecordsFromCollectionRequest ( const std::string &  tableName,
const int64_t  offset,
const int64_t  limit,
const std::map< std::string, std::string > &  options 
)
inline

Constructs a GetRecordsFromCollectionRequest object with the specified parameters.

Parameters
[in]tableNameName of the collection or table from which records are to be retrieved. Must be an existing GPUdb collection or table.
[in]offsetA positive integer indicating the number of initial results to skip (this can be useful for paging through the results). Default value is 0. The minimum allowed value is 0. The maximum allowed value is MAX_INT.
[in]limitA positive integer indicating the maximum number of results to be returned, or END_OF_SET (-9999) to indicate that the max number of results should be returned. Default value is 10000.
[in]options
  • return_record_ids: If 'true' then return GPUdb's internal record id along with each returned record. Default is 'false'. Values: 'true', 'false'.
Default value is an empty std::map.

Definition at line 68 of file get_records_from_collection.h.

gpudb::GetRecordsFromCollectionRequest::GetRecordsFromCollectionRequest ( const std::string &  tableName,
const int64_t  offset,
const int64_t  limit,
const std::string &  encoding,
const std::map< std::string, std::string > &  options 
)
inline

Constructs a GetRecordsFromCollectionRequest object with the specified parameters.

Parameters
[in]tableNameName of the collection or table from which records are to be retrieved. Must be an existing GPUdb collection or table.
[in]offsetA positive integer indicating the number of initial results to skip (this can be useful for paging through the results). Default value is 0. The minimum allowed value is 0. The maximum allowed value is MAX_INT.
[in]limitA positive integer indicating the maximum number of results to be returned, or END_OF_SET (-9999) to indicate that the max number of results should be returned. Default value is 10000.
[in]encodingSpecifies the encoding for returned records; either 'binary' or 'json'. Values: 'binary', 'json'. Default value is 'binary'.
[in]options
  • return_record_ids: If 'true' then return GPUdb's internal record id along with each returned record. Default is 'false'. Values: 'true', 'false'.
Default value is an empty std::map.

Definition at line 107 of file get_records_from_collection.h.

Member Data Documentation

std::string gpudb::GetRecordsFromCollectionRequest::encoding

Definition at line 119 of file get_records_from_collection.h.

int64_t gpudb::GetRecordsFromCollectionRequest::limit

Definition at line 118 of file get_records_from_collection.h.

int64_t gpudb::GetRecordsFromCollectionRequest::offset

Definition at line 117 of file get_records_from_collection.h.

std::map<std::string, std::string> gpudb::GetRecordsFromCollectionRequest::options

Definition at line 120 of file get_records_from_collection.h.

std::string gpudb::GetRecordsFromCollectionRequest::tableName

Definition at line 116 of file get_records_from_collection.h.


The documentation for this struct was generated from the following file: