GPUdb C++ API  Version 6.2.0.3
gpudb::CreateTriggerByAreaRequest Struct Reference

A set of input parameters for createTriggerByArea(const CreateTriggerByAreaRequest&) const. More...

#include <gpudb/protocol/create_trigger_by_area.h>

Public Member Functions

 CreateTriggerByAreaRequest ()
 Constructs a CreateTriggerByAreaRequest object with default parameter values. More...
 
 CreateTriggerByAreaRequest (const std::string &requestId_, const std::vector< std::string > &tableNames_, const std::string &xColumnName_, const std::vector< double > &xVector_, const std::string &yColumnName_, const std::vector< double > &yVector_, const std::map< std::string, std::string > &options_)
 Constructs a CreateTriggerByAreaRequest object with the specified parameters. More...
 

Public Attributes

std::string requestId
 
std::vector< std::string > tableNames
 
std::string xColumnName
 
std::vector< double > xVector
 
std::string yColumnName
 
std::vector< double > yVector
 
std::map< std::string, std::string > options
 

Detailed Description

A set of input parameters for createTriggerByArea(const CreateTriggerByAreaRequest&) const.

Sets up an area trigger mechanism for two column_names for one or more tables. (This function is essentially the two-dimensional version of createTriggerByRange(const CreateTriggerByRangeRequest&) const.) Once the trigger has been activated, any record added to the listed tables(s) via insertRecordsRaw(const RawInsertRecordsRequest&) const with the chosen columns' values falling within the specified region will trip the trigger. All such records will be queued at the trigger port (by default '9001' but able to be retrieved via showSystemStatus(const ShowSystemStatusRequest&) const) for any listening client to collect. Active triggers can be cancelled by using the clearTrigger(const ClearTriggerRequest&) const endpoint or by clearing all relevant tables.

The output returns the trigger handle as well as indicating success or failure of the trigger activation.

Definition at line 34 of file create_trigger_by_area.h.

Constructor & Destructor Documentation

◆ CreateTriggerByAreaRequest() [1/2]

gpudb::CreateTriggerByAreaRequest::CreateTriggerByAreaRequest ( )
inline

Constructs a CreateTriggerByAreaRequest object with default parameter values.

Definition at line 41 of file create_trigger_by_area.h.

◆ CreateTriggerByAreaRequest() [2/2]

gpudb::CreateTriggerByAreaRequest::CreateTriggerByAreaRequest ( const std::string &  requestId_,
const std::vector< std::string > &  tableNames_,
const std::string &  xColumnName_,
const std::vector< double > &  xVector_,
const std::string &  yColumnName_,
const std::vector< double > &  yVector_,
const std::map< std::string, std::string > &  options_ 
)
inline

Constructs a CreateTriggerByAreaRequest object with the specified parameters.

Parameters
[in]requestId_User-created ID for the trigger. The ID can be alphanumeric, contain symbols, and must contain at least one character.
[in]tableNames_Names of the tables on which the trigger will be activated and maintained.
[in]xColumnName_Name of a numeric column on which the trigger is activated. Usually 'x' for geospatial data points.
[in]xVector_The respective coordinate values for the region on which the trigger is activated. This usually translates to the x-coordinates of a geospatial region.
[in]yColumnName_Name of a second numeric column on which the trigger is activated. Usually 'y' for geospatial data points.
[in]yVector_The respective coordinate values for the region on which the trigger is activated. This usually translates to the y-coordinates of a geospatial region. Must be the same length as xvals.
[in]options_Optional parameters.

Definition at line 78 of file create_trigger_by_area.h.

Member Data Documentation

◆ options

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

Definition at line 95 of file create_trigger_by_area.h.

◆ requestId

std::string gpudb::CreateTriggerByAreaRequest::requestId

Definition at line 89 of file create_trigger_by_area.h.

◆ tableNames

std::vector<std::string> gpudb::CreateTriggerByAreaRequest::tableNames

Definition at line 90 of file create_trigger_by_area.h.

◆ xColumnName

std::string gpudb::CreateTriggerByAreaRequest::xColumnName

Definition at line 91 of file create_trigger_by_area.h.

◆ xVector

std::vector<double> gpudb::CreateTriggerByAreaRequest::xVector

Definition at line 92 of file create_trigger_by_area.h.

◆ yColumnName

std::string gpudb::CreateTriggerByAreaRequest::yColumnName

Definition at line 93 of file create_trigger_by_area.h.

◆ yVector

std::vector<double> gpudb::CreateTriggerByAreaRequest::yVector

Definition at line 94 of file create_trigger_by_area.h.


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