GPUdb C++ API  Version 7.2.2.4
gpudb::GPUdb Class Reference

#include <gpudb/GPUdb.hpp>

Inherits noncopyable.

Classes

class  Options
 

Public Types

enum  HASynchronicityMode {
  DEFAULT = 0,
  NONE,
  SYNCHRONOUS,
  SYNCHRONOUS_PARALLEL,
  ASYNCHRONOUS,
  ASYNCHRONOUS_PARALLEL
}
 A enumeration of high-availability synchronicity override modes. More...
 

Public Member Functions

 GPUdb (const HttpUrl &url, const Options &options=Options())
 Pass a single HttpURL and options to instantiate a GPUdb object. More...
 
 GPUdb (const std::string &url, const Options &options=Options())
 Pass a single or multiple, comma-separated URLs as a string and optional options to instantiate a GPUdb object. More...
 
 GPUdb (const std::vector< HttpUrl > &urls, const Options &options=Options())
 Pass multiple HttpURLs and optional options to instantiate a GPUdb object. More...
 
 GPUdb (const std::vector< std::string > &urls, const Options &options=Options())
 Pass multiple strings, each containing a single URL, and optional options to instantiate a GPUdb object. More...
 
 ~GPUdb ()
 Destructor. More...
 
const HttpUrlgetUrl () const
 
const std::vector< HttpUrl > & getUrls () const
 
const HttpUrlgetHmUrl () const
 
const std::vector< HttpUrl > & getHmUrls () const
 
boost::asio::ssl::context * getSslContext () const
 
bool getBypassSslCertCheck () const
 
const std::string & getUsername () const
 
const std::string & getPassword () const
 
const std::string & getOauthToken () const
 
const std::string & getPrimaryURL () const
 Return a string containing the URL for the primary cluster; empty string otherwise. More...
 
bool getUseSnappy () const
 
size_t getThreadCount () const
 
avro::ExecutorPtr getExecutor () const
 
const std::map< std::string, std::string > & getHttpHeaders () const
 
HASynchronicityMode getHASyncMode () const
 
size_t getTimeout () const
 
long execute (const std::string &sql)
 This method is used to execute a SQL statement (e.g., DML, DDL). More...
 
long execute (const std::string &sql, const std::string &parameters)
 This method is used to execute a SQL statement (e.g., DML, DDL). More...
 
long execute (const std::string &sql, const std::string &parameters, const std::map< std::string, std::string > &options)
 This method is used to execute a SQL statement (e.g., DML, DDL). More...
 
template<typename T >
long execute (const std::string &sql, const std::vector< T > &parameters)
 
template<typename T >
long execute (const std::string &sql, const std::vector< T > &parameters, const std::map< std::string, std::string > &options)
 
void setHASyncMode (HASynchronicityMode mode)
 Sets the high-availability synchronization mode which will override the default mode. More...
 
void addHttpHeader (const std::string &header, const std::string &value)
 Adds an HTTP header to the map of additional HTTP headers to send to GPUdb with each request. More...
 
void removeHttpHeader (const std::string &header)
 Removes the given HTTP header from the map of additional HTTP headers to send to GPUdb with each request. More...
 
void updateHostManagerPort ()
 Update the host manager port by inquiring the server. More...
 
template<typename TRequest , typename TResponse >
TResponse & submitRequest (const HttpUrl &url, const TRequest &request, TResponse &response, const bool enableCompression=false) const
 
template<typename TRequest , typename TResponse >
TResponse & submitRequest (const std::string &endpoint, const TRequest &request, TResponse &response, const bool enableCompression=false) const
 
template<typename TRequest , typename TResponse >
TResponse & submitRequest (const char *endpoint, const TRequest &request, TResponse &response, const bool enableCompression=false) const
 
template<typename TRequest , typename TResponse >
TResponse & submitRequestToHostManager (const std::string &endpoint, const TRequest &request, TResponse &response, const bool enableCompression=false) const
 Submit an HTTP request to the host manager. More...
 
template<typename TRequest , typename TResponse >
TResponse & submitRequestToHostManager (const char *endpoint, const TRequest &request, TResponse &response, const bool enableCompression=false) const
 Submit an HTTP request to the host manager. More...
 
AdminAddHostResponse adminAddHost (const AdminAddHostRequest &request_) const
 Adds a host to an existing cluster. More...
 
AdminAddHostResponseadminAddHost (const AdminAddHostRequest &request_, AdminAddHostResponse &response_) const
 Adds a host to an existing cluster. More...
 
AdminAddHostResponse adminAddHost (const std::string &hostAddress, const std::map< std::string, std::string > &options) const
 Adds a host to an existing cluster. More...
 
AdminAddHostResponseadminAddHost (const std::string &hostAddress, const std::map< std::string, std::string > &options, AdminAddHostResponse &response_) const
 Adds a host to an existing cluster. More...
 
AdminAddRanksResponse adminAddRanks (const AdminAddRanksRequest &request_) const
 Add one or more ranks to an existing Kinetica cluster. More...
 
AdminAddRanksResponseadminAddRanks (const AdminAddRanksRequest &request_, AdminAddRanksResponse &response_) const
 Add one or more ranks to an existing Kinetica cluster. More...
 
AdminAddRanksResponse adminAddRanks (const std::vector< std::string > &hosts, const std::vector< std::map< std::string, std::string > > &configParams, const std::map< std::string, std::string > &options) const
 Add one or more ranks to an existing Kinetica cluster. More...
 
AdminAddRanksResponseadminAddRanks (const std::vector< std::string > &hosts, const std::vector< std::map< std::string, std::string > > &configParams, const std::map< std::string, std::string > &options, AdminAddRanksResponse &response_) const
 Add one or more ranks to an existing Kinetica cluster. More...
 
AdminAlterHostResponse adminAlterHost (const AdminAlterHostRequest &request_) const
 Alter properties on an existing host in the cluster. More...
 
AdminAlterHostResponseadminAlterHost (const AdminAlterHostRequest &request_, AdminAlterHostResponse &response_) const
 Alter properties on an existing host in the cluster. More...
 
AdminAlterHostResponse adminAlterHost (const std::string &host, const std::map< std::string, std::string > &options) const
 Alter properties on an existing host in the cluster. More...
 
AdminAlterHostResponseadminAlterHost (const std::string &host, const std::map< std::string, std::string > &options, AdminAlterHostResponse &response_) const
 Alter properties on an existing host in the cluster. More...
 
AdminAlterJobsResponse adminAlterJobs (const AdminAlterJobsRequest &request_) const
 Perform the requested action on a list of one or more job(s). More...
 
AdminAlterJobsResponseadminAlterJobs (const AdminAlterJobsRequest &request_, AdminAlterJobsResponse &response_) const
 Perform the requested action on a list of one or more job(s). More...
 
AdminAlterJobsResponse adminAlterJobs (const std::vector< int64_t > &jobIds, const std::string &action, const std::map< std::string, std::string > &options) const
 Perform the requested action on a list of one or more job(s). More...
 
AdminAlterJobsResponseadminAlterJobs (const std::vector< int64_t > &jobIds, const std::string &action, const std::map< std::string, std::string > &options, AdminAlterJobsResponse &response_) const
 Perform the requested action on a list of one or more job(s). More...
 
AdminBackupBeginResponse adminBackupBegin (const AdminBackupBeginRequest &request_) const
 Prepares the system for a backup by closing all open file handles after allowing current active jobs to complete. More...
 
AdminBackupBeginResponseadminBackupBegin (const AdminBackupBeginRequest &request_, AdminBackupBeginResponse &response_) const
 Prepares the system for a backup by closing all open file handles after allowing current active jobs to complete. More...
 
AdminBackupBeginResponse adminBackupBegin (const std::map< std::string, std::string > &options) const
 Prepares the system for a backup by closing all open file handles after allowing current active jobs to complete. More...
 
AdminBackupBeginResponseadminBackupBegin (const std::map< std::string, std::string > &options, AdminBackupBeginResponse &response_) const
 Prepares the system for a backup by closing all open file handles after allowing current active jobs to complete. More...
 
AdminBackupEndResponse adminBackupEnd (const AdminBackupEndRequest &request_) const
 Restores the system to normal operating mode after a backup has completed, allowing any queries that were blocked to complete. More...
 
AdminBackupEndResponseadminBackupEnd (const AdminBackupEndRequest &request_, AdminBackupEndResponse &response_) const
 Restores the system to normal operating mode after a backup has completed, allowing any queries that were blocked to complete. More...
 
AdminBackupEndResponse adminBackupEnd (const std::map< std::string, std::string > &options) const
 Restores the system to normal operating mode after a backup has completed, allowing any queries that were blocked to complete. More...
 
AdminBackupEndResponseadminBackupEnd (const std::map< std::string, std::string > &options, AdminBackupEndResponse &response_) const
 Restores the system to normal operating mode after a backup has completed, allowing any queries that were blocked to complete. More...
 
AdminHaRefreshResponse adminHaRefresh (const AdminHaRefreshRequest &request_) const
 Restarts the HA processing on the given cluster as a mechanism of accepting breaking HA conf changes. More...
 
AdminHaRefreshResponseadminHaRefresh (const AdminHaRefreshRequest &request_, AdminHaRefreshResponse &response_) const
 Restarts the HA processing on the given cluster as a mechanism of accepting breaking HA conf changes. More...
 
AdminHaRefreshResponse adminHaRefresh (const std::map< std::string, std::string > &options) const
 Restarts the HA processing on the given cluster as a mechanism of accepting breaking HA conf changes. More...
 
AdminHaRefreshResponseadminHaRefresh (const std::map< std::string, std::string > &options, AdminHaRefreshResponse &response_) const
 Restarts the HA processing on the given cluster as a mechanism of accepting breaking HA conf changes. More...
 
AdminOfflineResponse adminOffline (const AdminOfflineRequest &request_) const
 Take the system offline. More...
 
AdminOfflineResponseadminOffline (const AdminOfflineRequest &request_, AdminOfflineResponse &response_) const
 Take the system offline. More...
 
AdminOfflineResponse adminOffline (const bool offline, const std::map< std::string, std::string > &options) const
 Take the system offline. More...
 
AdminOfflineResponseadminOffline (const bool offline, const std::map< std::string, std::string > &options, AdminOfflineResponse &response_) const
 Take the system offline. More...
 
AdminRebalanceResponse adminRebalance (const AdminRebalanceRequest &request_) const
 Rebalance the data in the cluster so that all nodes contain an equal number of records approximately and/or rebalance the shards to be equally distributed (as much as possible) across all the ranks. More...
 
AdminRebalanceResponseadminRebalance (const AdminRebalanceRequest &request_, AdminRebalanceResponse &response_) const
 Rebalance the data in the cluster so that all nodes contain an equal number of records approximately and/or rebalance the shards to be equally distributed (as much as possible) across all the ranks. More...
 
AdminRebalanceResponse adminRebalance (const std::map< std::string, std::string > &options) const
 Rebalance the data in the cluster so that all nodes contain an equal number of records approximately and/or rebalance the shards to be equally distributed (as much as possible) across all the ranks. More...
 
AdminRebalanceResponseadminRebalance (const std::map< std::string, std::string > &options, AdminRebalanceResponse &response_) const
 Rebalance the data in the cluster so that all nodes contain an equal number of records approximately and/or rebalance the shards to be equally distributed (as much as possible) across all the ranks. More...
 
AdminRemoveHostResponse adminRemoveHost (const AdminRemoveHostRequest &request_) const
 Removes a host from an existing cluster. More...
 
AdminRemoveHostResponseadminRemoveHost (const AdminRemoveHostRequest &request_, AdminRemoveHostResponse &response_) const
 Removes a host from an existing cluster. More...
 
AdminRemoveHostResponse adminRemoveHost (const std::string &host, const std::map< std::string, std::string > &options) const
 Removes a host from an existing cluster. More...
 
AdminRemoveHostResponseadminRemoveHost (const std::string &host, const std::map< std::string, std::string > &options, AdminRemoveHostResponse &response_) const
 Removes a host from an existing cluster. More...
 
AdminRemoveRanksResponse adminRemoveRanks (const AdminRemoveRanksRequest &request_) const
 Remove one or more ranks from an existing Kinetica cluster. More...
 
AdminRemoveRanksResponseadminRemoveRanks (const AdminRemoveRanksRequest &request_, AdminRemoveRanksResponse &response_) const
 Remove one or more ranks from an existing Kinetica cluster. More...
 
AdminRemoveRanksResponse adminRemoveRanks (const std::vector< std::string > &ranks, const std::map< std::string, std::string > &options) const
 Remove one or more ranks from an existing Kinetica cluster. More...
 
AdminRemoveRanksResponseadminRemoveRanks (const std::vector< std::string > &ranks, const std::map< std::string, std::string > &options, AdminRemoveRanksResponse &response_) const
 Remove one or more ranks from an existing Kinetica cluster. More...
 
AdminRepairTableResponse adminRepairTable (const AdminRepairTableRequest &request_) const
 Manually repair a corrupted table. More...
 
AdminRepairTableResponseadminRepairTable (const AdminRepairTableRequest &request_, AdminRepairTableResponse &response_) const
 Manually repair a corrupted table. More...
 
AdminRepairTableResponse adminRepairTable (const std::vector< std::string > &tableNames, const std::map< std::string, std::string > &options) const
 Manually repair a corrupted table. More...
 
AdminRepairTableResponseadminRepairTable (const std::vector< std::string > &tableNames, const std::map< std::string, std::string > &options, AdminRepairTableResponse &response_) const
 Manually repair a corrupted table. More...
 
AdminShowAlertsResponse adminShowAlerts (const AdminShowAlertsRequest &request_) const
 Requests a list of the most recent alerts. More...
 
AdminShowAlertsResponseadminShowAlerts (const AdminShowAlertsRequest &request_, AdminShowAlertsResponse &response_) const
 Requests a list of the most recent alerts. More...
 
AdminShowAlertsResponse adminShowAlerts (const int32_t numAlerts, const std::map< std::string, std::string > &options) const
 Requests a list of the most recent alerts. More...
 
AdminShowAlertsResponseadminShowAlerts (const int32_t numAlerts, const std::map< std::string, std::string > &options, AdminShowAlertsResponse &response_) const
 Requests a list of the most recent alerts. More...
 
AdminShowClusterOperationsResponse adminShowClusterOperations (const AdminShowClusterOperationsRequest &request_) const
 Requests the detailed status of the current operation (by default) or a prior cluster operation specified by historyIndex. More...
 
AdminShowClusterOperationsResponseadminShowClusterOperations (const AdminShowClusterOperationsRequest &request_, AdminShowClusterOperationsResponse &response_) const
 Requests the detailed status of the current operation (by default) or a prior cluster operation specified by historyIndex. More...
 
AdminShowClusterOperationsResponse adminShowClusterOperations (const int32_t historyIndex, const std::map< std::string, std::string > &options) const
 Requests the detailed status of the current operation (by default) or a prior cluster operation specified by historyIndex. More...
 
AdminShowClusterOperationsResponseadminShowClusterOperations (const int32_t historyIndex, const std::map< std::string, std::string > &options, AdminShowClusterOperationsResponse &response_) const
 Requests the detailed status of the current operation (by default) or a prior cluster operation specified by historyIndex. More...
 
AdminShowJobsResponse adminShowJobs (const AdminShowJobsRequest &request_) const
 Get a list of the current jobs in GPUdb. More...
 
AdminShowJobsResponseadminShowJobs (const AdminShowJobsRequest &request_, AdminShowJobsResponse &response_) const
 Get a list of the current jobs in GPUdb. More...
 
AdminShowJobsResponse adminShowJobs (const std::map< std::string, std::string > &options) const
 Get a list of the current jobs in GPUdb. More...
 
AdminShowJobsResponseadminShowJobs (const std::map< std::string, std::string > &options, AdminShowJobsResponse &response_) const
 Get a list of the current jobs in GPUdb. More...
 
AdminShowShardsResponse adminShowShards (const AdminShowShardsRequest &request_) const
 Show the mapping of shards to the corresponding rank and tom. More...
 
AdminShowShardsResponseadminShowShards (const AdminShowShardsRequest &request_, AdminShowShardsResponse &response_) const
 Show the mapping of shards to the corresponding rank and tom. More...
 
AdminShowShardsResponse adminShowShards (const std::map< std::string, std::string > &options) const
 Show the mapping of shards to the corresponding rank and tom. More...
 
AdminShowShardsResponseadminShowShards (const std::map< std::string, std::string > &options, AdminShowShardsResponse &response_) const
 Show the mapping of shards to the corresponding rank and tom. More...
 
AdminShutdownResponse adminShutdown (const AdminShutdownRequest &request_) const
 Exits the database server application. More...
 
AdminShutdownResponseadminShutdown (const AdminShutdownRequest &request_, AdminShutdownResponse &response_) const
 Exits the database server application. More...
 
AdminShutdownResponse adminShutdown (const std::string &exitType, const std::string &authorization, const std::map< std::string, std::string > &options) const
 Exits the database server application. More...
 
AdminShutdownResponseadminShutdown (const std::string &exitType, const std::string &authorization, const std::map< std::string, std::string > &options, AdminShutdownResponse &response_) const
 Exits the database server application. More...
 
AdminSwitchoverResponse adminSwitchover (const AdminSwitchoverRequest &request_) const
 Manually switch over one or more processes to another host. More...
 
AdminSwitchoverResponseadminSwitchover (const AdminSwitchoverRequest &request_, AdminSwitchoverResponse &response_) const
 Manually switch over one or more processes to another host. More...
 
AdminSwitchoverResponse adminSwitchover (const std::vector< std::string > &processes, const std::vector< std::string > &destinations, const std::map< std::string, std::string > &options) const
 Manually switch over one or more processes to another host. More...
 
AdminSwitchoverResponseadminSwitchover (const std::vector< std::string > &processes, const std::vector< std::string > &destinations, const std::map< std::string, std::string > &options, AdminSwitchoverResponse &response_) const
 Manually switch over one or more processes to another host. More...
 
AdminVerifyDbResponse adminVerifyDb (const AdminVerifyDbRequest &request_) const
 Verify database is in a consistent state. More...
 
AdminVerifyDbResponseadminVerifyDb (const AdminVerifyDbRequest &request_, AdminVerifyDbResponse &response_) const
 Verify database is in a consistent state. More...
 
AdminVerifyDbResponse adminVerifyDb (const std::map< std::string, std::string > &options) const
 Verify database is in a consistent state. More...
 
AdminVerifyDbResponseadminVerifyDb (const std::map< std::string, std::string > &options, AdminVerifyDbResponse &response_) const
 Verify database is in a consistent state. More...
 
AggregateConvexHullResponse aggregateConvexHull (const AggregateConvexHullRequest &request_) const
 Calculates and returns the convex hull for the values in a table specified by tableName. More...
 
AggregateConvexHullResponseaggregateConvexHull (const AggregateConvexHullRequest &request_, AggregateConvexHullResponse &response_) const
 Calculates and returns the convex hull for the values in a table specified by tableName. More...
 
AggregateConvexHullResponse aggregateConvexHull (const std::string &tableName, const std::string &xColumnName, const std::string &yColumnName, const std::map< std::string, std::string > &options) const
 Calculates and returns the convex hull for the values in a table specified by tableName. More...
 
AggregateConvexHullResponseaggregateConvexHull (const std::string &tableName, const std::string &xColumnName, const std::string &yColumnName, const std::map< std::string, std::string > &options, AggregateConvexHullResponse &response_) const
 Calculates and returns the convex hull for the values in a table specified by tableName. More...
 
RawAggregateGroupByResponse aggregateGroupByRaw (const AggregateGroupByRequest &request_) const
 Calculates unique combinations (groups) of values for the given columns in a given table or view and computes aggregates on each unique combination. More...
 
RawAggregateGroupByResponseaggregateGroupByRaw (const AggregateGroupByRequest &request_, RawAggregateGroupByResponse &response_) const
 Calculates unique combinations (groups) of values for the given columns in a given table or view and computes aggregates on each unique combination. More...
 
AggregateGroupByResponse aggregateGroupBy (const AggregateGroupByRequest &request_) const
 Calculates unique combinations (groups) of values for the given columns in a given table or view and computes aggregates on each unique combination. More...
 
AggregateGroupByResponseaggregateGroupBy (const AggregateGroupByRequest &request_, AggregateGroupByResponse &response_) const
 Calculates unique combinations (groups) of values for the given columns in a given table or view and computes aggregates on each unique combination. More...
 
AggregateGroupByResponse aggregateGroupBy (const std::string &tableName, const std::vector< std::string > &columnNames, const int64_t offset, const int64_t limit, const std::map< std::string, std::string > &options) const
 Calculates unique combinations (groups) of values for the given columns in a given table or view and computes aggregates on each unique combination. More...
 
AggregateGroupByResponseaggregateGroupBy (const std::string &tableName, const std::vector< std::string > &columnNames, const int64_t offset, const int64_t limit, const std::map< std::string, std::string > &options, AggregateGroupByResponse &response_) const
 Calculates unique combinations (groups) of values for the given columns in a given table or view and computes aggregates on each unique combination. More...
 
AggregateHistogramResponse aggregateHistogram (const AggregateHistogramRequest &request_) const
 Performs a histogram calculation given a table, a column, and an interval function. More...
 
AggregateHistogramResponseaggregateHistogram (const AggregateHistogramRequest &request_, AggregateHistogramResponse &response_) const
 Performs a histogram calculation given a table, a column, and an interval function. More...
 
AggregateHistogramResponse aggregateHistogram (const std::string &tableName, const std::string &columnName, const double start, const double end, const double interval, const std::map< std::string, std::string > &options) const
 Performs a histogram calculation given a table, a column, and an interval function. More...
 
AggregateHistogramResponseaggregateHistogram (const std::string &tableName, const std::string &columnName, const double start, const double end, const double interval, const std::map< std::string, std::string > &options, AggregateHistogramResponse &response_) const
 Performs a histogram calculation given a table, a column, and an interval function. More...
 
AggregateKMeansResponse aggregateKMeans (const AggregateKMeansRequest &request_) const
 This endpoint runs the k-means algorithm - a heuristic algorithm that attempts to do k-means clustering. More...
 
AggregateKMeansResponseaggregateKMeans (const AggregateKMeansRequest &request_, AggregateKMeansResponse &response_) const
 This endpoint runs the k-means algorithm - a heuristic algorithm that attempts to do k-means clustering. More...
 
AggregateKMeansResponse aggregateKMeans (const std::string &tableName, const std::vector< std::string > &columnNames, const int32_t k, const double tolerance, const std::map< std::string, std::string > &options) const
 This endpoint runs the k-means algorithm - a heuristic algorithm that attempts to do k-means clustering. More...
 
AggregateKMeansResponseaggregateKMeans (const std::string &tableName, const std::vector< std::string > &columnNames, const int32_t k, const double tolerance, const std::map< std::string, std::string > &options, AggregateKMeansResponse &response_) const
 This endpoint runs the k-means algorithm - a heuristic algorithm that attempts to do k-means clustering. More...
 
AggregateMinMaxResponse aggregateMinMax (const AggregateMinMaxRequest &request_) const
 Calculates and returns the minimum and maximum values of a particular column in a table. More...
 
AggregateMinMaxResponseaggregateMinMax (const AggregateMinMaxRequest &request_, AggregateMinMaxResponse &response_) const
 Calculates and returns the minimum and maximum values of a particular column in a table. More...
 
AggregateMinMaxResponse aggregateMinMax (const std::string &tableName, const std::string &columnName, const std::map< std::string, std::string > &options) const
 Calculates and returns the minimum and maximum values of a particular column in a table. More...
 
AggregateMinMaxResponseaggregateMinMax (const std::string &tableName, const std::string &columnName, const std::map< std::string, std::string > &options, AggregateMinMaxResponse &response_) const
 Calculates and returns the minimum and maximum values of a particular column in a table. More...
 
AggregateMinMaxGeometryResponse aggregateMinMaxGeometry (const AggregateMinMaxGeometryRequest &request_) const
 Calculates and returns the minimum and maximum x- and y-coordinates of a particular geospatial geometry column in a table. More...
 
AggregateMinMaxGeometryResponseaggregateMinMaxGeometry (const AggregateMinMaxGeometryRequest &request_, AggregateMinMaxGeometryResponse &response_) const
 Calculates and returns the minimum and maximum x- and y-coordinates of a particular geospatial geometry column in a table. More...
 
AggregateMinMaxGeometryResponse aggregateMinMaxGeometry (const std::string &tableName, const std::string &columnName, const std::map< std::string, std::string > &options) const
 Calculates and returns the minimum and maximum x- and y-coordinates of a particular geospatial geometry column in a table. More...
 
AggregateMinMaxGeometryResponseaggregateMinMaxGeometry (const std::string &tableName, const std::string &columnName, const std::map< std::string, std::string > &options, AggregateMinMaxGeometryResponse &response_) const
 Calculates and returns the minimum and maximum x- and y-coordinates of a particular geospatial geometry column in a table. More...
 
AggregateStatisticsResponse aggregateStatistics (const AggregateStatisticsRequest &request_) const
 Calculates the requested statistics of the given column(s) in a given table. More...
 
AggregateStatisticsResponseaggregateStatistics (const AggregateStatisticsRequest &request_, AggregateStatisticsResponse &response_) const
 Calculates the requested statistics of the given column(s) in a given table. More...
 
AggregateStatisticsResponse aggregateStatistics (const std::string &tableName, const std::string &columnName, const std::string &stats, const std::map< std::string, std::string > &options) const
 Calculates the requested statistics of the given column(s) in a given table. More...
 
AggregateStatisticsResponseaggregateStatistics (const std::string &tableName, const std::string &columnName, const std::string &stats, const std::map< std::string, std::string > &options, AggregateStatisticsResponse &response_) const
 Calculates the requested statistics of the given column(s) in a given table. More...
 
AggregateStatisticsByRangeResponse aggregateStatisticsByRange (const AggregateStatisticsByRangeRequest &request_) const
 Divides the given set into bins and calculates statistics of the values of a value-column in each bin. More...
 
AggregateStatisticsByRangeResponseaggregateStatisticsByRange (const AggregateStatisticsByRangeRequest &request_, AggregateStatisticsByRangeResponse &response_) const
 Divides the given set into bins and calculates statistics of the values of a value-column in each bin. More...
 
AggregateStatisticsByRangeResponse aggregateStatisticsByRange (const std::string &tableName, const std::string &selectExpression, const std::string &columnName, const std::string &valueColumnName, const std::string &stats, const double start, const double end, const double interval, const std::map< std::string, std::string > &options) const
 Divides the given set into bins and calculates statistics of the values of a value-column in each bin. More...
 
AggregateStatisticsByRangeResponseaggregateStatisticsByRange (const std::string &tableName, const std::string &selectExpression, const std::string &columnName, const std::string &valueColumnName, const std::string &stats, const double start, const double end, const double interval, const std::map< std::string, std::string > &options, AggregateStatisticsByRangeResponse &response_) const
 Divides the given set into bins and calculates statistics of the values of a value-column in each bin. More...
 
RawAggregateUniqueResponse aggregateUniqueRaw (const AggregateUniqueRequest &request_) const
 Returns all the unique values from a particular column (specified by columnName) of a particular table or view (specified by tableName). More...
 
RawAggregateUniqueResponseaggregateUniqueRaw (const AggregateUniqueRequest &request_, RawAggregateUniqueResponse &response_) const
 Returns all the unique values from a particular column (specified by columnName) of a particular table or view (specified by tableName). More...
 
AggregateUniqueResponse aggregateUnique (const AggregateUniqueRequest &request_) const
 Returns all the unique values from a particular column (specified by columnName) of a particular table or view (specified by tableName). More...
 
AggregateUniqueResponseaggregateUnique (const AggregateUniqueRequest &request_, AggregateUniqueResponse &response_) const
 Returns all the unique values from a particular column (specified by columnName) of a particular table or view (specified by tableName). More...
 
AggregateUniqueResponse aggregateUnique (const std::string &tableName, const std::string &columnName, const int64_t offset, const int64_t limit, const std::map< std::string, std::string > &options) const
 Returns all the unique values from a particular column (specified by columnName) of a particular table or view (specified by tableName). More...
 
AggregateUniqueResponseaggregateUnique (const std::string &tableName, const std::string &columnName, const int64_t offset, const int64_t limit, const std::map< std::string, std::string > &options, AggregateUniqueResponse &response_) const
 Returns all the unique values from a particular column (specified by columnName) of a particular table or view (specified by tableName). More...
 
RawAggregateUnpivotResponse aggregateUnpivotRaw (const AggregateUnpivotRequest &request_) const
 Rotate the column values into rows values. More...
 
RawAggregateUnpivotResponseaggregateUnpivotRaw (const AggregateUnpivotRequest &request_, RawAggregateUnpivotResponse &response_) const
 Rotate the column values into rows values. More...
 
AggregateUnpivotResponse aggregateUnpivot (const AggregateUnpivotRequest &request_) const
 Rotate the column values into rows values. More...
 
AggregateUnpivotResponseaggregateUnpivot (const AggregateUnpivotRequest &request_, AggregateUnpivotResponse &response_) const
 Rotate the column values into rows values. More...
 
AggregateUnpivotResponse aggregateUnpivot (const std::string &tableName, const std::vector< std::string > &columnNames, const std::string &variableColumnName, const std::string &valueColumnName, const std::vector< std::string > &pivotedColumns, const std::map< std::string, std::string > &options) const
 Rotate the column values into rows values. More...
 
AggregateUnpivotResponseaggregateUnpivot (const std::string &tableName, const std::vector< std::string > &columnNames, const std::string &variableColumnName, const std::string &valueColumnName, const std::vector< std::string > &pivotedColumns, const std::map< std::string, std::string > &options, AggregateUnpivotResponse &response_) const
 Rotate the column values into rows values. More...
 
AlterCredentialResponse alterCredential (const AlterCredentialRequest &request_) const
 Alter the properties of an existing credential. More...
 
AlterCredentialResponsealterCredential (const AlterCredentialRequest &request_, AlterCredentialResponse &response_) const
 Alter the properties of an existing credential. More...
 
AlterCredentialResponse alterCredential (const std::string &credentialName, const std::map< std::string, std::string > &credentialUpdatesMap, const std::map< std::string, std::string > &options) const
 Alter the properties of an existing credential. More...
 
AlterCredentialResponsealterCredential (const std::string &credentialName, const std::map< std::string, std::string > &credentialUpdatesMap, const std::map< std::string, std::string > &options, AlterCredentialResponse &response_) const
 Alter the properties of an existing credential. More...
 
AlterDatasinkResponse alterDatasink (const AlterDatasinkRequest &request_) const
 Alters the properties of an existing data sink More...
 
AlterDatasinkResponsealterDatasink (const AlterDatasinkRequest &request_, AlterDatasinkResponse &response_) const
 Alters the properties of an existing data sink More...
 
AlterDatasinkResponse alterDatasink (const std::string &name, const std::map< std::string, std::string > &datasinkUpdatesMap, const std::map< std::string, std::string > &options) const
 Alters the properties of an existing data sink More...
 
AlterDatasinkResponsealterDatasink (const std::string &name, const std::map< std::string, std::string > &datasinkUpdatesMap, const std::map< std::string, std::string > &options, AlterDatasinkResponse &response_) const
 Alters the properties of an existing data sink More...
 
AlterDatasourceResponse alterDatasource (const AlterDatasourceRequest &request_) const
 Alters the properties of an existing data source More...
 
AlterDatasourceResponsealterDatasource (const AlterDatasourceRequest &request_, AlterDatasourceResponse &response_) const
 Alters the properties of an existing data source More...
 
AlterDatasourceResponse alterDatasource (const std::string &name, const std::map< std::string, std::string > &datasourceUpdatesMap, const std::map< std::string, std::string > &options) const
 Alters the properties of an existing data source More...
 
AlterDatasourceResponsealterDatasource (const std::string &name, const std::map< std::string, std::string > &datasourceUpdatesMap, const std::map< std::string, std::string > &options, AlterDatasourceResponse &response_) const
 Alters the properties of an existing data source More...
 
AlterDirectoryResponse alterDirectory (const AlterDirectoryRequest &request_) const
 Alters an existing directory in KiFS. More...
 
AlterDirectoryResponsealterDirectory (const AlterDirectoryRequest &request_, AlterDirectoryResponse &response_) const
 Alters an existing directory in KiFS. More...
 
AlterDirectoryResponse alterDirectory (const std::string &directoryName, const std::map< std::string, std::string > &directoryUpdatesMap, const std::map< std::string, std::string > &options) const
 Alters an existing directory in KiFS. More...
 
AlterDirectoryResponsealterDirectory (const std::string &directoryName, const std::map< std::string, std::string > &directoryUpdatesMap, const std::map< std::string, std::string > &options, AlterDirectoryResponse &response_) const
 Alters an existing directory in KiFS. More...
 
AlterEnvironmentResponse alterEnvironment (const AlterEnvironmentRequest &request_) const
 Alters an existing environment which can be referenced by a user-defined function (UDF). More...
 
AlterEnvironmentResponsealterEnvironment (const AlterEnvironmentRequest &request_, AlterEnvironmentResponse &response_) const
 Alters an existing environment which can be referenced by a user-defined function (UDF). More...
 
AlterEnvironmentResponse alterEnvironment (const std::string &environmentName, const std::string &action, const std::string &value, const std::map< std::string, std::string > &options) const
 Alters an existing environment which can be referenced by a user-defined function (UDF). More...
 
AlterEnvironmentResponsealterEnvironment (const std::string &environmentName, const std::string &action, const std::string &value, const std::map< std::string, std::string > &options, AlterEnvironmentResponse &response_) const
 Alters an existing environment which can be referenced by a user-defined function (UDF). More...
 
AlterResourceGroupResponse alterResourceGroup (const AlterResourceGroupRequest &request_) const
 Alters the properties of an exisiting resource group to facilitate resource management. More...
 
AlterResourceGroupResponsealterResourceGroup (const AlterResourceGroupRequest &request_, AlterResourceGroupResponse &response_) const
 Alters the properties of an exisiting resource group to facilitate resource management. More...
 
AlterResourceGroupResponse alterResourceGroup (const std::string &name, const std::map< std::string, std::map< std::string, std::string > > &tierAttributes, const std::string &ranking, const std::string &adjoiningResourceGroup, const std::map< std::string, std::string > &options) const
 Alters the properties of an exisiting resource group to facilitate resource management. More...
 
AlterResourceGroupResponsealterResourceGroup (const std::string &name, const std::map< std::string, std::map< std::string, std::string > > &tierAttributes, const std::string &ranking, const std::string &adjoiningResourceGroup, const std::map< std::string, std::string > &options, AlterResourceGroupResponse &response_) const
 Alters the properties of an exisiting resource group to facilitate resource management. More...
 
AlterRoleResponse alterRole (const AlterRoleRequest &request_) const
 Alters a Role. More...
 
AlterRoleResponsealterRole (const AlterRoleRequest &request_, AlterRoleResponse &response_) const
 Alters a Role. More...
 
AlterRoleResponse alterRole (const std::string &name, const std::string &action, const std::string &value, const std::map< std::string, std::string > &options) const
 Alters a Role. More...
 
AlterRoleResponsealterRole (const std::string &name, const std::string &action, const std::string &value, const std::map< std::string, std::string > &options, AlterRoleResponse &response_) const
 Alters a Role. More...
 
AlterSchemaResponse alterSchema (const AlterSchemaRequest &request_) const
 Used to change the name of a SQL-style schema, specified in schemaName. More...
 
AlterSchemaResponsealterSchema (const AlterSchemaRequest &request_, AlterSchemaResponse &response_) const
 Used to change the name of a SQL-style schema, specified in schemaName. More...
 
AlterSchemaResponse alterSchema (const std::string &schemaName, const std::string &action, const std::string &value, const std::map< std::string, std::string > &options) const
 Used to change the name of a SQL-style schema, specified in schemaName. More...
 
AlterSchemaResponsealterSchema (const std::string &schemaName, const std::string &action, const std::string &value, const std::map< std::string, std::string > &options, AlterSchemaResponse &response_) const
 Used to change the name of a SQL-style schema, specified in schemaName. More...
 
AlterSystemPropertiesResponse alterSystemProperties (const AlterSystemPropertiesRequest &request_) const
 The alterSystemProperties endpoint is primarily used to simplify the testing of the system and is not expected to be used during normal execution. More...
 
AlterSystemPropertiesResponsealterSystemProperties (const AlterSystemPropertiesRequest &request_, AlterSystemPropertiesResponse &response_) const
 The alterSystemProperties endpoint is primarily used to simplify the testing of the system and is not expected to be used during normal execution. More...
 
AlterSystemPropertiesResponse alterSystemProperties (const std::map< std::string, std::string > &propertyUpdatesMap, const std::map< std::string, std::string > &options) const
 The alterSystemProperties endpoint is primarily used to simplify the testing of the system and is not expected to be used during normal execution. More...
 
AlterSystemPropertiesResponsealterSystemProperties (const std::map< std::string, std::string > &propertyUpdatesMap, const std::map< std::string, std::string > &options, AlterSystemPropertiesResponse &response_) const
 The alterSystemProperties endpoint is primarily used to simplify the testing of the system and is not expected to be used during normal execution. More...
 
AlterTableResponse alterTable (const AlterTableRequest &request_) const
 Apply various modifications to a table or view. More...
 
AlterTableResponsealterTable (const AlterTableRequest &request_, AlterTableResponse &response_) const
 Apply various modifications to a table or view. More...
 
AlterTableResponse alterTable (const std::string &tableName, const std::string &action, const std::string &value, const std::map< std::string, std::string > &options) const
 Apply various modifications to a table or view. More...
 
AlterTableResponsealterTable (const std::string &tableName, const std::string &action, const std::string &value, const std::map< std::string, std::string > &options, AlterTableResponse &response_) const
 Apply various modifications to a table or view. More...
 
AlterTableColumnsResponse alterTableColumns (const AlterTableColumnsRequest &request_) const
 Apply various modifications to columns in a table, view. More...
 
AlterTableColumnsResponsealterTableColumns (const AlterTableColumnsRequest &request_, AlterTableColumnsResponse &response_) const
 Apply various modifications to columns in a table, view. More...
 
AlterTableColumnsResponse alterTableColumns (const std::string &tableName, const std::vector< std::map< std::string, std::string > > &columnAlterations, const std::map< std::string, std::string > &options) const
 Apply various modifications to columns in a table, view. More...
 
AlterTableColumnsResponsealterTableColumns (const std::string &tableName, const std::vector< std::map< std::string, std::string > > &columnAlterations, const std::map< std::string, std::string > &options, AlterTableColumnsResponse &response_) const
 Apply various modifications to columns in a table, view. More...
 
AlterTableMetadataResponse alterTableMetadata (const AlterTableMetadataRequest &request_) const
 Updates (adds or changes) metadata for tables. More...
 
AlterTableMetadataResponsealterTableMetadata (const AlterTableMetadataRequest &request_, AlterTableMetadataResponse &response_) const
 Updates (adds or changes) metadata for tables. More...
 
AlterTableMetadataResponse alterTableMetadata (const std::vector< std::string > &tableNames, const std::map< std::string, std::string > &metadataMap, const std::map< std::string, std::string > &options) const
 Updates (adds or changes) metadata for tables. More...
 
AlterTableMetadataResponsealterTableMetadata (const std::vector< std::string > &tableNames, const std::map< std::string, std::string > &metadataMap, const std::map< std::string, std::string > &options, AlterTableMetadataResponse &response_) const
 Updates (adds or changes) metadata for tables. More...
 
AlterTableMonitorResponse alterTableMonitor (const AlterTableMonitorRequest &request_) const
 Alters a table monitor previously created with createTableMonitor. More...
 
AlterTableMonitorResponsealterTableMonitor (const AlterTableMonitorRequest &request_, AlterTableMonitorResponse &response_) const
 Alters a table monitor previously created with createTableMonitor. More...
 
AlterTableMonitorResponse alterTableMonitor (const std::string &topicId, const std::map< std::string, std::string > &monitorUpdatesMap, const std::map< std::string, std::string > &options) const
 Alters a table monitor previously created with createTableMonitor. More...
 
AlterTableMonitorResponsealterTableMonitor (const std::string &topicId, const std::map< std::string, std::string > &monitorUpdatesMap, const std::map< std::string, std::string > &options, AlterTableMonitorResponse &response_) const
 Alters a table monitor previously created with createTableMonitor. More...
 
AlterTierResponse alterTier (const AlterTierRequest &request_) const
 Alters properties of an exisiting tier to facilitate resource management. More...
 
AlterTierResponsealterTier (const AlterTierRequest &request_, AlterTierResponse &response_) const
 Alters properties of an exisiting tier to facilitate resource management. More...
 
AlterTierResponse alterTier (const std::string &name, const std::map< std::string, std::string > &options) const
 Alters properties of an exisiting tier to facilitate resource management. More...
 
AlterTierResponsealterTier (const std::string &name, const std::map< std::string, std::string > &options, AlterTierResponse &response_) const
 Alters properties of an exisiting tier to facilitate resource management. More...
 
AlterUserResponse alterUser (const AlterUserRequest &request_) const
 Alters a user. More...
 
AlterUserResponsealterUser (const AlterUserRequest &request_, AlterUserResponse &response_) const
 Alters a user. More...
 
AlterUserResponse alterUser (const std::string &name, const std::string &action, const std::string &value, const std::map< std::string, std::string > &options) const
 Alters a user. More...
 
AlterUserResponsealterUser (const std::string &name, const std::string &action, const std::string &value, const std::map< std::string, std::string > &options, AlterUserResponse &response_) const
 Alters a user. More...
 
AlterVideoResponse alterVideo (const AlterVideoRequest &request_) const
 Alters a video. More...
 
AlterVideoResponsealterVideo (const AlterVideoRequest &request_, AlterVideoResponse &response_) const
 Alters a video. More...
 
AlterVideoResponse alterVideo (const std::string &path, const std::map< std::string, std::string > &options) const
 Alters a video. More...
 
AlterVideoResponsealterVideo (const std::string &path, const std::map< std::string, std::string > &options, AlterVideoResponse &response_) const
 Alters a video. More...
 
AlterWalResponse alterWal (const AlterWalRequest &request_) const
 Alters table wal settings. More...
 
AlterWalResponsealterWal (const AlterWalRequest &request_, AlterWalResponse &response_) const
 Alters table wal settings. More...
 
AlterWalResponse alterWal (const std::vector< std::string > &tableNames, const std::map< std::string, std::string > &options) const
 Alters table wal settings. More...
 
AlterWalResponsealterWal (const std::vector< std::string > &tableNames, const std::map< std::string, std::string > &options, AlterWalResponse &response_) const
 Alters table wal settings. More...
 
AppendRecordsResponse appendRecords (const AppendRecordsRequest &request_) const
 Append (or insert) all records from a source table (specified by sourceTableName) to a particular target table (specified by tableName). More...
 
AppendRecordsResponseappendRecords (const AppendRecordsRequest &request_, AppendRecordsResponse &response_) const
 Append (or insert) all records from a source table (specified by sourceTableName) to a particular target table (specified by tableName). More...
 
AppendRecordsResponse appendRecords (const std::string &tableName, const std::string &sourceTableName, const std::map< std::string, std::string > &fieldMap, const std::map< std::string, std::string > &options) const
 Append (or insert) all records from a source table (specified by sourceTableName) to a particular target table (specified by tableName). More...
 
AppendRecordsResponseappendRecords (const std::string &tableName, const std::string &sourceTableName, const std::map< std::string, std::string > &fieldMap, const std::map< std::string, std::string > &options, AppendRecordsResponse &response_) const
 Append (or insert) all records from a source table (specified by sourceTableName) to a particular target table (specified by tableName). More...
 
ClearStatisticsResponse clearStatistics (const ClearStatisticsRequest &request_) const
 Clears statistics (cardinality, mean value, etc.) for a column in a specified table. More...
 
ClearStatisticsResponseclearStatistics (const ClearStatisticsRequest &request_, ClearStatisticsResponse &response_) const
 Clears statistics (cardinality, mean value, etc.) for a column in a specified table. More...
 
ClearStatisticsResponse clearStatistics (const std::string &tableName, const std::string &columnName, const std::map< std::string, std::string > &options) const
 Clears statistics (cardinality, mean value, etc.) for a column in a specified table. More...
 
ClearStatisticsResponseclearStatistics (const std::string &tableName, const std::string &columnName, const std::map< std::string, std::string > &options, ClearStatisticsResponse &response_) const
 Clears statistics (cardinality, mean value, etc.) for a column in a specified table. More...
 
ClearTableResponse clearTable (const ClearTableRequest &request_) const
 Clears (drops) one or all tables in the database cluster. More...
 
ClearTableResponseclearTable (const ClearTableRequest &request_, ClearTableResponse &response_) const
 Clears (drops) one or all tables in the database cluster. More...
 
ClearTableResponse clearTable (const std::string &tableName, const std::string &authorization, const std::map< std::string, std::string > &options) const
 Clears (drops) one or all tables in the database cluster. More...
 
ClearTableResponseclearTable (const std::string &tableName, const std::string &authorization, const std::map< std::string, std::string > &options, ClearTableResponse &response_) const
 Clears (drops) one or all tables in the database cluster. More...
 
ClearTableMonitorResponse clearTableMonitor (const ClearTableMonitorRequest &request_) const
 Deactivates a table monitor previously created with createTableMonitor. More...
 
ClearTableMonitorResponseclearTableMonitor (const ClearTableMonitorRequest &request_, ClearTableMonitorResponse &response_) const
 Deactivates a table monitor previously created with createTableMonitor. More...
 
ClearTableMonitorResponse clearTableMonitor (const std::string &topicId, const std::map< std::string, std::string > &options) const
 Deactivates a table monitor previously created with createTableMonitor. More...
 
ClearTableMonitorResponseclearTableMonitor (const std::string &topicId, const std::map< std::string, std::string > &options, ClearTableMonitorResponse &response_) const
 Deactivates a table monitor previously created with createTableMonitor. More...
 
ClearTriggerResponse clearTrigger (const ClearTriggerRequest &request_) const
 Clears or cancels the trigger identified by the specified handle. More...
 
ClearTriggerResponseclearTrigger (const ClearTriggerRequest &request_, ClearTriggerResponse &response_) const
 Clears or cancels the trigger identified by the specified handle. More...
 
ClearTriggerResponse clearTrigger (const std::string &triggerId, const std::map< std::string, std::string > &options) const
 Clears or cancels the trigger identified by the specified handle. More...
 
ClearTriggerResponseclearTrigger (const std::string &triggerId, const std::map< std::string, std::string > &options, ClearTriggerResponse &response_) const
 Clears or cancels the trigger identified by the specified handle. More...
 
CollectStatisticsResponse collectStatistics (const CollectStatisticsRequest &request_) const
 Collect statistics for a column(s) in a specified table. More...
 
CollectStatisticsResponsecollectStatistics (const CollectStatisticsRequest &request_, CollectStatisticsResponse &response_) const
 Collect statistics for a column(s) in a specified table. More...
 
CollectStatisticsResponse collectStatistics (const std::string &tableName, const std::vector< std::string > &columnNames, const std::map< std::string, std::string > &options) const
 Collect statistics for a column(s) in a specified table. More...
 
CollectStatisticsResponsecollectStatistics (const std::string &tableName, const std::vector< std::string > &columnNames, const std::map< std::string, std::string > &options, CollectStatisticsResponse &response_) const
 Collect statistics for a column(s) in a specified table. More...
 
CreateCredentialResponse createCredential (const CreateCredentialRequest &request_) const
 Create a new credential. More...
 
CreateCredentialResponsecreateCredential (const CreateCredentialRequest &request_, CreateCredentialResponse &response_) const
 Create a new credential. More...
 
CreateCredentialResponse createCredential (const std::string &credentialName, const std::string &type, const std::string &identity, const std::string &secret, const std::map< std::string, std::string > &options) const
 Create a new credential. More...
 
CreateCredentialResponsecreateCredential (const std::string &credentialName, const std::string &type, const std::string &identity, const std::string &secret, const std::map< std::string, std::string > &options, CreateCredentialResponse &response_) const
 Create a new credential. More...
 
CreateDatasinkResponse createDatasink (const CreateDatasinkRequest &request_) const
 Creates a data sink, which contains the destination information for a data sink that is external to the database. More...
 
CreateDatasinkResponsecreateDatasink (const CreateDatasinkRequest &request_, CreateDatasinkResponse &response_) const
 Creates a data sink, which contains the destination information for a data sink that is external to the database. More...
 
CreateDatasinkResponse createDatasink (const std::string &name, const std::string &destination, const std::map< std::string, std::string > &options) const
 Creates a data sink, which contains the destination information for a data sink that is external to the database. More...
 
CreateDatasinkResponsecreateDatasink (const std::string &name, const std::string &destination, const std::map< std::string, std::string > &options, CreateDatasinkResponse &response_) const
 Creates a data sink, which contains the destination information for a data sink that is external to the database. More...
 
CreateDatasourceResponse createDatasource (const CreateDatasourceRequest &request_) const
 Creates a data source, which contains the location and connection information for a data store that is external to the database. More...
 
CreateDatasourceResponsecreateDatasource (const CreateDatasourceRequest &request_, CreateDatasourceResponse &response_) const
 Creates a data source, which contains the location and connection information for a data store that is external to the database. More...
 
CreateDatasourceResponse createDatasource (const std::string &name, const std::string &location, const std::string &userName, const std::string &password, const std::map< std::string, std::string > &options) const
 Creates a data source, which contains the location and connection information for a data store that is external to the database. More...
 
CreateDatasourceResponsecreateDatasource (const std::string &name, const std::string &location, const std::string &userName, const std::string &password, const std::map< std::string, std::string > &options, CreateDatasourceResponse &response_) const
 Creates a data source, which contains the location and connection information for a data store that is external to the database. More...
 
CreateDirectoryResponse createDirectory (const CreateDirectoryRequest &request_) const
 Creates a new directory in KiFS. More...
 
CreateDirectoryResponsecreateDirectory (const CreateDirectoryRequest &request_, CreateDirectoryResponse &response_) const
 Creates a new directory in KiFS. More...
 
CreateDirectoryResponse createDirectory (const std::string &directoryName, const std::map< std::string, std::string > &options) const
 Creates a new directory in KiFS. More...
 
CreateDirectoryResponsecreateDirectory (const std::string &directoryName, const std::map< std::string, std::string > &options, CreateDirectoryResponse &response_) const
 Creates a new directory in KiFS. More...
 
CreateEnvironmentResponse createEnvironment (const CreateEnvironmentRequest &request_) const
 Creates a new environment which can be used by user-defined functions (UDF). More...
 
CreateEnvironmentResponsecreateEnvironment (const CreateEnvironmentRequest &request_, CreateEnvironmentResponse &response_) const
 Creates a new environment which can be used by user-defined functions (UDF). More...
 
CreateEnvironmentResponse createEnvironment (const std::string &environmentName, const std::map< std::string, std::string > &options) const
 Creates a new environment which can be used by user-defined functions (UDF). More...
 
CreateEnvironmentResponsecreateEnvironment (const std::string &environmentName, const std::map< std::string, std::string > &options, CreateEnvironmentResponse &response_) const
 Creates a new environment which can be used by user-defined functions (UDF). More...
 
CreateGraphResponse createGraph (const CreateGraphRequest &request_) const
 Creates a new graph network using given nodes, edges, weights, and restrictions. More...
 
CreateGraphResponsecreateGraph (const CreateGraphRequest &request_, CreateGraphResponse &response_) const
 Creates a new graph network using given nodes, edges, weights, and restrictions. More...
 
CreateGraphResponse createGraph (const std::string &graphName, const bool directedGraph, const std::vector< std::string > &nodes, const std::vector< std::string > &edges, const std::vector< std::string > &weights, const std::vector< std::string > &restrictions, const std::map< std::string, std::string > &options) const
 Creates a new graph network using given nodes, edges, weights, and restrictions. More...
 
CreateGraphResponsecreateGraph (const std::string &graphName, const bool directedGraph, const std::vector< std::string > &nodes, const std::vector< std::string > &edges, const std::vector< std::string > &weights, const std::vector< std::string > &restrictions, const std::map< std::string, std::string > &options, CreateGraphResponse &response_) const
 Creates a new graph network using given nodes, edges, weights, and restrictions. More...
 
CreateJobResponse createJob (const CreateJobRequest &request_) const
 Create a job which will run asynchronously. More...
 
CreateJobResponsecreateJob (const CreateJobRequest &request_, CreateJobResponse &response_) const
 Create a job which will run asynchronously. More...
 
CreateJobResponse createJob (const std::string &endpoint, const std::string &requestEncoding, const std::vector< uint8_t > &data, const std::string &dataStr, const std::map< std::string, std::string > &options) const
 Create a job which will run asynchronously. More...
 
CreateJobResponsecreateJob (const std::string &endpoint, const std::string &requestEncoding, const std::vector< uint8_t > &data, const std::string &dataStr, const std::map< std::string, std::string > &options, CreateJobResponse &response_) const
 Create a job which will run asynchronously. More...
 
CreateJoinTableResponse createJoinTable (const CreateJoinTableRequest &request_) const
 Creates a table that is the result of a SQL JOIN. More...
 
CreateJoinTableResponsecreateJoinTable (const CreateJoinTableRequest &request_, CreateJoinTableResponse &response_) const
 Creates a table that is the result of a SQL JOIN. More...
 
CreateJoinTableResponse createJoinTable (const std::string &joinTableName, const std::vector< std::string > &tableNames, const std::vector< std::string > &columnNames, const std::vector< std::string > &expressions, const std::map< std::string, std::string > &options) const
 Creates a table that is the result of a SQL JOIN. More...
 
CreateJoinTableResponsecreateJoinTable (const std::string &joinTableName, const std::vector< std::string > &tableNames, const std::vector< std::string > &columnNames, const std::vector< std::string > &expressions, const std::map< std::string, std::string > &options, CreateJoinTableResponse &response_) const
 Creates a table that is the result of a SQL JOIN. More...
 
CreateMaterializedViewResponse createMaterializedView (const CreateMaterializedViewRequest &request_) const
 Initiates the process of creating a materialized view, reserving the view's name to prevent other views or tables from being created with that name. More...
 
CreateMaterializedViewResponsecreateMaterializedView (const CreateMaterializedViewRequest &request_, CreateMaterializedViewResponse &response_) const
 Initiates the process of creating a materialized view, reserving the view's name to prevent other views or tables from being created with that name. More...
 
CreateMaterializedViewResponse createMaterializedView (const std::string &tableName, const std::map< std::string, std::string > &options) const
 Initiates the process of creating a materialized view, reserving the view's name to prevent other views or tables from being created with that name. More...
 
CreateMaterializedViewResponsecreateMaterializedView (const std::string &tableName, const std::map< std::string, std::string > &options, CreateMaterializedViewResponse &response_) const
 Initiates the process of creating a materialized view, reserving the view's name to prevent other views or tables from being created with that name. More...
 
CreateProcResponse createProc (const CreateProcRequest &request_) const
 Creates an instance (proc) of the user-defined functions (UDF) specified by the given command, options, and files, and makes it available for execution. More...
 
CreateProcResponsecreateProc (const CreateProcRequest &request_, CreateProcResponse &response_) const
 Creates an instance (proc) of the user-defined functions (UDF) specified by the given command, options, and files, and makes it available for execution. More...
 
CreateProcResponse createProc (const std::string &procName, const std::string &executionMode, const std::map< std::string, std::vector< uint8_t > > &files, const std::string &command, const std::vector< std::string > &args, const std::map< std::string, std::string > &options) const
 Creates an instance (proc) of the user-defined functions (UDF) specified by the given command, options, and files, and makes it available for execution. More...
 
CreateProcResponsecreateProc (const std::string &procName, const std::string &executionMode, const std::map< std::string, std::vector< uint8_t > > &files, const std::string &command, const std::vector< std::string > &args, const std::map< std::string, std::string > &options, CreateProcResponse &response_) const
 Creates an instance (proc) of the user-defined functions (UDF) specified by the given command, options, and files, and makes it available for execution. More...
 
CreateProjectionResponse createProjection (const CreateProjectionRequest &request_) const
 Creates a new projection of an existing table. More...
 
CreateProjectionResponsecreateProjection (const CreateProjectionRequest &request_, CreateProjectionResponse &response_) const
 Creates a new projection of an existing table. More...
 
CreateProjectionResponse createProjection (const std::string &tableName, const std::string &projectionName, const std::vector< std::string > &columnNames, const std::map< std::string, std::string > &options) const
 Creates a new projection of an existing table. More...
 
CreateProjectionResponsecreateProjection (const std::string &tableName, const std::string &projectionName, const std::vector< std::string > &columnNames, const std::map< std::string, std::string > &options, CreateProjectionResponse &response_) const
 Creates a new projection of an existing table. More...
 
CreateResourceGroupResponse createResourceGroup (const CreateResourceGroupRequest &request_) const
 Creates a new resource group to facilitate resource management. More...
 
CreateResourceGroupResponsecreateResourceGroup (const CreateResourceGroupRequest &request_, CreateResourceGroupResponse &response_) const
 Creates a new resource group to facilitate resource management. More...
 
CreateResourceGroupResponse createResourceGroup (const std::string &name, const std::map< std::string, std::map< std::string, std::string > > &tierAttributes, const std::string &ranking, const std::string &adjoiningResourceGroup, const std::map< std::string, std::string > &options) const
 Creates a new resource group to facilitate resource management. More...
 
CreateResourceGroupResponsecreateResourceGroup (const std::string &name, const std::map< std::string, std::map< std::string, std::string > > &tierAttributes, const std::string &ranking, const std::string &adjoiningResourceGroup, const std::map< std::string, std::string > &options, CreateResourceGroupResponse &response_) const
 Creates a new resource group to facilitate resource management. More...
 
CreateRoleResponse createRole (const CreateRoleRequest &request_) const
 Creates a new role. More...
 
CreateRoleResponsecreateRole (const CreateRoleRequest &request_, CreateRoleResponse &response_) const
 Creates a new role. More...
 
CreateRoleResponse createRole (const std::string &name, const std::map< std::string, std::string > &options) const
 Creates a new role. More...
 
CreateRoleResponsecreateRole (const std::string &name, const std::map< std::string, std::string > &options, CreateRoleResponse &response_) const
 Creates a new role. More...
 
CreateSchemaResponse createSchema (const CreateSchemaRequest &request_) const
 Creates a SQL-style schema. More...
 
CreateSchemaResponsecreateSchema (const CreateSchemaRequest &request_, CreateSchemaResponse &response_) const
 Creates a SQL-style schema. More...
 
CreateSchemaResponse createSchema (const std::string &schemaName, const std::map< std::string, std::string > &options) const
 Creates a SQL-style schema. More...
 
CreateSchemaResponsecreateSchema (const std::string &schemaName, const std::map< std::string, std::string > &options, CreateSchemaResponse &response_) const
 Creates a SQL-style schema. More...
 
CreateTableResponse createTable (const CreateTableRequest &request_) const
 Creates a new table. More...
 
CreateTableResponsecreateTable (const CreateTableRequest &request_, CreateTableResponse &response_) const
 Creates a new table. More...
 
CreateTableResponse createTable (const std::string &tableName, const std::string &typeId, const std::map< std::string, std::string > &options) const
 Creates a new table. More...
 
CreateTableResponsecreateTable (const std::string &tableName, const std::string &typeId, const std::map< std::string, std::string > &options, CreateTableResponse &response_) const
 Creates a new table. More...
 
CreateTableExternalResponse createTableExternal (const CreateTableExternalRequest &request_) const
 Creates a new external table, which is a local database object whose source data is located externally to the database. More...
 
CreateTableExternalResponsecreateTableExternal (const CreateTableExternalRequest &request_, CreateTableExternalResponse &response_) const
 Creates a new external table, which is a local database object whose source data is located externally to the database. More...
 
CreateTableExternalResponse createTableExternal (const std::string &tableName, const std::vector< std::string > &filepaths, const std::map< std::string, std::map< std::string, std::string > > &modifyColumns, const std::map< std::string, std::string > &createTableOptions, const std::map< std::string, std::string > &options) const
 Creates a new external table, which is a local database object whose source data is located externally to the database. More...
 
CreateTableExternalResponsecreateTableExternal (const std::string &tableName, const std::vector< std::string > &filepaths, const std::map< std::string, std::map< std::string, std::string > > &modifyColumns, const std::map< std::string, std::string > &createTableOptions, const std::map< std::string, std::string > &options, CreateTableExternalResponse &response_) const
 Creates a new external table, which is a local database object whose source data is located externally to the database. More...
 
CreateTableMonitorResponse createTableMonitor (const CreateTableMonitorRequest &request_) const
 Creates a monitor that watches for a single table modification event type (insert, update, or delete) on a particular table (identified by tableName) and forwards event notifications to subscribers via ZMQ. More...
 
CreateTableMonitorResponsecreateTableMonitor (const CreateTableMonitorRequest &request_, CreateTableMonitorResponse &response_) const
 Creates a monitor that watches for a single table modification event type (insert, update, or delete) on a particular table (identified by tableName) and forwards event notifications to subscribers via ZMQ. More...
 
CreateTableMonitorResponse createTableMonitor (const std::string &tableName, const std::map< std::string, std::string > &options) const
 Creates a monitor that watches for a single table modification event type (insert, update, or delete) on a particular table (identified by tableName) and forwards event notifications to subscribers via ZMQ. More...
 
CreateTableMonitorResponsecreateTableMonitor (const std::string &tableName, const std::map< std::string, std::string > &options, CreateTableMonitorResponse &response_) const
 Creates a monitor that watches for a single table modification event type (insert, update, or delete) on a particular table (identified by tableName) and forwards event notifications to subscribers via ZMQ. More...
 
CreateTriggerByAreaResponse createTriggerByArea (const CreateTriggerByAreaRequest &request_) const
 Sets up an area trigger mechanism for two column_names for one or more tables. More...
 
CreateTriggerByAreaResponsecreateTriggerByArea (const CreateTriggerByAreaRequest &request_, CreateTriggerByAreaResponse &response_) const
 Sets up an area trigger mechanism for two column_names for one or more tables. More...
 
CreateTriggerByAreaResponse createTriggerByArea (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) const
 Sets up an area trigger mechanism for two column_names for one or more tables. More...
 
CreateTriggerByAreaResponsecreateTriggerByArea (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, CreateTriggerByAreaResponse &response_) const
 Sets up an area trigger mechanism for two column_names for one or more tables. More...
 
CreateTriggerByRangeResponse createTriggerByRange (const CreateTriggerByRangeRequest &request_) const
 Sets up a simple range trigger for a column_name for one or more tables. More...
 
CreateTriggerByRangeResponsecreateTriggerByRange (const CreateTriggerByRangeRequest &request_, CreateTriggerByRangeResponse &response_) const
 Sets up a simple range trigger for a column_name for one or more tables. More...
 
CreateTriggerByRangeResponse createTriggerByRange (const std::string &requestId, const std::vector< std::string > &tableNames, const std::string &columnName, const double min, const double max, const std::map< std::string, std::string > &options) const
 Sets up a simple range trigger for a column_name for one or more tables. More...
 
CreateTriggerByRangeResponsecreateTriggerByRange (const std::string &requestId, const std::vector< std::string > &tableNames, const std::string &columnName, const double min, const double max, const std::map< std::string, std::string > &options, CreateTriggerByRangeResponse &response_) const
 Sets up a simple range trigger for a column_name for one or more tables. More...
 
CreateTypeResponse createType (const CreateTypeRequest &request_) const
 Creates a new type describing the layout of a table. More...
 
CreateTypeResponsecreateType (const CreateTypeRequest &request_, CreateTypeResponse &response_) const
 Creates a new type describing the layout of a table. More...
 
CreateTypeResponse createType (const std::string &typeDefinition, const std::string &label, const std::map< std::string, std::vector< std::string > > &properties, const std::map< std::string, std::string > &options) const
 Creates a new type describing the layout of a table. More...
 
CreateTypeResponsecreateType (const std::string &typeDefinition, const std::string &label, const std::map< std::string, std::vector< std::string > > &properties, const std::map< std::string, std::string > &options, CreateTypeResponse &response_) const
 Creates a new type describing the layout of a table. More...
 
CreateUnionResponse createUnion (const CreateUnionRequest &request_) const
 Merges data from one or more tables with comparable data types into a new table. More...
 
CreateUnionResponsecreateUnion (const CreateUnionRequest &request_, CreateUnionResponse &response_) const
 Merges data from one or more tables with comparable data types into a new table. More...
 
CreateUnionResponse createUnion (const std::string &tableName, const std::vector< std::string > &tableNames, const std::vector< std::vector< std::string > > &inputColumnNames, const std::vector< std::string > &outputColumnNames, const std::map< std::string, std::string > &options) const
 Merges data from one or more tables with comparable data types into a new table. More...
 
CreateUnionResponsecreateUnion (const std::string &tableName, const std::vector< std::string > &tableNames, const std::vector< std::vector< std::string > > &inputColumnNames, const std::vector< std::string > &outputColumnNames, const std::map< std::string, std::string > &options, CreateUnionResponse &response_) const
 Merges data from one or more tables with comparable data types into a new table. More...
 
CreateUserExternalResponse createUserExternal (const CreateUserExternalRequest &request_) const
 Creates a new external user (a user whose credentials are managed by an external LDAP). More...
 
CreateUserExternalResponsecreateUserExternal (const CreateUserExternalRequest &request_, CreateUserExternalResponse &response_) const
 Creates a new external user (a user whose credentials are managed by an external LDAP). More...
 
CreateUserExternalResponse createUserExternal (const std::string &name, const std::map< std::string, std::string > &options) const
 Creates a new external user (a user whose credentials are managed by an external LDAP). More...
 
CreateUserExternalResponsecreateUserExternal (const std::string &name, const std::map< std::string, std::string > &options, CreateUserExternalResponse &response_) const
 Creates a new external user (a user whose credentials are managed by an external LDAP). More...
 
CreateUserInternalResponse createUserInternal (const CreateUserInternalRequest &request_) const
 Creates a new internal user (a user whose credentials are managed by the database system). More...
 
CreateUserInternalResponsecreateUserInternal (const CreateUserInternalRequest &request_, CreateUserInternalResponse &response_) const
 Creates a new internal user (a user whose credentials are managed by the database system). More...
 
CreateUserInternalResponse createUserInternal (const std::string &name, const std::string &password, const std::map< std::string, std::string > &options) const
 Creates a new internal user (a user whose credentials are managed by the database system). More...
 
CreateUserInternalResponsecreateUserInternal (const std::string &name, const std::string &password, const std::map< std::string, std::string > &options, CreateUserInternalResponse &response_) const
 Creates a new internal user (a user whose credentials are managed by the database system). More...
 
CreateVideoResponse createVideo (const CreateVideoRequest &request_) const
 Creates a job to generate a sequence of raster images that visualize data over a specified time. More...
 
CreateVideoResponsecreateVideo (const CreateVideoRequest &request_, CreateVideoResponse &response_) const
 Creates a job to generate a sequence of raster images that visualize data over a specified time. More...
 
CreateVideoResponse createVideo (const std::string &attribute, const std::string &begin, const double durationSeconds, const std::string &end, const double framesPerSecond, const std::string &style, const std::string &path, const std::string &styleParameters, const std::map< std::string, std::string > &options) const
 Creates a job to generate a sequence of raster images that visualize data over a specified time. More...
 
CreateVideoResponsecreateVideo (const std::string &attribute, const std::string &begin, const double durationSeconds, const std::string &end, const double framesPerSecond, const std::string &style, const std::string &path, const std::string &styleParameters, const std::map< std::string, std::string > &options, CreateVideoResponse &response_) const
 Creates a job to generate a sequence of raster images that visualize data over a specified time. More...
 
DeleteDirectoryResponse deleteDirectory (const DeleteDirectoryRequest &request_) const
 Deletes a directory from KiFS. More...
 
DeleteDirectoryResponsedeleteDirectory (const DeleteDirectoryRequest &request_, DeleteDirectoryResponse &response_) const
 Deletes a directory from KiFS. More...
 
DeleteDirectoryResponse deleteDirectory (const std::string &directoryName, const std::map< std::string, std::string > &options) const
 Deletes a directory from KiFS. More...
 
DeleteDirectoryResponsedeleteDirectory (const std::string &directoryName, const std::map< std::string, std::string > &options, DeleteDirectoryResponse &response_) const
 Deletes a directory from KiFS. More...
 
DeleteFilesResponse deleteFiles (const DeleteFilesRequest &request_) const
 Deletes one or more files from KiFS. More...
 
DeleteFilesResponsedeleteFiles (const DeleteFilesRequest &request_, DeleteFilesResponse &response_) const
 Deletes one or more files from KiFS. More...
 
DeleteFilesResponse deleteFiles (const std::vector< std::string > &fileNames, const std::map< std::string, std::string > &options) const
 Deletes one or more files from KiFS. More...
 
DeleteFilesResponsedeleteFiles (const std::vector< std::string > &fileNames, const std::map< std::string, std::string > &options, DeleteFilesResponse &response_) const
 Deletes one or more files from KiFS. More...
 
DeleteGraphResponse deleteGraph (const DeleteGraphRequest &request_) const
 Deletes an existing graph from the graph server and/or persist. More...
 
DeleteGraphResponsedeleteGraph (const DeleteGraphRequest &request_, DeleteGraphResponse &response_) const
 Deletes an existing graph from the graph server and/or persist. More...
 
DeleteGraphResponse deleteGraph (const std::string &graphName, const std::map< std::string, std::string > &options) const
 Deletes an existing graph from the graph server and/or persist. More...
 
DeleteGraphResponsedeleteGraph (const std::string &graphName, const std::map< std::string, std::string > &options, DeleteGraphResponse &response_) const
 Deletes an existing graph from the graph server and/or persist. More...
 
DeleteProcResponse deleteProc (const DeleteProcRequest &request_) const
 Deletes a proc. More...
 
DeleteProcResponsedeleteProc (const DeleteProcRequest &request_, DeleteProcResponse &response_) const
 Deletes a proc. More...
 
DeleteProcResponse deleteProc (const std::string &procName, const std::map< std::string, std::string > &options) const
 Deletes a proc. More...
 
DeleteProcResponsedeleteProc (const std::string &procName, const std::map< std::string, std::string > &options, DeleteProcResponse &response_) const
 Deletes a proc. More...
 
DeleteRecordsResponse deleteRecords (const DeleteRecordsRequest &request_) const
 Deletes record(s) matching the provided criteria from the given table. More...
 
DeleteRecordsResponsedeleteRecords (const DeleteRecordsRequest &request_, DeleteRecordsResponse &response_) const
 Deletes record(s) matching the provided criteria from the given table. More...
 
DeleteRecordsResponse deleteRecords (const std::string &tableName, const std::vector< std::string > &expressions, const std::map< std::string, std::string > &options) const
 Deletes record(s) matching the provided criteria from the given table. More...
 
DeleteRecordsResponsedeleteRecords (const std::string &tableName, const std::vector< std::string > &expressions, const std::map< std::string, std::string > &options, DeleteRecordsResponse &response_) const
 Deletes record(s) matching the provided criteria from the given table. More...
 
DeleteResourceGroupResponse deleteResourceGroup (const DeleteResourceGroupRequest &request_) const
 Deletes a resource group. More...
 
DeleteResourceGroupResponsedeleteResourceGroup (const DeleteResourceGroupRequest &request_, DeleteResourceGroupResponse &response_) const
 Deletes a resource group. More...
 
DeleteResourceGroupResponse deleteResourceGroup (const std::string &name, const std::map< std::string, std::string > &options) const
 Deletes a resource group. More...
 
DeleteResourceGroupResponsedeleteResourceGroup (const std::string &name, const std::map< std::string, std::string > &options, DeleteResourceGroupResponse &response_) const
 Deletes a resource group. More...
 
DeleteRoleResponse deleteRole (const DeleteRoleRequest &request_) const
 Deletes an existing role. More...
 
DeleteRoleResponsedeleteRole (const DeleteRoleRequest &request_, DeleteRoleResponse &response_) const
 Deletes an existing role. More...
 
DeleteRoleResponse deleteRole (const std::string &name, const std::map< std::string, std::string > &options) const
 Deletes an existing role. More...
 
DeleteRoleResponsedeleteRole (const std::string &name, const std::map< std::string, std::string > &options, DeleteRoleResponse &response_) const
 Deletes an existing role. More...
 
DeleteUserResponse deleteUser (const DeleteUserRequest &request_) const
 Deletes an existing user. More...
 
DeleteUserResponsedeleteUser (const DeleteUserRequest &request_, DeleteUserResponse &response_) const
 Deletes an existing user. More...
 
DeleteUserResponse deleteUser (const std::string &name, const std::map< std::string, std::string > &options) const
 Deletes an existing user. More...
 
DeleteUserResponsedeleteUser (const std::string &name, const std::map< std::string, std::string > &options, DeleteUserResponse &response_) const
 Deletes an existing user. More...
 
DownloadFilesResponse downloadFiles (const DownloadFilesRequest &request_) const
 Downloads one or more files from KiFS. More...
 
DownloadFilesResponsedownloadFiles (const DownloadFilesRequest &request_, DownloadFilesResponse &response_) const
 Downloads one or more files from KiFS. More...
 
DownloadFilesResponse downloadFiles (const std::vector< std::string > &fileNames, const std::vector< int64_t > &readOffsets, const std::vector< int64_t > &readLengths, const std::map< std::string, std::string > &options) const
 Downloads one or more files from KiFS. More...
 
DownloadFilesResponsedownloadFiles (const std::vector< std::string > &fileNames, const std::vector< int64_t > &readOffsets, const std::vector< int64_t > &readLengths, const std::map< std::string, std::string > &options, DownloadFilesResponse &response_) const
 Downloads one or more files from KiFS. More...
 
DropCredentialResponse dropCredential (const DropCredentialRequest &request_) const
 Drop an existing credential. More...
 
DropCredentialResponsedropCredential (const DropCredentialRequest &request_, DropCredentialResponse &response_) const
 Drop an existing credential. More...
 
DropCredentialResponse dropCredential (const std::string &credentialName, const std::map< std::string, std::string > &options) const
 Drop an existing credential. More...
 
DropCredentialResponsedropCredential (const std::string &credentialName, const std::map< std::string, std::string > &options, DropCredentialResponse &response_) const
 Drop an existing credential. More...
 
DropDatasinkResponse dropDatasink (const DropDatasinkRequest &request_) const
 Drops an existing data sink. More...
 
DropDatasinkResponsedropDatasink (const DropDatasinkRequest &request_, DropDatasinkResponse &response_) const
 Drops an existing data sink. More...
 
DropDatasinkResponse dropDatasink (const std::string &name, const std::map< std::string, std::string > &options) const
 Drops an existing data sink. More...
 
DropDatasinkResponsedropDatasink (const std::string &name, const std::map< std::string, std::string > &options, DropDatasinkResponse &response_) const
 Drops an existing data sink. More...
 
DropDatasourceResponse dropDatasource (const DropDatasourceRequest &request_) const
 Drops an existing data source. More...
 
DropDatasourceResponsedropDatasource (const DropDatasourceRequest &request_, DropDatasourceResponse &response_) const
 Drops an existing data source. More...
 
DropDatasourceResponse dropDatasource (const std::string &name, const std::map< std::string, std::string > &options) const
 Drops an existing data source. More...
 
DropDatasourceResponsedropDatasource (const std::string &name, const std::map< std::string, std::string > &options, DropDatasourceResponse &response_) const
 Drops an existing data source. More...
 
DropEnvironmentResponse dropEnvironment (const DropEnvironmentRequest &request_) const
 Drop an existing user-defined function (UDF) environment. More...
 
DropEnvironmentResponsedropEnvironment (const DropEnvironmentRequest &request_, DropEnvironmentResponse &response_) const
 Drop an existing user-defined function (UDF) environment. More...
 
DropEnvironmentResponse dropEnvironment (const std::string &environmentName, const std::map< std::string, std::string > &options) const
 Drop an existing user-defined function (UDF) environment. More...
 
DropEnvironmentResponsedropEnvironment (const std::string &environmentName, const std::map< std::string, std::string > &options, DropEnvironmentResponse &response_) const
 Drop an existing user-defined function (UDF) environment. More...
 
DropSchemaResponse dropSchema (const DropSchemaRequest &request_) const
 Drops an existing SQL-style schema, specified in schemaName. More...
 
DropSchemaResponsedropSchema (const DropSchemaRequest &request_, DropSchemaResponse &response_) const
 Drops an existing SQL-style schema, specified in schemaName. More...
 
DropSchemaResponse dropSchema (const std::string &schemaName, const std::map< std::string, std::string > &options) const
 Drops an existing SQL-style schema, specified in schemaName. More...
 
DropSchemaResponsedropSchema (const std::string &schemaName, const std::map< std::string, std::string > &options, DropSchemaResponse &response_) const
 Drops an existing SQL-style schema, specified in schemaName. More...
 
ExecuteProcResponse executeProc (const ExecuteProcRequest &request_) const
 Executes a proc. More...
 
ExecuteProcResponseexecuteProc (const ExecuteProcRequest &request_, ExecuteProcResponse &response_) const
 Executes a proc. More...
 
ExecuteProcResponse executeProc (const std::string &procName, const std::map< std::string, std::string > &params, const std::map< std::string, std::vector< uint8_t > > &binParams, const std::vector< std::string > &inputTableNames, const std::map< std::string, std::vector< std::string > > &inputColumnNames, const std::vector< std::string > &outputTableNames, const std::map< std::string, std::string > &options) const
 Executes a proc. More...
 
ExecuteProcResponseexecuteProc (const std::string &procName, const std::map< std::string, std::string > &params, const std::map< std::string, std::vector< uint8_t > > &binParams, const std::vector< std::string > &inputTableNames, const std::map< std::string, std::vector< std::string > > &inputColumnNames, const std::vector< std::string > &outputTableNames, const std::map< std::string, std::string > &options, ExecuteProcResponse &response_) const
 Executes a proc. More...
 
RawExecuteSqlResponse executeSqlRaw (const ExecuteSqlRequest &request_) const
 Execute a SQL statement (query, DML, or DDL). More...
 
RawExecuteSqlResponseexecuteSqlRaw (const ExecuteSqlRequest &request_, RawExecuteSqlResponse &response_) const
 Execute a SQL statement (query, DML, or DDL). More...
 
ExecuteSqlResponse executeSql (const ExecuteSqlRequest &request_) const
 Execute a SQL statement (query, DML, or DDL). More...
 
ExecuteSqlResponseexecuteSql (const ExecuteSqlRequest &request_, ExecuteSqlResponse &response_) const
 Execute a SQL statement (query, DML, or DDL). More...
 
ExecuteSqlResponse executeSql (const std::string &statement, const int64_t offset, const int64_t limit, const std::string &requestSchemaStr, const std::vector< std::vector< uint8_t > > &data, const std::map< std::string, std::string > &options) const
 Execute a SQL statement (query, DML, or DDL). More...
 
ExecuteSqlResponseexecuteSql (const std::string &statement, const int64_t offset, const int64_t limit, const std::string &requestSchemaStr, const std::vector< std::vector< uint8_t > > &data, const std::map< std::string, std::string > &options, ExecuteSqlResponse &response_) const
 Execute a SQL statement (query, DML, or DDL). More...
 
ExportQueryMetricsResponse exportQueryMetrics (const ExportQueryMetricsRequest &request_) const
 Export query metrics to a given destination. More...
 
ExportQueryMetricsResponseexportQueryMetrics (const ExportQueryMetricsRequest &request_, ExportQueryMetricsResponse &response_) const
 Export query metrics to a given destination. More...
 
ExportQueryMetricsResponse exportQueryMetrics (const std::map< std::string, std::string > &options) const
 Export query metrics to a given destination. More...
 
ExportQueryMetricsResponseexportQueryMetrics (const std::map< std::string, std::string > &options, ExportQueryMetricsResponse &response_) const
 Export query metrics to a given destination. More...
 
ExportRecordsToFilesResponse exportRecordsToFiles (const ExportRecordsToFilesRequest &request_) const
 Export records from a table to files. More...
 
ExportRecordsToFilesResponseexportRecordsToFiles (const ExportRecordsToFilesRequest &request_, ExportRecordsToFilesResponse &response_) const
 Export records from a table to files. More...
 
ExportRecordsToFilesResponse exportRecordsToFiles (const std::string &tableName, const std::string &filepath, const std::map< std::string, std::string > &options) const
 Export records from a table to files. More...
 
ExportRecordsToFilesResponseexportRecordsToFiles (const std::string &tableName, const std::string &filepath, const std::map< std::string, std::string > &options, ExportRecordsToFilesResponse &response_) const
 Export records from a table to files. More...
 
ExportRecordsToTableResponse exportRecordsToTable (const ExportRecordsToTableRequest &request_) const
 Exports records from source table to the specified target table in an external database. More...
 
ExportRecordsToTableResponseexportRecordsToTable (const ExportRecordsToTableRequest &request_, ExportRecordsToTableResponse &response_) const
 Exports records from source table to the specified target table in an external database. More...
 
ExportRecordsToTableResponse exportRecordsToTable (const std::string &tableName, const std::string &remoteQuery, const std::map< std::string, std::string > &options) const
 Exports records from source table to the specified target table in an external database. More...
 
ExportRecordsToTableResponseexportRecordsToTable (const std::string &tableName, const std::string &remoteQuery, const std::map< std::string, std::string > &options, ExportRecordsToTableResponse &response_) const
 Exports records from source table to the specified target table in an external database. More...
 
FilterResponse filter (const FilterRequest &request_) const
 Filters data based on the specified expression. More...
 
FilterResponsefilter (const FilterRequest &request_, FilterResponse &response_) const
 Filters data based on the specified expression. More...
 
FilterResponse filter (const std::string &tableName, const std::string &viewName, const std::string &expression, const std::map< std::string, std::string > &options) const
 Filters data based on the specified expression. More...
 
FilterResponsefilter (const std::string &tableName, const std::string &viewName, const std::string &expression, const std::map< std::string, std::string > &options, FilterResponse &response_) const
 Filters data based on the specified expression. More...
 
FilterByAreaResponse filterByArea (const FilterByAreaRequest &request_) const
 Calculates which objects from a table are within a named area of interest (NAI/polygon). More...
 
FilterByAreaResponsefilterByArea (const FilterByAreaRequest &request_, FilterByAreaResponse &response_) const
 Calculates which objects from a table are within a named area of interest (NAI/polygon). More...
 
FilterByAreaResponse filterByArea (const std::string &tableName, const std::string &viewName, 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) const
 Calculates which objects from a table are within a named area of interest (NAI/polygon). More...
 
FilterByAreaResponsefilterByArea (const std::string &tableName, const std::string &viewName, 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, FilterByAreaResponse &response_) const
 Calculates which objects from a table are within a named area of interest (NAI/polygon). More...
 
FilterByAreaGeometryResponse filterByAreaGeometry (const FilterByAreaGeometryRequest &request_) const
 Calculates which geospatial geometry objects from a table intersect a named area of interest (NAI/polygon). More...
 
FilterByAreaGeometryResponsefilterByAreaGeometry (const FilterByAreaGeometryRequest &request_, FilterByAreaGeometryResponse &response_) const
 Calculates which geospatial geometry objects from a table intersect a named area of interest (NAI/polygon). More...
 
FilterByAreaGeometryResponse filterByAreaGeometry (const std::string &tableName, const std::string &viewName, const std::string &columnName, const std::vector< double > &xVector, const std::vector< double > &yVector, const std::map< std::string, std::string > &options) const
 Calculates which geospatial geometry objects from a table intersect a named area of interest (NAI/polygon). More...
 
FilterByAreaGeometryResponsefilterByAreaGeometry (const std::string &tableName, const std::string &viewName, const std::string &columnName, const std::vector< double > &xVector, const std::vector< double > &yVector, const std::map< std::string, std::string > &options, FilterByAreaGeometryResponse &response_) const
 Calculates which geospatial geometry objects from a table intersect a named area of interest (NAI/polygon). More...
 
FilterByBoxResponse filterByBox (const FilterByBoxRequest &request_) const
 Calculates how many objects within the given table lie in a rectangular box. More...
 
FilterByBoxResponsefilterByBox (const FilterByBoxRequest &request_, FilterByBoxResponse &response_) const
 Calculates how many objects within the given table lie in a rectangular box. More...
 
FilterByBoxResponse filterByBox (const std::string &tableName, const std::string &viewName, const std::string &xColumnName, const double minX, const double maxX, const std::string &yColumnName, const double minY, const double maxY, const std::map< std::string, std::string > &options) const
 Calculates how many objects within the given table lie in a rectangular box. More...
 
FilterByBoxResponsefilterByBox (const std::string &tableName, const std::string &viewName, const std::string &xColumnName, const double minX, const double maxX, const std::string &yColumnName, const double minY, const double maxY, const std::map< std::string, std::string > &options, FilterByBoxResponse &response_) const
 Calculates how many objects within the given table lie in a rectangular box. More...
 
FilterByBoxGeometryResponse filterByBoxGeometry (const FilterByBoxGeometryRequest &request_) const
 Calculates which geospatial geometry objects from a table intersect a rectangular box. More...
 
FilterByBoxGeometryResponsefilterByBoxGeometry (const FilterByBoxGeometryRequest &request_, FilterByBoxGeometryResponse &response_) const
 Calculates which geospatial geometry objects from a table intersect a rectangular box. More...
 
FilterByBoxGeometryResponse filterByBoxGeometry (const std::string &tableName, const std::string &viewName, const std::string &columnName, const double minX, const double maxX, const double minY, const double maxY, const std::map< std::string, std::string > &options) const
 Calculates which geospatial geometry objects from a table intersect a rectangular box. More...
 
FilterByBoxGeometryResponsefilterByBoxGeometry (const std::string &tableName, const std::string &viewName, const std::string &columnName, const double minX, const double maxX, const double minY, const double maxY, const std::map< std::string, std::string > &options, FilterByBoxGeometryResponse &response_) const
 Calculates which geospatial geometry objects from a table intersect a rectangular box. More...
 
FilterByGeometryResponse filterByGeometry (const FilterByGeometryRequest &request_) const
 Applies a geometry filter against a geospatial geometry column in a given table or view. More...
 
FilterByGeometryResponsefilterByGeometry (const FilterByGeometryRequest &request_, FilterByGeometryResponse &response_) const
 Applies a geometry filter against a geospatial geometry column in a given table or view. More...
 
FilterByGeometryResponse filterByGeometry (const std::string &tableName, const std::string &viewName, const std::string &columnName, const std::string &inputWkt, const std::string &operation, const std::map< std::string, std::string > &options) const
 Applies a geometry filter against a geospatial geometry column in a given table or view. More...
 
FilterByGeometryResponsefilterByGeometry (const std::string &tableName, const std::string &viewName, const std::string &columnName, const std::string &inputWkt, const std::string &operation, const std::map< std::string, std::string > &options, FilterByGeometryResponse &response_) const
 Applies a geometry filter against a geospatial geometry column in a given table or view. More...
 
FilterByListResponse filterByList (const FilterByListRequest &request_) const
 Calculates which records from a table have values in the given list for the corresponding column. More...
 
FilterByListResponsefilterByList (const FilterByListRequest &request_, FilterByListResponse &response_) const
 Calculates which records from a table have values in the given list for the corresponding column. More...
 
FilterByListResponse filterByList (const std::string &tableName, const std::string &viewName, const std::map< std::string, std::vector< std::string > > &columnValuesMap, const std::map< std::string, std::string > &options) const
 Calculates which records from a table have values in the given list for the corresponding column. More...
 
FilterByListResponsefilterByList (const std::string &tableName, const std::string &viewName, const std::map< std::string, std::vector< std::string > > &columnValuesMap, const std::map< std::string, std::string > &options, FilterByListResponse &response_) const
 Calculates which records from a table have values in the given list for the corresponding column. More...
 
FilterByRadiusResponse filterByRadius (const FilterByRadiusRequest &request_) const
 Calculates which objects from a table lie within a circle with the given radius and center point (i.e. circular NAI). More...
 
FilterByRadiusResponsefilterByRadius (const FilterByRadiusRequest &request_, FilterByRadiusResponse &response_) const
 Calculates which objects from a table lie within a circle with the given radius and center point (i.e. circular NAI). More...
 
FilterByRadiusResponse filterByRadius (const std::string &tableName, const std::string &viewName, const std::string &xColumnName, const double xCenter, const std::string &yColumnName, const double yCenter, const double radius, const std::map< std::string, std::string > &options) const
 Calculates which objects from a table lie within a circle with the given radius and center point (i.e. circular NAI). More...
 
FilterByRadiusResponsefilterByRadius (const std::string &tableName, const std::string &viewName, const std::string &xColumnName, const double xCenter, const std::string &yColumnName, const double yCenter, const double radius, const std::map< std::string, std::string > &options, FilterByRadiusResponse &response_) const
 Calculates which objects from a table lie within a circle with the given radius and center point (i.e. circular NAI). More...
 
FilterByRadiusGeometryResponse filterByRadiusGeometry (const FilterByRadiusGeometryRequest &request_) const
 Calculates which geospatial geometry objects from a table intersect a circle with the given radius and center point (i.e. circular NAI). More...
 
FilterByRadiusGeometryResponsefilterByRadiusGeometry (const FilterByRadiusGeometryRequest &request_, FilterByRadiusGeometryResponse &response_) const
 Calculates which geospatial geometry objects from a table intersect a circle with the given radius and center point (i.e. circular NAI). More...
 
FilterByRadiusGeometryResponse filterByRadiusGeometry (const std::string &tableName, const std::string &viewName, const std::string &columnName, const double xCenter, const double yCenter, const double radius, const std::map< std::string, std::string > &options) const
 Calculates which geospatial geometry objects from a table intersect a circle with the given radius and center point (i.e. circular NAI). More...
 
FilterByRadiusGeometryResponsefilterByRadiusGeometry (const std::string &tableName, const std::string &viewName, const std::string &columnName, const double xCenter, const double yCenter, const double radius, const std::map< std::string, std::string > &options, FilterByRadiusGeometryResponse &response_) const
 Calculates which geospatial geometry objects from a table intersect a circle with the given radius and center point (i.e. circular NAI). More...
 
FilterByRangeResponse filterByRange (const FilterByRangeRequest &request_) const
 Calculates which objects from a table have a column that is within the given bounds. More...
 
FilterByRangeResponsefilterByRange (const FilterByRangeRequest &request_, FilterByRangeResponse &response_) const
 Calculates which objects from a table have a column that is within the given bounds. More...
 
FilterByRangeResponse filterByRange (const std::string &tableName, const std::string &viewName, const std::string &columnName, const double lowerBound, const double upperBound, const std::map< std::string, std::string > &options) const
 Calculates which objects from a table have a column that is within the given bounds. More...
 
FilterByRangeResponsefilterByRange (const std::string &tableName, const std::string &viewName, const std::string &columnName, const double lowerBound, const double upperBound, const std::map< std::string, std::string > &options, FilterByRangeResponse &response_) const
 Calculates which objects from a table have a column that is within the given bounds. More...
 
FilterBySeriesResponse filterBySeries (const FilterBySeriesRequest &request_) const
 Filters objects matching all points of the given track (works only on track type data). More...
 
FilterBySeriesResponsefilterBySeries (const FilterBySeriesRequest &request_, FilterBySeriesResponse &response_) const
 Filters objects matching all points of the given track (works only on track type data). More...
 
FilterBySeriesResponse filterBySeries (const std::string &tableName, const std::string &viewName, const std::string &trackId, const std::vector< std::string > &targetTrackIds, const std::map< std::string, std::string > &options) const
 Filters objects matching all points of the given track (works only on track type data). More...
 
FilterBySeriesResponsefilterBySeries (const std::string &tableName, const std::string &viewName, const std::string &trackId, const std::vector< std::string > &targetTrackIds, const std::map< std::string, std::string > &options, FilterBySeriesResponse &response_) const
 Filters objects matching all points of the given track (works only on track type data). More...
 
FilterByStringResponse filterByString (const FilterByStringRequest &request_) const
 Calculates which objects from a table or view match a string expression for the given string columns. More...
 
FilterByStringResponsefilterByString (const FilterByStringRequest &request_, FilterByStringResponse &response_) const
 Calculates which objects from a table or view match a string expression for the given string columns. More...
 
FilterByStringResponse filterByString (const std::string &tableName, const std::string &viewName, const std::string &expression, const std::string &mode, const std::vector< std::string > &columnNames, const std::map< std::string, std::string > &options) const
 Calculates which objects from a table or view match a string expression for the given string columns. More...
 
FilterByStringResponsefilterByString (const std::string &tableName, const std::string &viewName, const std::string &expression, const std::string &mode, const std::vector< std::string > &columnNames, const std::map< std::string, std::string > &options, FilterByStringResponse &response_) const
 Calculates which objects from a table or view match a string expression for the given string columns. More...
 
FilterByTableResponse filterByTable (const FilterByTableRequest &request_) const
 Filters objects in one table based on objects in another table. More...
 
FilterByTableResponsefilterByTable (const FilterByTableRequest &request_, FilterByTableResponse &response_) const
 Filters objects in one table based on objects in another table. More...
 
FilterByTableResponse filterByTable (const std::string &tableName, const std::string &viewName, const std::string &columnName, const std::string &sourceTableName, const std::string &sourceTableColumnName, const std::map< std::string, std::string > &options) const
 Filters objects in one table based on objects in another table. More...
 
FilterByTableResponsefilterByTable (const std::string &tableName, const std::string &viewName, const std::string &columnName, const std::string &sourceTableName, const std::string &sourceTableColumnName, const std::map< std::string, std::string > &options, FilterByTableResponse &response_) const
 Filters objects in one table based on objects in another table. More...
 
FilterByValueResponse filterByValue (const FilterByValueRequest &request_) const
 Calculates which objects from a table has a particular value for a particular column. More...
 
FilterByValueResponsefilterByValue (const FilterByValueRequest &request_, FilterByValueResponse &response_) const
 Calculates which objects from a table has a particular value for a particular column. More...
 
FilterByValueResponse filterByValue (const std::string &tableName, const std::string &viewName, const bool isString, const double value, const std::string &valueStr, const std::string &columnName, const std::map< std::string, std::string > &options) const
 Calculates which objects from a table has a particular value for a particular column. More...
 
FilterByValueResponsefilterByValue (const std::string &tableName, const std::string &viewName, const bool isString, const double value, const std::string &valueStr, const std::string &columnName, const std::map< std::string, std::string > &options, FilterByValueResponse &response_) const
 Calculates which objects from a table has a particular value for a particular column. More...
 
GetJobResponse getJob (const GetJobRequest &request_) const
 Get the status and result of asynchronously running job. More...
 
GetJobResponsegetJob (const GetJobRequest &request_, GetJobResponse &response_) const
 Get the status and result of asynchronously running job. More...
 
GetJobResponse getJob (const int64_t jobId, const std::map< std::string, std::string > &options) const
 Get the status and result of asynchronously running job. More...
 
GetJobResponsegetJob (const int64_t jobId, const std::map< std::string, std::string > &options, GetJobResponse &response_) const
 Get the status and result of asynchronously running job. More...
 
RawGetRecordsResponse getRecordsRaw (const GetRecordsRequest &request_) const
 Retrieves records from a given table, optionally filtered by an expression and/or sorted by a column. More...
 
RawGetRecordsResponsegetRecordsRaw (const GetRecordsRequest &request_, RawGetRecordsResponse &response_) const
 Retrieves records from a given table, optionally filtered by an expression and/or sorted by a column. More...
 
template<typename TResponse >
GetRecordsResponse< TResponse > getRecords (const GetRecordsRequest &request_) const
 Retrieves records from a given table, optionally filtered by an expression and/or sorted by a column. More...
 
template<typename TResponse >
GetRecordsResponse< TResponse > & getRecords (const GetRecordsRequest &request_, GetRecordsResponse< TResponse > &response_) const
 Retrieves records from a given table, optionally filtered by an expression and/or sorted by a column. More...
 
template<typename TResponse >
GetRecordsResponse< TResponse > getRecords (const std::string &tableName, const int64_t offset, const int64_t limit, const std::map< std::string, std::string > &options) const
 Retrieves records from a given table, optionally filtered by an expression and/or sorted by a column. More...
 
template<typename TResponse >
GetRecordsResponse< TResponse > & getRecords (const std::string &tableName, const int64_t offset, const int64_t limit, const std::map< std::string, std::string > &options, GetRecordsResponse< TResponse > &response_) const
 Retrieves records from a given table, optionally filtered by an expression and/or sorted by a column. More...
 
template<typename TResponse >
GetRecordsResponse< TResponse > getRecords (const ::avro::ValidSchema &schema_, const GetRecordsRequest &request_) const
 Retrieves records from a given table, optionally filtered by an expression and/or sorted by a column. More...
 
template<typename TResponse >
GetRecordsResponse< TResponse > getRecords (const Type &type_, const GetRecordsRequest &request_) const
 Retrieves records from a given table, optionally filtered by an expression and/or sorted by a column. More...
 
template<typename TResponse >
GetRecordsResponse< TResponse > & getRecords (const ::avro::ValidSchema &schema_, const GetRecordsRequest &request_, GetRecordsResponse< TResponse > &response_) const
 Retrieves records from a given table, optionally filtered by an expression and/or sorted by a column. More...
 
template<typename TResponse >
GetRecordsResponse< TResponse > & getRecords (const Type &type_, const GetRecordsRequest &request_, GetRecordsResponse< TResponse > &response_) const
 Retrieves records from a given table, optionally filtered by an expression and/or sorted by a column. More...
 
template<typename TResponse >
GetRecordsResponse< TResponse > getRecords (const ::avro::ValidSchema &schema_, const std::string &tableName, const int64_t offset, const int64_t limit, const std::map< std::string, std::string > &options) const
 Retrieves records from a given table, optionally filtered by an expression and/or sorted by a column. More...
 
template<typename TResponse >
GetRecordsResponse< TResponse > getRecords (const Type &type_, const std::string &tableName, const int64_t offset, const int64_t limit, const std::map< std::string, std::string > &options) const
 Retrieves records from a given table, optionally filtered by an expression and/or sorted by a column. More...
 
template<typename TResponse >
GetRecordsResponse< TResponse > & getRecords (const ::avro::ValidSchema &schema_, const std::string &tableName, const int64_t offset, const int64_t limit, const std::map< std::string, std::string > &options, GetRecordsResponse< TResponse > &response_) const
 Retrieves records from a given table, optionally filtered by an expression and/or sorted by a column. More...
 
template<typename TResponse >
GetRecordsResponse< TResponse > & getRecords (const Type &type_, const std::string &tableName, const int64_t offset, const int64_t limit, const std::map< std::string, std::string > &options, GetRecordsResponse< TResponse > &response_) const
 Retrieves records from a given table, optionally filtered by an expression and/or sorted by a column. More...
 
RawGetRecordsByColumnResponse getRecordsByColumnRaw (const GetRecordsByColumnRequest &request_) const
 For a given table, retrieves the values from the requested column(s). More...
 
RawGetRecordsByColumnResponsegetRecordsByColumnRaw (const GetRecordsByColumnRequest &request_, RawGetRecordsByColumnResponse &response_) const
 For a given table, retrieves the values from the requested column(s). More...
 
GetRecordsByColumnResponse getRecordsByColumn (const GetRecordsByColumnRequest &request_) const
 For a given table, retrieves the values from the requested column(s). More...
 
GetRecordsByColumnResponsegetRecordsByColumn (const GetRecordsByColumnRequest &request_, GetRecordsByColumnResponse &response_) const
 For a given table, retrieves the values from the requested column(s). More...
 
GetRecordsByColumnResponse getRecordsByColumn (const std::string &tableName, const std::vector< std::string > &columnNames, const int64_t offset, const int64_t limit, const std::map< std::string, std::string > &options) const
 For a given table, retrieves the values from the requested column(s). More...
 
GetRecordsByColumnResponsegetRecordsByColumn (const std::string &tableName, const std::vector< std::string > &columnNames, const int64_t offset, const int64_t limit, const std::map< std::string, std::string > &options, GetRecordsByColumnResponse &response_) const
 For a given table, retrieves the values from the requested column(s). More...
 
RawGetRecordsBySeriesResponse getRecordsBySeriesRaw (const GetRecordsBySeriesRequest &request_) const
 Retrieves the complete series/track records from the given worldTableName based on the partial track information contained in the tableName. More...
 
RawGetRecordsBySeriesResponsegetRecordsBySeriesRaw (const GetRecordsBySeriesRequest &request_, RawGetRecordsBySeriesResponse &response_) const
 Retrieves the complete series/track records from the given worldTableName based on the partial track information contained in the tableName. More...
 
template<typename TResponse >
GetRecordsBySeriesResponse< TResponse > getRecordsBySeries (const GetRecordsBySeriesRequest &request_) const
 Retrieves the complete series/track records from the given worldTableName based on the partial track information contained in the tableName. More...
 
template<typename TResponse >
GetRecordsBySeriesResponse< TResponse > & getRecordsBySeries (const GetRecordsBySeriesRequest &request_, GetRecordsBySeriesResponse< TResponse > &response_) const
 Retrieves the complete series/track records from the given worldTableName based on the partial track information contained in the tableName. More...
 
template<typename TResponse >
GetRecordsBySeriesResponse< TResponse > getRecordsBySeries (const std::string &tableName, const std::string &worldTableName, const int32_t offset, const int32_t limit, const std::map< std::string, std::string > &options) const
 Retrieves the complete series/track records from the given worldTableName based on the partial track information contained in the tableName. More...
 
template<typename TResponse >
GetRecordsBySeriesResponse< TResponse > & getRecordsBySeries (const std::string &tableName, const std::string &worldTableName, const int32_t offset, const int32_t limit, const std::map< std::string, std::string > &options, GetRecordsBySeriesResponse< TResponse > &response_) const
 Retrieves the complete series/track records from the given worldTableName based on the partial track information contained in the tableName. More...
 
template<typename TResponse >
GetRecordsBySeriesResponse< TResponse > getRecordsBySeries (const ::avro::ValidSchema &schema_, const GetRecordsBySeriesRequest &request_) const
 Retrieves the complete series/track records from the given worldTableName based on the partial track information contained in the tableName. More...
 
template<typename TResponse >
GetRecordsBySeriesResponse< TResponse > getRecordsBySeries (const Type &type_, const GetRecordsBySeriesRequest &request_) const
 Retrieves the complete series/track records from the given worldTableName based on the partial track information contained in the tableName. More...
 
template<typename TResponse >
GetRecordsBySeriesResponse< TResponse > & getRecordsBySeries (const ::avro::ValidSchema &schema_, const GetRecordsBySeriesRequest &request_, GetRecordsBySeriesResponse< TResponse > &response_) const
 Retrieves the complete series/track records from the given worldTableName based on the partial track information contained in the tableName. More...
 
template<typename TResponse >
GetRecordsBySeriesResponse< TResponse > & getRecordsBySeries (const Type &type_, const GetRecordsBySeriesRequest &request_, GetRecordsBySeriesResponse< TResponse > &response_) const
 Retrieves the complete series/track records from the given worldTableName based on the partial track information contained in the tableName. More...
 
template<typename TResponse >
GetRecordsBySeriesResponse< TResponse > getRecordsBySeries (const ::avro::ValidSchema &schema_, const std::string &tableName, const std::string &worldTableName, const int32_t offset, const int32_t limit, const std::map< std::string, std::string > &options) const
 Retrieves the complete series/track records from the given worldTableName based on the partial track information contained in the tableName. More...
 
template<typename TResponse >
GetRecordsBySeriesResponse< TResponse > getRecordsBySeries (const Type &type_, const std::string &tableName, const std::string &worldTableName, const int32_t offset, const int32_t limit, const std::map< std::string, std::string > &options) const
 Retrieves the complete series/track records from the given worldTableName based on the partial track information contained in the tableName. More...
 
template<typename TResponse >
GetRecordsBySeriesResponse< TResponse > & getRecordsBySeries (const ::avro::ValidSchema &schema_, const std::string &tableName, const std::string &worldTableName, const int32_t offset, const int32_t limit, const std::map< std::string, std::string > &options, GetRecordsBySeriesResponse< TResponse > &response_) const
 Retrieves the complete series/track records from the given worldTableName based on the partial track information contained in the tableName. More...
 
template<typename TResponse >
GetRecordsBySeriesResponse< TResponse > & getRecordsBySeries (const Type &type_, const std::string &tableName, const std::string &worldTableName, const int32_t offset, const int32_t limit, const std::map< std::string, std::string > &options, GetRecordsBySeriesResponse< TResponse > &response_) const
 Retrieves the complete series/track records from the given worldTableName based on the partial track information contained in the tableName. More...
 
RawGetRecordsFromCollectionResponse getRecordsFromCollectionRaw (const GetRecordsFromCollectionRequest &request_) const
 Retrieves records from a collection. More...
 
RawGetRecordsFromCollectionResponsegetRecordsFromCollectionRaw (const GetRecordsFromCollectionRequest &request_, RawGetRecordsFromCollectionResponse &response_) const
 Retrieves records from a collection. More...
 
template<typename TResponse >
GetRecordsFromCollectionResponse< TResponse > getRecordsFromCollection (const GetRecordsFromCollectionRequest &request_) const
 Retrieves records from a collection. More...
 
template<typename TResponse >
GetRecordsFromCollectionResponse< TResponse > & getRecordsFromCollection (const GetRecordsFromCollectionRequest &request_, GetRecordsFromCollectionResponse< TResponse > &response_) const
 Retrieves records from a collection. More...
 
template<typename TResponse >
GetRecordsFromCollectionResponse< TResponse > getRecordsFromCollection (const std::string &tableName, const int64_t offset, const int64_t limit, const std::map< std::string, std::string > &options) const
 Retrieves records from a collection. More...
 
template<typename TResponse >
GetRecordsFromCollectionResponse< TResponse > & getRecordsFromCollection (const std::string &tableName, const int64_t offset, const int64_t limit, const std::map< std::string, std::string > &options, GetRecordsFromCollectionResponse< TResponse > &response_) const
 Retrieves records from a collection. More...
 
template<typename TResponse >
GetRecordsFromCollectionResponse< TResponse > getRecordsFromCollection (const ::avro::ValidSchema &schema_, const GetRecordsFromCollectionRequest &request_) const
 Retrieves records from a collection. More...
 
template<typename TResponse >
GetRecordsFromCollectionResponse< TResponse > getRecordsFromCollection (const Type &type_, const GetRecordsFromCollectionRequest &request_) const
 Retrieves records from a collection. More...
 
template<typename TResponse >
GetRecordsFromCollectionResponse< TResponse > & getRecordsFromCollection (const ::avro::ValidSchema &schema_, const GetRecordsFromCollectionRequest &request_, GetRecordsFromCollectionResponse< TResponse > &response_) const
 Retrieves records from a collection. More...
 
template<typename TResponse >
GetRecordsFromCollectionResponse< TResponse > & getRecordsFromCollection (const Type &type_, const GetRecordsFromCollectionRequest &request_, GetRecordsFromCollectionResponse< TResponse > &response_) const
 Retrieves records from a collection. More...
 
template<typename TResponse >
GetRecordsFromCollectionResponse< TResponse > getRecordsFromCollection (const ::avro::ValidSchema &schema_, const std::string &tableName, const int64_t offset, const int64_t limit, const std::map< std::string, std::string > &options) const
 Retrieves records from a collection. More...
 
template<typename TResponse >
GetRecordsFromCollectionResponse< TResponse > getRecordsFromCollection (const Type &type_, const std::string &tableName, const int64_t offset, const int64_t limit, const std::map< std::string, std::string > &options) const
 Retrieves records from a collection. More...
 
template<typename TResponse >
GetRecordsFromCollectionResponse< TResponse > & getRecordsFromCollection (const ::avro::ValidSchema &schema_, const std::string &tableName, const int64_t offset, const int64_t limit, const std::map< std::string, std::string > &options, GetRecordsFromCollectionResponse< TResponse > &response_) const
 Retrieves records from a collection. More...
 
template<typename TResponse >
GetRecordsFromCollectionResponse< TResponse > & getRecordsFromCollection (const Type &type_, const std::string &tableName, const int64_t offset, const int64_t limit, const std::map< std::string, std::string > &options, GetRecordsFromCollectionResponse< TResponse > &response_) const
 Retrieves records from a collection. More...
 
GrantPermissionResponse grantPermission (const GrantPermissionRequest &request_) const
 Grant user or role the specified permission on the specified object. More...
 
GrantPermissionResponsegrantPermission (const GrantPermissionRequest &request_, GrantPermissionResponse &response_) const
 Grant user or role the specified permission on the specified object. More...
 
GrantPermissionResponse grantPermission (const std::string &principal, const std::string &object, const std::string &objectType, const std::string &permission, const std::map< std::string, std::string > &options) const
 Grant user or role the specified permission on the specified object. More...
 
GrantPermissionResponsegrantPermission (const std::string &principal, const std::string &object, const std::string &objectType, const std::string &permission, const std::map< std::string, std::string > &options, GrantPermissionResponse &response_) const
 Grant user or role the specified permission on the specified object. More...
 
GrantPermissionCredentialResponse grantPermissionCredential (const GrantPermissionCredentialRequest &request_) const
 Grants a credential-level permission to a user or role. More...
 
GrantPermissionCredentialResponsegrantPermissionCredential (const GrantPermissionCredentialRequest &request_, GrantPermissionCredentialResponse &response_) const
 Grants a credential-level permission to a user or role. More...
 
GrantPermissionCredentialResponse grantPermissionCredential (const std::string &name, const std::string &permission, const std::string &credentialName, const std::map< std::string, std::string > &options) const
 Grants a credential-level permission to a user or role. More...
 
GrantPermissionCredentialResponsegrantPermissionCredential (const std::string &name, const std::string &permission, const std::string &credentialName, const std::map< std::string, std::string > &options, GrantPermissionCredentialResponse &response_) const
 Grants a credential-level permission to a user or role. More...
 
GrantPermissionDatasourceResponse grantPermissionDatasource (const GrantPermissionDatasourceRequest &request_) const
 Grants a data source permission to a user or role. More...
 
GrantPermissionDatasourceResponsegrantPermissionDatasource (const GrantPermissionDatasourceRequest &request_, GrantPermissionDatasourceResponse &response_) const
 Grants a data source permission to a user or role. More...
 
GrantPermissionDatasourceResponse grantPermissionDatasource (const std::string &name, const std::string &permission, const std::string &datasourceName, const std::map< std::string, std::string > &options) const
 Grants a data source permission to a user or role. More...
 
GrantPermissionDatasourceResponsegrantPermissionDatasource (const std::string &name, const std::string &permission, const std::string &datasourceName, const std::map< std::string, std::string > &options, GrantPermissionDatasourceResponse &response_) const
 Grants a data source permission to a user or role. More...
 
GrantPermissionDirectoryResponse grantPermissionDirectory (const GrantPermissionDirectoryRequest &request_) const
 Grants a KiFS directory-level permission to a user or role. More...
 
GrantPermissionDirectoryResponsegrantPermissionDirectory (const GrantPermissionDirectoryRequest &request_, GrantPermissionDirectoryResponse &response_) const
 Grants a KiFS directory-level permission to a user or role. More...
 
GrantPermissionDirectoryResponse grantPermissionDirectory (const std::string &name, const std::string &permission, const std::string &directoryName, const std::map< std::string, std::string > &options) const
 Grants a KiFS directory-level permission to a user or role. More...
 
GrantPermissionDirectoryResponsegrantPermissionDirectory (const std::string &name, const std::string &permission, const std::string &directoryName, const std::map< std::string, std::string > &options, GrantPermissionDirectoryResponse &response_) const
 Grants a KiFS directory-level permission to a user or role. More...
 
GrantPermissionProcResponse grantPermissionProc (const GrantPermissionProcRequest &request_) const
 Grants a proc-level permission to a user or role. More...
 
GrantPermissionProcResponsegrantPermissionProc (const GrantPermissionProcRequest &request_, GrantPermissionProcResponse &response_) const
 Grants a proc-level permission to a user or role. More...
 
GrantPermissionProcResponse grantPermissionProc (const std::string &name, const std::string &permission, const std::string &procName, const std::map< std::string, std::string > &options) const
 Grants a proc-level permission to a user or role. More...
 
GrantPermissionProcResponsegrantPermissionProc (const std::string &name, const std::string &permission, const std::string &procName, const std::map< std::string, std::string > &options, GrantPermissionProcResponse &response_) const
 Grants a proc-level permission to a user or role. More...
 
GrantPermissionSystemResponse grantPermissionSystem (const GrantPermissionSystemRequest &request_) const
 Grants a system-level permission to a user or role. More...
 
GrantPermissionSystemResponsegrantPermissionSystem (const GrantPermissionSystemRequest &request_, GrantPermissionSystemResponse &response_) const
 Grants a system-level permission to a user or role. More...
 
GrantPermissionSystemResponse grantPermissionSystem (const std::string &name, const std::string &permission, const std::map< std::string, std::string > &options) const
 Grants a system-level permission to a user or role. More...
 
GrantPermissionSystemResponsegrantPermissionSystem (const std::string &name, const std::string &permission, const std::map< std::string, std::string > &options, GrantPermissionSystemResponse &response_) const
 Grants a system-level permission to a user or role. More...
 
GrantPermissionTableResponse grantPermissionTable (const GrantPermissionTableRequest &request_) const
 Grants a table-level permission to a user or role. More...
 
GrantPermissionTableResponsegrantPermissionTable (const GrantPermissionTableRequest &request_, GrantPermissionTableResponse &response_) const
 Grants a table-level permission to a user or role. More...
 
GrantPermissionTableResponse grantPermissionTable (const std::string &name, const std::string &permission, const std::string &tableName, const std::string &filterExpression, const std::map< std::string, std::string > &options) const
 Grants a table-level permission to a user or role. More...
 
GrantPermissionTableResponsegrantPermissionTable (const std::string &name, const std::string &permission, const std::string &tableName, const std::string &filterExpression, const std::map< std::string, std::string > &options, GrantPermissionTableResponse &response_) const
 Grants a table-level permission to a user or role. More...
 
GrantRoleResponse grantRole (const GrantRoleRequest &request_) const
 Grants membership in a role to a user or role. More...
 
GrantRoleResponsegrantRole (const GrantRoleRequest &request_, GrantRoleResponse &response_) const
 Grants membership in a role to a user or role. More...
 
GrantRoleResponse grantRole (const std::string &role, const std::string &member, const std::map< std::string, std::string > &options) const
 Grants membership in a role to a user or role. More...
 
GrantRoleResponsegrantRole (const std::string &role, const std::string &member, const std::map< std::string, std::string > &options, GrantRoleResponse &response_) const
 Grants membership in a role to a user or role. More...
 
HasPermissionResponse hasPermission (const HasPermissionRequest &request_) const
 Checks if the specified user has the specified permission on the specified object. More...
 
HasPermissionResponsehasPermission (const HasPermissionRequest &request_, HasPermissionResponse &response_) const
 Checks if the specified user has the specified permission on the specified object. More...
 
HasPermissionResponse hasPermission (const std::string &principal, const std::string &object, const std::string &objectType, const std::string &permission, const std::map< std::string, std::string > &options) const
 Checks if the specified user has the specified permission on the specified object. More...
 
HasPermissionResponsehasPermission (const std::string &principal, const std::string &object, const std::string &objectType, const std::string &permission, const std::map< std::string, std::string > &options, HasPermissionResponse &response_) const
 Checks if the specified user has the specified permission on the specified object. More...
 
HasProcResponse hasProc (const HasProcRequest &request_) const
 Checks the existence of a proc with the given name. More...
 
HasProcResponsehasProc (const HasProcRequest &request_, HasProcResponse &response_) const
 Checks the existence of a proc with the given name. More...
 
HasProcResponse hasProc (const std::string &procName, const std::map< std::string, std::string > &options) const
 Checks the existence of a proc with the given name. More...
 
HasProcResponsehasProc (const std::string &procName, const std::map< std::string, std::string > &options, HasProcResponse &response_) const
 Checks the existence of a proc with the given name. More...
 
HasRoleResponse hasRole (const HasRoleRequest &request_) const
 Checks if the specified user has the specified role. More...
 
HasRoleResponsehasRole (const HasRoleRequest &request_, HasRoleResponse &response_) const
 Checks if the specified user has the specified role. More...
 
HasRoleResponse hasRole (const std::string &principal, const std::string &role, const std::map< std::string, std::string > &options) const
 Checks if the specified user has the specified role. More...
 
HasRoleResponsehasRole (const std::string &principal, const std::string &role, const std::map< std::string, std::string > &options, HasRoleResponse &response_) const
 Checks if the specified user has the specified role. More...
 
HasSchemaResponse hasSchema (const HasSchemaRequest &request_) const
 Checks for the existence of a schema with the given name. More...
 
HasSchemaResponsehasSchema (const HasSchemaRequest &request_, HasSchemaResponse &response_) const
 Checks for the existence of a schema with the given name. More...
 
HasSchemaResponse hasSchema (const std::string &schemaName, const std::map< std::string, std::string > &options) const
 Checks for the existence of a schema with the given name. More...
 
HasSchemaResponsehasSchema (const std::string &schemaName, const std::map< std::string, std::string > &options, HasSchemaResponse &response_) const
 Checks for the existence of a schema with the given name. More...
 
HasTableResponse hasTable (const HasTableRequest &request_) const
 Checks for the existence of a table with the given name. More...
 
HasTableResponsehasTable (const HasTableRequest &request_, HasTableResponse &response_) const
 Checks for the existence of a table with the given name. More...
 
HasTableResponse hasTable (const std::string &tableName, const std::map< std::string, std::string > &options) const
 Checks for the existence of a table with the given name. More...
 
HasTableResponsehasTable (const std::string &tableName, const std::map< std::string, std::string > &options, HasTableResponse &response_) const
 Checks for the existence of a table with the given name. More...
 
HasTypeResponse hasType (const HasTypeRequest &request_) const
 Check for the existence of a type. More...
 
HasTypeResponsehasType (const HasTypeRequest &request_, HasTypeResponse &response_) const
 Check for the existence of a type. More...
 
HasTypeResponse hasType (const std::string &typeId, const std::map< std::string, std::string > &options) const
 Check for the existence of a type. More...
 
HasTypeResponsehasType (const std::string &typeId, const std::map< std::string, std::string > &options, HasTypeResponse &response_) const
 Check for the existence of a type. More...
 
InsertRecordsResponse insertRecordsRaw (const RawInsertRecordsRequest &request_) const
 Adds multiple records to the specified table. More...
 
InsertRecordsResponseinsertRecordsRaw (const RawInsertRecordsRequest &request_, InsertRecordsResponse &response_) const
 Adds multiple records to the specified table. More...
 
template<typename TRequest >
InsertRecordsResponse insertRecords (const InsertRecordsRequest< TRequest > &request_) const
 Adds multiple records to the specified table. More...
 
template<typename TRequest >
InsertRecordsResponseinsertRecords (const InsertRecordsRequest< TRequest > &request_, InsertRecordsResponse &response_) const
 Adds multiple records to the specified table. More...
 
template<typename TRequest >
InsertRecordsResponse insertRecords (const std::string &tableName, const std::vector< TRequest > &data, const std::map< std::string, std::string > &options) const
 Adds multiple records to the specified table. More...
 
template<typename TRequest >
InsertRecordsResponseinsertRecords (const std::string &tableName, const std::vector< TRequest > &data, const std::map< std::string, std::string > &options, InsertRecordsResponse &response_) const
 Adds multiple records to the specified table. More...
 
InsertRecordsFromFilesResponse insertRecordsFromFiles (const InsertRecordsFromFilesRequest &request_) const
 Reads from one or more files and inserts the data into a new or existing table. More...
 
InsertRecordsFromFilesResponseinsertRecordsFromFiles (const InsertRecordsFromFilesRequest &request_, InsertRecordsFromFilesResponse &response_) const
 Reads from one or more files and inserts the data into a new or existing table. More...
 
InsertRecordsFromFilesResponse insertRecordsFromFiles (const std::string &tableName, const std::vector< std::string > &filepaths, const std::map< std::string, std::map< std::string, std::string > > &modifyColumns, const std::map< std::string, std::string > &createTableOptions, const std::map< std::string, std::string > &options) const
 Reads from one or more files and inserts the data into a new or existing table. More...
 
InsertRecordsFromFilesResponseinsertRecordsFromFiles (const std::string &tableName, const std::vector< std::string > &filepaths, const std::map< std::string, std::map< std::string, std::string > > &modifyColumns, const std::map< std::string, std::string > &createTableOptions, const std::map< std::string, std::string > &options, InsertRecordsFromFilesResponse &response_) const
 Reads from one or more files and inserts the data into a new or existing table. More...
 
InsertRecordsFromPayloadResponse insertRecordsFromPayload (const InsertRecordsFromPayloadRequest &request_) const
 Reads from the given text-based or binary payload and inserts the data into a new or existing table. More...
 
InsertRecordsFromPayloadResponseinsertRecordsFromPayload (const InsertRecordsFromPayloadRequest &request_, InsertRecordsFromPayloadResponse &response_) const
 Reads from the given text-based or binary payload and inserts the data into a new or existing table. More...
 
InsertRecordsFromPayloadResponse insertRecordsFromPayload (const std::string &tableName, const std::string &dataText, const std::vector< uint8_t > &dataBytes, const std::map< std::string, std::map< std::string, std::string > > &modifyColumns, const std::map< std::string, std::string > &createTableOptions, const std::map< std::string, std::string > &options) const
 Reads from the given text-based or binary payload and inserts the data into a new or existing table. More...
 
InsertRecordsFromPayloadResponseinsertRecordsFromPayload (const std::string &tableName, const std::string &dataText, const std::vector< uint8_t > &dataBytes, const std::map< std::string, std::map< std::string, std::string > > &modifyColumns, const std::map< std::string, std::string > &createTableOptions, const std::map< std::string, std::string > &options, InsertRecordsFromPayloadResponse &response_) const
 Reads from the given text-based or binary payload and inserts the data into a new or existing table. More...
 
InsertRecordsFromQueryResponse insertRecordsFromQuery (const InsertRecordsFromQueryRequest &request_) const
 Computes remote query result and inserts the result data into a new or existing table. More...
 
InsertRecordsFromQueryResponseinsertRecordsFromQuery (const InsertRecordsFromQueryRequest &request_, InsertRecordsFromQueryResponse &response_) const
 Computes remote query result and inserts the result data into a new or existing table. More...
 
InsertRecordsFromQueryResponse insertRecordsFromQuery (const std::string &tableName, const std::string &remoteQuery, const std::map< std::string, std::map< std::string, std::string > > &modifyColumns, const std::map< std::string, std::string > &createTableOptions, const std::map< std::string, std::string > &options) const
 Computes remote query result and inserts the result data into a new or existing table. More...
 
InsertRecordsFromQueryResponseinsertRecordsFromQuery (const std::string &tableName, const std::string &remoteQuery, const std::map< std::string, std::map< std::string, std::string > > &modifyColumns, const std::map< std::string, std::string > &createTableOptions, const std::map< std::string, std::string > &options, InsertRecordsFromQueryResponse &response_) const
 Computes remote query result and inserts the result data into a new or existing table. More...
 
InsertRecordsRandomResponse insertRecordsRandom (const InsertRecordsRandomRequest &request_) const
 Generates a specified number of random records and adds them to the given table. More...
 
InsertRecordsRandomResponseinsertRecordsRandom (const InsertRecordsRandomRequest &request_, InsertRecordsRandomResponse &response_) const
 Generates a specified number of random records and adds them to the given table. More...
 
InsertRecordsRandomResponse insertRecordsRandom (const std::string &tableName, const int64_t count, const std::map< std::string, std::map< std::string, double > > &options) const
 Generates a specified number of random records and adds them to the given table. More...
 
InsertRecordsRandomResponseinsertRecordsRandom (const std::string &tableName, const int64_t count, const std::map< std::string, std::map< std::string, double > > &options, InsertRecordsRandomResponse &response_) const
 Generates a specified number of random records and adds them to the given table. More...
 
InsertSymbolResponse insertSymbol (const InsertSymbolRequest &request_) const
 Adds a symbol or icon (i.e. an image) to represent data points when data is rendered visually. More...
 
InsertSymbolResponseinsertSymbol (const InsertSymbolRequest &request_, InsertSymbolResponse &response_) const
 Adds a symbol or icon (i.e. an image) to represent data points when data is rendered visually. More...
 
InsertSymbolResponse insertSymbol (const std::string &symbolId, const std::string &symbolFormat, const std::vector< uint8_t > &symbolData, const std::map< std::string, std::string > &options) const
 Adds a symbol or icon (i.e. an image) to represent data points when data is rendered visually. More...
 
InsertSymbolResponseinsertSymbol (const std::string &symbolId, const std::string &symbolFormat, const std::vector< uint8_t > &symbolData, const std::map< std::string, std::string > &options, InsertSymbolResponse &response_) const
 Adds a symbol or icon (i.e. an image) to represent data points when data is rendered visually. More...
 
KillProcResponse killProc (const KillProcRequest &request_) const
 Kills a running proc instance. More...
 
KillProcResponsekillProc (const KillProcRequest &request_, KillProcResponse &response_) const
 Kills a running proc instance. More...
 
KillProcResponse killProc (const std::string &runId, const std::map< std::string, std::string > &options) const
 Kills a running proc instance. More...
 
KillProcResponsekillProc (const std::string &runId, const std::map< std::string, std::string > &options, KillProcResponse &response_) const
 Kills a running proc instance. More...
 
LockTableResponse lockTable (const LockTableRequest &request_) const
 Manages global access to a table's data. More...
 
LockTableResponselockTable (const LockTableRequest &request_, LockTableResponse &response_) const
 Manages global access to a table's data. More...
 
LockTableResponse lockTable (const std::string &tableName, const std::string &lockType, const std::map< std::string, std::string > &options) const
 Manages global access to a table's data. More...
 
LockTableResponselockTable (const std::string &tableName, const std::string &lockType, const std::map< std::string, std::string > &options, LockTableResponse &response_) const
 Manages global access to a table's data. More...
 
MatchGraphResponse matchGraph (const MatchGraphRequest &request_) const
 Matches a directed route implied by a given set of latitude/longitude points to an existing underlying road network graph using a given solution type. More...
 
MatchGraphResponsematchGraph (const MatchGraphRequest &request_, MatchGraphResponse &response_) const
 Matches a directed route implied by a given set of latitude/longitude points to an existing underlying road network graph using a given solution type. More...
 
MatchGraphResponse matchGraph (const std::string &graphName, const std::vector< std::string > &samplePoints, const std::string &solveMethod, const std::string &solutionTable, const std::map< std::string, std::string > &options) const
 Matches a directed route implied by a given set of latitude/longitude points to an existing underlying road network graph using a given solution type. More...
 
MatchGraphResponsematchGraph (const std::string &graphName, const std::vector< std::string > &samplePoints, const std::string &solveMethod, const std::string &solutionTable, const std::map< std::string, std::string > &options, MatchGraphResponse &response_) const
 Matches a directed route implied by a given set of latitude/longitude points to an existing underlying road network graph using a given solution type. More...
 
MergeRecordsResponse mergeRecords (const MergeRecordsRequest &request_) const
 Create a new empty result table (specified by tableName), and insert all records from source tables (specified by sourceTableNames) based on the field mapping information (specified by fieldMaps). More...
 
MergeRecordsResponsemergeRecords (const MergeRecordsRequest &request_, MergeRecordsResponse &response_) const
 Create a new empty result table (specified by tableName), and insert all records from source tables (specified by sourceTableNames) based on the field mapping information (specified by fieldMaps). More...
 
MergeRecordsResponse mergeRecords (const std::string &tableName, const std::vector< std::string > &sourceTableNames, const std::vector< std::map< std::string, std::string > > &fieldMaps, const std::map< std::string, std::string > &options) const
 Create a new empty result table (specified by tableName), and insert all records from source tables (specified by sourceTableNames) based on the field mapping information (specified by fieldMaps). More...
 
MergeRecordsResponsemergeRecords (const std::string &tableName, const std::vector< std::string > &sourceTableNames, const std::vector< std::map< std::string, std::string > > &fieldMaps, const std::map< std::string, std::string > &options, MergeRecordsResponse &response_) const
 Create a new empty result table (specified by tableName), and insert all records from source tables (specified by sourceTableNames) based on the field mapping information (specified by fieldMaps). More...
 
ModifyGraphResponse modifyGraph (const ModifyGraphRequest &request_) const
 Update an existing graph network using given nodes, edges, weights, restrictions, and options. More...
 
ModifyGraphResponsemodifyGraph (const ModifyGraphRequest &request_, ModifyGraphResponse &response_) const
 Update an existing graph network using given nodes, edges, weights, restrictions, and options. More...
 
ModifyGraphResponse modifyGraph (const std::string &graphName, const std::vector< std::string > &nodes, const std::vector< std::string > &edges, const std::vector< std::string > &weights, const std::vector< std::string > &restrictions, const std::map< std::string, std::string > &options) const
 Update an existing graph network using given nodes, edges, weights, restrictions, and options. More...
 
ModifyGraphResponsemodifyGraph (const std::string &graphName, const std::vector< std::string > &nodes, const std::vector< std::string > &edges, const std::vector< std::string > &weights, const std::vector< std::string > &restrictions, const std::map< std::string, std::string > &options, ModifyGraphResponse &response_) const
 Update an existing graph network using given nodes, edges, weights, restrictions, and options. More...
 
QueryGraphResponse queryGraph (const QueryGraphRequest &request_) const
 Employs a topological query on a graph generated a-priori by createGraph and returns a list of adjacent edge(s) or node(s), also known as an adjacency list, depending on what's been provided to the endpoint; providing edges will return nodes and providing nodes will return edges. More...
 
QueryGraphResponsequeryGraph (const QueryGraphRequest &request_, QueryGraphResponse &response_) const
 Employs a topological query on a graph generated a-priori by createGraph and returns a list of adjacent edge(s) or node(s), also known as an adjacency list, depending on what's been provided to the endpoint; providing edges will return nodes and providing nodes will return edges. More...
 
QueryGraphResponse queryGraph (const std::string &graphName, const std::vector< std::string > &queries, const std::vector< std::string > &restrictions, const std::string &adjacencyTable, const int32_t rings, const std::map< std::string, std::string > &options) const
 Employs a topological query on a graph generated a-priori by createGraph and returns a list of adjacent edge(s) or node(s), also known as an adjacency list, depending on what's been provided to the endpoint; providing edges will return nodes and providing nodes will return edges. More...
 
QueryGraphResponsequeryGraph (const std::string &graphName, const std::vector< std::string > &queries, const std::vector< std::string > &restrictions, const std::string &adjacencyTable, const int32_t rings, const std::map< std::string, std::string > &options, QueryGraphResponse &response_) const
 Employs a topological query on a graph generated a-priori by createGraph and returns a list of adjacent edge(s) or node(s), also known as an adjacency list, depending on what's been provided to the endpoint; providing edges will return nodes and providing nodes will return edges. More...
 
RepartitionGraphResponse repartitionGraph (const RepartitionGraphRequest &request_) const
 Rebalances an existing partitioned graph. More...
 
RepartitionGraphResponserepartitionGraph (const RepartitionGraphRequest &request_, RepartitionGraphResponse &response_) const
 Rebalances an existing partitioned graph. More...
 
RepartitionGraphResponse repartitionGraph (const std::string &graphName, const std::map< std::string, std::string > &options) const
 Rebalances an existing partitioned graph. More...
 
RepartitionGraphResponserepartitionGraph (const std::string &graphName, const std::map< std::string, std::string > &options, RepartitionGraphResponse &response_) const
 Rebalances an existing partitioned graph. More...
 
RevokePermissionResponse revokePermission (const RevokePermissionRequest &request_) const
 Revoke user or role the specified permission on the specified object. More...
 
RevokePermissionResponserevokePermission (const RevokePermissionRequest &request_, RevokePermissionResponse &response_) const
 Revoke user or role the specified permission on the specified object. More...
 
RevokePermissionResponse revokePermission (const std::string &principal, const std::string &object, const std::string &objectType, const std::string &permission, const std::map< std::string, std::string > &options) const
 Revoke user or role the specified permission on the specified object. More...
 
RevokePermissionResponserevokePermission (const std::string &principal, const std::string &object, const std::string &objectType, const std::string &permission, const std::map< std::string, std::string > &options, RevokePermissionResponse &response_) const
 Revoke user or role the specified permission on the specified object. More...
 
RevokePermissionCredentialResponse revokePermissionCredential (const RevokePermissionCredentialRequest &request_) const
 Revokes a credential-level permission from a user or role. More...
 
RevokePermissionCredentialResponserevokePermissionCredential (const RevokePermissionCredentialRequest &request_, RevokePermissionCredentialResponse &response_) const
 Revokes a credential-level permission from a user or role. More...
 
RevokePermissionCredentialResponse revokePermissionCredential (const std::string &name, const std::string &permission, const std::string &credentialName, const std::map< std::string, std::string > &options) const
 Revokes a credential-level permission from a user or role. More...
 
RevokePermissionCredentialResponserevokePermissionCredential (const std::string &name, const std::string &permission, const std::string &credentialName, const std::map< std::string, std::string > &options, RevokePermissionCredentialResponse &response_) const
 Revokes a credential-level permission from a user or role. More...
 
RevokePermissionDatasourceResponse revokePermissionDatasource (const RevokePermissionDatasourceRequest &request_) const
 Revokes a data source permission from a user or role. More...
 
RevokePermissionDatasourceResponserevokePermissionDatasource (const RevokePermissionDatasourceRequest &request_, RevokePermissionDatasourceResponse &response_) const
 Revokes a data source permission from a user or role. More...
 
RevokePermissionDatasourceResponse revokePermissionDatasource (const std::string &name, const std::string &permission, const std::string &datasourceName, const std::map< std::string, std::string > &options) const
 Revokes a data source permission from a user or role. More...
 
RevokePermissionDatasourceResponserevokePermissionDatasource (const std::string &name, const std::string &permission, const std::string &datasourceName, const std::map< std::string, std::string > &options, RevokePermissionDatasourceResponse &response_) const
 Revokes a data source permission from a user or role. More...
 
RevokePermissionDirectoryResponse revokePermissionDirectory (const RevokePermissionDirectoryRequest &request_) const
 Revokes a KiFS directory-level permission from a user or role. More...
 
RevokePermissionDirectoryResponserevokePermissionDirectory (const RevokePermissionDirectoryRequest &request_, RevokePermissionDirectoryResponse &response_) const
 Revokes a KiFS directory-level permission from a user or role. More...
 
RevokePermissionDirectoryResponse revokePermissionDirectory (const std::string &name, const std::string &permission, const std::string &directoryName, const std::map< std::string, std::string > &options) const
 Revokes a KiFS directory-level permission from a user or role. More...
 
RevokePermissionDirectoryResponserevokePermissionDirectory (const std::string &name, const std::string &permission, const std::string &directoryName, const std::map< std::string, std::string > &options, RevokePermissionDirectoryResponse &response_) const
 Revokes a KiFS directory-level permission from a user or role. More...
 
RevokePermissionProcResponse revokePermissionProc (const RevokePermissionProcRequest &request_) const
 Revokes a proc-level permission from a user or role. More...
 
RevokePermissionProcResponserevokePermissionProc (const RevokePermissionProcRequest &request_, RevokePermissionProcResponse &response_) const
 Revokes a proc-level permission from a user or role. More...
 
RevokePermissionProcResponse revokePermissionProc (const std::string &name, const std::string &permission, const std::string &procName, const std::map< std::string, std::string > &options) const
 Revokes a proc-level permission from a user or role. More...
 
RevokePermissionProcResponserevokePermissionProc (const std::string &name, const std::string &permission, const std::string &procName, const std::map< std::string, std::string > &options, RevokePermissionProcResponse &response_) const
 Revokes a proc-level permission from a user or role. More...
 
RevokePermissionSystemResponse revokePermissionSystem (const RevokePermissionSystemRequest &request_) const
 Revokes a system-level permission from a user or role. More...
 
RevokePermissionSystemResponserevokePermissionSystem (const RevokePermissionSystemRequest &request_, RevokePermissionSystemResponse &response_) const
 Revokes a system-level permission from a user or role. More...
 
RevokePermissionSystemResponse revokePermissionSystem (const std::string &name, const std::string &permission, const std::map< std::string, std::string > &options) const
 Revokes a system-level permission from a user or role. More...
 
RevokePermissionSystemResponserevokePermissionSystem (const std::string &name, const std::string &permission, const std::map< std::string, std::string > &options, RevokePermissionSystemResponse &response_) const
 Revokes a system-level permission from a user or role. More...
 
RevokePermissionTableResponse revokePermissionTable (const RevokePermissionTableRequest &request_) const
 Revokes a table-level permission from a user or role. More...
 
RevokePermissionTableResponserevokePermissionTable (const RevokePermissionTableRequest &request_, RevokePermissionTableResponse &response_) const
 Revokes a table-level permission from a user or role. More...
 
RevokePermissionTableResponse revokePermissionTable (const std::string &name, const std::string &permission, const std::string &tableName, const std::map< std::string, std::string > &options) const
 Revokes a table-level permission from a user or role. More...
 
RevokePermissionTableResponserevokePermissionTable (const std::string &name, const std::string &permission, const std::string &tableName, const std::map< std::string, std::string > &options, RevokePermissionTableResponse &response_) const
 Revokes a table-level permission from a user or role. More...
 
RevokeRoleResponse revokeRole (const RevokeRoleRequest &request_) const
 Revokes membership in a role from a user or role. More...
 
RevokeRoleResponserevokeRole (const RevokeRoleRequest &request_, RevokeRoleResponse &response_) const
 Revokes membership in a role from a user or role. More...
 
RevokeRoleResponse revokeRole (const std::string &role, const std::string &member, const std::map< std::string, std::string > &options) const
 Revokes membership in a role from a user or role. More...
 
RevokeRoleResponserevokeRole (const std::string &role, const std::string &member, const std::map< std::string, std::string > &options, RevokeRoleResponse &response_) const
 Revokes membership in a role from a user or role. More...
 
ShowCredentialResponse showCredential (const ShowCredentialRequest &request_) const
 Shows information about a specified credential or all credentials. More...
 
ShowCredentialResponseshowCredential (const ShowCredentialRequest &request_, ShowCredentialResponse &response_) const
 Shows information about a specified credential or all credentials. More...
 
ShowCredentialResponse showCredential (const std::string &credentialName, const std::map< std::string, std::string > &options) const
 Shows information about a specified credential or all credentials. More...
 
ShowCredentialResponseshowCredential (const std::string &credentialName, const std::map< std::string, std::string > &options, ShowCredentialResponse &response_) const
 Shows information about a specified credential or all credentials. More...
 
ShowDatasinkResponse showDatasink (const ShowDatasinkRequest &request_) const
 Shows information about a specified data sink or all data sinks. More...
 
ShowDatasinkResponseshowDatasink (const ShowDatasinkRequest &request_, ShowDatasinkResponse &response_) const
 Shows information about a specified data sink or all data sinks. More...
 
ShowDatasinkResponse showDatasink (const std::string &name, const std::map< std::string, std::string > &options) const
 Shows information about a specified data sink or all data sinks. More...
 
ShowDatasinkResponseshowDatasink (const std::string &name, const std::map< std::string, std::string > &options, ShowDatasinkResponse &response_) const
 Shows information about a specified data sink or all data sinks. More...
 
ShowDatasourceResponse showDatasource (const ShowDatasourceRequest &request_) const
 Shows information about a specified data source or all data sources. More...
 
ShowDatasourceResponseshowDatasource (const ShowDatasourceRequest &request_, ShowDatasourceResponse &response_) const
 Shows information about a specified data source or all data sources. More...
 
ShowDatasourceResponse showDatasource (const std::string &name, const std::map< std::string, std::string > &options) const
 Shows information about a specified data source or all data sources. More...
 
ShowDatasourceResponseshowDatasource (const std::string &name, const std::map< std::string, std::string > &options, ShowDatasourceResponse &response_) const
 Shows information about a specified data source or all data sources. More...
 
ShowDirectoriesResponse showDirectories (const ShowDirectoriesRequest &request_) const
 Shows information about directories in KiFS. More...
 
ShowDirectoriesResponseshowDirectories (const ShowDirectoriesRequest &request_, ShowDirectoriesResponse &response_) const
 Shows information about directories in KiFS. More...
 
ShowDirectoriesResponse showDirectories (const std::string &directoryName, const std::map< std::string, std::string > &options) const
 Shows information about directories in KiFS. More...
 
ShowDirectoriesResponseshowDirectories (const std::string &directoryName, const std::map< std::string, std::string > &options, ShowDirectoriesResponse &response_) const
 Shows information about directories in KiFS. More...
 
ShowEnvironmentResponse showEnvironment (const ShowEnvironmentRequest &request_) const
 Shows information about a specified user-defined function (UDF) environment or all environments. More...
 
ShowEnvironmentResponseshowEnvironment (const ShowEnvironmentRequest &request_, ShowEnvironmentResponse &response_) const
 Shows information about a specified user-defined function (UDF) environment or all environments. More...
 
ShowEnvironmentResponse showEnvironment (const std::string &environmentName, const std::map< std::string, std::string > &options) const
 Shows information about a specified user-defined function (UDF) environment or all environments. More...
 
ShowEnvironmentResponseshowEnvironment (const std::string &environmentName, const std::map< std::string, std::string > &options, ShowEnvironmentResponse &response_) const
 Shows information about a specified user-defined function (UDF) environment or all environments. More...
 
ShowFilesResponse showFiles (const ShowFilesRequest &request_) const
 Shows information about files in KiFS. More...
 
ShowFilesResponseshowFiles (const ShowFilesRequest &request_, ShowFilesResponse &response_) const
 Shows information about files in KiFS. More...
 
ShowFilesResponse showFiles (const std::vector< std::string > &paths, const std::map< std::string, std::string > &options) const
 Shows information about files in KiFS. More...
 
ShowFilesResponseshowFiles (const std::vector< std::string > &paths, const std::map< std::string, std::string > &options, ShowFilesResponse &response_) const
 Shows information about files in KiFS. More...
 
ShowGraphResponse showGraph (const ShowGraphRequest &request_) const
 Shows information and characteristics of graphs that exist on the graph server. More...
 
ShowGraphResponseshowGraph (const ShowGraphRequest &request_, ShowGraphResponse &response_) const
 Shows information and characteristics of graphs that exist on the graph server. More...
 
ShowGraphResponse showGraph (const std::string &graphName, const std::map< std::string, std::string > &options) const
 Shows information and characteristics of graphs that exist on the graph server. More...
 
ShowGraphResponseshowGraph (const std::string &graphName, const std::map< std::string, std::string > &options, ShowGraphResponse &response_) const
 Shows information and characteristics of graphs that exist on the graph server. More...
 
ShowProcResponse showProc (const ShowProcRequest &request_) const
 Shows information about a proc. More...
 
ShowProcResponseshowProc (const ShowProcRequest &request_, ShowProcResponse &response_) const
 Shows information about a proc. More...
 
ShowProcResponse showProc (const std::string &procName, const std::map< std::string, std::string > &options) const
 Shows information about a proc. More...
 
ShowProcResponseshowProc (const std::string &procName, const std::map< std::string, std::string > &options, ShowProcResponse &response_) const
 Shows information about a proc. More...
 
ShowProcStatusResponse showProcStatus (const ShowProcStatusRequest &request_) const
 Shows the statuses of running or completed proc instances. More...
 
ShowProcStatusResponseshowProcStatus (const ShowProcStatusRequest &request_, ShowProcStatusResponse &response_) const
 Shows the statuses of running or completed proc instances. More...
 
ShowProcStatusResponse showProcStatus (const std::string &runId, const std::map< std::string, std::string > &options) const
 Shows the statuses of running or completed proc instances. More...
 
ShowProcStatusResponseshowProcStatus (const std::string &runId, const std::map< std::string, std::string > &options, ShowProcStatusResponse &response_) const
 Shows the statuses of running or completed proc instances. More...
 
ShowResourceObjectsResponse showResourceObjects (const ShowResourceObjectsRequest &request_) const
 Returns information about the internal sub-components (tiered objects) which use resources of the system. More...
 
ShowResourceObjectsResponseshowResourceObjects (const ShowResourceObjectsRequest &request_, ShowResourceObjectsResponse &response_) const
 Returns information about the internal sub-components (tiered objects) which use resources of the system. More...
 
ShowResourceObjectsResponse showResourceObjects (const std::map< std::string, std::string > &options) const
 Returns information about the internal sub-components (tiered objects) which use resources of the system. More...
 
ShowResourceObjectsResponseshowResourceObjects (const std::map< std::string, std::string > &options, ShowResourceObjectsResponse &response_) const
 Returns information about the internal sub-components (tiered objects) which use resources of the system. More...
 
ShowResourceStatisticsResponse showResourceStatistics (const ShowResourceStatisticsRequest &request_) const
 Requests various statistics for storage/memory tiers and resource groups. More...
 
ShowResourceStatisticsResponseshowResourceStatistics (const ShowResourceStatisticsRequest &request_, ShowResourceStatisticsResponse &response_) const
 Requests various statistics for storage/memory tiers and resource groups. More...
 
ShowResourceStatisticsResponse showResourceStatistics (const std::map< std::string, std::string > &options) const
 Requests various statistics for storage/memory tiers and resource groups. More...
 
ShowResourceStatisticsResponseshowResourceStatistics (const std::map< std::string, std::string > &options, ShowResourceStatisticsResponse &response_) const
 Requests various statistics for storage/memory tiers and resource groups. More...
 
ShowResourceGroupsResponse showResourceGroups (const ShowResourceGroupsRequest &request_) const
 Requests resource group properties. More...
 
ShowResourceGroupsResponseshowResourceGroups (const ShowResourceGroupsRequest &request_, ShowResourceGroupsResponse &response_) const
 Requests resource group properties. More...
 
ShowResourceGroupsResponse showResourceGroups (const std::vector< std::string > &names, const std::map< std::string, std::string > &options) const
 Requests resource group properties. More...
 
ShowResourceGroupsResponseshowResourceGroups (const std::vector< std::string > &names, const std::map< std::string, std::string > &options, ShowResourceGroupsResponse &response_) const
 Requests resource group properties. More...
 
ShowSchemaResponse showSchema (const ShowSchemaRequest &request_) const
 Retrieves information about a schema (or all schemas), as specified in schemaName. More...
 
ShowSchemaResponseshowSchema (const ShowSchemaRequest &request_, ShowSchemaResponse &response_) const
 Retrieves information about a schema (or all schemas), as specified in schemaName. More...
 
ShowSchemaResponse showSchema (const std::string &schemaName, const std::map< std::string, std::string > &options) const
 Retrieves information about a schema (or all schemas), as specified in schemaName. More...
 
ShowSchemaResponseshowSchema (const std::string &schemaName, const std::map< std::string, std::string > &options, ShowSchemaResponse &response_) const
 Retrieves information about a schema (or all schemas), as specified in schemaName. More...
 
ShowSecurityResponse showSecurity (const ShowSecurityRequest &request_) const
 Shows security information relating to users and/or roles. More...
 
ShowSecurityResponseshowSecurity (const ShowSecurityRequest &request_, ShowSecurityResponse &response_) const
 Shows security information relating to users and/or roles. More...
 
ShowSecurityResponse showSecurity (const std::vector< std::string > &names, const std::map< std::string, std::string > &options) const
 Shows security information relating to users and/or roles. More...
 
ShowSecurityResponseshowSecurity (const std::vector< std::string > &names, const std::map< std::string, std::string > &options, ShowSecurityResponse &response_) const
 Shows security information relating to users and/or roles. More...
 
ShowSqlProcResponse showSqlProc (const ShowSqlProcRequest &request_) const
 Shows information about SQL procedures, including the full definition of each requested procedure. More...
 
ShowSqlProcResponseshowSqlProc (const ShowSqlProcRequest &request_, ShowSqlProcResponse &response_) const
 Shows information about SQL procedures, including the full definition of each requested procedure. More...
 
ShowSqlProcResponse showSqlProc (const std::string &procedureName, const std::map< std::string, std::string > &options) const
 Shows information about SQL procedures, including the full definition of each requested procedure. More...
 
ShowSqlProcResponseshowSqlProc (const std::string &procedureName, const std::map< std::string, std::string > &options, ShowSqlProcResponse &response_) const
 Shows information about SQL procedures, including the full definition of each requested procedure. More...
 
ShowStatisticsResponse showStatistics (const ShowStatisticsRequest &request_) const
 Retrieves the collected column statistics for the specified table(s). More...
 
ShowStatisticsResponseshowStatistics (const ShowStatisticsRequest &request_, ShowStatisticsResponse &response_) const
 Retrieves the collected column statistics for the specified table(s). More...
 
ShowStatisticsResponse showStatistics (const std::vector< std::string > &tableNames, const std::map< std::string, std::string > &options) const
 Retrieves the collected column statistics for the specified table(s). More...
 
ShowStatisticsResponseshowStatistics (const std::vector< std::string > &tableNames, const std::map< std::string, std::string > &options, ShowStatisticsResponse &response_) const
 Retrieves the collected column statistics for the specified table(s). More...
 
ShowSystemPropertiesResponse showSystemProperties (const ShowSystemPropertiesRequest &request_) const
 Returns server configuration and version related information to the caller. More...
 
ShowSystemPropertiesResponseshowSystemProperties (const ShowSystemPropertiesRequest &request_, ShowSystemPropertiesResponse &response_) const
 Returns server configuration and version related information to the caller. More...
 
ShowSystemPropertiesResponse showSystemProperties (const std::map< std::string, std::string > &options) const
 Returns server configuration and version related information to the caller. More...
 
ShowSystemPropertiesResponseshowSystemProperties (const std::map< std::string, std::string > &options, ShowSystemPropertiesResponse &response_) const
 Returns server configuration and version related information to the caller. More...
 
ShowSystemStatusResponse showSystemStatus (const ShowSystemStatusRequest &request_) const
 Provides server configuration and health related status to the caller. More...
 
ShowSystemStatusResponseshowSystemStatus (const ShowSystemStatusRequest &request_, ShowSystemStatusResponse &response_) const
 Provides server configuration and health related status to the caller. More...
 
ShowSystemStatusResponse showSystemStatus (const std::map< std::string, std::string > &options) const
 Provides server configuration and health related status to the caller. More...
 
ShowSystemStatusResponseshowSystemStatus (const std::map< std::string, std::string > &options, ShowSystemStatusResponse &response_) const
 Provides server configuration and health related status to the caller. More...
 
ShowSystemTimingResponse showSystemTiming (const ShowSystemTimingRequest &request_) const
 Returns the last 100 database requests along with the request timing and internal job id. More...
 
ShowSystemTimingResponseshowSystemTiming (const ShowSystemTimingRequest &request_, ShowSystemTimingResponse &response_) const
 Returns the last 100 database requests along with the request timing and internal job id. More...
 
ShowSystemTimingResponse showSystemTiming (const std::map< std::string, std::string > &options) const
 Returns the last 100 database requests along with the request timing and internal job id. More...
 
ShowSystemTimingResponseshowSystemTiming (const std::map< std::string, std::string > &options, ShowSystemTimingResponse &response_) const
 Returns the last 100 database requests along with the request timing and internal job id. More...
 
ShowTableResponse showTable (const ShowTableRequest &request_) const
 Retrieves detailed information about a table, view, or schema, specified in tableName. More...
 
ShowTableResponseshowTable (const ShowTableRequest &request_, ShowTableResponse &response_) const
 Retrieves detailed information about a table, view, or schema, specified in tableName. More...
 
ShowTableResponse showTable (const std::string &tableName, const std::map< std::string, std::string > &options) const
 Retrieves detailed information about a table, view, or schema, specified in tableName. More...
 
ShowTableResponseshowTable (const std::string &tableName, const std::map< std::string, std::string > &options, ShowTableResponse &response_) const
 Retrieves detailed information about a table, view, or schema, specified in tableName. More...
 
ShowTableMetadataResponse showTableMetadata (const ShowTableMetadataRequest &request_) const
 Retrieves the user provided metadata for the specified tables. More...
 
ShowTableMetadataResponseshowTableMetadata (const ShowTableMetadataRequest &request_, ShowTableMetadataResponse &response_) const
 Retrieves the user provided metadata for the specified tables. More...
 
ShowTableMetadataResponse showTableMetadata (const std::vector< std::string > &tableNames, const std::map< std::string, std::string > &options) const
 Retrieves the user provided metadata for the specified tables. More...
 
ShowTableMetadataResponseshowTableMetadata (const std::vector< std::string > &tableNames, const std::map< std::string, std::string > &options, ShowTableMetadataResponse &response_) const
 Retrieves the user provided metadata for the specified tables. More...
 
ShowTableMonitorsResponse showTableMonitors (const ShowTableMonitorsRequest &request_) const
 Show table monitors and their properties. More...
 
ShowTableMonitorsResponseshowTableMonitors (const ShowTableMonitorsRequest &request_, ShowTableMonitorsResponse &response_) const
 Show table monitors and their properties. More...
 
ShowTableMonitorsResponse showTableMonitors (const std::vector< std::string > &monitorIds, const std::map< std::string, std::string > &options) const
 Show table monitors and their properties. More...
 
ShowTableMonitorsResponseshowTableMonitors (const std::vector< std::string > &monitorIds, const std::map< std::string, std::string > &options, ShowTableMonitorsResponse &response_) const
 Show table monitors and their properties. More...
 
ShowTablesByTypeResponse showTablesByType (const ShowTablesByTypeRequest &request_) const
 Gets names of the tables whose type matches the given criteria. More...
 
ShowTablesByTypeResponseshowTablesByType (const ShowTablesByTypeRequest &request_, ShowTablesByTypeResponse &response_) const
 Gets names of the tables whose type matches the given criteria. More...
 
ShowTablesByTypeResponse showTablesByType (const std::string &typeId, const std::string &label, const std::map< std::string, std::string > &options) const
 Gets names of the tables whose type matches the given criteria. More...
 
ShowTablesByTypeResponseshowTablesByType (const std::string &typeId, const std::string &label, const std::map< std::string, std::string > &options, ShowTablesByTypeResponse &response_) const
 Gets names of the tables whose type matches the given criteria. More...
 
ShowTriggersResponse showTriggers (const ShowTriggersRequest &request_) const
 Retrieves information regarding the specified triggers or all existing triggers currently active. More...
 
ShowTriggersResponseshowTriggers (const ShowTriggersRequest &request_, ShowTriggersResponse &response_) const
 Retrieves information regarding the specified triggers or all existing triggers currently active. More...
 
ShowTriggersResponse showTriggers (const std::vector< std::string > &triggerIds, const std::map< std::string, std::string > &options) const
 Retrieves information regarding the specified triggers or all existing triggers currently active. More...
 
ShowTriggersResponseshowTriggers (const std::vector< std::string > &triggerIds, const std::map< std::string, std::string > &options, ShowTriggersResponse &response_) const
 Retrieves information regarding the specified triggers or all existing triggers currently active. More...
 
ShowTypesResponse showTypes (const ShowTypesRequest &request_) const
 Retrieves information for the specified data type ID or type label. More...
 
ShowTypesResponseshowTypes (const ShowTypesRequest &request_, ShowTypesResponse &response_) const
 Retrieves information for the specified data type ID or type label. More...
 
ShowTypesResponse showTypes (const std::string &typeId, const std::string &label, const std::map< std::string, std::string > &options) const
 Retrieves information for the specified data type ID or type label. More...
 
ShowTypesResponseshowTypes (const std::string &typeId, const std::string &label, const std::map< std::string, std::string > &options, ShowTypesResponse &response_) const
 Retrieves information for the specified data type ID or type label. More...
 
ShowVideoResponse showVideo (const ShowVideoRequest &request_) const
 Retrieves information about rendered videos. More...
 
ShowVideoResponseshowVideo (const ShowVideoRequest &request_, ShowVideoResponse &response_) const
 Retrieves information about rendered videos. More...
 
ShowVideoResponse showVideo (const std::vector< std::string > &paths, const std::map< std::string, std::string > &options) const
 Retrieves information about rendered videos. More...
 
ShowVideoResponseshowVideo (const std::vector< std::string > &paths, const std::map< std::string, std::string > &options, ShowVideoResponse &response_) const
 Retrieves information about rendered videos. More...
 
ShowWalResponse showWal (const ShowWalRequest &request_) const
 Requests table wal properties. More...
 
ShowWalResponseshowWal (const ShowWalRequest &request_, ShowWalResponse &response_) const
 Requests table wal properties. More...
 
ShowWalResponse showWal (const std::vector< std::string > &tableNames, const std::map< std::string, std::string > &options) const
 Requests table wal properties. More...
 
ShowWalResponseshowWal (const std::vector< std::string > &tableNames, const std::map< std::string, std::string > &options, ShowWalResponse &response_) const
 Requests table wal properties. More...
 
SolveGraphResponse solveGraph (const SolveGraphRequest &request_) const
 Solves an existing graph for a type of problem (e.g., shortest path, page rank, travelling salesman, etc.) using source nodes, destination nodes, and additional, optional weights and restrictions. More...
 
SolveGraphResponsesolveGraph (const SolveGraphRequest &request_, SolveGraphResponse &response_) const
 Solves an existing graph for a type of problem (e.g., shortest path, page rank, travelling salesman, etc.) using source nodes, destination nodes, and additional, optional weights and restrictions. More...
 
SolveGraphResponse solveGraph (const std::string &graphName, const std::vector< std::string > &weightsOnEdges, const std::vector< std::string > &restrictions, const std::string &solverType, const std::vector< std::string > &sourceNodes, const std::vector< std::string > &destinationNodes, const std::string &solutionTable, const std::map< std::string, std::string > &options) const
 Solves an existing graph for a type of problem (e.g., shortest path, page rank, travelling salesman, etc.) using source nodes, destination nodes, and additional, optional weights and restrictions. More...
 
SolveGraphResponsesolveGraph (const std::string &graphName, const std::vector< std::string > &weightsOnEdges, const std::vector< std::string > &restrictions, const std::string &solverType, const std::vector< std::string > &sourceNodes, const std::vector< std::string > &destinationNodes, const std::string &solutionTable, const std::map< std::string, std::string > &options, SolveGraphResponse &response_) const
 Solves an existing graph for a type of problem (e.g., shortest path, page rank, travelling salesman, etc.) using source nodes, destination nodes, and additional, optional weights and restrictions. More...
 
UpdateRecordsResponse updateRecordsRaw (const RawUpdateRecordsRequest &request_) const
 Runs multiple predicate-based updates in a single call. More...
 
UpdateRecordsResponseupdateRecordsRaw (const RawUpdateRecordsRequest &request_, UpdateRecordsResponse &response_) const
 Runs multiple predicate-based updates in a single call. More...
 
template<typename TRequest >
UpdateRecordsResponse updateRecords (const UpdateRecordsRequest< TRequest > &request_) const
 Runs multiple predicate-based updates in a single call. More...
 
template<typename TRequest >
UpdateRecordsResponseupdateRecords (const UpdateRecordsRequest< TRequest > &request_, UpdateRecordsResponse &response_) const
 Runs multiple predicate-based updates in a single call. More...
 
template<typename TRequest >
UpdateRecordsResponse updateRecords (const std::string &tableName, const std::vector< std::string > &expressions, const std::vector< std::map< std::string, boost::optional< std::string > > > &newValuesMaps, const std::vector< TRequest > &data, const std::map< std::string, std::string > &options) const
 Runs multiple predicate-based updates in a single call. More...
 
template<typename TRequest >
UpdateRecordsResponseupdateRecords (const std::string &tableName, const std::vector< std::string > &expressions, const std::vector< std::map< std::string, boost::optional< std::string > > > &newValuesMaps, const std::vector< TRequest > &data, const std::map< std::string, std::string > &options, UpdateRecordsResponse &response_) const
 Runs multiple predicate-based updates in a single call. More...
 
UpdateRecordsBySeriesResponse updateRecordsBySeries (const UpdateRecordsBySeriesRequest &request_) const
 Updates the view specified by tableName to include full series (track) information from the worldTableName for the series (tracks) present in the viewName. More...
 
UpdateRecordsBySeriesResponseupdateRecordsBySeries (const UpdateRecordsBySeriesRequest &request_, UpdateRecordsBySeriesResponse &response_) const
 Updates the view specified by tableName to include full series (track) information from the worldTableName for the series (tracks) present in the viewName. More...
 
UpdateRecordsBySeriesResponse updateRecordsBySeries (const std::string &tableName, const std::string &worldTableName, const std::string &viewName, const std::vector< std::string > &reserved, const std::map< std::string, std::string > &options) const
 Updates the view specified by tableName to include full series (track) information from the worldTableName for the series (tracks) present in the viewName. More...
 
UpdateRecordsBySeriesResponseupdateRecordsBySeries (const std::string &tableName, const std::string &worldTableName, const std::string &viewName, const std::vector< std::string > &reserved, const std::map< std::string, std::string > &options, UpdateRecordsBySeriesResponse &response_) const
 Updates the view specified by tableName to include full series (track) information from the worldTableName for the series (tracks) present in the viewName. More...
 
UploadFilesResponse uploadFiles (const UploadFilesRequest &request_) const
 Uploads one or more files to KiFS. More...
 
UploadFilesResponseuploadFiles (const UploadFilesRequest &request_, UploadFilesResponse &response_) const
 Uploads one or more files to KiFS. More...
 
UploadFilesResponse uploadFiles (const std::vector< std::string > &fileNames, const std::vector< std::vector< uint8_t > > &fileData, const std::map< std::string, std::string > &options) const
 Uploads one or more files to KiFS. More...
 
UploadFilesResponseuploadFiles (const std::vector< std::string > &fileNames, const std::vector< std::vector< uint8_t > > &fileData, const std::map< std::string, std::string > &options, UploadFilesResponse &response_) const
 Uploads one or more files to KiFS. More...
 
UploadFilesFromurlResponse uploadFilesFromurl (const UploadFilesFromurlRequest &request_) const
 Uploads one or more files to KiFS. More...
 
UploadFilesFromurlResponseuploadFilesFromurl (const UploadFilesFromurlRequest &request_, UploadFilesFromurlResponse &response_) const
 Uploads one or more files to KiFS. More...
 
UploadFilesFromurlResponse uploadFilesFromurl (const std::vector< std::string > &fileNames, const std::vector< std::string > &urls, const std::map< std::string, std::string > &options) const
 Uploads one or more files to KiFS. More...
 
UploadFilesFromurlResponseuploadFilesFromurl (const std::vector< std::string > &fileNames, const std::vector< std::string > &urls, const std::map< std::string, std::string > &options, UploadFilesFromurlResponse &response_) const
 Uploads one or more files to KiFS. More...
 
VisualizeImageChartResponse visualizeImageChart (const VisualizeImageChartRequest &request_) const
 Scatter plot is the only plot type currently supported. More...
 
VisualizeImageChartResponsevisualizeImageChart (const VisualizeImageChartRequest &request_, VisualizeImageChartResponse &response_) const
 Scatter plot is the only plot type currently supported. More...
 
VisualizeImageChartResponse visualizeImageChart (const std::string &tableName, const std::vector< std::string > &xColumnNames, const std::vector< std::string > &yColumnNames, const double minX, const double maxX, const double minY, const double maxY, const int32_t width, const int32_t height, const std::string &bgColor, const std::map< std::string, std::vector< std::string > > &styleOptions, const std::map< std::string, std::string > &options) const
 Scatter plot is the only plot type currently supported. More...
 
VisualizeImageChartResponsevisualizeImageChart (const std::string &tableName, const std::vector< std::string > &xColumnNames, const std::vector< std::string > &yColumnNames, const double minX, const double maxX, const double minY, const double maxY, const int32_t width, const int32_t height, const std::string &bgColor, const std::map< std::string, std::vector< std::string > > &styleOptions, const std::map< std::string, std::string > &options, VisualizeImageChartResponse &response_) const
 Scatter plot is the only plot type currently supported. More...
 
VisualizeIsochroneResponse visualizeIsochrone (const VisualizeIsochroneRequest &request_) const
 Generate an image containing isolines for travel results using an existing graph. More...
 
VisualizeIsochroneResponsevisualizeIsochrone (const VisualizeIsochroneRequest &request_, VisualizeIsochroneResponse &response_) const
 Generate an image containing isolines for travel results using an existing graph. More...
 
VisualizeIsochroneResponse visualizeIsochrone (const std::string &graphName, const std::string &sourceNode, const double maxSolutionRadius, const std::vector< std::string > &weightsOnEdges, const std::vector< std::string > &restrictions, const int32_t numLevels, const bool generateImage, const std::string &levelsTable, const std::map< std::string, std::string > &styleOptions, const std::map< std::string, std::string > &solveOptions, const std::map< std::string, std::string > &contourOptions, const std::map< std::string, std::string > &options) const
 Generate an image containing isolines for travel results using an existing graph. More...
 
VisualizeIsochroneResponsevisualizeIsochrone (const std::string &graphName, const std::string &sourceNode, const double maxSolutionRadius, const std::vector< std::string > &weightsOnEdges, const std::vector< std::string > &restrictions, const int32_t numLevels, const bool generateImage, const std::string &levelsTable, const std::map< std::string, std::string > &styleOptions, const std::map< std::string, std::string > &solveOptions, const std::map< std::string, std::string > &contourOptions, const std::map< std::string, std::string > &options, VisualizeIsochroneResponse &response_) const
 Generate an image containing isolines for travel results using an existing graph. More...
 
void addKnownType (const std::string &typeId, const avro::DecoderPtr &decoder)
 
template<typename T >
void addKnownType (const std::string &typeId)
 
template<typename T >
void addKnownType (const std::string &typeId, const std::string &schemaString)
 
template<typename T >
void addKnownType (const std::string &typeId, const ::avro::ValidSchema &schema)
 
void addKnownTypeFromTable (const std::string &tableName, const avro::DecoderPtr &decoder)
 
template<typename T >
void addKnownTypeFromTable (const std::string &tableName)
 
template<typename T >
void addKnownTypeFromTable (const std::string &tableName, const std::string &schemaString)
 
template<typename T >
void addKnownTypeFromTable (const std::string &tableName, const ::avro::ValidSchema &schema)
 
template<>
GetRecordsResponse< boost::any > getRecords (const GetRecordsRequest &request_) const
 Retrieves records from a given table, optionally filtered by an expression and/or sorted by a column. More...
 
template<>
GetRecordsResponse< boost::any > & getRecords (const GetRecordsRequest &request_, GetRecordsResponse< boost::any > &response_) const
 Retrieves records from a given table, optionally filtered by an expression and/or sorted by a column. More...
 
template<>
GetRecordsResponse< boost::any > getRecords (const std::string &tableName, const int64_t offset, const int64_t limit, const std::map< std::string, std::string > &options) const
 Retrieves records from a given table, optionally filtered by an expression and/or sorted by a column. More...
 
template<>
GetRecordsResponse< boost::any > & getRecords (const std::string &tableName, const int64_t offset, const int64_t limit, const std::map< std::string, std::string > &options, GetRecordsResponse< boost::any > &response_) const
 Retrieves records from a given table, optionally filtered by an expression and/or sorted by a column. More...
 
template<>
GetRecordsBySeriesResponse< boost::any > getRecordsBySeries (const GetRecordsBySeriesRequest &request_) const
 Retrieves the complete series/track records from the given worldTableName based on the partial track information contained in the tableName. More...
 
template<>
GetRecordsBySeriesResponse< boost::any > & getRecordsBySeries (const GetRecordsBySeriesRequest &request_, GetRecordsBySeriesResponse< boost::any > &response_) const
 Retrieves the complete series/track records from the given worldTableName based on the partial track information contained in the tableName. More...
 
template<>
GetRecordsBySeriesResponse< boost::any > getRecordsBySeries (const std::string &tableName, const std::string &worldTableName, const int32_t offset, const int32_t limit, const std::map< std::string, std::string > &options) const
 Retrieves the complete series/track records from the given worldTableName based on the partial track information contained in the tableName. More...
 
template<>
GetRecordsBySeriesResponse< boost::any > & getRecordsBySeries (const std::string &tableName, const std::string &worldTableName, const int32_t offset, const int32_t limit, const std::map< std::string, std::string > &options, GetRecordsBySeriesResponse< boost::any > &response_) const
 Retrieves the complete series/track records from the given worldTableName based on the partial track information contained in the tableName. More...
 
template<>
GetRecordsFromCollectionResponse< boost::any > getRecordsFromCollection (const GetRecordsFromCollectionRequest &request_) const
 Retrieves records from a collection. More...
 
template<>
GetRecordsFromCollectionResponse< boost::any > & getRecordsFromCollection (const GetRecordsFromCollectionRequest &request_, GetRecordsFromCollectionResponse< boost::any > &response_) const
 Retrieves records from a collection. More...
 
template<>
GetRecordsFromCollectionResponse< boost::any > getRecordsFromCollection (const std::string &tableName, const int64_t offset, const int64_t limit, const std::map< std::string, std::string > &options) const
 Retrieves records from a collection. More...
 
template<>
GetRecordsFromCollectionResponse< boost::any > & getRecordsFromCollection (const std::string &tableName, const int64_t offset, const int64_t limit, const std::map< std::string, std::string > &options, GetRecordsFromCollectionResponse< boost::any > &response_) const
 Retrieves records from a collection. More...
 
template<>
GetRecordsResponse< boost::any > getRecords (const GetRecordsRequest &request_) const
 Retrieves records from a given table, optionally filtered by an expression and/or sorted by a column. More...
 
template<>
GetRecordsResponse< boost::any > & getRecords (const GetRecordsRequest &request_, GetRecordsResponse< boost::any > &response_) const
 Retrieves records from a given table, optionally filtered by an expression and/or sorted by a column. More...
 
template<>
GetRecordsResponse< boost::any > getRecords (const std::string &tableName, const int64_t offset, const int64_t limit, const std::map< std::string, std::string > &options) const
 Retrieves records from a given table, optionally filtered by an expression and/or sorted by a column. More...
 
template<>
GetRecordsResponse< boost::any > & getRecords (const std::string &tableName, const int64_t offset, const int64_t limit, const std::map< std::string, std::string > &options, GetRecordsResponse< boost::any > &response_) const
 Retrieves records from a given table, optionally filtered by an expression and/or sorted by a column. More...
 
template<>
GetRecordsBySeriesResponse< boost::any > getRecordsBySeries (const GetRecordsBySeriesRequest &request_) const
 Retrieves the complete series/track records from the given worldTableName based on the partial track information contained in the tableName. More...
 
template<>
GetRecordsBySeriesResponse< boost::any > & getRecordsBySeries (const GetRecordsBySeriesRequest &request_, GetRecordsBySeriesResponse< boost::any > &response_) const
 Retrieves the complete series/track records from the given worldTableName based on the partial track information contained in the tableName. More...
 
template<>
GetRecordsBySeriesResponse< boost::any > getRecordsBySeries (const std::string &tableName, const std::string &worldTableName, const int32_t offset, const int32_t limit, const std::map< std::string, std::string > &options) const
 Retrieves the complete series/track records from the given worldTableName based on the partial track information contained in the tableName. More...
 
template<>
GetRecordsBySeriesResponse< boost::any > & getRecordsBySeries (const std::string &tableName, const std::string &worldTableName, const int32_t offset, const int32_t limit, const std::map< std::string, std::string > &options, GetRecordsBySeriesResponse< boost::any > &response_) const
 Retrieves the complete series/track records from the given worldTableName based on the partial track information contained in the tableName. More...
 
template<>
GetRecordsFromCollectionResponse< boost::any > getRecordsFromCollection (const GetRecordsFromCollectionRequest &request_) const
 Retrieves records from a collection. More...
 
template<>
GetRecordsFromCollectionResponse< boost::any > & getRecordsFromCollection (const GetRecordsFromCollectionRequest &request_, GetRecordsFromCollectionResponse< boost::any > &response_) const
 Retrieves records from a collection. More...
 
template<>
GetRecordsFromCollectionResponse< boost::any > getRecordsFromCollection (const std::string &tableName, const int64_t offset, const int64_t limit, const std::map< std::string, std::string > &options) const
 Retrieves records from a collection. More...
 
template<>
GetRecordsFromCollectionResponse< boost::any > & getRecordsFromCollection (const std::string &tableName, const int64_t offset, const int64_t limit, const std::map< std::string, std::string > &options, GetRecordsFromCollectionResponse< boost::any > &response_) const
 Retrieves records from a collection. More...
 

Static Public Member Functions

static std::string getApiVersion ()
 

Static Public Attributes

static const int64_t END_OF_SET = -9999
 
static const std::string DB_CONNECTION_RESET_ERROR_MESSAGE
 Special error messages indicating that a connection failure happened (generally should trigger a high-availability failover if applicable) More...
 
static const std::string DB_CONNECTION_REFUSED_ERROR_MESSAGE
 
static const std::string DB_EXITING_ERROR_MESSAGE
 
static const std::string DB_OFFLINE_ERROR_MESSAGE
 
static const std::string DB_SYSTEM_LIMITED_ERROR_MESSAGE
 
static const std::string DB_HM_OFFLINE_ERROR_MESSAGE
 
static const std::string HEADER_AUTHORIZATION
 Headers used internally; MUST add each of them to PROTECTED_HEADERS in the .cpp file. More...
 
static const std::string HEADER_CONTENT_TYPE
 
static const std::string HEADER_CONTENT_LENGTH
 
static const std::string HEADER_HA_SYNC_MODE
 

Detailed Description

Definition at line 58 of file GPUdb.hpp.

Member Enumeration Documentation

◆ HASynchronicityMode

A enumeration of high-availability synchronicity override modes.

See also
setHASyncMode
Enumerator
DEFAULT 

No override; defer to the HA process for synchronizing endpoints (which has different logic for different endpoints)

NONE 

Explicitly do NOT replicate across the HA cluster.

SYNCHRONOUS 

Synchronize all endpoint calls.

SYNCHRONOUS_PARALLEL 

Sends a http request directly to each cluster, executes the query locally, and waits for the response from each cluster.

ASYNCHRONOUS 

Do NOT synchronize any endpoint call.

ASYNCHRONOUS_PARALLEL 

Queues a request to RMQ for each cluster, executes the query locally, and returns to the user.

Definition at line 139 of file GPUdb.hpp.

Constructor & Destructor Documentation

◆ GPUdb() [1/4]

gpudb::GPUdb::GPUdb ( const HttpUrl url,
const Options options = Options() 
)

Pass a single HttpURL and options to instantiate a GPUdb object.

Parameters
[in]urlAn HttpURL object containing the single host URL for the client. If no primary URL is specified via the options, the given URL will be used as the primary URL.
[in]optionsAn optional GPUdb::Options object containing options, e.g. primary cluster URL, used to the create the GPUdb object.

◆ GPUdb() [2/4]

gpudb::GPUdb::GPUdb ( const std::string &  url,
const Options options = Options() 
)

Pass a single or multiple, comma-separated URLs as a string and optional options to instantiate a GPUdb object.

Parameters
[in]urlAn std::string containing the one host URL or a comma-separated string with multiple host URLs for the client. For example 'http://172.42.40.1:9191,,http://172.42.40.2:9191'. If a single URL is given, and no primary URL is specified via the options, the given URL will be used as the primary URL.
[in]optionsAn optional GPUdb::Options object containing options, e.g. primary cluster URL, used to the create the GPUdb object.

◆ GPUdb() [3/4]

gpudb::GPUdb::GPUdb ( const std::vector< HttpUrl > &  urls,
const Options options = Options() 
)

Pass multiple HttpURLs and optional options to instantiate a GPUdb object.

Parameters
[in]urlsThe host URLs for the client. If a single URL is given, and no primary URL is specified via the options, the given URL will be used as the primary URL.
[in]optionsAn optional GPUdb::Options object containing options, e.g. primary cluster URL, used to the create the GPUdb object.

◆ GPUdb() [4/4]

gpudb::GPUdb::GPUdb ( const std::vector< std::string > &  urls,
const Options options = Options() 
)

Pass multiple strings, each containing a single URL, and optional options to instantiate a GPUdb object.

Parameters
[in]urlsThe host URLs for the client. Each string must contain a single valid URL. If a single URL is given, and no primary URL is specified via the options, the given URL will be used as the primary URL.
[in]optionsAn optional GPUdb::Options object containing options, e.g. primary cluster URL, used to the create the GPUdb object.

◆ ~GPUdb()

gpudb::GPUdb::~GPUdb ( )

Destructor.

Member Function Documentation

◆ addHttpHeader()

void gpudb::GPUdb::addHttpHeader ( const std::string &  header,
const std::string &  value 
)

Adds an HTTP header to the map of additional HTTP headers to send to GPUdb with each request.

If the header is already in the map, its value is replaced with the specified value. The user is not allowed to modify the following headers:

  • Authorization
  • Content-type
  • Content-length
  • ha_sync_mode
Parameters
headerthe HTTP header
valuethe value of the HTTP header

See getHttpHeaders() See removeHttpHeader(const std::string&)

◆ addKnownType() [1/4]

void gpudb::GPUdb::addKnownType ( const std::string &  typeId,
const avro::DecoderPtr &  decoder 
)

◆ addKnownType() [2/4]

template<typename T >
void gpudb::GPUdb::addKnownType ( const std::string &  typeId)
inline

Definition at line 520 of file GPUdb.hpp.

◆ addKnownType() [3/4]

template<typename T >
void gpudb::GPUdb::addKnownType ( const std::string &  typeId,
const std::string &  schemaString 
)
inline

Definition at line 526 of file GPUdb.hpp.

◆ addKnownType() [4/4]

template<typename T >
void gpudb::GPUdb::addKnownType ( const std::string &  typeId,
const ::avro::ValidSchema &  schema 
)
inline

Definition at line 532 of file GPUdb.hpp.

◆ addKnownTypeFromTable() [1/4]

void gpudb::GPUdb::addKnownTypeFromTable ( const std::string &  tableName,
const avro::DecoderPtr &  decoder 
)

◆ addKnownTypeFromTable() [2/4]

template<typename T >
void gpudb::GPUdb::addKnownTypeFromTable ( const std::string &  tableName)
inline

Definition at line 540 of file GPUdb.hpp.

◆ addKnownTypeFromTable() [3/4]

template<typename T >
void gpudb::GPUdb::addKnownTypeFromTable ( const std::string &  tableName,
const std::string &  schemaString 
)
inline

Definition at line 546 of file GPUdb.hpp.

◆ addKnownTypeFromTable() [4/4]

template<typename T >
void gpudb::GPUdb::addKnownTypeFromTable ( const std::string &  tableName,
const ::avro::ValidSchema &  schema 
)
inline

Definition at line 552 of file GPUdb.hpp.

◆ adminAddHost() [1/4]

AdminAddHostResponse gpudb::GPUdb::adminAddHost ( const AdminAddHostRequest request_) const

Adds a host to an existing cluster.

Attention
This method should be used for on-premise deployments only.
Parameters
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

◆ adminAddHost() [2/4]

AdminAddHostResponse& gpudb::GPUdb::adminAddHost ( const AdminAddHostRequest request_,
AdminAddHostResponse response_ 
) const

Adds a host to an existing cluster.

Attention
This method should be used for on-premise deployments only.
Parameters
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ adminAddHost() [3/4]

AdminAddHostResponse gpudb::GPUdb::adminAddHost ( const std::string &  hostAddress,
const std::map< std::string, std::string > &  options 
) const

Adds a host to an existing cluster.

Attention
This method should be used for on-premise deployments only.
Parameters
[in]hostAddressIP address of the host that will be added to the cluster. This host must have installed the same version of Kinetica as the cluster to which it is being added.
[in]optionsOptional parameters. The default value is an empty map.
Returns
Response object containing the result of the operation.

◆ adminAddHost() [4/4]

AdminAddHostResponse& gpudb::GPUdb::adminAddHost ( const std::string &  hostAddress,
const std::map< std::string, std::string > &  options,
AdminAddHostResponse response_ 
) const

Adds a host to an existing cluster.

Attention
This method should be used for on-premise deployments only.
Parameters
[in]hostAddressIP address of the host that will be added to the cluster. This host must have installed the same version of Kinetica as the cluster to which it is being added.
[in]optionsOptional parameters. The default value is an empty map.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ adminAddRanks() [1/4]

AdminAddRanksResponse gpudb::GPUdb::adminAddRanks ( const AdminAddRanksRequest request_) const

Add one or more ranks to an existing Kinetica cluster.

The new ranks will not contain any data initially (other than replicated tables) and will not be assigned any shards. To rebalance data and shards across the cluster, use adminRebalance.

The database must be offline for this operation, see adminOffline

For example, if attempting to add three new ranks (two ranks on host 172.123.45.67 and one rank on host 172.123.45.68) to a Kinetica cluster with additional configuration parameters:

  • hosts would be an array including 172.123.45.67 in the first two indices (signifying two ranks being added to host 172.123.45.67) and 172.123.45.68 in the last index (signifying one rank being added to host 172.123.45.67)
  • configParams would be an array of maps, with each map corresponding to the ranks being added in hosts. The key of each map would be the configuration parameter name and the value would be the parameter's value, e.g. '{"rank.gpu":"1"}'

This endpoint's processing includes copying all replicated table data to the new rank(s) and therefore could take a long time. The API call may time out if run directly. It is recommended to run this endpoint asynchronously via createJob.

Attention
This method should be used for on-premise deployments only.
Parameters
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

◆ adminAddRanks() [2/4]

AdminAddRanksResponse& gpudb::GPUdb::adminAddRanks ( const AdminAddRanksRequest request_,
AdminAddRanksResponse response_ 
) const

Add one or more ranks to an existing Kinetica cluster.

The new ranks will not contain any data initially (other than replicated tables) and will not be assigned any shards. To rebalance data and shards across the cluster, use adminRebalance.

The database must be offline for this operation, see adminOffline

For example, if attempting to add three new ranks (two ranks on host 172.123.45.67 and one rank on host 172.123.45.68) to a Kinetica cluster with additional configuration parameters:

  • hosts would be an array including 172.123.45.67 in the first two indices (signifying two ranks being added to host 172.123.45.67) and 172.123.45.68 in the last index (signifying one rank being added to host 172.123.45.67)
  • configParams would be an array of maps, with each map corresponding to the ranks being added in hosts. The key of each map would be the configuration parameter name and the value would be the parameter's value, e.g. '{"rank.gpu":"1"}'

This endpoint's processing includes copying all replicated table data to the new rank(s) and therefore could take a long time. The API call may time out if run directly. It is recommended to run this endpoint asynchronously via createJob.

Attention
This method should be used for on-premise deployments only.
Parameters
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ adminAddRanks() [3/4]

AdminAddRanksResponse gpudb::GPUdb::adminAddRanks ( const std::vector< std::string > &  hosts,
const std::vector< std::map< std::string, std::string > > &  configParams,
const std::map< std::string, std::string > &  options 
) const

Add one or more ranks to an existing Kinetica cluster.

The new ranks will not contain any data initially (other than replicated tables) and will not be assigned any shards. To rebalance data and shards across the cluster, use adminRebalance.

The database must be offline for this operation, see adminOffline

For example, if attempting to add three new ranks (two ranks on host 172.123.45.67 and one rank on host 172.123.45.68) to a Kinetica cluster with additional configuration parameters:

  • hosts would be an array including 172.123.45.67 in the first two indices (signifying two ranks being added to host 172.123.45.67) and 172.123.45.68 in the last index (signifying one rank being added to host 172.123.45.67)
  • configParams would be an array of maps, with each map corresponding to the ranks being added in hosts. The key of each map would be the configuration parameter name and the value would be the parameter's value, e.g. '{"rank.gpu":"1"}'

This endpoint's processing includes copying all replicated table data to the new rank(s) and therefore could take a long time. The API call may time out if run directly. It is recommended to run this endpoint asynchronously via createJob.

Attention
This method should be used for on-premise deployments only.
Parameters
[in]hostsArray of host IP addresses (matching a hostN.address from the gpudb.conf file), or host identifiers (e.g. 'host0' from the gpudb.conf file), on which to add ranks to the cluster. The hosts must already be in the cluster. If needed beforehand, to add a new host to the cluster use adminAddHost. Include the same entry as many times as there are ranks to add to the cluster, e.g., if two ranks on host 172.123.45.67 should be added, hosts could look like '["172.123.45.67", "172.123.45.67"]'. All ranks will be added simultaneously, i.e. they're not added in the order of this array. Each entry in this array corresponds to the entry at the same index in the configParams.
[in]configParamsArray of maps containing configuration parameters to apply to the new ranks found in hosts. For example, '{"rank.gpu":"2", "tier.ram.rank.limit":"10000000000"}'. Currently, the available parameters are rank-specific parameters in the Network, Hardware, Text Search, and RAM Tiered Storage sections in the gpudb.conf file, with the key exception of the 'rankN.host' settings in the Network section that will be determined by hosts instead. Though many of these configuration parameters typically are affixed with 'rankN' in the gpudb.conf file (where N is the rank number), the 'N' should be omitted in configParams as the new rank number(s) are not allocated until the ranks have been added to the cluster. Each entry in this array corresponds to the entry at the same index in the hosts. This array must either be completely empty or have the same number of elements as the hosts. An empty configParams array will result in the new ranks being set with default parameters.
[in]optionsOptional parameters. The default value is an empty map.
Returns
Response object containing the result of the operation.

◆ adminAddRanks() [4/4]

AdminAddRanksResponse& gpudb::GPUdb::adminAddRanks ( const std::vector< std::string > &  hosts,
const std::vector< std::map< std::string, std::string > > &  configParams,
const std::map< std::string, std::string > &  options,
AdminAddRanksResponse response_ 
) const

Add one or more ranks to an existing Kinetica cluster.

The new ranks will not contain any data initially (other than replicated tables) and will not be assigned any shards. To rebalance data and shards across the cluster, use adminRebalance.

The database must be offline for this operation, see adminOffline

For example, if attempting to add three new ranks (two ranks on host 172.123.45.67 and one rank on host 172.123.45.68) to a Kinetica cluster with additional configuration parameters:

  • hosts would be an array including 172.123.45.67 in the first two indices (signifying two ranks being added to host 172.123.45.67) and 172.123.45.68 in the last index (signifying one rank being added to host 172.123.45.67)
  • configParams would be an array of maps, with each map corresponding to the ranks being added in hosts. The key of each map would be the configuration parameter name and the value would be the parameter's value, e.g. '{"rank.gpu":"1"}'

This endpoint's processing includes copying all replicated table data to the new rank(s) and therefore could take a long time. The API call may time out if run directly. It is recommended to run this endpoint asynchronously via createJob.

Attention
This method should be used for on-premise deployments only.
Parameters
[in]hostsArray of host IP addresses (matching a hostN.address from the gpudb.conf file), or host identifiers (e.g. 'host0' from the gpudb.conf file), on which to add ranks to the cluster. The hosts must already be in the cluster. If needed beforehand, to add a new host to the cluster use adminAddHost. Include the same entry as many times as there are ranks to add to the cluster, e.g., if two ranks on host 172.123.45.67 should be added, hosts could look like '["172.123.45.67", "172.123.45.67"]'. All ranks will be added simultaneously, i.e. they're not added in the order of this array. Each entry in this array corresponds to the entry at the same index in the configParams.
[in]configParamsArray of maps containing configuration parameters to apply to the new ranks found in hosts. For example, '{"rank.gpu":"2", "tier.ram.rank.limit":"10000000000"}'. Currently, the available parameters are rank-specific parameters in the Network, Hardware, Text Search, and RAM Tiered Storage sections in the gpudb.conf file, with the key exception of the 'rankN.host' settings in the Network section that will be determined by hosts instead. Though many of these configuration parameters typically are affixed with 'rankN' in the gpudb.conf file (where N is the rank number), the 'N' should be omitted in configParams as the new rank number(s) are not allocated until the ranks have been added to the cluster. Each entry in this array corresponds to the entry at the same index in the hosts. This array must either be completely empty or have the same number of elements as the hosts. An empty configParams array will result in the new ranks being set with default parameters.
[in]optionsOptional parameters. The default value is an empty map.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ adminAlterHost() [1/4]

AdminAlterHostResponse gpudb::GPUdb::adminAlterHost ( const AdminAlterHostRequest request_) const

Alter properties on an existing host in the cluster.

Currently, the only property that can be altered is a hosts ability to accept failover processes.

Parameters
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

◆ adminAlterHost() [2/4]

AdminAlterHostResponse& gpudb::GPUdb::adminAlterHost ( const AdminAlterHostRequest request_,
AdminAlterHostResponse response_ 
) const

Alter properties on an existing host in the cluster.

Currently, the only property that can be altered is a hosts ability to accept failover processes.

Parameters
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ adminAlterHost() [3/4]

AdminAlterHostResponse gpudb::GPUdb::adminAlterHost ( const std::string &  host,
const std::map< std::string, std::string > &  options 
) const

Alter properties on an existing host in the cluster.

Currently, the only property that can be altered is a hosts ability to accept failover processes.

Parameters
[in]hostIdentifies the host this applies to. Can be the host address, or formatted as 'hostN' where N is the host number as specified in gpudb.conf
[in]optionsOptional parameters. The default value is an empty map.
Returns
Response object containing the result of the operation.

◆ adminAlterHost() [4/4]

AdminAlterHostResponse& gpudb::GPUdb::adminAlterHost ( const std::string &  host,
const std::map< std::string, std::string > &  options,
AdminAlterHostResponse response_ 
) const

Alter properties on an existing host in the cluster.

Currently, the only property that can be altered is a hosts ability to accept failover processes.

Parameters
[in]hostIdentifies the host this applies to. Can be the host address, or formatted as 'hostN' where N is the host number as specified in gpudb.conf
[in]optionsOptional parameters. The default value is an empty map.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ adminAlterJobs() [1/4]

AdminAlterJobsResponse gpudb::GPUdb::adminAlterJobs ( const AdminAlterJobsRequest request_) const

Perform the requested action on a list of one or more job(s).

Based on the type of job and the current state of execution, the action may not be successfully executed. The final result of the attempted actions for each specified job is returned in the status array of the response. See Job Manager for more information.

Parameters
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

◆ adminAlterJobs() [2/4]

AdminAlterJobsResponse& gpudb::GPUdb::adminAlterJobs ( const AdminAlterJobsRequest request_,
AdminAlterJobsResponse response_ 
) const

Perform the requested action on a list of one or more job(s).

Based on the type of job and the current state of execution, the action may not be successfully executed. The final result of the attempted actions for each specified job is returned in the status array of the response. See Job Manager for more information.

Parameters
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ adminAlterJobs() [3/4]

AdminAlterJobsResponse gpudb::GPUdb::adminAlterJobs ( const std::vector< int64_t > &  jobIds,
const std::string &  action,
const std::map< std::string, std::string > &  options 
) const

Perform the requested action on a list of one or more job(s).

Based on the type of job and the current state of execution, the action may not be successfully executed. The final result of the attempted actions for each specified job is returned in the status array of the response. See Job Manager for more information.

Parameters
[in]jobIdsJobs to be modified.
[in]actionAction to be performed on the jobs specified by job_ids. Supported values:
[in]optionsOptional parameters. The default value is an empty map.
Returns
Response object containing the result of the operation.

◆ adminAlterJobs() [4/4]

AdminAlterJobsResponse& gpudb::GPUdb::adminAlterJobs ( const std::vector< int64_t > &  jobIds,
const std::string &  action,
const std::map< std::string, std::string > &  options,
AdminAlterJobsResponse response_ 
) const

Perform the requested action on a list of one or more job(s).

Based on the type of job and the current state of execution, the action may not be successfully executed. The final result of the attempted actions for each specified job is returned in the status array of the response. See Job Manager for more information.

Parameters
[in]jobIdsJobs to be modified.
[in]actionAction to be performed on the jobs specified by job_ids. Supported values:
[in]optionsOptional parameters. The default value is an empty map.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ adminBackupBegin() [1/4]

AdminBackupBeginResponse gpudb::GPUdb::adminBackupBegin ( const AdminBackupBeginRequest request_) const

Prepares the system for a backup by closing all open file handles after allowing current active jobs to complete.

When the database is in backup mode, queries that result in a disk write operation will be blocked until backup mode has been completed by using adminBackupEnd.

Parameters
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

◆ adminBackupBegin() [2/4]

AdminBackupBeginResponse& gpudb::GPUdb::adminBackupBegin ( const AdminBackupBeginRequest request_,
AdminBackupBeginResponse response_ 
) const

Prepares the system for a backup by closing all open file handles after allowing current active jobs to complete.

When the database is in backup mode, queries that result in a disk write operation will be blocked until backup mode has been completed by using adminBackupEnd.

Parameters
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ adminBackupBegin() [3/4]

AdminBackupBeginResponse gpudb::GPUdb::adminBackupBegin ( const std::map< std::string, std::string > &  options) const

Prepares the system for a backup by closing all open file handles after allowing current active jobs to complete.

When the database is in backup mode, queries that result in a disk write operation will be blocked until backup mode has been completed by using adminBackupEnd.

Parameters
[in]optionsOptional parameters. The default value is an empty map.
Returns
Response object containing the result of the operation.

◆ adminBackupBegin() [4/4]

AdminBackupBeginResponse& gpudb::GPUdb::adminBackupBegin ( const std::map< std::string, std::string > &  options,
AdminBackupBeginResponse response_ 
) const

Prepares the system for a backup by closing all open file handles after allowing current active jobs to complete.

When the database is in backup mode, queries that result in a disk write operation will be blocked until backup mode has been completed by using adminBackupEnd.

Parameters
[in]optionsOptional parameters. The default value is an empty map.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ adminBackupEnd() [1/4]

AdminBackupEndResponse gpudb::GPUdb::adminBackupEnd ( const AdminBackupEndRequest request_) const

Restores the system to normal operating mode after a backup has completed, allowing any queries that were blocked to complete.

Parameters
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

◆ adminBackupEnd() [2/4]

AdminBackupEndResponse& gpudb::GPUdb::adminBackupEnd ( const AdminBackupEndRequest request_,
AdminBackupEndResponse response_ 
) const

Restores the system to normal operating mode after a backup has completed, allowing any queries that were blocked to complete.

Parameters
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ adminBackupEnd() [3/4]

AdminBackupEndResponse gpudb::GPUdb::adminBackupEnd ( const std::map< std::string, std::string > &  options) const

Restores the system to normal operating mode after a backup has completed, allowing any queries that were blocked to complete.

Parameters
[in]optionsOptional parameters. The default value is an empty map.
Returns
Response object containing the result of the operation.

◆ adminBackupEnd() [4/4]

AdminBackupEndResponse& gpudb::GPUdb::adminBackupEnd ( const std::map< std::string, std::string > &  options,
AdminBackupEndResponse response_ 
) const

Restores the system to normal operating mode after a backup has completed, allowing any queries that were blocked to complete.

Parameters
[in]optionsOptional parameters. The default value is an empty map.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ adminHaRefresh() [1/4]

AdminHaRefreshResponse gpudb::GPUdb::adminHaRefresh ( const AdminHaRefreshRequest request_) const

Restarts the HA processing on the given cluster as a mechanism of accepting breaking HA conf changes.

Additionally the cluster is put into read-only while HA is restarting.

Parameters
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

◆ adminHaRefresh() [2/4]

AdminHaRefreshResponse& gpudb::GPUdb::adminHaRefresh ( const AdminHaRefreshRequest request_,
AdminHaRefreshResponse response_ 
) const

Restarts the HA processing on the given cluster as a mechanism of accepting breaking HA conf changes.

Additionally the cluster is put into read-only while HA is restarting.

Parameters
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ adminHaRefresh() [3/4]

AdminHaRefreshResponse gpudb::GPUdb::adminHaRefresh ( const std::map< std::string, std::string > &  options) const

Restarts the HA processing on the given cluster as a mechanism of accepting breaking HA conf changes.

Additionally the cluster is put into read-only while HA is restarting.

Parameters
[in]optionsOptional parameters. The default value is an empty map.
Returns
Response object containing the result of the operation.

◆ adminHaRefresh() [4/4]

AdminHaRefreshResponse& gpudb::GPUdb::adminHaRefresh ( const std::map< std::string, std::string > &  options,
AdminHaRefreshResponse response_ 
) const

Restarts the HA processing on the given cluster as a mechanism of accepting breaking HA conf changes.

Additionally the cluster is put into read-only while HA is restarting.

Parameters
[in]optionsOptional parameters. The default value is an empty map.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ adminOffline() [1/4]

AdminOfflineResponse gpudb::GPUdb::adminOffline ( const AdminOfflineRequest request_) const

Take the system offline.

When the system is offline, no user operations can be performed with the exception of a system shutdown.

Parameters
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

◆ adminOffline() [2/4]

AdminOfflineResponse& gpudb::GPUdb::adminOffline ( const AdminOfflineRequest request_,
AdminOfflineResponse response_ 
) const

Take the system offline.

When the system is offline, no user operations can be performed with the exception of a system shutdown.

Parameters
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ adminOffline() [3/4]

AdminOfflineResponse gpudb::GPUdb::adminOffline ( const bool  offline,
const std::map< std::string, std::string > &  options 
) const

Take the system offline.

When the system is offline, no user operations can be performed with the exception of a system shutdown.

Parameters
[in]offlineSet to true if desired state is offline. Supported values:
  • true
  • false
[in]optionsOptional parameters. The default value is an empty map.
Returns
Response object containing the result of the operation.

◆ adminOffline() [4/4]

AdminOfflineResponse& gpudb::GPUdb::adminOffline ( const bool  offline,
const std::map< std::string, std::string > &  options,
AdminOfflineResponse response_ 
) const

Take the system offline.

When the system is offline, no user operations can be performed with the exception of a system shutdown.

Parameters
[in]offlineSet to true if desired state is offline. Supported values:
  • true
  • false
[in]optionsOptional parameters. The default value is an empty map.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ adminRebalance() [1/4]

AdminRebalanceResponse gpudb::GPUdb::adminRebalance ( const AdminRebalanceRequest request_) const

Rebalance the data in the cluster so that all nodes contain an equal number of records approximately and/or rebalance the shards to be equally distributed (as much as possible) across all the ranks.

The database must be offline for this operation, see adminOffline

  • If adminRebalance is invoked after a change is made to the cluster, e.g., a host was added or removed, sharded data will be evenly redistributed across the cluster by number of shards per rank while unsharded data will be redistributed across the cluster by data size per rank
  • If adminRebalance is invoked at some point when unsharded data (a.k.a. randomly-sharded) in the cluster is unevenly distributed over time, sharded data will not move while unsharded data will be redistributed across the cluster by data size per rank

NOTE: Replicated data will not move as a result of this call

This endpoint's processing time depends on the amount of data in the system, thus the API call may time out if run directly. It is recommended to run this endpoint asynchronously via createJob.

Parameters
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

◆ adminRebalance() [2/4]

AdminRebalanceResponse& gpudb::GPUdb::adminRebalance ( const AdminRebalanceRequest request_,
AdminRebalanceResponse response_ 
) const

Rebalance the data in the cluster so that all nodes contain an equal number of records approximately and/or rebalance the shards to be equally distributed (as much as possible) across all the ranks.

The database must be offline for this operation, see adminOffline

  • If adminRebalance is invoked after a change is made to the cluster, e.g., a host was added or removed, sharded data will be evenly redistributed across the cluster by number of shards per rank while unsharded data will be redistributed across the cluster by data size per rank
  • If adminRebalance is invoked at some point when unsharded data (a.k.a. randomly-sharded) in the cluster is unevenly distributed over time, sharded data will not move while unsharded data will be redistributed across the cluster by data size per rank

NOTE: Replicated data will not move as a result of this call

This endpoint's processing time depends on the amount of data in the system, thus the API call may time out if run directly. It is recommended to run this endpoint asynchronously via createJob.

Parameters
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ adminRebalance() [3/4]

AdminRebalanceResponse gpudb::GPUdb::adminRebalance ( const std::map< std::string, std::string > &  options) const

Rebalance the data in the cluster so that all nodes contain an equal number of records approximately and/or rebalance the shards to be equally distributed (as much as possible) across all the ranks.

The database must be offline for this operation, see adminOffline

  • If adminRebalance is invoked after a change is made to the cluster, e.g., a host was added or removed, sharded data will be evenly redistributed across the cluster by number of shards per rank while unsharded data will be redistributed across the cluster by data size per rank
  • If adminRebalance is invoked at some point when unsharded data (a.k.a. randomly-sharded) in the cluster is unevenly distributed over time, sharded data will not move while unsharded data will be redistributed across the cluster by data size per rank

NOTE: Replicated data will not move as a result of this call

This endpoint's processing time depends on the amount of data in the system, thus the API call may time out if run directly. It is recommended to run this endpoint asynchronously via createJob.

Parameters
[in]optionsOptional parameters. The default value is an empty map.
Returns
Response object containing the result of the operation.

◆ adminRebalance() [4/4]

AdminRebalanceResponse& gpudb::GPUdb::adminRebalance ( const std::map< std::string, std::string > &  options,
AdminRebalanceResponse response_ 
) const

Rebalance the data in the cluster so that all nodes contain an equal number of records approximately and/or rebalance the shards to be equally distributed (as much as possible) across all the ranks.

The database must be offline for this operation, see adminOffline

  • If adminRebalance is invoked after a change is made to the cluster, e.g., a host was added or removed, sharded data will be evenly redistributed across the cluster by number of shards per rank while unsharded data will be redistributed across the cluster by data size per rank
  • If adminRebalance is invoked at some point when unsharded data (a.k.a. randomly-sharded) in the cluster is unevenly distributed over time, sharded data will not move while unsharded data will be redistributed across the cluster by data size per rank

NOTE: Replicated data will not move as a result of this call

This endpoint's processing time depends on the amount of data in the system, thus the API call may time out if run directly. It is recommended to run this endpoint asynchronously via createJob.

Parameters
[in]optionsOptional parameters. The default value is an empty map.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ adminRemoveHost() [1/4]

AdminRemoveHostResponse gpudb::GPUdb::adminRemoveHost ( const AdminRemoveHostRequest request_) const

Removes a host from an existing cluster.

If the host to be removed has any ranks running on it, the ranks must be removed using adminRemoveRanks or manually switched over to a new host using adminSwitchover prior to host removal. If the host to be removed has the graph server or SQL planner running on it, these must be manually switched over to a new host using adminSwitchover.

Attention
This method should be used for on-premise deployments only.
Parameters
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

◆ adminRemoveHost() [2/4]

AdminRemoveHostResponse& gpudb::GPUdb::adminRemoveHost ( const AdminRemoveHostRequest request_,
AdminRemoveHostResponse response_ 
) const

Removes a host from an existing cluster.

If the host to be removed has any ranks running on it, the ranks must be removed using adminRemoveRanks or manually switched over to a new host using adminSwitchover prior to host removal. If the host to be removed has the graph server or SQL planner running on it, these must be manually switched over to a new host using adminSwitchover.

Attention
This method should be used for on-premise deployments only.
Parameters
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ adminRemoveHost() [3/4]

AdminRemoveHostResponse gpudb::GPUdb::adminRemoveHost ( const std::string &  host,
const std::map< std::string, std::string > &  options 
) const

Removes a host from an existing cluster.

If the host to be removed has any ranks running on it, the ranks must be removed using adminRemoveRanks or manually switched over to a new host using adminSwitchover prior to host removal. If the host to be removed has the graph server or SQL planner running on it, these must be manually switched over to a new host using adminSwitchover.

Attention
This method should be used for on-premise deployments only.
Parameters
[in]hostIdentifies the host this applies to. Can be the host address, or formatted as 'hostN' where N is the host number as specified in gpudb.conf
[in]optionsOptional parameters. The default value is an empty map.
Returns
Response object containing the result of the operation.

◆ adminRemoveHost() [4/4]

AdminRemoveHostResponse& gpudb::GPUdb::adminRemoveHost ( const std::string &  host,
const std::map< std::string, std::string > &  options,
AdminRemoveHostResponse response_ 
) const

Removes a host from an existing cluster.

If the host to be removed has any ranks running on it, the ranks must be removed using adminRemoveRanks or manually switched over to a new host using adminSwitchover prior to host removal. If the host to be removed has the graph server or SQL planner running on it, these must be manually switched over to a new host using adminSwitchover.

Attention
This method should be used for on-premise deployments only.
Parameters
[in]hostIdentifies the host this applies to. Can be the host address, or formatted as 'hostN' where N is the host number as specified in gpudb.conf
[in]optionsOptional parameters. The default value is an empty map.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ adminRemoveRanks() [1/4]

AdminRemoveRanksResponse gpudb::GPUdb::adminRemoveRanks ( const AdminRemoveRanksRequest request_) const

Remove one or more ranks from an existing Kinetica cluster.

All data will be rebalanced to other ranks before the rank(s) is removed unless the rebalance_sharded_data or rebalance_unsharded_data parameters are set to false in the options, in which case the corresponding sharded data and/or unsharded data (a.k.a. randomly-sharded) will be deleted.

The database must be offline for this operation, see adminOffline

This endpoint's processing time depends on the amount of data in the system, thus the API call may time out if run directly. It is recommended to run this endpoint asynchronously via createJob.

Attention
This method should be used for on-premise deployments only.
Parameters
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

◆ adminRemoveRanks() [2/4]

AdminRemoveRanksResponse& gpudb::GPUdb::adminRemoveRanks ( const AdminRemoveRanksRequest request_,
AdminRemoveRanksResponse response_ 
) const

Remove one or more ranks from an existing Kinetica cluster.

All data will be rebalanced to other ranks before the rank(s) is removed unless the rebalance_sharded_data or rebalance_unsharded_data parameters are set to false in the options, in which case the corresponding sharded data and/or unsharded data (a.k.a. randomly-sharded) will be deleted.

The database must be offline for this operation, see adminOffline

This endpoint's processing time depends on the amount of data in the system, thus the API call may time out if run directly. It is recommended to run this endpoint asynchronously via createJob.

Attention
This method should be used for on-premise deployments only.
Parameters
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ adminRemoveRanks() [3/4]

AdminRemoveRanksResponse gpudb::GPUdb::adminRemoveRanks ( const std::vector< std::string > &  ranks,
const std::map< std::string, std::string > &  options 
) const

Remove one or more ranks from an existing Kinetica cluster.

All data will be rebalanced to other ranks before the rank(s) is removed unless the rebalance_sharded_data or rebalance_unsharded_data parameters are set to false in the options, in which case the corresponding sharded data and/or unsharded data (a.k.a. randomly-sharded) will be deleted.

The database must be offline for this operation, see adminOffline

This endpoint's processing time depends on the amount of data in the system, thus the API call may time out if run directly. It is recommended to run this endpoint asynchronously via createJob.

Attention
This method should be used for on-premise deployments only.
Parameters
[in]ranksEach array value designates one or more ranks to remove from the cluster. Values can be formatted as 'rankN' for a specific rank, 'hostN' (from the gpudb.conf file) to remove all ranks on that host, or the host IP address (hostN.address from the gpub.conf file) which also removes all ranks on that host. Rank 0 (the head rank) cannot be removed (but can be moved to another host using adminSwitchover). At least one worker rank must be left in the cluster after the operation.
[in]optionsOptional parameters. The default value is an empty map.
Returns
Response object containing the result of the operation.

◆ adminRemoveRanks() [4/4]

AdminRemoveRanksResponse& gpudb::GPUdb::adminRemoveRanks ( const std::vector< std::string > &  ranks,
const std::map< std::string, std::string > &  options,
AdminRemoveRanksResponse response_ 
) const

Remove one or more ranks from an existing Kinetica cluster.

All data will be rebalanced to other ranks before the rank(s) is removed unless the rebalance_sharded_data or rebalance_unsharded_data parameters are set to false in the options, in which case the corresponding sharded data and/or unsharded data (a.k.a. randomly-sharded) will be deleted.

The database must be offline for this operation, see adminOffline

This endpoint's processing time depends on the amount of data in the system, thus the API call may time out if run directly. It is recommended to run this endpoint asynchronously via createJob.

Attention
This method should be used for on-premise deployments only.
Parameters
[in]ranksEach array value designates one or more ranks to remove from the cluster. Values can be formatted as 'rankN' for a specific rank, 'hostN' (from the gpudb.conf file) to remove all ranks on that host, or the host IP address (hostN.address from the gpub.conf file) which also removes all ranks on that host. Rank 0 (the head rank) cannot be removed (but can be moved to another host using adminSwitchover). At least one worker rank must be left in the cluster after the operation.
[in]optionsOptional parameters. The default value is an empty map.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ adminRepairTable() [1/4]

AdminRepairTableResponse gpudb::GPUdb::adminRepairTable ( const AdminRepairTableRequest request_) const

Manually repair a corrupted table.

Returns information about affected tables.

Parameters
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

◆ adminRepairTable() [2/4]

AdminRepairTableResponse& gpudb::GPUdb::adminRepairTable ( const AdminRepairTableRequest request_,
AdminRepairTableResponse response_ 
) const

Manually repair a corrupted table.

Returns information about affected tables.

Parameters
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ adminRepairTable() [3/4]

AdminRepairTableResponse gpudb::GPUdb::adminRepairTable ( const std::vector< std::string > &  tableNames,
const std::map< std::string, std::string > &  options 
) const

Manually repair a corrupted table.

Returns information about affected tables.

Parameters
[in]tableNamesList of tables to query. An asterisk returns all tables.
[in]optionsOptional parameters. The default value is an empty map.
Returns
Response object containing the result of the operation.

◆ adminRepairTable() [4/4]

AdminRepairTableResponse& gpudb::GPUdb::adminRepairTable ( const std::vector< std::string > &  tableNames,
const std::map< std::string, std::string > &  options,
AdminRepairTableResponse response_ 
) const

Manually repair a corrupted table.

Returns information about affected tables.

Parameters
[in]tableNamesList of tables to query. An asterisk returns all tables.
[in]optionsOptional parameters. The default value is an empty map.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ adminShowAlerts() [1/4]

AdminShowAlertsResponse gpudb::GPUdb::adminShowAlerts ( const AdminShowAlertsRequest request_) const

Requests a list of the most recent alerts.

Returns lists of alert data, including timestamp and type.

Parameters
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

◆ adminShowAlerts() [2/4]

AdminShowAlertsResponse& gpudb::GPUdb::adminShowAlerts ( const AdminShowAlertsRequest request_,
AdminShowAlertsResponse response_ 
) const

Requests a list of the most recent alerts.

Returns lists of alert data, including timestamp and type.

Parameters
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ adminShowAlerts() [3/4]

AdminShowAlertsResponse gpudb::GPUdb::adminShowAlerts ( const int32_t  numAlerts,
const std::map< std::string, std::string > &  options 
) const

Requests a list of the most recent alerts.

Returns lists of alert data, including timestamp and type.

Parameters
[in]numAlertsNumber of most recent alerts to request. The response will include up to numAlerts depending on how many alerts there are in the system. A value of 0 returns all stored alerts.
[in]optionsOptional parameters. The default value is an empty map.
Returns
Response object containing the result of the operation.

◆ adminShowAlerts() [4/4]

AdminShowAlertsResponse& gpudb::GPUdb::adminShowAlerts ( const int32_t  numAlerts,
const std::map< std::string, std::string > &  options,
AdminShowAlertsResponse response_ 
) const

Requests a list of the most recent alerts.

Returns lists of alert data, including timestamp and type.

Parameters
[in]numAlertsNumber of most recent alerts to request. The response will include up to numAlerts depending on how many alerts there are in the system. A value of 0 returns all stored alerts.
[in]optionsOptional parameters. The default value is an empty map.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ adminShowClusterOperations() [1/4]

AdminShowClusterOperationsResponse gpudb::GPUdb::adminShowClusterOperations ( const AdminShowClusterOperationsRequest request_) const

Requests the detailed status of the current operation (by default) or a prior cluster operation specified by historyIndex.

Returns details on the requested cluster operation.

The response will also indicate how many cluster operations are stored in the history.

Parameters
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

◆ adminShowClusterOperations() [2/4]

AdminShowClusterOperationsResponse& gpudb::GPUdb::adminShowClusterOperations ( const AdminShowClusterOperationsRequest request_,
AdminShowClusterOperationsResponse response_ 
) const

Requests the detailed status of the current operation (by default) or a prior cluster operation specified by historyIndex.

Returns details on the requested cluster operation.

The response will also indicate how many cluster operations are stored in the history.

Parameters
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ adminShowClusterOperations() [3/4]

AdminShowClusterOperationsResponse gpudb::GPUdb::adminShowClusterOperations ( const int32_t  historyIndex,
const std::map< std::string, std::string > &  options 
) const

Requests the detailed status of the current operation (by default) or a prior cluster operation specified by historyIndex.

Returns details on the requested cluster operation.

The response will also indicate how many cluster operations are stored in the history.

Parameters
[in]historyIndexIndicates which cluster operation to retrieve. Use 0 for the most recent. The default value is 0.
[in]optionsOptional parameters. The default value is an empty map.
Returns
Response object containing the result of the operation.

◆ adminShowClusterOperations() [4/4]

AdminShowClusterOperationsResponse& gpudb::GPUdb::adminShowClusterOperations ( const int32_t  historyIndex,
const std::map< std::string, std::string > &  options,
AdminShowClusterOperationsResponse response_ 
) const

Requests the detailed status of the current operation (by default) or a prior cluster operation specified by historyIndex.

Returns details on the requested cluster operation.

The response will also indicate how many cluster operations are stored in the history.

Parameters
[in]historyIndexIndicates which cluster operation to retrieve. Use 0 for the most recent. The default value is 0.
[in]optionsOptional parameters. The default value is an empty map.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ adminShowJobs() [1/4]

AdminShowJobsResponse gpudb::GPUdb::adminShowJobs ( const AdminShowJobsRequest request_) const

Get a list of the current jobs in GPUdb.

Parameters
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

◆ adminShowJobs() [2/4]

AdminShowJobsResponse& gpudb::GPUdb::adminShowJobs ( const AdminShowJobsRequest request_,
AdminShowJobsResponse response_ 
) const

Get a list of the current jobs in GPUdb.

Parameters
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ adminShowJobs() [3/4]

AdminShowJobsResponse gpudb::GPUdb::adminShowJobs ( const std::map< std::string, std::string > &  options) const

Get a list of the current jobs in GPUdb.

Parameters
[in]optionsOptional parameters. The default value is an empty map.
Returns
Response object containing the result of the operation.

◆ adminShowJobs() [4/4]

AdminShowJobsResponse& gpudb::GPUdb::adminShowJobs ( const std::map< std::string, std::string > &  options,
AdminShowJobsResponse response_ 
) const

Get a list of the current jobs in GPUdb.

Parameters
[in]optionsOptional parameters. The default value is an empty map.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ adminShowShards() [1/4]

AdminShowShardsResponse gpudb::GPUdb::adminShowShards ( const AdminShowShardsRequest request_) const

Show the mapping of shards to the corresponding rank and tom.

The response message contains list of 16384 (total number of shards in the system) Rank and TOM numbers corresponding to each shard.

Parameters
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

◆ adminShowShards() [2/4]

AdminShowShardsResponse& gpudb::GPUdb::adminShowShards ( const AdminShowShardsRequest request_,
AdminShowShardsResponse response_ 
) const

Show the mapping of shards to the corresponding rank and tom.

The response message contains list of 16384 (total number of shards in the system) Rank and TOM numbers corresponding to each shard.

Parameters
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ adminShowShards() [3/4]

AdminShowShardsResponse gpudb::GPUdb::adminShowShards ( const std::map< std::string, std::string > &  options) const

Show the mapping of shards to the corresponding rank and tom.

The response message contains list of 16384 (total number of shards in the system) Rank and TOM numbers corresponding to each shard.

Parameters
[in]optionsOptional parameters. The default value is an empty map.
Returns
Response object containing the result of the operation.

◆ adminShowShards() [4/4]

AdminShowShardsResponse& gpudb::GPUdb::adminShowShards ( const std::map< std::string, std::string > &  options,
AdminShowShardsResponse response_ 
) const

Show the mapping of shards to the corresponding rank and tom.

The response message contains list of 16384 (total number of shards in the system) Rank and TOM numbers corresponding to each shard.

Parameters
[in]optionsOptional parameters. The default value is an empty map.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ adminShutdown() [1/4]

AdminShutdownResponse gpudb::GPUdb::adminShutdown ( const AdminShutdownRequest request_) const

Exits the database server application.

Parameters
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

◆ adminShutdown() [2/4]

AdminShutdownResponse& gpudb::GPUdb::adminShutdown ( const AdminShutdownRequest request_,
AdminShutdownResponse response_ 
) const

Exits the database server application.

Parameters
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ adminShutdown() [3/4]

AdminShutdownResponse gpudb::GPUdb::adminShutdown ( const std::string &  exitType,
const std::string &  authorization,
const std::map< std::string, std::string > &  options 
) const

Exits the database server application.

Parameters
[in]exitTypeReserved for future use. User can pass an empty string.
[in]authorizationNo longer used. User can pass an empty string.
[in]optionsOptional parameters. The default value is an empty map.
Returns
Response object containing the result of the operation.

◆ adminShutdown() [4/4]

AdminShutdownResponse& gpudb::GPUdb::adminShutdown ( const std::string &  exitType,
const std::string &  authorization,
const std::map< std::string, std::string > &  options,
AdminShutdownResponse response_ 
) const

Exits the database server application.

Parameters
[in]exitTypeReserved for future use. User can pass an empty string.
[in]authorizationNo longer used. User can pass an empty string.
[in]optionsOptional parameters. The default value is an empty map.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ adminSwitchover() [1/4]

AdminSwitchoverResponse gpudb::GPUdb::adminSwitchover ( const AdminSwitchoverRequest request_) const

Manually switch over one or more processes to another host.

Individual ranks or entire hosts may be moved to another host.

Attention
This method should be used for on-premise deployments only.
Parameters
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

◆ adminSwitchover() [2/4]

AdminSwitchoverResponse& gpudb::GPUdb::adminSwitchover ( const AdminSwitchoverRequest request_,
AdminSwitchoverResponse response_ 
) const

Manually switch over one or more processes to another host.

Individual ranks or entire hosts may be moved to another host.

Attention
This method should be used for on-premise deployments only.
Parameters
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ adminSwitchover() [3/4]

AdminSwitchoverResponse gpudb::GPUdb::adminSwitchover ( const std::vector< std::string > &  processes,
const std::vector< std::string > &  destinations,
const std::map< std::string, std::string > &  options 
) const

Manually switch over one or more processes to another host.

Individual ranks or entire hosts may be moved to another host.

Attention
This method should be used for on-premise deployments only.
Parameters
[in]processesIndicates the process identifier to switch over to another host. Options are 'hostN' and 'rankN' where 'N' corresponds to the number associated with a host or rank in the Network section of the gpudb.conf file; e.g., 'host[N].address' or 'rank[N].host'. If 'hostN' is provided, all processes on that host will be moved to another host. Each entry in this array will be switched over to the corresponding host entry at the same index in destinations.
[in]destinationsIndicates to which host to switch over each corresponding process given in processes. Each index must be specified as 'hostN' where 'N' corresponds to the number associated with a host or rank in the Network section of the gpudb.conf file; e.g., 'host[N].address'. Each entry in this array will receive the corresponding process entry at the same index in processes.
[in]optionsOptional parameters. The default value is an empty map.
Returns
Response object containing the result of the operation.

◆ adminSwitchover() [4/4]

AdminSwitchoverResponse& gpudb::GPUdb::adminSwitchover ( const std::vector< std::string > &  processes,
const std::vector< std::string > &  destinations,
const std::map< std::string, std::string > &  options,
AdminSwitchoverResponse response_ 
) const

Manually switch over one or more processes to another host.

Individual ranks or entire hosts may be moved to another host.

Attention
This method should be used for on-premise deployments only.
Parameters
[in]processesIndicates the process identifier to switch over to another host. Options are 'hostN' and 'rankN' where 'N' corresponds to the number associated with a host or rank in the Network section of the gpudb.conf file; e.g., 'host[N].address' or 'rank[N].host'. If 'hostN' is provided, all processes on that host will be moved to another host. Each entry in this array will be switched over to the corresponding host entry at the same index in destinations.
[in]destinationsIndicates to which host to switch over each corresponding process given in processes. Each index must be specified as 'hostN' where 'N' corresponds to the number associated with a host or rank in the Network section of the gpudb.conf file; e.g., 'host[N].address'. Each entry in this array will receive the corresponding process entry at the same index in processes.
[in]optionsOptional parameters. The default value is an empty map.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ adminVerifyDb() [1/4]

AdminVerifyDbResponse gpudb::GPUdb::adminVerifyDb ( const AdminVerifyDbRequest request_) const

Verify database is in a consistent state.

When inconsistencies or errors are found, the verified_ok flag in the response is set to false and the list of errors found is provided in the error_list.

Parameters
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

◆ adminVerifyDb() [2/4]

AdminVerifyDbResponse& gpudb::GPUdb::adminVerifyDb ( const AdminVerifyDbRequest request_,
AdminVerifyDbResponse response_ 
) const

Verify database is in a consistent state.

When inconsistencies or errors are found, the verified_ok flag in the response is set to false and the list of errors found is provided in the error_list.

Parameters
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ adminVerifyDb() [3/4]

AdminVerifyDbResponse gpudb::GPUdb::adminVerifyDb ( const std::map< std::string, std::string > &  options) const

Verify database is in a consistent state.

When inconsistencies or errors are found, the verified_ok flag in the response is set to false and the list of errors found is provided in the error_list.

Parameters
[in]optionsOptional parameters. The default value is an empty map.
Returns
Response object containing the result of the operation.

◆ adminVerifyDb() [4/4]

AdminVerifyDbResponse& gpudb::GPUdb::adminVerifyDb ( const std::map< std::string, std::string > &  options,
AdminVerifyDbResponse response_ 
) const

Verify database is in a consistent state.

When inconsistencies or errors are found, the verified_ok flag in the response is set to false and the list of errors found is provided in the error_list.

Parameters
[in]optionsOptional parameters. The default value is an empty map.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ aggregateConvexHull() [1/4]

AggregateConvexHullResponse gpudb::GPUdb::aggregateConvexHull ( const AggregateConvexHullRequest request_) const

Calculates and returns the convex hull for the values in a table specified by tableName.

Parameters
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

◆ aggregateConvexHull() [2/4]

AggregateConvexHullResponse& gpudb::GPUdb::aggregateConvexHull ( const AggregateConvexHullRequest request_,
AggregateConvexHullResponse response_ 
) const

Calculates and returns the convex hull for the values in a table specified by tableName.

Parameters
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ aggregateConvexHull() [3/4]

AggregateConvexHullResponse gpudb::GPUdb::aggregateConvexHull ( const std::string &  tableName,
const std::string &  xColumnName,
const std::string &  yColumnName,
const std::map< std::string, std::string > &  options 
) const

Calculates and returns the convex hull for the values in a table specified by tableName.

Parameters
[in]tableNameName of table on which the operation will be performed. Must be an existing table, in [schema_name.]table_name format, using standard name resolution rules.
[in]xColumnNameName of the column containing the x coordinates of the points for the operation being performed.
[in]yColumnNameName of the column containing the y coordinates of the points for the operation being performed.
[in]optionsOptional parameters. The default value is an empty map.
Returns
Response object containing the result of the operation.

◆ aggregateConvexHull() [4/4]

AggregateConvexHullResponse& gpudb::GPUdb::aggregateConvexHull ( const std::string &  tableName,
const std::string &  xColumnName,
const std::string &  yColumnName,
const std::map< std::string, std::string > &  options,
AggregateConvexHullResponse response_ 
) const

Calculates and returns the convex hull for the values in a table specified by tableName.

Parameters
[in]tableNameName of table on which the operation will be performed. Must be an existing table, in [schema_name.]table_name format, using standard name resolution rules.
[in]xColumnNameName of the column containing the x coordinates of the points for the operation being performed.
[in]yColumnNameName of the column containing the y coordinates of the points for the operation being performed.
[in]optionsOptional parameters. The default value is an empty map.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ aggregateGroupBy() [1/4]

AggregateGroupByResponse gpudb::GPUdb::aggregateGroupBy ( const AggregateGroupByRequest request_) const

Calculates unique combinations (groups) of values for the given columns in a given table or view and computes aggregates on each unique combination.

This is somewhat analogous to an SQL-style SELECT...GROUP BY.

For aggregation details and examples, see Aggregation. For limitations, see Aggregation Limitations.

Any column(s) can be grouped on, and all column types except unrestricted-length strings may be used for computing applicable aggregates; columns marked as store-only are unable to be used in grouping or aggregation.

The results can be paged via the offset and limit parameters. For example, to get 10 groups with the largest counts the inputs would be: limit=10, options={"sort_order":"descending", "sort_by":"value"}.

options can be used to customize behavior of this call e.g. filtering or sorting the results.

To group by columns 'x' and 'y' and compute the number of objects within each group, use: column_names=['x','y','count(*)'].

To also compute the sum of 'z' over each group, use: column_names=['x','y','count(*)','sum(z)'].

Available aggregation functions are: count(*), sum, min, max, avg, mean, stddev, stddev_pop, stddev_samp, var, var_pop, var_samp, arg_min, arg_max and count_distinct.

Available grouping functions are Rollup, Cube, and Grouping Sets

This service also provides support for Pivot operations.

Filtering on aggregates is supported via expressions using aggregation functions supplied to having.

The response is returned as a dynamic schema. For details see: dynamic schemas documentation.

If a result_table name is specified in the options, the results are stored in a new table with that name–no results are returned in the response. Both the table name and resulting column names must adhere to standard naming conventions; column/aggregation expressions will need to be aliased. If the source table's shard key is used as the grouping column(s) and all result records are selected (offset is 0 and limit is -9999), the result table will be sharded, in all other cases it will be replicated. Sorting will properly function only if the result table is replicated or if there is only one processing node and should not be relied upon in other cases. Not available when any of the values of columnNames is an unrestricted-length string.

Parameters
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

◆ aggregateGroupBy() [2/4]

AggregateGroupByResponse& gpudb::GPUdb::aggregateGroupBy ( const AggregateGroupByRequest request_,
AggregateGroupByResponse response_ 
) const

Calculates unique combinations (groups) of values for the given columns in a given table or view and computes aggregates on each unique combination.

This is somewhat analogous to an SQL-style SELECT...GROUP BY.

For aggregation details and examples, see Aggregation. For limitations, see Aggregation Limitations.

Any column(s) can be grouped on, and all column types except unrestricted-length strings may be used for computing applicable aggregates; columns marked as store-only are unable to be used in grouping or aggregation.

The results can be paged via the offset and limit parameters. For example, to get 10 groups with the largest counts the inputs would be: limit=10, options={"sort_order":"descending", "sort_by":"value"}.

options can be used to customize behavior of this call e.g. filtering or sorting the results.

To group by columns 'x' and 'y' and compute the number of objects within each group, use: column_names=['x','y','count(*)'].

To also compute the sum of 'z' over each group, use: column_names=['x','y','count(*)','sum(z)'].

Available aggregation functions are: count(*), sum, min, max, avg, mean, stddev, stddev_pop, stddev_samp, var, var_pop, var_samp, arg_min, arg_max and count_distinct.

Available grouping functions are Rollup, Cube, and Grouping Sets

This service also provides support for Pivot operations.

Filtering on aggregates is supported via expressions using aggregation functions supplied to having.

The response is returned as a dynamic schema. For details see: dynamic schemas documentation.

If a result_table name is specified in the options, the results are stored in a new table with that name–no results are returned in the response. Both the table name and resulting column names must adhere to standard naming conventions; column/aggregation expressions will need to be aliased. If the source table's shard key is used as the grouping column(s) and all result records are selected (offset is 0 and limit is -9999), the result table will be sharded, in all other cases it will be replicated. Sorting will properly function only if the result table is replicated or if there is only one processing node and should not be relied upon in other cases. Not available when any of the values of columnNames is an unrestricted-length string.

Parameters
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ aggregateGroupBy() [3/4]

AggregateGroupByResponse gpudb::GPUdb::aggregateGroupBy ( const std::string &  tableName,
const std::vector< std::string > &  columnNames,
const int64_t  offset,
const int64_t  limit,
const std::map< std::string, std::string > &  options 
) const

Calculates unique combinations (groups) of values for the given columns in a given table or view and computes aggregates on each unique combination.

This is somewhat analogous to an SQL-style SELECT...GROUP BY.

For aggregation details and examples, see Aggregation. For limitations, see Aggregation Limitations.

Any column(s) can be grouped on, and all column types except unrestricted-length strings may be used for computing applicable aggregates; columns marked as store-only are unable to be used in grouping or aggregation.

The results can be paged via the offset and limit parameters. For example, to get 10 groups with the largest counts the inputs would be: limit=10, options={"sort_order":"descending", "sort_by":"value"}.

options can be used to customize behavior of this call e.g. filtering or sorting the results.

To group by columns 'x' and 'y' and compute the number of objects within each group, use: column_names=['x','y','count(*)'].

To also compute the sum of 'z' over each group, use: column_names=['x','y','count(*)','sum(z)'].

Available aggregation functions are: count(*), sum, min, max, avg, mean, stddev, stddev_pop, stddev_samp, var, var_pop, var_samp, arg_min, arg_max and count_distinct.

Available grouping functions are Rollup, Cube, and Grouping Sets

This service also provides support for Pivot operations.

Filtering on aggregates is supported via expressions using aggregation functions supplied to having.

The response is returned as a dynamic schema. For details see: dynamic schemas documentation.

If a result_table name is specified in the options, the results are stored in a new table with that name–no results are returned in the response. Both the table name and resulting column names must adhere to standard naming conventions; column/aggregation expressions will need to be aliased. If the source table's shard key is used as the grouping column(s) and all result records are selected (offset is 0 and limit is -9999), the result table will be sharded, in all other cases it will be replicated. Sorting will properly function only if the result table is replicated or if there is only one processing node and should not be relied upon in other cases. Not available when any of the values of columnNames is an unrestricted-length string.

Parameters
[in]tableNameName of an existing table or view on which the operation will be performed, in [schema_name.]table_name format, using standard name resolution rules.
[in]columnNamesList of one or more column names, expressions, and aggregate expressions.
[in]offsetA positive integer indicating the number of initial results to skip (this can be useful for paging through the results). The 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 maximum number of results allowed by the server should be returned. The number of records returned will never exceed the server's own limit, defined by the max_get_records_size parameter in the server configuration. Use hasMoreRecords to see if more records exist in the result to be fetched, and offset & limit to request subsequent pages of results. The default value is -9999.
[in]optionsOptional parameters. The default value is an empty map.
Returns
Response object containing the result of the operation.

◆ aggregateGroupBy() [4/4]

AggregateGroupByResponse& gpudb::GPUdb::aggregateGroupBy ( const std::string &  tableName,
const std::vector< std::string > &  columnNames,
const int64_t  offset,
const int64_t  limit,
const std::map< std::string, std::string > &  options,
AggregateGroupByResponse response_ 
) const

Calculates unique combinations (groups) of values for the given columns in a given table or view and computes aggregates on each unique combination.

This is somewhat analogous to an SQL-style SELECT...GROUP BY.

For aggregation details and examples, see Aggregation. For limitations, see Aggregation Limitations.

Any column(s) can be grouped on, and all column types except unrestricted-length strings may be used for computing applicable aggregates; columns marked as store-only are unable to be used in grouping or aggregation.

The results can be paged via the offset and limit parameters. For example, to get 10 groups with the largest counts the inputs would be: limit=10, options={"sort_order":"descending", "sort_by":"value"}.

options can be used to customize behavior of this call e.g. filtering or sorting the results.

To group by columns 'x' and 'y' and compute the number of objects within each group, use: column_names=['x','y','count(*)'].

To also compute the sum of 'z' over each group, use: column_names=['x','y','count(*)','sum(z)'].

Available aggregation functions are: count(*), sum, min, max, avg, mean, stddev, stddev_pop, stddev_samp, var, var_pop, var_samp, arg_min, arg_max and count_distinct.

Available grouping functions are Rollup, Cube, and Grouping Sets

This service also provides support for Pivot operations.

Filtering on aggregates is supported via expressions using aggregation functions supplied to having.

The response is returned as a dynamic schema. For details see: dynamic schemas documentation.

If a result_table name is specified in the options, the results are stored in a new table with that name–no results are returned in the response. Both the table name and resulting column names must adhere to standard naming conventions; column/aggregation expressions will need to be aliased. If the source table's shard key is used as the grouping column(s) and all result records are selected (offset is 0 and limit is -9999), the result table will be sharded, in all other cases it will be replicated. Sorting will properly function only if the result table is replicated or if there is only one processing node and should not be relied upon in other cases. Not available when any of the values of columnNames is an unrestricted-length string.

Parameters
[in]tableNameName of an existing table or view on which the operation will be performed, in [schema_name.]table_name format, using standard name resolution rules.
[in]columnNamesList of one or more column names, expressions, and aggregate expressions.
[in]offsetA positive integer indicating the number of initial results to skip (this can be useful for paging through the results). The 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 maximum number of results allowed by the server should be returned. The number of records returned will never exceed the server's own limit, defined by the max_get_records_size parameter in the server configuration. Use hasMoreRecords to see if more records exist in the result to be fetched, and offset & limit to request subsequent pages of results. The default value is -9999.
[in]optionsOptional parameters. The default value is an empty map.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ aggregateGroupByRaw() [1/2]

RawAggregateGroupByResponse gpudb::GPUdb::aggregateGroupByRaw ( const AggregateGroupByRequest request_) const

Calculates unique combinations (groups) of values for the given columns in a given table or view and computes aggregates on each unique combination.

This is somewhat analogous to an SQL-style SELECT...GROUP BY.

For aggregation details and examples, see Aggregation. For limitations, see Aggregation Limitations.

Any column(s) can be grouped on, and all column types except unrestricted-length strings may be used for computing applicable aggregates; columns marked as store-only are unable to be used in grouping or aggregation.

The results can be paged via the offset and limit parameters. For example, to get 10 groups with the largest counts the inputs would be: limit=10, options={"sort_order":"descending", "sort_by":"value"}.

options can be used to customize behavior of this call e.g. filtering or sorting the results.

To group by columns 'x' and 'y' and compute the number of objects within each group, use: column_names=['x','y','count(*)'].

To also compute the sum of 'z' over each group, use: column_names=['x','y','count(*)','sum(z)'].

Available aggregation functions are: count(*), sum, min, max, avg, mean, stddev, stddev_pop, stddev_samp, var, var_pop, var_samp, arg_min, arg_max and count_distinct.

Available grouping functions are Rollup, Cube, and Grouping Sets

This service also provides support for Pivot operations.

Filtering on aggregates is supported via expressions using aggregation functions supplied to having.

The response is returned as a dynamic schema. For details see: dynamic schemas documentation.

If a result_table name is specified in the options, the results are stored in a new table with that name–no results are returned in the response. Both the table name and resulting column names must adhere to standard naming conventions; column/aggregation expressions will need to be aliased. If the source table's shard key is used as the grouping column(s) and all result records are selected (offset is 0 and limit is -9999), the result table will be sharded, in all other cases it will be replicated. Sorting will properly function only if the result table is replicated or if there is only one processing node and should not be relied upon in other cases. Not available when any of the values of columnNames is an unrestricted-length string.

Parameters
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

◆ aggregateGroupByRaw() [2/2]

RawAggregateGroupByResponse& gpudb::GPUdb::aggregateGroupByRaw ( const AggregateGroupByRequest request_,
RawAggregateGroupByResponse response_ 
) const

Calculates unique combinations (groups) of values for the given columns in a given table or view and computes aggregates on each unique combination.

This is somewhat analogous to an SQL-style SELECT...GROUP BY.

For aggregation details and examples, see Aggregation. For limitations, see Aggregation Limitations.

Any column(s) can be grouped on, and all column types except unrestricted-length strings may be used for computing applicable aggregates; columns marked as store-only are unable to be used in grouping or aggregation.

The results can be paged via the offset and limit parameters. For example, to get 10 groups with the largest counts the inputs would be: limit=10, options={"sort_order":"descending", "sort_by":"value"}.

options can be used to customize behavior of this call e.g. filtering or sorting the results.

To group by columns 'x' and 'y' and compute the number of objects within each group, use: column_names=['x','y','count(*)'].

To also compute the sum of 'z' over each group, use: column_names=['x','y','count(*)','sum(z)'].

Available aggregation functions are: count(*), sum, min, max, avg, mean, stddev, stddev_pop, stddev_samp, var, var_pop, var_samp, arg_min, arg_max and count_distinct.

Available grouping functions are Rollup, Cube, and Grouping Sets

This service also provides support for Pivot operations.

Filtering on aggregates is supported via expressions using aggregation functions supplied to having.

The response is returned as a dynamic schema. For details see: dynamic schemas documentation.

If a result_table name is specified in the options, the results are stored in a new table with that name–no results are returned in the response. Both the table name and resulting column names must adhere to standard naming conventions; column/aggregation expressions will need to be aliased. If the source table's shard key is used as the grouping column(s) and all result records are selected (offset is 0 and limit is -9999), the result table will be sharded, in all other cases it will be replicated. Sorting will properly function only if the result table is replicated or if there is only one processing node and should not be relied upon in other cases. Not available when any of the values of columnNames is an unrestricted-length string.

Parameters
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ aggregateHistogram() [1/4]

AggregateHistogramResponse gpudb::GPUdb::aggregateHistogram ( const AggregateHistogramRequest request_) const

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.

Parameters
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

◆ aggregateHistogram() [2/4]

AggregateHistogramResponse& gpudb::GPUdb::aggregateHistogram ( const AggregateHistogramRequest request_,
AggregateHistogramResponse response_ 
) const

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.

Parameters
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ aggregateHistogram() [3/4]

AggregateHistogramResponse gpudb::GPUdb::aggregateHistogram ( const std::string &  tableName,
const std::string &  columnName,
const double  start,
const double  end,
const double  interval,
const std::map< std::string, std::string > &  options 
) const

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.

Parameters
[in]tableNameName of the table on which the operation will be performed. Must be an existing table, in [schema_name.]table_name format, using standard name resolution rules.
[in]columnNameName of a column or an expression of one or more column names over which the histogram will be calculated.
[in]startLower end value of the histogram interval, inclusive.
[in]endUpper end value of the histogram interval, inclusive.
[in]intervalThe size of each bin within the start and end parameters.
[in]optionsOptional parameters.
  • aggregate_histogram_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
Response object containing the result of the operation.

◆ aggregateHistogram() [4/4]

AggregateHistogramResponse& gpudb::GPUdb::aggregateHistogram ( const std::string &  tableName,
const std::string &  columnName,
const double  start,
const double  end,
const double  interval,
const std::map< std::string, std::string > &  options,
AggregateHistogramResponse response_ 
) const

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.

Parameters
[in]tableNameName of the table on which the operation will be performed. Must be an existing table, in [schema_name.]table_name format, using standard name resolution rules.
[in]columnNameName of a column or an expression of one or more column names over which the histogram will be calculated.
[in]startLower end value of the histogram interval, inclusive.
[in]endUpper end value of the histogram interval, inclusive.
[in]intervalThe size of each bin within the start and end parameters.
[in]optionsOptional parameters.
  • aggregate_histogram_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.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ aggregateKMeans() [1/4]

AggregateKMeansResponse gpudb::GPUdb::aggregateKMeans ( const AggregateKMeansRequest request_) const

This endpoint runs the k-means algorithm - a heuristic algorithm that attempts to do k-means clustering.

An ideal k-means clustering algorithm selects k points such that the sum of the mean squared distances of each member of the set to the nearest of the k points is minimized. The k-means algorithm however does not necessarily produce such an ideal cluster. It begins with a randomly selected set of k points and then refines the location of the points iteratively and settles to a local minimum. Various parameters and options are provided to control the heuristic search.

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

Parameters
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

◆ aggregateKMeans() [2/4]

AggregateKMeansResponse& gpudb::GPUdb::aggregateKMeans ( const AggregateKMeansRequest request_,
AggregateKMeansResponse response_ 
) const

This endpoint runs the k-means algorithm - a heuristic algorithm that attempts to do k-means clustering.

An ideal k-means clustering algorithm selects k points such that the sum of the mean squared distances of each member of the set to the nearest of the k points is minimized. The k-means algorithm however does not necessarily produce such an ideal cluster. It begins with a randomly selected set of k points and then refines the location of the points iteratively and settles to a local minimum. Various parameters and options are provided to control the heuristic search.

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

Parameters
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ aggregateKMeans() [3/4]

AggregateKMeansResponse gpudb::GPUdb::aggregateKMeans ( const std::string &  tableName,
const std::vector< std::string > &  columnNames,
const int32_t  k,
const double  tolerance,
const std::map< std::string, std::string > &  options 
) const

This endpoint runs the k-means algorithm - a heuristic algorithm that attempts to do k-means clustering.

An ideal k-means clustering algorithm selects k points such that the sum of the mean squared distances of each member of the set to the nearest of the k points is minimized. The k-means algorithm however does not necessarily produce such an ideal cluster. It begins with a randomly selected set of k points and then refines the location of the points iteratively and settles to a local minimum. Various parameters and options are provided to control the heuristic search.

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

Parameters
[in]tableNameName of the table on which the operation will be performed. Must be an existing table, in [schema_name.]table_name format, using standard name resolution rules.
[in]columnNamesList of column names on which the operation would be performed. If n columns are provided then each of the k result points will have n dimensions corresponding to the n columns.
[in]kThe number of mean points to be determined by the algorithm.
[in]toleranceStop iterating when the distances between successive points is less than the given tolerance.
[in]optionsOptional parameters. The default value is an empty map.
Returns
Response object containing the result of the operation.

◆ aggregateKMeans() [4/4]

AggregateKMeansResponse& gpudb::GPUdb::aggregateKMeans ( const std::string &  tableName,
const std::vector< std::string > &  columnNames,
const int32_t  k,
const double  tolerance,
const std::map< std::string, std::string > &  options,
AggregateKMeansResponse response_ 
) const

This endpoint runs the k-means algorithm - a heuristic algorithm that attempts to do k-means clustering.

An ideal k-means clustering algorithm selects k points such that the sum of the mean squared distances of each member of the set to the nearest of the k points is minimized. The k-means algorithm however does not necessarily produce such an ideal cluster. It begins with a randomly selected set of k points and then refines the location of the points iteratively and settles to a local minimum. Various parameters and options are provided to control the heuristic search.

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

Parameters
[in]tableNameName of the table on which the operation will be performed. Must be an existing table, in [schema_name.]table_name format, using standard name resolution rules.
[in]columnNamesList of column names on which the operation would be performed. If n columns are provided then each of the k result points will have n dimensions corresponding to the n columns.
[in]kThe number of mean points to be determined by the algorithm.
[in]toleranceStop iterating when the distances between successive points is less than the given tolerance.
[in]optionsOptional parameters. The default value is an empty map.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ aggregateMinMax() [1/4]

AggregateMinMaxResponse gpudb::GPUdb::aggregateMinMax ( const AggregateMinMaxRequest request_) const

Calculates and returns the minimum and maximum values of a particular column in a table.

Parameters
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

◆ aggregateMinMax() [2/4]

AggregateMinMaxResponse& gpudb::GPUdb::aggregateMinMax ( const AggregateMinMaxRequest request_,
AggregateMinMaxResponse response_ 
) const

Calculates and returns the minimum and maximum values of a particular column in a table.

Parameters
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ aggregateMinMax() [3/4]

AggregateMinMaxResponse gpudb::GPUdb::aggregateMinMax ( const std::string &  tableName,
const std::string &  columnName,
const std::map< std::string, std::string > &  options 
) const

Calculates and returns the minimum and maximum values of a particular column in a table.

Parameters
[in]tableNameName of the table on which the operation will be performed. Must be an existing table, in [schema_name.]table_name format, using standard name resolution rules.
[in]columnNameName of a column or an expression of one or more column on which the min-max will be calculated.
[in]optionsOptional parameters. The default value is an empty map.
Returns
Response object containing the result of the operation.

◆ aggregateMinMax() [4/4]

AggregateMinMaxResponse& gpudb::GPUdb::aggregateMinMax ( const std::string &  tableName,
const std::string &  columnName,
const std::map< std::string, std::string > &  options,
AggregateMinMaxResponse response_ 
) const

Calculates and returns the minimum and maximum values of a particular column in a table.

Parameters
[in]tableNameName of the table on which the operation will be performed. Must be an existing table, in [schema_name.]table_name format, using standard name resolution rules.
[in]columnNameName of a column or an expression of one or more column on which the min-max will be calculated.
[in]optionsOptional parameters. The default value is an empty map.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ aggregateMinMaxGeometry() [1/4]

AggregateMinMaxGeometryResponse gpudb::GPUdb::aggregateMinMaxGeometry ( const AggregateMinMaxGeometryRequest request_) const

Calculates and returns the minimum and maximum x- and y-coordinates of a particular geospatial geometry column in a table.

Parameters
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

◆ aggregateMinMaxGeometry() [2/4]

AggregateMinMaxGeometryResponse& gpudb::GPUdb::aggregateMinMaxGeometry ( const AggregateMinMaxGeometryRequest request_,
AggregateMinMaxGeometryResponse response_ 
) const

Calculates and returns the minimum and maximum x- and y-coordinates of a particular geospatial geometry column in a table.

Parameters
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ aggregateMinMaxGeometry() [3/4]

AggregateMinMaxGeometryResponse gpudb::GPUdb::aggregateMinMaxGeometry ( const std::string &  tableName,
const std::string &  columnName,
const std::map< std::string, std::string > &  options 
) const

Calculates and returns the minimum and maximum x- and y-coordinates of a particular geospatial geometry column in a table.

Parameters
[in]tableNameName of the table on which the operation will be performed. Must be an existing table, in [schema_name.]table_name format, using standard name resolution rules.
[in]columnNameName of a geospatial geometry column on which the min-max will be calculated.
[in]optionsOptional parameters. The default value is an empty map.
Returns
Response object containing the result of the operation.

◆ aggregateMinMaxGeometry() [4/4]

AggregateMinMaxGeometryResponse& gpudb::GPUdb::aggregateMinMaxGeometry ( const std::string &  tableName,
const std::string &  columnName,
const std::map< std::string, std::string > &  options,
AggregateMinMaxGeometryResponse response_ 
) const

Calculates and returns the minimum and maximum x- and y-coordinates of a particular geospatial geometry column in a table.

Parameters
[in]tableNameName of the table on which the operation will be performed. Must be an existing table, in [schema_name.]table_name format, using standard name resolution rules.
[in]columnNameName of a geospatial geometry column on which the min-max will be calculated.
[in]optionsOptional parameters. The default value is an empty map.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ aggregateStatistics() [1/4]

AggregateStatisticsResponse gpudb::GPUdb::aggregateStatistics ( const AggregateStatisticsRequest request_) const

Calculates the requested statistics of the given column(s) in a given table.

The available statistics are: count (number of total objects), mean, stdv (standard deviation), variance, skew, kurtosis, sum, min, max, weighted_average, cardinality (unique count), estimated_cardinality, percentile, and percentile_rank.

Estimated cardinality is calculated by using the hyperloglog approximation technique.

Percentiles and percentile ranks are approximate and are calculated using the t-digest algorithm. They must include the desired percentile/percentile_rank. To compute multiple percentiles each value must be specified separately (i.e.\ 'percentile(75.0),percentile(99.0),percentile_rank(1234.56),percentile_rank(-5)').

A second, comma-separated value can be added to the percentile statistic to calculate percentile resolution, e.g., a 50th percentile with 200 resolution would be 'percentile(50,200)'.

The weighted average statistic requires a weight column to be specified in weight_column_name. The weighted average is then defined as the sum of the products of columnName times the weight_column_name values divided by the sum of the weight_column_name values.

Additional columns can be used in the calculation of statistics via additional_column_names. Values in these columns will be included in the overall aggregate calculation–individual aggregates will not be calculated per additional column. For instance, requesting the count & mean of columnName x and additional_column_names y & z, where x holds the numbers 1-10, y holds 11-20, and z holds 21-30, would return the total number of x, y, & z values (30), and the single average value across all x, y, & z values (15.5).

The response includes a list of key/value pairs of each statistic requested and its corresponding value.

Parameters
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

◆ aggregateStatistics() [2/4]

AggregateStatisticsResponse& gpudb::GPUdb::aggregateStatistics ( const AggregateStatisticsRequest request_,
AggregateStatisticsResponse response_ 
) const

Calculates the requested statistics of the given column(s) in a given table.

The available statistics are: count (number of total objects), mean, stdv (standard deviation), variance, skew, kurtosis, sum, min, max, weighted_average, cardinality (unique count), estimated_cardinality, percentile, and percentile_rank.

Estimated cardinality is calculated by using the hyperloglog approximation technique.

Percentiles and percentile ranks are approximate and are calculated using the t-digest algorithm. They must include the desired percentile/percentile_rank. To compute multiple percentiles each value must be specified separately (i.e.\ 'percentile(75.0),percentile(99.0),percentile_rank(1234.56),percentile_rank(-5)').

A second, comma-separated value can be added to the percentile statistic to calculate percentile resolution, e.g., a 50th percentile with 200 resolution would be 'percentile(50,200)'.

The weighted average statistic requires a weight column to be specified in weight_column_name. The weighted average is then defined as the sum of the products of columnName times the weight_column_name values divided by the sum of the weight_column_name values.

Additional columns can be used in the calculation of statistics via additional_column_names. Values in these columns will be included in the overall aggregate calculation–individual aggregates will not be calculated per additional column. For instance, requesting the count & mean of columnName x and additional_column_names y & z, where x holds the numbers 1-10, y holds 11-20, and z holds 21-30, would return the total number of x, y, & z values (30), and the single average value across all x, y, & z values (15.5).

The response includes a list of key/value pairs of each statistic requested and its corresponding value.

Parameters
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ aggregateStatistics() [3/4]

AggregateStatisticsResponse gpudb::GPUdb::aggregateStatistics ( const std::string &  tableName,
const std::string &  columnName,
const std::string &  stats,
const std::map< std::string, std::string > &  options 
) const

Calculates the requested statistics of the given column(s) in a given table.

The available statistics are: count (number of total objects), mean, stdv (standard deviation), variance, skew, kurtosis, sum, min, max, weighted_average, cardinality (unique count), estimated_cardinality, percentile, and percentile_rank.

Estimated cardinality is calculated by using the hyperloglog approximation technique.

Percentiles and percentile ranks are approximate and are calculated using the t-digest algorithm. They must include the desired percentile/percentile_rank. To compute multiple percentiles each value must be specified separately (i.e.\ 'percentile(75.0),percentile(99.0),percentile_rank(1234.56),percentile_rank(-5)').

A second, comma-separated value can be added to the percentile statistic to calculate percentile resolution, e.g., a 50th percentile with 200 resolution would be 'percentile(50,200)'.

The weighted average statistic requires a weight column to be specified in weight_column_name. The weighted average is then defined as the sum of the products of columnName times the weight_column_name values divided by the sum of the weight_column_name values.

Additional columns can be used in the calculation of statistics via additional_column_names. Values in these columns will be included in the overall aggregate calculation–individual aggregates will not be calculated per additional column. For instance, requesting the count & mean of columnName x and additional_column_names y & z, where x holds the numbers 1-10, y holds 11-20, and z holds 21-30, would return the total number of x, y, & z values (30), and the single average value across all x, y, & z values (15.5).

The response includes a list of key/value pairs of each statistic requested and its corresponding value.

Parameters
[in]tableNameName of the table on which the statistics operation will be performed, in [schema_name.]table_name format, using standard name resolution rules.
[in]columnNameName of the primary column for which the statistics are to be calculated.
[in]statsComma separated list of the statistics to calculate, e.g. "sum,mean". Supported values:
[in]optionsOptional parameters.
  • aggregate_statistics_additional_column_names: A list of comma separated column names over which statistics can be accumulated along with the primary column. All columns listed and columnName must be of the same type. Must not include the column specified in columnName and no column can be listed twice.
  • aggregate_statistics_weight_column_name: Name of column used as weighting attribute for the weighted average statistic.
The default value is an empty map.
Returns
Response object containing the result of the operation.

◆ aggregateStatistics() [4/4]

AggregateStatisticsResponse& gpudb::GPUdb::aggregateStatistics ( const std::string &  tableName,
const std::string &  columnName,
const std::string &  stats,
const std::map< std::string, std::string > &  options,
AggregateStatisticsResponse response_ 
) const

Calculates the requested statistics of the given column(s) in a given table.

The available statistics are: count (number of total objects), mean, stdv (standard deviation), variance, skew, kurtosis, sum, min, max, weighted_average, cardinality (unique count), estimated_cardinality, percentile, and percentile_rank.

Estimated cardinality is calculated by using the hyperloglog approximation technique.

Percentiles and percentile ranks are approximate and are calculated using the t-digest algorithm. They must include the desired percentile/percentile_rank. To compute multiple percentiles each value must be specified separately (i.e.\ 'percentile(75.0),percentile(99.0),percentile_rank(1234.56),percentile_rank(-5)').

A second, comma-separated value can be added to the percentile statistic to calculate percentile resolution, e.g., a 50th percentile with 200 resolution would be 'percentile(50,200)'.

The weighted average statistic requires a weight column to be specified in weight_column_name. The weighted average is then defined as the sum of the products of columnName times the weight_column_name values divided by the sum of the weight_column_name values.

Additional columns can be used in the calculation of statistics via additional_column_names. Values in these columns will be included in the overall aggregate calculation–individual aggregates will not be calculated per additional column. For instance, requesting the count & mean of columnName x and additional_column_names y & z, where x holds the numbers 1-10, y holds 11-20, and z holds 21-30, would return the total number of x, y, & z values (30), and the single average value across all x, y, & z values (15.5).

The response includes a list of key/value pairs of each statistic requested and its corresponding value.

Parameters
[in]tableNameName of the table on which the statistics operation will be performed, in [schema_name.]table_name format, using standard name resolution rules.
[in]columnNameName of the primary column for which the statistics are to be calculated.
[in]statsComma separated list of the statistics to calculate, e.g. "sum,mean". Supported values:
[in]optionsOptional parameters.
  • aggregate_statistics_additional_column_names: A list of comma separated column names over which statistics can be accumulated along with the primary column. All columns listed and columnName must be of the same type. Must not include the column specified in columnName and no column can be listed twice.
  • aggregate_statistics_weight_column_name: Name of column used as weighting attribute for the weighted average statistic.
The default value is an empty map.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ aggregateStatisticsByRange() [1/4]

AggregateStatisticsByRangeResponse gpudb::GPUdb::aggregateStatisticsByRange ( const AggregateStatisticsByRangeRequest request_) const

Divides the given set into bins and calculates statistics of the values of a value-column in each bin.

The bins are based on the values of a given binning-column. The statistics that may be requested are mean, stdv (standard deviation), variance, skew, kurtosis, sum, min, max, first, last and weighted average. In addition to the requested statistics the count of total samples in each bin is returned. This counts vector is just the histogram of the column used to divide the set members into bins. The weighted average statistic requires a weight column to be specified in weight_column_name. The weighted average is then defined as the sum of the products of the value column times the weight column divided by the sum of the weight column.

There are two methods for binning the set members. In the first, which can be used for numeric valued binning-columns, a min, max and interval are specified. The number of bins, nbins, is the integer upper bound of (max-min)/interval. Values that fall in the range [min+n*interval,min+(n+1)*interval) are placed in the nth bin where n ranges from 0..nbin-2. The final bin is [min+(nbin-1)*interval,max]. In the second method, bin_values specifies a list of binning column values. Binning-columns whose value matches the nth member of the bin_values list are placed in the nth bin. When a list is provided, the binning-column must be of type string or int.

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

Parameters
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

◆ aggregateStatisticsByRange() [2/4]

AggregateStatisticsByRangeResponse& gpudb::GPUdb::aggregateStatisticsByRange ( const AggregateStatisticsByRangeRequest request_,
AggregateStatisticsByRangeResponse response_ 
) const

Divides the given set into bins and calculates statistics of the values of a value-column in each bin.

The bins are based on the values of a given binning-column. The statistics that may be requested are mean, stdv (standard deviation), variance, skew, kurtosis, sum, min, max, first, last and weighted average. In addition to the requested statistics the count of total samples in each bin is returned. This counts vector is just the histogram of the column used to divide the set members into bins. The weighted average statistic requires a weight column to be specified in weight_column_name. The weighted average is then defined as the sum of the products of the value column times the weight column divided by the sum of the weight column.

There are two methods for binning the set members. In the first, which can be used for numeric valued binning-columns, a min, max and interval are specified. The number of bins, nbins, is the integer upper bound of (max-min)/interval. Values that fall in the range [min+n*interval,min+(n+1)*interval) are placed in the nth bin where n ranges from 0..nbin-2. The final bin is [min+(nbin-1)*interval,max]. In the second method, bin_values specifies a list of binning column values. Binning-columns whose value matches the nth member of the bin_values list are placed in the nth bin. When a list is provided, the binning-column must be of type string or int.

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

Parameters
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ aggregateStatisticsByRange() [3/4]

AggregateStatisticsByRangeResponse gpudb::GPUdb::aggregateStatisticsByRange ( const std::string &  tableName,
const std::string &  selectExpression,
const std::string &  columnName,
const std::string &  valueColumnName,
const std::string &  stats,
const double  start,
const double  end,
const double  interval,
const std::map< std::string, std::string > &  options 
) const

Divides the given set into bins and calculates statistics of the values of a value-column in each bin.

The bins are based on the values of a given binning-column. The statistics that may be requested are mean, stdv (standard deviation), variance, skew, kurtosis, sum, min, max, first, last and weighted average. In addition to the requested statistics the count of total samples in each bin is returned. This counts vector is just the histogram of the column used to divide the set members into bins. The weighted average statistic requires a weight column to be specified in weight_column_name. The weighted average is then defined as the sum of the products of the value column times the weight column divided by the sum of the weight column.

There are two methods for binning the set members. In the first, which can be used for numeric valued binning-columns, a min, max and interval are specified. The number of bins, nbins, is the integer upper bound of (max-min)/interval. Values that fall in the range [min+n*interval,min+(n+1)*interval) are placed in the nth bin where n ranges from 0..nbin-2. The final bin is [min+(nbin-1)*interval,max]. In the second method, bin_values specifies a list of binning column values. Binning-columns whose value matches the nth member of the bin_values list are placed in the nth bin. When a list is provided, the binning-column must be of type string or int.

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

Parameters
[in]tableNameName of the table on which the ranged-statistics operation will be performed, in [schema_name.]table_name format, using standard name resolution rules.
[in]selectExpressionFor a non-empty expression statistics are calculated for those records for which the expression is true. The default value is ''.
[in]columnNameName of the binning-column used to divide the set samples into bins.
[in]valueColumnNameName of the value-column for which statistics are to be computed.
[in]statsA string of comma separated list of the statistics to calculate, e.g. 'sum,mean'. Available statistics: mean, stdv (standard deviation), variance, skew, kurtosis, sum.
[in]startThe lower bound of the binning-column.
[in]endThe upper bound of the binning-column.
[in]intervalThe interval of a bin. Set members fall into bin i if the binning-column falls in the range [start+interval*i, start+interval*(i+1)).
[in]optionsMap of optional parameters: The default value is an empty map.
Returns
Response object containing the result of the operation.

◆ aggregateStatisticsByRange() [4/4]

AggregateStatisticsByRangeResponse& gpudb::GPUdb::aggregateStatisticsByRange ( const std::string &  tableName,
const std::string &  selectExpression,
const std::string &  columnName,
const std::string &  valueColumnName,
const std::string &  stats,
const double  start,
const double  end,
const double  interval,
const std::map< std::string, std::string > &  options,
AggregateStatisticsByRangeResponse response_ 
) const

Divides the given set into bins and calculates statistics of the values of a value-column in each bin.

The bins are based on the values of a given binning-column. The statistics that may be requested are mean, stdv (standard deviation), variance, skew, kurtosis, sum, min, max, first, last and weighted average. In addition to the requested statistics the count of total samples in each bin is returned. This counts vector is just the histogram of the column used to divide the set members into bins. The weighted average statistic requires a weight column to be specified in weight_column_name. The weighted average is then defined as the sum of the products of the value column times the weight column divided by the sum of the weight column.

There are two methods for binning the set members. In the first, which can be used for numeric valued binning-columns, a min, max and interval are specified. The number of bins, nbins, is the integer upper bound of (max-min)/interval. Values that fall in the range [min+n*interval,min+(n+1)*interval) are placed in the nth bin where n ranges from 0..nbin-2. The final bin is [min+(nbin-1)*interval,max]. In the second method, bin_values specifies a list of binning column values. Binning-columns whose value matches the nth member of the bin_values list are placed in the nth bin. When a list is provided, the binning-column must be of type string or int.

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

Parameters
[in]tableNameName of the table on which the ranged-statistics operation will be performed, in [schema_name.]table_name format, using standard name resolution rules.
[in]selectExpressionFor a non-empty expression statistics are calculated for those records for which the expression is true. The default value is ''.
[in]columnNameName of the binning-column used to divide the set samples into bins.
[in]valueColumnNameName of the value-column for which statistics are to be computed.
[in]statsA string of comma separated list of the statistics to calculate, e.g. 'sum,mean'. Available statistics: mean, stdv (standard deviation), variance, skew, kurtosis, sum.
[in]startThe lower bound of the binning-column.
[in]endThe upper bound of the binning-column.
[in]intervalThe interval of a bin. Set members fall into bin i if the binning-column falls in the range [start+interval*i, start+interval*(i+1)).
[in]optionsMap of optional parameters: The default value is an empty map.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ aggregateUnique() [1/4]

AggregateUniqueResponse gpudb::GPUdb::aggregateUnique ( const AggregateUniqueRequest request_) const

Returns all the unique values from a particular column (specified by columnName) of a particular table or view (specified by tableName).

If columnName is a numeric column, the values will be in binaryEncodedResponse. Otherwise if columnName is a string column, the values will be in jsonEncodedResponse. The results can be paged via offset and limit parameters.

Columns marked as store-only are unable to be used with this function.

To get the first 10 unique values sorted in descending order options would be:

{"limit":"10","sort_order":"descending"}

The response is returned as a dynamic schema. For details see: dynamic schemas documentation.

If a result_table name is specified in the options, the results are stored in a new table with that name–no results are returned in the response. Both the table name and resulting column name must adhere to standard naming conventions; any column expression will need to be aliased. If the source table's shard key is used as the columnName, the result table will be sharded, in all other cases it will be replicated. Sorting will properly function only if the result table is replicated or if there is only one processing node and should not be relied upon in other cases. Not available if the value of columnName is an unrestricted-length string.

Parameters
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

◆ aggregateUnique() [2/4]

AggregateUniqueResponse& gpudb::GPUdb::aggregateUnique ( const AggregateUniqueRequest request_,
AggregateUniqueResponse response_ 
) const

Returns all the unique values from a particular column (specified by columnName) of a particular table or view (specified by tableName).

If columnName is a numeric column, the values will be in binaryEncodedResponse. Otherwise if columnName is a string column, the values will be in jsonEncodedResponse. The results can be paged via offset and limit parameters.

Columns marked as store-only are unable to be used with this function.

To get the first 10 unique values sorted in descending order options would be:

{"limit":"10","sort_order":"descending"}

The response is returned as a dynamic schema. For details see: dynamic schemas documentation.

If a result_table name is specified in the options, the results are stored in a new table with that name–no results are returned in the response. Both the table name and resulting column name must adhere to standard naming conventions; any column expression will need to be aliased. If the source table's shard key is used as the columnName, the result table will be sharded, in all other cases it will be replicated. Sorting will properly function only if the result table is replicated or if there is only one processing node and should not be relied upon in other cases. Not available if the value of columnName is an unrestricted-length string.

Parameters
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ aggregateUnique() [3/4]

AggregateUniqueResponse gpudb::GPUdb::aggregateUnique ( const std::string &  tableName,
const std::string &  columnName,
const int64_t  offset,
const int64_t  limit,
const std::map< std::string, std::string > &  options 
) const

Returns all the unique values from a particular column (specified by columnName) of a particular table or view (specified by tableName).

If columnName is a numeric column, the values will be in binaryEncodedResponse. Otherwise if columnName is a string column, the values will be in jsonEncodedResponse. The results can be paged via offset and limit parameters.

Columns marked as store-only are unable to be used with this function.

To get the first 10 unique values sorted in descending order options would be:

{"limit":"10","sort_order":"descending"}

The response is returned as a dynamic schema. For details see: dynamic schemas documentation.

If a result_table name is specified in the options, the results are stored in a new table with that name–no results are returned in the response. Both the table name and resulting column name must adhere to standard naming conventions; any column expression will need to be aliased. If the source table's shard key is used as the columnName, the result table will be sharded, in all other cases it will be replicated. Sorting will properly function only if the result table is replicated or if there is only one processing node and should not be relied upon in other cases. Not available if the value of columnName is an unrestricted-length string.

Parameters
[in]tableNameName of an existing table or view on which the operation will be performed, in [schema_name.]table_name format, using standard name resolution rules.
[in]columnNameName of the column or an expression containing one or more column names on which the unique function would be applied.
[in]offsetA positive integer indicating the number of initial results to skip (this can be useful for paging through the results). The 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 maximum number of results allowed by the server should be returned. The number of records returned will never exceed the server's own limit, defined by the max_get_records_size parameter in the server configuration. Use hasMoreRecords to see if more records exist in the result to be fetched, and offset & limit to request subsequent pages of results. The default value is -9999.
[in]optionsOptional parameters. The default value is an empty map.
Returns
Response object containing the result of the operation.

◆ aggregateUnique() [4/4]

AggregateUniqueResponse& gpudb::GPUdb::aggregateUnique ( const std::string &  tableName,
const std::string &  columnName,
const int64_t  offset,
const int64_t  limit,
const std::map< std::string, std::string > &  options,
AggregateUniqueResponse response_ 
) const

Returns all the unique values from a particular column (specified by columnName) of a particular table or view (specified by tableName).

If columnName is a numeric column, the values will be in binaryEncodedResponse. Otherwise if columnName is a string column, the values will be in jsonEncodedResponse. The results can be paged via offset and limit parameters.

Columns marked as store-only are unable to be used with this function.

To get the first 10 unique values sorted in descending order options would be:

{"limit":"10","sort_order":"descending"}

The response is returned as a dynamic schema. For details see: dynamic schemas documentation.

If a result_table name is specified in the options, the results are stored in a new table with that name–no results are returned in the response. Both the table name and resulting column name must adhere to standard naming conventions; any column expression will need to be aliased. If the source table's shard key is used as the columnName, the result table will be sharded, in all other cases it will be replicated. Sorting will properly function only if the result table is replicated or if there is only one processing node and should not be relied upon in other cases. Not available if the value of columnName is an unrestricted-length string.

Parameters
[in]tableNameName of an existing table or view on which the operation will be performed, in [schema_name.]table_name format, using standard name resolution rules.
[in]columnNameName of the column or an expression containing one or more column names on which the unique function would be applied.
[in]offsetA positive integer indicating the number of initial results to skip (this can be useful for paging through the results). The 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 maximum number of results allowed by the server should be returned. The number of records returned will never exceed the server's own limit, defined by the max_get_records_size parameter in the server configuration. Use hasMoreRecords to see if more records exist in the result to be fetched, and offset & limit to request subsequent pages of results. The default value is -9999.
[in]optionsOptional parameters. The default value is an empty map.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ aggregateUniqueRaw() [1/2]

RawAggregateUniqueResponse gpudb::GPUdb::aggregateUniqueRaw ( const AggregateUniqueRequest request_) const

Returns all the unique values from a particular column (specified by columnName) of a particular table or view (specified by tableName).

If columnName is a numeric column, the values will be in binaryEncodedResponse. Otherwise if columnName is a string column, the values will be in jsonEncodedResponse. The results can be paged via offset and limit parameters.

Columns marked as store-only are unable to be used with this function.

To get the first 10 unique values sorted in descending order options would be:

{"limit":"10","sort_order":"descending"}

The response is returned as a dynamic schema. For details see: dynamic schemas documentation.

If a result_table name is specified in the options, the results are stored in a new table with that name–no results are returned in the response. Both the table name and resulting column name must adhere to standard naming conventions; any column expression will need to be aliased. If the source table's shard key is used as the columnName, the result table will be sharded, in all other cases it will be replicated. Sorting will properly function only if the result table is replicated or if there is only one processing node and should not be relied upon in other cases. Not available if the value of columnName is an unrestricted-length string.

Parameters
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

◆ aggregateUniqueRaw() [2/2]

RawAggregateUniqueResponse& gpudb::GPUdb::aggregateUniqueRaw ( const AggregateUniqueRequest request_,
RawAggregateUniqueResponse response_ 
) const

Returns all the unique values from a particular column (specified by columnName) of a particular table or view (specified by tableName).

If columnName is a numeric column, the values will be in binaryEncodedResponse. Otherwise if columnName is a string column, the values will be in jsonEncodedResponse. The results can be paged via offset and limit parameters.

Columns marked as store-only are unable to be used with this function.

To get the first 10 unique values sorted in descending order options would be:

{"limit":"10","sort_order":"descending"}

The response is returned as a dynamic schema. For details see: dynamic schemas documentation.

If a result_table name is specified in the options, the results are stored in a new table with that name–no results are returned in the response. Both the table name and resulting column name must adhere to standard naming conventions; any column expression will need to be aliased. If the source table's shard key is used as the columnName, the result table will be sharded, in all other cases it will be replicated. Sorting will properly function only if the result table is replicated or if there is only one processing node and should not be relied upon in other cases. Not available if the value of columnName is an unrestricted-length string.

Parameters
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ aggregateUnpivot() [1/4]

AggregateUnpivotResponse gpudb::GPUdb::aggregateUnpivot ( const AggregateUnpivotRequest request_) const

Rotate the column values into rows values.

For unpivot details and examples, see Unpivot. For limitations, see Unpivot Limitations.

Unpivot is used to normalize tables that are built for cross tabular reporting purposes. The unpivot operator rotates the column values for all the pivoted columns. A variable column, value column and all columns from the source table except the unpivot columns are projected into the result table. The variable column and value columns in the result table indicate the pivoted column name and values respectively.

The response is returned as a dynamic schema. For details see: dynamic schemas documentation.

Parameters
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

◆ aggregateUnpivot() [2/4]

AggregateUnpivotResponse& gpudb::GPUdb::aggregateUnpivot ( const AggregateUnpivotRequest request_,
AggregateUnpivotResponse response_ 
) const

Rotate the column values into rows values.

For unpivot details and examples, see Unpivot. For limitations, see Unpivot Limitations.

Unpivot is used to normalize tables that are built for cross tabular reporting purposes. The unpivot operator rotates the column values for all the pivoted columns. A variable column, value column and all columns from the source table except the unpivot columns are projected into the result table. The variable column and value columns in the result table indicate the pivoted column name and values respectively.

The response is returned as a dynamic schema. For details see: dynamic schemas documentation.

Parameters
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ aggregateUnpivot() [3/4]

AggregateUnpivotResponse gpudb::GPUdb::aggregateUnpivot ( const std::string &  tableName,
const std::vector< std::string > &  columnNames,
const std::string &  variableColumnName,
const std::string &  valueColumnName,
const std::vector< std::string > &  pivotedColumns,
const std::map< std::string, std::string > &  options 
) const

Rotate the column values into rows values.

For unpivot details and examples, see Unpivot. For limitations, see Unpivot Limitations.

Unpivot is used to normalize tables that are built for cross tabular reporting purposes. The unpivot operator rotates the column values for all the pivoted columns. A variable column, value column and all columns from the source table except the unpivot columns are projected into the result table. The variable column and value columns in the result table indicate the pivoted column name and values respectively.

The response is returned as a dynamic schema. For details see: dynamic schemas documentation.

Parameters
[in]tableNameName of the table on which the operation will be performed. Must be an existing table/view, in [schema_name.]table_name format, using standard name resolution rules.
[in]columnNamesList of column names or expressions. A wildcard '*' can be used to include all the non-pivoted columns from the source table.
[in]variableColumnNameSpecifies the variable/parameter column name. The default value is ''.
[in]valueColumnNameSpecifies the value column name. The default value is ''.
[in]pivotedColumnsList of one or more values typically the column names of the input table. All the columns in the source table must have the same data type.
[in]optionsOptional parameters. The default value is an empty map.
Returns
Response object containing the result of the operation.

◆ aggregateUnpivot() [4/4]

AggregateUnpivotResponse& gpudb::GPUdb::aggregateUnpivot ( const std::string &  tableName,
const std::vector< std::string > &  columnNames,
const std::string &  variableColumnName,
const std::string &  valueColumnName,
const std::vector< std::string > &  pivotedColumns,
const std::map< std::string, std::string > &  options,
AggregateUnpivotResponse response_ 
) const

Rotate the column values into rows values.

For unpivot details and examples, see Unpivot. For limitations, see Unpivot Limitations.

Unpivot is used to normalize tables that are built for cross tabular reporting purposes. The unpivot operator rotates the column values for all the pivoted columns. A variable column, value column and all columns from the source table except the unpivot columns are projected into the result table. The variable column and value columns in the result table indicate the pivoted column name and values respectively.

The response is returned as a dynamic schema. For details see: dynamic schemas documentation.

Parameters
[in]tableNameName of the table on which the operation will be performed. Must be an existing table/view, in [schema_name.]table_name format, using standard name resolution rules.
[in]columnNamesList of column names or expressions. A wildcard '*' can be used to include all the non-pivoted columns from the source table.
[in]variableColumnNameSpecifies the variable/parameter column name. The default value is ''.
[in]valueColumnNameSpecifies the value column name. The default value is ''.
[in]pivotedColumnsList of one or more values typically the column names of the input table. All the columns in the source table must have the same data type.
[in]optionsOptional parameters. The default value is an empty map.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ aggregateUnpivotRaw() [1/2]

RawAggregateUnpivotResponse gpudb::GPUdb::aggregateUnpivotRaw ( const AggregateUnpivotRequest request_) const

Rotate the column values into rows values.

For unpivot details and examples, see Unpivot. For limitations, see Unpivot Limitations.

Unpivot is used to normalize tables that are built for cross tabular reporting purposes. The unpivot operator rotates the column values for all the pivoted columns. A variable column, value column and all columns from the source table except the unpivot columns are projected into the result table. The variable column and value columns in the result table indicate the pivoted column name and values respectively.

The response is returned as a dynamic schema. For details see: dynamic schemas documentation.

Parameters
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

◆ aggregateUnpivotRaw() [2/2]

RawAggregateUnpivotResponse& gpudb::GPUdb::aggregateUnpivotRaw ( const AggregateUnpivotRequest request_,
RawAggregateUnpivotResponse response_ 
) const

Rotate the column values into rows values.

For unpivot details and examples, see Unpivot. For limitations, see Unpivot Limitations.

Unpivot is used to normalize tables that are built for cross tabular reporting purposes. The unpivot operator rotates the column values for all the pivoted columns. A variable column, value column and all columns from the source table except the unpivot columns are projected into the result table. The variable column and value columns in the result table indicate the pivoted column name and values respectively.

The response is returned as a dynamic schema. For details see: dynamic schemas documentation.

Parameters
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ alterCredential() [1/4]

AlterCredentialResponse gpudb::GPUdb::alterCredential ( const AlterCredentialRequest request_) const

Alter the properties of an existing credential.

Parameters
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

◆ alterCredential() [2/4]

AlterCredentialResponse& gpudb::GPUdb::alterCredential ( const AlterCredentialRequest request_,
AlterCredentialResponse response_ 
) const

Alter the properties of an existing credential.

Parameters
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ alterCredential() [3/4]

AlterCredentialResponse gpudb::GPUdb::alterCredential ( const std::string &  credentialName,
const std::map< std::string, std::string > &  credentialUpdatesMap,
const std::map< std::string, std::string > &  options 
) const

Alter the properties of an existing credential.

Parameters
[in]credentialNameName of the credential to be altered. Must be an existing credential.
[in]credentialUpdatesMapMap containing the properties of the credential to be updated. Error if empty.
[in]optionsOptional parameters.
Returns
Response object containing the result of the operation.

◆ alterCredential() [4/4]

AlterCredentialResponse& gpudb::GPUdb::alterCredential ( const std::string &  credentialName,
const std::map< std::string, std::string > &  credentialUpdatesMap,
const std::map< std::string, std::string > &  options,
AlterCredentialResponse response_ 
) const

Alter the properties of an existing credential.

Parameters
[in]credentialNameName of the credential to be altered. Must be an existing credential.
[in]credentialUpdatesMapMap containing the properties of the credential to be updated. Error if empty.
[in]optionsOptional parameters.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ alterDatasink() [1/4]

AlterDatasinkResponse gpudb::GPUdb::alterDatasink ( const AlterDatasinkRequest request_) const

Alters the properties of an existing data sink

Parameters
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

◆ alterDatasink() [2/4]

AlterDatasinkResponse& gpudb::GPUdb::alterDatasink ( const AlterDatasinkRequest request_,
AlterDatasinkResponse response_ 
) const

Alters the properties of an existing data sink

Parameters
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ alterDatasink() [3/4]

AlterDatasinkResponse gpudb::GPUdb::alterDatasink ( const std::string &  name,
const std::map< std::string, std::string > &  datasinkUpdatesMap,
const std::map< std::string, std::string > &  options 
) const

Alters the properties of an existing data sink

Parameters
[in]nameName of the data sink to be altered. Must be an existing data sink.
[in]datasinkUpdatesMapMap containing the properties of the data sink to be updated. Error if empty.
[in]optionsOptional parameters.
Returns
Response object containing the result of the operation.

◆ alterDatasink() [4/4]

AlterDatasinkResponse& gpudb::GPUdb::alterDatasink ( const std::string &  name,
const std::map< std::string, std::string > &  datasinkUpdatesMap,
const std::map< std::string, std::string > &  options,
AlterDatasinkResponse response_ 
) const

Alters the properties of an existing data sink

Parameters
[in]nameName of the data sink to be altered. Must be an existing data sink.
[in]datasinkUpdatesMapMap containing the properties of the data sink to be updated. Error if empty.
[in]optionsOptional parameters.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ alterDatasource() [1/4]

AlterDatasourceResponse gpudb::GPUdb::alterDatasource ( const AlterDatasourceRequest request_) const

Alters the properties of an existing data source

Parameters
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

◆ alterDatasource() [2/4]

AlterDatasourceResponse& gpudb::GPUdb::alterDatasource ( const AlterDatasourceRequest request_,
AlterDatasourceResponse response_ 
) const

Alters the properties of an existing data source

Parameters
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ alterDatasource() [3/4]

AlterDatasourceResponse gpudb::GPUdb::alterDatasource ( const std::string &  name,
const std::map< std::string, std::string > &  datasourceUpdatesMap,
const std::map< std::string, std::string > &  options 
) const

Alters the properties of an existing data source

Parameters
[in]nameName of the data source to be altered. Must be an existing data source.
[in]datasourceUpdatesMapMap containing the properties of the data source to be updated. Error if empty.
[in]optionsOptional parameters.
Returns
Response object containing the result of the operation.

◆ alterDatasource() [4/4]

AlterDatasourceResponse& gpudb::GPUdb::alterDatasource ( const std::string &  name,
const std::map< std::string, std::string > &  datasourceUpdatesMap,
const std::map< std::string, std::string > &  options,
AlterDatasourceResponse response_ 
) const

Alters the properties of an existing data source

Parameters
[in]nameName of the data source to be altered. Must be an existing data source.
[in]datasourceUpdatesMapMap containing the properties of the data source to be updated. Error if empty.
[in]optionsOptional parameters.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ alterDirectory() [1/4]

AlterDirectoryResponse gpudb::GPUdb::alterDirectory ( const AlterDirectoryRequest request_) const

Alters an existing directory in KiFS.

Parameters
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

◆ alterDirectory() [2/4]

AlterDirectoryResponse& gpudb::GPUdb::alterDirectory ( const AlterDirectoryRequest request_,
AlterDirectoryResponse response_ 
) const

Alters an existing directory in KiFS.

Parameters
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ alterDirectory() [3/4]

AlterDirectoryResponse gpudb::GPUdb::alterDirectory ( const std::string &  directoryName,
const std::map< std::string, std::string > &  directoryUpdatesMap,
const std::map< std::string, std::string > &  options 
) const

Alters an existing directory in KiFS.

Parameters
[in]directoryNameName of the directory in KiFS to be altered.
[in]directoryUpdatesMapMap containing the properties of the directory to be altered. Error if empty.
[in]optionsOptional parameters. The default value is an empty map.
Returns
Response object containing the result of the operation.

◆ alterDirectory() [4/4]

AlterDirectoryResponse& gpudb::GPUdb::alterDirectory ( const std::string &  directoryName,
const std::map< std::string, std::string > &  directoryUpdatesMap,
const std::map< std::string, std::string > &  options,
AlterDirectoryResponse response_ 
) const

Alters an existing directory in KiFS.

Parameters
[in]directoryNameName of the directory in KiFS to be altered.
[in]directoryUpdatesMapMap containing the properties of the directory to be altered. Error if empty.
[in]optionsOptional parameters. The default value is an empty map.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ alterEnvironment() [1/4]

AlterEnvironmentResponse gpudb::GPUdb::alterEnvironment ( const AlterEnvironmentRequest request_) const

Alters an existing environment which can be referenced by a user-defined function (UDF).

Parameters
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

◆ alterEnvironment() [2/4]

AlterEnvironmentResponse& gpudb::GPUdb::alterEnvironment ( const AlterEnvironmentRequest request_,
AlterEnvironmentResponse response_ 
) const

Alters an existing environment which can be referenced by a user-defined function (UDF).

Parameters
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ alterEnvironment() [3/4]

AlterEnvironmentResponse gpudb::GPUdb::alterEnvironment ( const std::string &  environmentName,
const std::string &  action,
const std::string &  value,
const std::map< std::string, std::string > &  options 
) const

Alters an existing environment which can be referenced by a user-defined function (UDF).

Parameters
[in]environmentNameName of the environment to be altered.
[in]actionModification operation to be applied. Supported values:
[in]valueThe value of the modification, depending on action. For example, if action is install_package, this would be the python package name. If action is install_requirements, this would be the path of a requirements file from which to install packages. If an external data source is specified in datasource_name, this can be the path to a wheel file or source archive. Alternatively, if installing from a file (wheel or source archive), the value may be a reference to a file in KiFS.
[in]optionsOptional parameters. The default value is an empty map.
Returns
Response object containing the result of the operation.

◆ alterEnvironment() [4/4]

AlterEnvironmentResponse& gpudb::GPUdb::alterEnvironment ( const std::string &  environmentName,
const std::string &  action,
const std::string &  value,
const std::map< std::string, std::string > &  options,
AlterEnvironmentResponse response_ 
) const

Alters an existing environment which can be referenced by a user-defined function (UDF).

Parameters
[in]environmentNameName of the environment to be altered.
[in]actionModification operation to be applied. Supported values:
[in]valueThe value of the modification, depending on action. For example, if action is install_package, this would be the python package name. If action is install_requirements, this would be the path of a requirements file from which to install packages. If an external data source is specified in datasource_name, this can be the path to a wheel file or source archive. Alternatively, if installing from a file (wheel or source archive), the value may be a reference to a file in KiFS.
[in]optionsOptional parameters. The default value is an empty map.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ alterResourceGroup() [1/4]

AlterResourceGroupResponse gpudb::GPUdb::alterResourceGroup ( const AlterResourceGroupRequest request_) const

Alters the properties of an exisiting resource group to facilitate resource management.

Parameters
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

◆ alterResourceGroup() [2/4]

AlterResourceGroupResponse& gpudb::GPUdb::alterResourceGroup ( const AlterResourceGroupRequest request_,
AlterResourceGroupResponse response_ 
) const

Alters the properties of an exisiting resource group to facilitate resource management.

Parameters
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ alterResourceGroup() [3/4]

AlterResourceGroupResponse gpudb::GPUdb::alterResourceGroup ( const std::string &  name,
const std::map< std::string, std::map< std::string, std::string > > &  tierAttributes,
const std::string &  ranking,
const std::string &  adjoiningResourceGroup,
const std::map< std::string, std::string > &  options 
) const

Alters the properties of an exisiting resource group to facilitate resource management.

Parameters
[in]nameName of the group to be altered. Must be an existing resource group name or an empty string when used inconjunction with the is_default_group option.
[in]tierAttributesOptional map containing tier names and their respective attribute group limits. The only valid attribute limit that can be set is max_memory (in bytes) for the VRAM & RAM tiers. For instance, to set max VRAM capacity to 1GB and max RAM capacity to 10GB, use: {'VRAM':{'max_memory':'1000000000'}, 'RAM':{'max_memory':'10000000000'}}. The default value is an empty map.
[in]rankingIf the resource group ranking is to be updated, this indicates the relative ranking among existing resource groups where this resource group will be moved; leave blank if not changing the ranking. When using before or after, specify which resource group this one will be inserted before or after in adjoiningResourceGroup. Supported values: The default value is alter_resource_group_empty_string.
[in]adjoiningResourceGroupIf ranking is before or after, this field indicates the resource group before or after which the current group will be placed; otherwise, leave blank. The default value is ''.
[in]optionsOptional parameters. The default value is an empty map.
Returns
Response object containing the result of the operation.

◆ alterResourceGroup() [4/4]

AlterResourceGroupResponse& gpudb::GPUdb::alterResourceGroup ( const std::string &  name,
const std::map< std::string, std::map< std::string, std::string > > &  tierAttributes,
const std::string &  ranking,
const std::string &  adjoiningResourceGroup,
const std::map< std::string, std::string > &  options,
AlterResourceGroupResponse response_ 
) const

Alters the properties of an exisiting resource group to facilitate resource management.

Parameters
[in]nameName of the group to be altered. Must be an existing resource group name or an empty string when used inconjunction with the is_default_group option.
[in]tierAttributesOptional map containing tier names and their respective attribute group limits. The only valid attribute limit that can be set is max_memory (in bytes) for the VRAM & RAM tiers. For instance, to set max VRAM capacity to 1GB and max RAM capacity to 10GB, use: {'VRAM':{'max_memory':'1000000000'}, 'RAM':{'max_memory':'10000000000'}}. The default value is an empty map.
[in]rankingIf the resource group ranking is to be updated, this indicates the relative ranking among existing resource groups where this resource group will be moved; leave blank if not changing the ranking. When using before or after, specify which resource group this one will be inserted before or after in adjoiningResourceGroup. Supported values: The default value is alter_resource_group_empty_string.
[in]adjoiningResourceGroupIf ranking is before or after, this field indicates the resource group before or after which the current group will be placed; otherwise, leave blank. The default value is ''.
[in]optionsOptional parameters. The default value is an empty map.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ alterRole() [1/4]

AlterRoleResponse gpudb::GPUdb::alterRole ( const AlterRoleRequest request_) const

Alters a Role.

Parameters
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

◆ alterRole() [2/4]

AlterRoleResponse& gpudb::GPUdb::alterRole ( const AlterRoleRequest request_,
AlterRoleResponse response_ 
) const

Alters a Role.

Parameters
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ alterRole() [3/4]

AlterRoleResponse gpudb::GPUdb::alterRole ( const std::string &  name,
const std::string &  action,
const std::string &  value,
const std::map< std::string, std::string > &  options 
) const

Alters a Role.

Parameters
[in]nameName of the role to be altered. Must be an existing role.
[in]actionModification operation to be applied to the role. Supported values:
[in]valueThe value of the modification, depending on action.
[in]optionsOptional parameters. The default value is an empty map.
Returns
Response object containing the result of the operation.

◆ alterRole() [4/4]

AlterRoleResponse& gpudb::GPUdb::alterRole ( const std::string &  name,
const std::string &  action,
const std::string &  value,
const std::map< std::string, std::string > &  options,
AlterRoleResponse response_ 
) const

Alters a Role.

Parameters
[in]nameName of the role to be altered. Must be an existing role.
[in]actionModification operation to be applied to the role. Supported values:
[in]valueThe value of the modification, depending on action.
[in]optionsOptional parameters. The default value is an empty map.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ alterSchema() [1/4]

AlterSchemaResponse gpudb::GPUdb::alterSchema ( const AlterSchemaRequest request_) const

Used to change the name of a SQL-style schema, specified in schemaName.

Parameters
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

◆ alterSchema() [2/4]

AlterSchemaResponse& gpudb::GPUdb::alterSchema ( const AlterSchemaRequest request_,
AlterSchemaResponse response_ 
) const

Used to change the name of a SQL-style schema, specified in schemaName.

Parameters
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ alterSchema() [3/4]

AlterSchemaResponse gpudb::GPUdb::alterSchema ( const std::string &  schemaName,
const std::string &  action,
const std::string &  value,
const std::map< std::string, std::string > &  options 
) const

Used to change the name of a SQL-style schema, specified in schemaName.

Parameters
[in]schemaNameName of the schema to be altered.
[in]actionModification operation to be applied. Supported values:
[in]valueThe value of the modification, depending on action. For now the only value of action is rename_schema. In this case the value is the new name of the schema.
[in]optionsOptional parameters. The default value is an empty map.
Returns
Response object containing the result of the operation.

◆ alterSchema() [4/4]

AlterSchemaResponse& gpudb::GPUdb::alterSchema ( const std::string &  schemaName,
const std::string &  action,
const std::string &  value,
const std::map< std::string, std::string > &  options,
AlterSchemaResponse response_ 
) const

Used to change the name of a SQL-style schema, specified in schemaName.

Parameters
[in]schemaNameName of the schema to be altered.
[in]actionModification operation to be applied. Supported values:
[in]valueThe value of the modification, depending on action. For now the only value of action is rename_schema. In this case the value is the new name of the schema.
[in]optionsOptional parameters. The default value is an empty map.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ alterSystemProperties() [1/4]

AlterSystemPropertiesResponse gpudb::GPUdb::alterSystemProperties ( const AlterSystemPropertiesRequest request_) const

The alterSystemProperties endpoint is primarily used to simplify the testing of the system and is not expected to be used during normal execution.

Commands are given through the propertyUpdatesMap whose keys are commands and values are strings representing integer values (for example '8000') or boolean values ('true' or 'false').

Parameters
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

◆ alterSystemProperties() [2/4]

AlterSystemPropertiesResponse& gpudb::GPUdb::alterSystemProperties ( const AlterSystemPropertiesRequest request_,
AlterSystemPropertiesResponse response_ 
) const

The alterSystemProperties endpoint is primarily used to simplify the testing of the system and is not expected to be used during normal execution.

Commands are given through the propertyUpdatesMap whose keys are commands and values are strings representing integer values (for example '8000') or boolean values ('true' or 'false').

Parameters
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ alterSystemProperties() [3/4]

AlterSystemPropertiesResponse gpudb::GPUdb::alterSystemProperties ( const std::map< std::string, std::string > &  propertyUpdatesMap,
const std::map< std::string, std::string > &  options 
) const

The alterSystemProperties endpoint is primarily used to simplify the testing of the system and is not expected to be used during normal execution.

Commands are given through the propertyUpdatesMap whose keys are commands and values are strings representing integer values (for example '8000') or boolean values ('true' or 'false').

Parameters
[in]propertyUpdatesMapMap containing the properties of the system to be updated. Error if empty.
[in]optionsOptional parameters. The default value is an empty map.
Returns
Response object containing the result of the operation.

◆ alterSystemProperties() [4/4]

AlterSystemPropertiesResponse& gpudb::GPUdb::alterSystemProperties ( const std::map< std::string, std::string > &  propertyUpdatesMap,
const std::map< std::string, std::string > &  options,
AlterSystemPropertiesResponse response_ 
) const

The alterSystemProperties endpoint is primarily used to simplify the testing of the system and is not expected to be used during normal execution.

Commands are given through the propertyUpdatesMap whose keys are commands and values are strings representing integer values (for example '8000') or boolean values ('true' or 'false').

Parameters
[in]propertyUpdatesMapMap containing the properties of the system to be updated. Error if empty.
[in]optionsOptional parameters. The default value is an empty map.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ alterTable() [1/4]

AlterTableResponse gpudb::GPUdb::alterTable ( const AlterTableRequest request_) const

Apply various modifications to a table or view.

The available modifications include the following:

Manage a table's columns–a column can be added, removed, or have its type and properties modified, including whether it is dictionary encoded or not.

External tables cannot be modified except for their refresh method.

Create or delete a column, low-cardinality index, chunk skip, geospatial, CAGRA, or HNSW index. This can speed up certain operations when using expressions containing equality or relational operators on indexed columns. This only applies to tables.

Create or delete a foreign key on a particular column.

Manage a range-partitioned or a manual list-partitioned table's partitions.

Set (or reset) the tier strategy of a table or view.

Refresh and manage the refresh mode of a materialized view or an external table.

Set the time-to-live (TTL). This can be applied to tables or views.

Set the global access mode (i.e. locking) for a table. This setting trumps any role-based access controls that may be in place; e.g., a user with write access to a table marked read-only will not be able to insert records into it. The mode can be set to read-only, write-only, read/write, and no access.

Parameters
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

◆ alterTable() [2/4]

AlterTableResponse& gpudb::GPUdb::alterTable ( const AlterTableRequest request_,
AlterTableResponse response_ 
) const

Apply various modifications to a table or view.

The available modifications include the following:

Manage a table's columns–a column can be added, removed, or have its type and properties modified, including whether it is dictionary encoded or not.

External tables cannot be modified except for their refresh method.

Create or delete a column, low-cardinality index, chunk skip, geospatial, CAGRA, or HNSW index. This can speed up certain operations when using expressions containing equality or relational operators on indexed columns. This only applies to tables.

Create or delete a foreign key on a particular column.

Manage a range-partitioned or a manual list-partitioned table's partitions.

Set (or reset) the tier strategy of a table or view.

Refresh and manage the refresh mode of a materialized view or an external table.

Set the time-to-live (TTL). This can be applied to tables or views.

Set the global access mode (i.e. locking) for a table. This setting trumps any role-based access controls that may be in place; e.g., a user with write access to a table marked read-only will not be able to insert records into it. The mode can be set to read-only, write-only, read/write, and no access.

Parameters
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ alterTable() [3/4]

AlterTableResponse gpudb::GPUdb::alterTable ( const std::string &  tableName,
const std::string &  action,
const std::string &  value,
const std::map< std::string, std::string > &  options 
) const

Apply various modifications to a table or view.

The available modifications include the following:

Manage a table's columns–a column can be added, removed, or have its type and properties modified, including whether it is dictionary encoded or not.

External tables cannot be modified except for their refresh method.

Create or delete a column, low-cardinality index, chunk skip, geospatial, CAGRA, or HNSW index. This can speed up certain operations when using expressions containing equality or relational operators on indexed columns. This only applies to tables.

Create or delete a foreign key on a particular column.

Manage a range-partitioned or a manual list-partitioned table's partitions.

Set (or reset) the tier strategy of a table or view.

Refresh and manage the refresh mode of a materialized view or an external table.

Set the time-to-live (TTL). This can be applied to tables or views.

Set the global access mode (i.e. locking) for a table. This setting trumps any role-based access controls that may be in place; e.g., a user with write access to a table marked read-only will not be able to insert records into it. The mode can be set to read-only, write-only, read/write, and no access.

Parameters
[in]tableNameTable on which the operation will be performed, in [schema_name.]table_name format, using standard name resolution rules. Must be an existing table or view.
[in]actionModification operation to be applied. Supported values:
[in]valueThe value of the modification, depending on action. For example, if action is add_column, this would be the column name; while the column's definition would be covered by the column_type, column_properties, column_default_value, and add_column_expression in options. If action is ttl, it would be the number of minutes for the new TTL. If action is refresh, this field would be blank.
[in]optionsOptional parameters. The default value is an empty map.
Returns
Response object containing the result of the operation.

◆ alterTable() [4/4]

AlterTableResponse& gpudb::GPUdb::alterTable ( const std::string &  tableName,
const std::string &  action,
const std::string &  value,
const std::map< std::string, std::string > &  options,
AlterTableResponse response_ 
) const

Apply various modifications to a table or view.

The available modifications include the following:

Manage a table's columns–a column can be added, removed, or have its type and properties modified, including whether it is dictionary encoded or not.

External tables cannot be modified except for their refresh method.

Create or delete a column, low-cardinality index, chunk skip, geospatial, CAGRA, or HNSW index. This can speed up certain operations when using expressions containing equality or relational operators on indexed columns. This only applies to tables.

Create or delete a foreign key on a particular column.

Manage a range-partitioned or a manual list-partitioned table's partitions.

Set (or reset) the tier strategy of a table or view.

Refresh and manage the refresh mode of a materialized view or an external table.

Set the time-to-live (TTL). This can be applied to tables or views.

Set the global access mode (i.e. locking) for a table. This setting trumps any role-based access controls that may be in place; e.g., a user with write access to a table marked read-only will not be able to insert records into it. The mode can be set to read-only, write-only, read/write, and no access.

Parameters
[in]tableNameTable on which the operation will be performed, in [schema_name.]table_name format, using standard name resolution rules. Must be an existing table or view.
[in]actionModification operation to be applied. Supported values:
[in]valueThe value of the modification, depending on action. For example, if action is add_column, this would be the column name; while the column's definition would be covered by the column_type, column_properties, column_default_value, and add_column_expression in options. If action is ttl, it would be the number of minutes for the new TTL. If action is refresh, this field would be blank.
[in]optionsOptional parameters. The default value is an empty map.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ alterTableColumns() [1/4]

AlterTableColumnsResponse gpudb::GPUdb::alterTableColumns ( const AlterTableColumnsRequest request_) const

Apply various modifications to columns in a table, view.

The available modifications include the following:

Create or delete an index on a particular column. This can speed up certain operations when using expressions containing equality or relational operators on indexed columns. This only applies to tables.

Manage a table's columns–a column can be added, removed, or have its type and properties modified, including whether it is dictionary encoded or not.

Parameters
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

◆ alterTableColumns() [2/4]

AlterTableColumnsResponse& gpudb::GPUdb::alterTableColumns ( const AlterTableColumnsRequest request_,
AlterTableColumnsResponse response_ 
) const

Apply various modifications to columns in a table, view.

The available modifications include the following:

Create or delete an index on a particular column. This can speed up certain operations when using expressions containing equality or relational operators on indexed columns. This only applies to tables.

Manage a table's columns–a column can be added, removed, or have its type and properties modified, including whether it is dictionary encoded or not.

Parameters
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ alterTableColumns() [3/4]

AlterTableColumnsResponse gpudb::GPUdb::alterTableColumns ( const std::string &  tableName,
const std::vector< std::map< std::string, std::string > > &  columnAlterations,
const std::map< std::string, std::string > &  options 
) const

Apply various modifications to columns in a table, view.

The available modifications include the following:

Create or delete an index on a particular column. This can speed up certain operations when using expressions containing equality or relational operators on indexed columns. This only applies to tables.

Manage a table's columns–a column can be added, removed, or have its type and properties modified, including whether it is dictionary encoded or not.

Parameters
[in]tableNameTable on which the operation will be performed. Must be an existing table or view, in [schema_name.]table_name format, using standard name resolution rules.
[in]columnAlterationsList of alter table add/delete/change column requests - all for the same table. Each request is a map that includes 'column_name', 'action' and the options specific for the action. Note that the same options as in alter table requests but in the same map as the column name and the action. For example: [{'column_name':'col_1','action':'change_column','rename_column':'col_2'},{'column_name':'col_1','action':'add_column', 'type':'int','default_value':'1'}]
[in]optionsOptional parameters.
Returns
Response object containing the result of the operation.

◆ alterTableColumns() [4/4]

AlterTableColumnsResponse& gpudb::GPUdb::alterTableColumns ( const std::string &  tableName,
const std::vector< std::map< std::string, std::string > > &  columnAlterations,
const std::map< std::string, std::string > &  options,
AlterTableColumnsResponse response_ 
) const

Apply various modifications to columns in a table, view.

The available modifications include the following:

Create or delete an index on a particular column. This can speed up certain operations when using expressions containing equality or relational operators on indexed columns. This only applies to tables.

Manage a table's columns–a column can be added, removed, or have its type and properties modified, including whether it is dictionary encoded or not.

Parameters
[in]tableNameTable on which the operation will be performed. Must be an existing table or view, in [schema_name.]table_name format, using standard name resolution rules.
[in]columnAlterationsList of alter table add/delete/change column requests - all for the same table. Each request is a map that includes 'column_name', 'action' and the options specific for the action. Note that the same options as in alter table requests but in the same map as the column name and the action. For example: [{'column_name':'col_1','action':'change_column','rename_column':'col_2'},{'column_name':'col_1','action':'add_column', 'type':'int','default_value':'1'}]
[in]optionsOptional parameters.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ alterTableMetadata() [1/4]

AlterTableMetadataResponse gpudb::GPUdb::alterTableMetadata ( const AlterTableMetadataRequest request_) const

Updates (adds or changes) metadata for tables.

The metadata key and values must both be strings. This is an easy way to annotate whole tables rather than single records within tables. Some examples of metadata are owner of the table, table creation timestamp etc.

Parameters
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

◆ alterTableMetadata() [2/4]

AlterTableMetadataResponse& gpudb::GPUdb::alterTableMetadata ( const AlterTableMetadataRequest request_,
AlterTableMetadataResponse response_ 
) const

Updates (adds or changes) metadata for tables.

The metadata key and values must both be strings. This is an easy way to annotate whole tables rather than single records within tables. Some examples of metadata are owner of the table, table creation timestamp etc.

Parameters
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ alterTableMetadata() [3/4]

AlterTableMetadataResponse gpudb::GPUdb::alterTableMetadata ( const std::vector< std::string > &  tableNames,
const std::map< std::string, std::string > &  metadataMap,
const std::map< std::string, std::string > &  options 
) const

Updates (adds or changes) metadata for tables.

The metadata key and values must both be strings. This is an easy way to annotate whole tables rather than single records within tables. Some examples of metadata are owner of the table, table creation timestamp etc.

Parameters
[in]tableNamesNames of the tables whose metadata will be updated, in [schema_name.]table_name format, using standard name resolution rules. All specified tables must exist, or an error will be returned.
[in]metadataMapA map which contains the metadata of the tables that are to be updated. Note that only one map is provided for all the tables; so the change will be applied to every table. If the provided map is empty, then all existing metadata for the table(s) will be cleared.
[in]optionsOptional parameters. The default value is an empty map.
Returns
Response object containing the result of the operation.

◆ alterTableMetadata() [4/4]

AlterTableMetadataResponse& gpudb::GPUdb::alterTableMetadata ( const std::vector< std::string > &  tableNames,
const std::map< std::string, std::string > &  metadataMap,
const std::map< std::string, std::string > &  options,
AlterTableMetadataResponse response_ 
) const

Updates (adds or changes) metadata for tables.

The metadata key and values must both be strings. This is an easy way to annotate whole tables rather than single records within tables. Some examples of metadata are owner of the table, table creation timestamp etc.

Parameters
[in]tableNamesNames of the tables whose metadata will be updated, in [schema_name.]table_name format, using standard name resolution rules. All specified tables must exist, or an error will be returned.
[in]metadataMapA map which contains the metadata of the tables that are to be updated. Note that only one map is provided for all the tables; so the change will be applied to every table. If the provided map is empty, then all existing metadata for the table(s) will be cleared.
[in]optionsOptional parameters. The default value is an empty map.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ alterTableMonitor() [1/4]

AlterTableMonitorResponse gpudb::GPUdb::alterTableMonitor ( const AlterTableMonitorRequest request_) const

Alters a table monitor previously created with createTableMonitor.

Parameters
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

◆ alterTableMonitor() [2/4]

AlterTableMonitorResponse& gpudb::GPUdb::alterTableMonitor ( const AlterTableMonitorRequest request_,
AlterTableMonitorResponse response_ 
) const

Alters a table monitor previously created with createTableMonitor.

Parameters
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ alterTableMonitor() [3/4]

AlterTableMonitorResponse gpudb::GPUdb::alterTableMonitor ( const std::string &  topicId,
const std::map< std::string, std::string > &  monitorUpdatesMap,
const std::map< std::string, std::string > &  options 
) const

Alters a table monitor previously created with createTableMonitor.

Parameters
[in]topicIdThe topic ID returned by createTableMonitor.
[in]monitorUpdatesMapMap containing the properties of the table monitor to be updated. Error if empty.
[in]optionsOptional parameters.
Returns
Response object containing the result of the operation.

◆ alterTableMonitor() [4/4]

AlterTableMonitorResponse& gpudb::GPUdb::alterTableMonitor ( const std::string &  topicId,
const std::map< std::string, std::string > &  monitorUpdatesMap,
const std::map< std::string, std::string > &  options,
AlterTableMonitorResponse response_ 
) const

Alters a table monitor previously created with createTableMonitor.

Parameters
[in]topicIdThe topic ID returned by createTableMonitor.
[in]monitorUpdatesMapMap containing the properties of the table monitor to be updated. Error if empty.
[in]optionsOptional parameters.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ alterTier() [1/4]

AlterTierResponse gpudb::GPUdb::alterTier ( const AlterTierRequest request_) const

Alters properties of an exisiting tier to facilitate resource management.

To disable watermark-based eviction, set both high_watermark and low_watermark to 100.

Parameters
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

◆ alterTier() [2/4]

AlterTierResponse& gpudb::GPUdb::alterTier ( const AlterTierRequest request_,
AlterTierResponse response_ 
) const

Alters properties of an exisiting tier to facilitate resource management.

To disable watermark-based eviction, set both high_watermark and low_watermark to 100.

Parameters
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ alterTier() [3/4]

AlterTierResponse gpudb::GPUdb::alterTier ( const std::string &  name,
const std::map< std::string, std::string > &  options 
) const

Alters properties of an exisiting tier to facilitate resource management.

To disable watermark-based eviction, set both high_watermark and low_watermark to 100.

Parameters
[in]nameName of the tier to be altered. Must be an existing tier group name.
[in]optionsOptional parameters.
  • alter_tier_capacity: Maximum size in bytes this tier may hold at once.
  • alter_tier_high_watermark: Threshold of usage of this tier's resource that once exceeded, will trigger watermark-based eviction from this tier. The minimum allowed value is '0'. The maximum allowed value is '100'.
  • alter_tier_low_watermark: Threshold of resource usage that once fallen below after crossing the high_watermark, will cease watermark-based eviction from this tier. The minimum allowed value is '0'. The maximum allowed value is '100'.
  • alter_tier_wait_timeout: Timeout in seconds for reading from or writing to this resource. Applies to cold storage tiers only.
  • alter_tier_persist: If true the system configuration will be written to disk upon successful application of this request. This will commit the changes from this request and any additional in-memory modifications. Supported values: The default value is alter_tier_true.
  • alter_tier_rank: Apply the requested change only to a specific rank. The minimum allowed value is '0'. The maximum allowed value is '10000'.
The default value is an empty map.
Returns
Response object containing the result of the operation.

◆ alterTier() [4/4]

AlterTierResponse& gpudb::GPUdb::alterTier ( const std::string &  name,
const std::map< std::string, std::string > &  options,
AlterTierResponse response_ 
) const

Alters properties of an exisiting tier to facilitate resource management.

To disable watermark-based eviction, set both high_watermark and low_watermark to 100.

Parameters
[in]nameName of the tier to be altered. Must be an existing tier group name.
[in]optionsOptional parameters.
  • alter_tier_capacity: Maximum size in bytes this tier may hold at once.
  • alter_tier_high_watermark: Threshold of usage of this tier's resource that once exceeded, will trigger watermark-based eviction from this tier. The minimum allowed value is '0'. The maximum allowed value is '100'.
  • alter_tier_low_watermark: Threshold of resource usage that once fallen below after crossing the high_watermark, will cease watermark-based eviction from this tier. The minimum allowed value is '0'. The maximum allowed value is '100'.
  • alter_tier_wait_timeout: Timeout in seconds for reading from or writing to this resource. Applies to cold storage tiers only.
  • alter_tier_persist: If true the system configuration will be written to disk upon successful application of this request. This will commit the changes from this request and any additional in-memory modifications. Supported values: The default value is alter_tier_true.
  • alter_tier_rank: Apply the requested change only to a specific rank. The minimum allowed value is '0'. The maximum allowed value is '10000'.
The default value is an empty map.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ alterUser() [1/4]

AlterUserResponse gpudb::GPUdb::alterUser ( const AlterUserRequest request_) const

Alters a user.

Parameters
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

◆ alterUser() [2/4]

AlterUserResponse& gpudb::GPUdb::alterUser ( const AlterUserRequest request_,
AlterUserResponse response_ 
) const

Alters a user.

Parameters
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ alterUser() [3/4]

AlterUserResponse gpudb::GPUdb::alterUser ( const std::string &  name,
const std::string &  action,
const std::string &  value,
const std::map< std::string, std::string > &  options 
) const

Alters a user.

Parameters
[in]nameName of the user to be altered. Must be an existing user.
[in]actionModification operation to be applied to the user. Supported values:
[in]valueThe value of the modification, depending on action.
[in]optionsOptional parameters. The default value is an empty map.
Returns
Response object containing the result of the operation.

◆ alterUser() [4/4]

AlterUserResponse& gpudb::GPUdb::alterUser ( const std::string &  name,
const std::string &  action,
const std::string &  value,
const std::map< std::string, std::string > &  options,
AlterUserResponse response_ 
) const

Alters a user.

Parameters
[in]nameName of the user to be altered. Must be an existing user.
[in]actionModification operation to be applied to the user. Supported values:
[in]valueThe value of the modification, depending on action.
[in]optionsOptional parameters. The default value is an empty map.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ alterVideo() [1/4]

AlterVideoResponse gpudb::GPUdb::alterVideo ( const AlterVideoRequest request_) const

Alters a video.

Parameters
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

◆ alterVideo() [2/4]

AlterVideoResponse& gpudb::GPUdb::alterVideo ( const AlterVideoRequest request_,
AlterVideoResponse response_ 
) const

Alters a video.

Parameters
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ alterVideo() [3/4]

AlterVideoResponse gpudb::GPUdb::alterVideo ( const std::string &  path,
const std::map< std::string, std::string > &  options 
) const

Alters a video.

Parameters
[in]pathFully-qualified KiFS path to the video to be altered.
[in]optionsOptional parameters. The default value is an empty map.
Returns
Response object containing the result of the operation.

◆ alterVideo() [4/4]

AlterVideoResponse& gpudb::GPUdb::alterVideo ( const std::string &  path,
const std::map< std::string, std::string > &  options,
AlterVideoResponse response_ 
) const

Alters a video.

Parameters
[in]pathFully-qualified KiFS path to the video to be altered.
[in]optionsOptional parameters. The default value is an empty map.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ alterWal() [1/4]

AlterWalResponse gpudb::GPUdb::alterWal ( const AlterWalRequest request_) const

Alters table wal settings.

Returns information about the requested table wal modifications.

Parameters
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

◆ alterWal() [2/4]

AlterWalResponse& gpudb::GPUdb::alterWal ( const AlterWalRequest request_,
AlterWalResponse response_ 
) const

Alters table wal settings.

Returns information about the requested table wal modifications.

Parameters
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ alterWal() [3/4]

AlterWalResponse gpudb::GPUdb::alterWal ( const std::vector< std::string > &  tableNames,
const std::map< std::string, std::string > &  options 
) const

Alters table wal settings.

Returns information about the requested table wal modifications.

Parameters
[in]tableNamesList of tables to modify. An asterisk changes the system settings.
[in]optionsOptional parameters. The default value is an empty map.
Returns
Response object containing the result of the operation.

◆ alterWal() [4/4]

AlterWalResponse& gpudb::GPUdb::alterWal ( const std::vector< std::string > &  tableNames,
const std::map< std::string, std::string > &  options,
AlterWalResponse response_ 
) const

Alters table wal settings.

Returns information about the requested table wal modifications.

Parameters
[in]tableNamesList of tables to modify. An asterisk changes the system settings.
[in]optionsOptional parameters. The default value is an empty map.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ appendRecords() [1/4]

AppendRecordsResponse gpudb::GPUdb::appendRecords ( const AppendRecordsRequest request_) const

Append (or insert) all records from a source table (specified by sourceTableName) to a particular target table (specified by tableName).

The field map (specified by fieldMap) holds the user specified map of target table column names with their mapped source column names.

Parameters
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

◆ appendRecords() [2/4]

AppendRecordsResponse& gpudb::GPUdb::appendRecords ( const AppendRecordsRequest request_,
AppendRecordsResponse response_ 
) const

Append (or insert) all records from a source table (specified by sourceTableName) to a particular target table (specified by tableName).

The field map (specified by fieldMap) holds the user specified map of target table column names with their mapped source column names.

Parameters
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ appendRecords() [3/4]

AppendRecordsResponse gpudb::GPUdb::appendRecords ( const std::string &  tableName,
const std::string &  sourceTableName,
const std::map< std::string, std::string > &  fieldMap,
const std::map< std::string, std::string > &  options 
) const

Append (or insert) all records from a source table (specified by sourceTableName) to a particular target table (specified by tableName).

The field map (specified by fieldMap) holds the user specified map of target table column names with their mapped source column names.

Parameters
[in]tableNameThe table name for the records to be appended, in [schema_name.]table_name format, using standard name resolution rules. Must be an existing table.
[in]sourceTableNameThe source table name to get records from, in [schema_name.]table_name format, using standard name resolution rules. Must be an existing table name.
[in]fieldMapContains the mapping of column names from the target table (specified by tableName) as the keys, and corresponding column names or expressions (e.g., 'col_name+1') from the source table (specified by sourceTableName). Must be existing column names in source table and target table, and their types must be matched. For details on using expressions, see Expressions.
[in]optionsOptional parameters.
  • append_records_offset: A positive integer indicating the number of initial results to skip from sourceTableName. Default is 0. The minimum allowed value is 0. The maximum allowed value is MAX_INT. The default value is '0'.
  • append_records_limit: A positive integer indicating the maximum number of results to be returned from sourceTableName. Or END_OF_SET (-9999) to indicate that the max number of results should be returned. The default value is '-9999'.
  • append_records_expression: Optional filter expression to apply to the sourceTableName. The default value is ''.
  • append_records_order_by: Comma-separated list of the columns to be sorted by from source table (specified by sourceTableName), e.g., 'timestamp asc, x desc'. The order_by columns do not have to be present in fieldMap. The default value is ''.
  • append_records_update_on_existing_pk: Specifies the record collision policy for inserting source table records (specified by sourceTableName) into a target table (specified by tableName) with a primary key. If set to true, any existing table record with primary key values that match those of a source table record being inserted will be replaced by that new record (the new data will be "upserted"). If set to false, any existing table record with primary key values that match those of a source table record being inserted will remain unchanged, while the source record will be rejected and an error handled as determined by ignore_existing_pk. If the specified table does not have a primary key, then this option has no effect. Supported values: The default value is append_records_false.
  • append_records_ignore_existing_pk: Specifies the record collision error-suppression policy for inserting source table records (specified by sourceTableName) into a target table (specified by tableName) with a primary key, only used when not in upsert mode (upsert mode is disabled when update_on_existing_pk is false). If set to true, any source table record being inserted that is rejected for having primary key values that match those of an existing target table record will be ignored with no error generated. If false, the rejection of any source table record for having primary key values matching an existing target table record will result in an error being raised. If the specified table does not have a primary key or if upsert mode is in effect (update_on_existing_pk is true), then this option has no effect. Supported values:
    • append_records_true: Ignore source table records whose primary key values collide with those of target table records
    • append_records_false: Raise an error for any source table record whose primary key values collide with those of a target table record
    The default value is append_records_false.
  • append_records_truncate_strings: If set to true, it allows inserting longer strings into smaller charN string columns by truncating the longer strings to fit. Supported values: The default value is append_records_false.
The default value is an empty map.
Returns
Response object containing the result of the operation.

◆ appendRecords() [4/4]

AppendRecordsResponse& gpudb::GPUdb::appendRecords ( const std::string &  tableName,
const std::string &  sourceTableName,
const std::map< std::string, std::string > &  fieldMap,
const std::map< std::string, std::string > &  options,
AppendRecordsResponse response_ 
) const

Append (or insert) all records from a source table (specified by sourceTableName) to a particular target table (specified by tableName).

The field map (specified by fieldMap) holds the user specified map of target table column names with their mapped source column names.

Parameters
[in]tableNameThe table name for the records to be appended, in [schema_name.]table_name format, using standard name resolution rules. Must be an existing table.
[in]sourceTableNameThe source table name to get records from, in [schema_name.]table_name format, using standard name resolution rules. Must be an existing table name.
[in]fieldMapContains the mapping of column names from the target table (specified by tableName) as the keys, and corresponding column names or expressions (e.g., 'col_name+1') from the source table (specified by sourceTableName). Must be existing column names in source table and target table, and their types must be matched. For details on using expressions, see Expressions.
[in]optionsOptional parameters.
  • append_records_offset: A positive integer indicating the number of initial results to skip from sourceTableName. Default is 0. The minimum allowed value is 0. The maximum allowed value is MAX_INT. The default value is '0'.
  • append_records_limit: A positive integer indicating the maximum number of results to be returned from sourceTableName. Or END_OF_SET (-9999) to indicate that the max number of results should be returned. The default value is '-9999'.
  • append_records_expression: Optional filter expression to apply to the sourceTableName. The default value is ''.
  • append_records_order_by: Comma-separated list of the columns to be sorted by from source table (specified by sourceTableName), e.g., 'timestamp asc, x desc'. The order_by columns do not have to be present in fieldMap. The default value is ''.
  • append_records_update_on_existing_pk: Specifies the record collision policy for inserting source table records (specified by sourceTableName) into a target table (specified by tableName) with a primary key. If set to true, any existing table record with primary key values that match those of a source table record being inserted will be replaced by that new record (the new data will be "upserted"). If set to false, any existing table record with primary key values that match those of a source table record being inserted will remain unchanged, while the source record will be rejected and an error handled as determined by ignore_existing_pk. If the specified table does not have a primary key, then this option has no effect. Supported values: The default value is append_records_false.
  • append_records_ignore_existing_pk: Specifies the record collision error-suppression policy for inserting source table records (specified by sourceTableName) into a target table (specified by tableName) with a primary key, only used when not in upsert mode (upsert mode is disabled when update_on_existing_pk is false). If set to true, any source table record being inserted that is rejected for having primary key values that match those of an existing target table record will be ignored with no error generated. If false, the rejection of any source table record for having primary key values matching an existing target table record will result in an error being raised. If the specified table does not have a primary key or if upsert mode is in effect (update_on_existing_pk is true), then this option has no effect. Supported values:
    • append_records_true: Ignore source table records whose primary key values collide with those of target table records
    • append_records_false: Raise an error for any source table record whose primary key values collide with those of a target table record
    The default value is append_records_false.
  • append_records_truncate_strings: If set to true, it allows inserting longer strings into smaller charN string columns by truncating the longer strings to fit. Supported values: The default value is append_records_false.
The default value is an empty map.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ clearStatistics() [1/4]

ClearStatisticsResponse gpudb::GPUdb::clearStatistics ( const ClearStatisticsRequest request_) const

Clears statistics (cardinality, mean value, etc.) for a column in a specified table.

Parameters
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

◆ clearStatistics() [2/4]

ClearStatisticsResponse& gpudb::GPUdb::clearStatistics ( const ClearStatisticsRequest request_,
ClearStatisticsResponse response_ 
) const

Clears statistics (cardinality, mean value, etc.) for a column in a specified table.

Parameters
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ clearStatistics() [3/4]

ClearStatisticsResponse gpudb::GPUdb::clearStatistics ( const std::string &  tableName,
const std::string &  columnName,
const std::map< std::string, std::string > &  options 
) const

Clears statistics (cardinality, mean value, etc.) for a column in a specified table.

Parameters
[in]tableNameName of a table, in [schema_name.]table_name format, using standard name resolution rules. Must be an existing table. The default value is ''.
[in]columnNameName of the column in tableName for which to clear statistics. The column must be from an existing table. An empty string clears statistics for all columns in the table. The default value is ''.
[in]optionsOptional parameters. The default value is an empty map.
Returns
Response object containing the result of the operation.

◆ clearStatistics() [4/4]

ClearStatisticsResponse& gpudb::GPUdb::clearStatistics ( const std::string &  tableName,
const std::string &  columnName,
const std::map< std::string, std::string > &  options,
ClearStatisticsResponse response_ 
) const

Clears statistics (cardinality, mean value, etc.) for a column in a specified table.

Parameters
[in]tableNameName of a table, in [schema_name.]table_name format, using standard name resolution rules. Must be an existing table. The default value is ''.
[in]columnNameName of the column in tableName for which to clear statistics. The column must be from an existing table. An empty string clears statistics for all columns in the table. The default value is ''.
[in]optionsOptional parameters. The default value is an empty map.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ clearTable() [1/4]

ClearTableResponse gpudb::GPUdb::clearTable ( const ClearTableRequest request_) const

Clears (drops) one or all tables in the database cluster.

The operation is synchronous meaning that the table will be cleared before the function returns. The response payload returns the status of the operation along with the name of the table that was cleared.

Parameters
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

◆ clearTable() [2/4]

ClearTableResponse& gpudb::GPUdb::clearTable ( const ClearTableRequest request_,
ClearTableResponse response_ 
) const

Clears (drops) one or all tables in the database cluster.

The operation is synchronous meaning that the table will be cleared before the function returns. The response payload returns the status of the operation along with the name of the table that was cleared.

Parameters
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ clearTable() [3/4]

ClearTableResponse gpudb::GPUdb::clearTable ( const std::string &  tableName,
const std::string &  authorization,
const std::map< std::string, std::string > &  options 
) const

Clears (drops) one or all tables in the database cluster.

The operation is synchronous meaning that the table will be cleared before the function returns. The response payload returns the status of the operation along with the name of the table that was cleared.

Parameters
[in]tableNameName of the table to be cleared, in [schema_name.]table_name format, using standard name resolution rules. Must be an existing table. Empty string clears all available tables, though this behavior is be prevented by default via gpudb.conf parameter 'disable_clear_all'. The default value is ''.
[in]authorizationNo longer used. User can pass an empty string. The default value is ''.
[in]optionsOptional parameters. The default value is an empty map.
Returns
Response object containing the result of the operation.

◆ clearTable() [4/4]

ClearTableResponse& gpudb::GPUdb::clearTable ( const std::string &  tableName,
const std::string &  authorization,
const std::map< std::string, std::string > &  options,
ClearTableResponse response_ 
) const

Clears (drops) one or all tables in the database cluster.

The operation is synchronous meaning that the table will be cleared before the function returns. The response payload returns the status of the operation along with the name of the table that was cleared.

Parameters
[in]tableNameName of the table to be cleared, in [schema_name.]table_name format, using standard name resolution rules. Must be an existing table. Empty string clears all available tables, though this behavior is be prevented by default via gpudb.conf parameter 'disable_clear_all'. The default value is ''.
[in]authorizationNo longer used. User can pass an empty string. The default value is ''.
[in]optionsOptional parameters. The default value is an empty map.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ clearTableMonitor() [1/4]

ClearTableMonitorResponse gpudb::GPUdb::clearTableMonitor ( const ClearTableMonitorRequest request_) const

Deactivates a table monitor previously created with createTableMonitor.

Parameters
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

◆ clearTableMonitor() [2/4]

ClearTableMonitorResponse& gpudb::GPUdb::clearTableMonitor ( const ClearTableMonitorRequest request_,
ClearTableMonitorResponse response_ 
) const

Deactivates a table monitor previously created with createTableMonitor.

Parameters
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ clearTableMonitor() [3/4]

ClearTableMonitorResponse gpudb::GPUdb::clearTableMonitor ( const std::string &  topicId,
const std::map< std::string, std::string > &  options 
) const

Deactivates a table monitor previously created with createTableMonitor.

Parameters
[in]topicIdThe topic ID returned by createTableMonitor.
[in]optionsOptional parameters. The default value is an empty map.
Returns
Response object containing the result of the operation.

◆ clearTableMonitor() [4/4]

ClearTableMonitorResponse& gpudb::GPUdb::clearTableMonitor ( const std::string &  topicId,
const std::map< std::string, std::string > &  options,
ClearTableMonitorResponse response_ 
) const

Deactivates a table monitor previously created with createTableMonitor.

Parameters
[in]topicIdThe topic ID returned by createTableMonitor.
[in]optionsOptional parameters. The default value is an empty map.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ clearTrigger() [1/4]

ClearTriggerResponse gpudb::GPUdb::clearTrigger ( const ClearTriggerRequest request_) const

Clears or cancels the trigger identified by the specified handle.

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

Parameters
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

◆ clearTrigger() [2/4]

ClearTriggerResponse& gpudb::GPUdb::clearTrigger ( const ClearTriggerRequest request_,
ClearTriggerResponse response_ 
) const

Clears or cancels the trigger identified by the specified handle.

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

Parameters
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ clearTrigger() [3/4]

ClearTriggerResponse gpudb::GPUdb::clearTrigger ( const std::string &  triggerId,
const std::map< std::string, std::string > &  options 
) const

Clears or cancels the trigger identified by the specified handle.

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

Parameters
[in]triggerIdID for the trigger to be deactivated.
[in]optionsOptional parameters. The default value is an empty map.
Returns
Response object containing the result of the operation.

◆ clearTrigger() [4/4]

ClearTriggerResponse& gpudb::GPUdb::clearTrigger ( const std::string &  triggerId,
const std::map< std::string, std::string > &  options,
ClearTriggerResponse response_ 
) const

Clears or cancels the trigger identified by the specified handle.

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

Parameters
[in]triggerIdID for the trigger to be deactivated.
[in]optionsOptional parameters. The default value is an empty map.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ collectStatistics() [1/4]

CollectStatisticsResponse gpudb::GPUdb::collectStatistics ( const CollectStatisticsRequest request_) const

Collect statistics for a column(s) in a specified table.

Parameters
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

◆ collectStatistics() [2/4]

CollectStatisticsResponse& gpudb::GPUdb::collectStatistics ( const CollectStatisticsRequest request_,
CollectStatisticsResponse response_ 
) const

Collect statistics for a column(s) in a specified table.

Parameters
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ collectStatistics() [3/4]

CollectStatisticsResponse gpudb::GPUdb::collectStatistics ( const std::string &  tableName,
const std::vector< std::string > &  columnNames,
const std::map< std::string, std::string > &  options 
) const

Collect statistics for a column(s) in a specified table.

Parameters
[in]tableNameName of a table, in [schema_name.]table_name format, using standard name resolution rules. Must be an existing table.
[in]columnNamesList of one or more column names in tableName for which to collect statistics (cardinality, mean value, etc.).
[in]optionsOptional parameters. The default value is an empty map.
Returns
Response object containing the result of the operation.

◆ collectStatistics() [4/4]

CollectStatisticsResponse& gpudb::GPUdb::collectStatistics ( const std::string &  tableName,
const std::vector< std::string > &  columnNames,
const std::map< std::string, std::string > &  options,
CollectStatisticsResponse response_ 
) const

Collect statistics for a column(s) in a specified table.

Parameters
[in]tableNameName of a table, in [schema_name.]table_name format, using standard name resolution rules. Must be an existing table.
[in]columnNamesList of one or more column names in tableName for which to collect statistics (cardinality, mean value, etc.).
[in]optionsOptional parameters. The default value is an empty map.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ createCredential() [1/4]

CreateCredentialResponse gpudb::GPUdb::createCredential ( const CreateCredentialRequest request_) const

Create a new credential.

Parameters
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

◆ createCredential() [2/4]

CreateCredentialResponse& gpudb::GPUdb::createCredential ( const CreateCredentialRequest request_,
CreateCredentialResponse response_ 
) const

Create a new credential.

Parameters
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ createCredential() [3/4]

CreateCredentialResponse gpudb::GPUdb::createCredential ( const std::string &  credentialName,
const std::string &  type,
const std::string &  identity,
const std::string &  secret,
const std::map< std::string, std::string > &  options 
) const

Create a new credential.

Parameters
[in]credentialNameName of the credential to be created. Must contain only letters, digits, and underscores, and cannot begin with a digit. Must not match an existing credential name.
[in]typeType of the credential to be created. Supported values:
[in]identityUser of the credential to be created.
[in]secretPassword of the credential to be created.
[in]optionsOptional parameters. The default value is an empty map.
Returns
Response object containing the result of the operation.

◆ createCredential() [4/4]

CreateCredentialResponse& gpudb::GPUdb::createCredential ( const std::string &  credentialName,
const std::string &  type,
const std::string &  identity,
const std::string &  secret,
const std::map< std::string, std::string > &  options,
CreateCredentialResponse response_ 
) const

Create a new credential.

Parameters
[in]credentialNameName of the credential to be created. Must contain only letters, digits, and underscores, and cannot begin with a digit. Must not match an existing credential name.
[in]typeType of the credential to be created. Supported values:
[in]identityUser of the credential to be created.
[in]secretPassword of the credential to be created.
[in]optionsOptional parameters. The default value is an empty map.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ createDatasink() [1/4]

CreateDatasinkResponse gpudb::GPUdb::createDatasink ( const CreateDatasinkRequest request_) const

Creates a data sink, which contains the destination information for a data sink that is external to the database.

Parameters
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

◆ createDatasink() [2/4]

CreateDatasinkResponse& gpudb::GPUdb::createDatasink ( const CreateDatasinkRequest request_,
CreateDatasinkResponse response_ 
) const

Creates a data sink, which contains the destination information for a data sink that is external to the database.

Parameters
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ createDatasink() [3/4]

CreateDatasinkResponse gpudb::GPUdb::createDatasink ( const std::string &  name,
const std::string &  destination,
const std::map< std::string, std::string > &  options 
) const

Creates a data sink, which contains the destination information for a data sink that is external to the database.

Parameters
[in]nameName of the data sink to be created.
[in]destinationDestination for the output data in format 'storage_provider_type://path[:port]'. Supported storage provider types are 'azure', 'gcs', 'hdfs', 'http', 'https', 'jdbc', 'kafka', and 's3'.
[in]optionsOptional parameters. The default value is an empty map.
Returns
Response object containing the result of the operation.

◆ createDatasink() [4/4]

CreateDatasinkResponse& gpudb::GPUdb::createDatasink ( const std::string &  name,
const std::string &  destination,
const std::map< std::string, std::string > &  options,
CreateDatasinkResponse response_ 
) const

Creates a data sink, which contains the destination information for a data sink that is external to the database.

Parameters
[in]nameName of the data sink to be created.
[in]destinationDestination for the output data in format 'storage_provider_type://path[:port]'. Supported storage provider types are 'azure', 'gcs', 'hdfs', 'http', 'https', 'jdbc', 'kafka', and 's3'.
[in]optionsOptional parameters. The default value is an empty map.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ createDatasource() [1/4]

CreateDatasourceResponse gpudb::GPUdb::createDatasource ( const CreateDatasourceRequest request_) const

Creates a data source, which contains the location and connection information for a data store that is external to the database.

Parameters
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

◆ createDatasource() [2/4]

CreateDatasourceResponse& gpudb::GPUdb::createDatasource ( const CreateDatasourceRequest request_,
CreateDatasourceResponse response_ 
) const

Creates a data source, which contains the location and connection information for a data store that is external to the database.

Parameters
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ createDatasource() [3/4]

CreateDatasourceResponse gpudb::GPUdb::createDatasource ( const std::string &  name,
const std::string &  location,
const std::string &  userName,
const std::string &  password,
const std::map< std::string, std::string > &  options 
) const

Creates a data source, which contains the location and connection information for a data store that is external to the database.

Parameters
[in]nameName of the data source to be created.
[in]locationLocation of the remote storage in 'storage_provider_type://[storage_path[:storage_port]]' format. Supported storage provider types are 'azure', 'gcs', 'hdfs', 'jdbc', 'kafka', 'confluent', and 's3'.
[in]userNameName of the remote system user; may be an empty string
[in]passwordPassword for the remote system user; may be an empty string
[in]optionsOptional parameters. The default value is an empty map.
Returns
Response object containing the result of the operation.

◆ createDatasource() [4/4]

CreateDatasourceResponse& gpudb::GPUdb::createDatasource ( const std::string &  name,
const std::string &  location,
const std::string &  userName,
const std::string &  password,
const std::map< std::string, std::string > &  options,
CreateDatasourceResponse response_ 
) const

Creates a data source, which contains the location and connection information for a data store that is external to the database.

Parameters
[in]nameName of the data source to be created.
[in]locationLocation of the remote storage in 'storage_provider_type://[storage_path[:storage_port]]' format. Supported storage provider types are 'azure', 'gcs', 'hdfs', 'jdbc', 'kafka', 'confluent', and 's3'.
[in]userNameName of the remote system user; may be an empty string
[in]passwordPassword for the remote system user; may be an empty string
[in]optionsOptional parameters. The default value is an empty map.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ createDirectory() [1/4]

CreateDirectoryResponse gpudb::GPUdb::createDirectory ( const CreateDirectoryRequest request_) const

Creates a new directory in KiFS.

The new directory serves as a location in which the user can upload files using uploadFiles.

Parameters
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

◆ createDirectory() [2/4]

CreateDirectoryResponse& gpudb::GPUdb::createDirectory ( const CreateDirectoryRequest request_,
CreateDirectoryResponse response_ 
) const

Creates a new directory in KiFS.

The new directory serves as a location in which the user can upload files using uploadFiles.

Parameters
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ createDirectory() [3/4]

CreateDirectoryResponse gpudb::GPUdb::createDirectory ( const std::string &  directoryName,
const std::map< std::string, std::string > &  options 
) const

Creates a new directory in KiFS.

The new directory serves as a location in which the user can upload files using uploadFiles.

Parameters
[in]directoryNameName of the directory in KiFS to be created.
[in]optionsOptional parameters. The default value is an empty map.
Returns
Response object containing the result of the operation.

◆ createDirectory() [4/4]

CreateDirectoryResponse& gpudb::GPUdb::createDirectory ( const std::string &  directoryName,
const std::map< std::string, std::string > &  options,
CreateDirectoryResponse response_ 
) const

Creates a new directory in KiFS.

The new directory serves as a location in which the user can upload files using uploadFiles.

Parameters
[in]directoryNameName of the directory in KiFS to be created.
[in]optionsOptional parameters. The default value is an empty map.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ createEnvironment() [1/4]

CreateEnvironmentResponse gpudb::GPUdb::createEnvironment ( const CreateEnvironmentRequest request_) const

Creates a new environment which can be used by user-defined functions (UDF).

Parameters
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

◆ createEnvironment() [2/4]

CreateEnvironmentResponse& gpudb::GPUdb::createEnvironment ( const CreateEnvironmentRequest request_,
CreateEnvironmentResponse response_ 
) const

Creates a new environment which can be used by user-defined functions (UDF).

Parameters
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ createEnvironment() [3/4]

CreateEnvironmentResponse gpudb::GPUdb::createEnvironment ( const std::string &  environmentName,
const std::map< std::string, std::string > &  options 
) const

Creates a new environment which can be used by user-defined functions (UDF).

Parameters
[in]environmentNameName of the environment to be created.
[in]optionsOptional parameters. The default value is an empty map.
Returns
Response object containing the result of the operation.

◆ createEnvironment() [4/4]

CreateEnvironmentResponse& gpudb::GPUdb::createEnvironment ( const std::string &  environmentName,
const std::map< std::string, std::string > &  options,
CreateEnvironmentResponse response_ 
) const

Creates a new environment which can be used by user-defined functions (UDF).

Parameters
[in]environmentNameName of the environment to be created.
[in]optionsOptional parameters. The default value is an empty map.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ createGraph() [1/4]

CreateGraphResponse gpudb::GPUdb::createGraph ( const CreateGraphRequest request_) const

Creates a new graph network using given nodes, edges, weights, and restrictions.

IMPORTANT: It's highly recommended that you review the Graphs & Solvers concepts documentation, the Graph REST Tutorial, and/or some graph examples before using this endpoint.

Parameters
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

◆ createGraph() [2/4]

CreateGraphResponse& gpudb::GPUdb::createGraph ( const CreateGraphRequest request_,
CreateGraphResponse response_ 
) const

Creates a new graph network using given nodes, edges, weights, and restrictions.

IMPORTANT: It's highly recommended that you review the Graphs & Solvers concepts documentation, the Graph REST Tutorial, and/or some graph examples before using this endpoint.

Parameters
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ createGraph() [3/4]

CreateGraphResponse gpudb::GPUdb::createGraph ( const std::string &  graphName,
const bool  directedGraph,
const std::vector< std::string > &  nodes,
const std::vector< std::string > &  edges,
const std::vector< std::string > &  weights,
const std::vector< std::string > &  restrictions,
const std::map< std::string, std::string > &  options 
) const

Creates a new graph network using given nodes, edges, weights, and restrictions.

IMPORTANT: It's highly recommended that you review the Graphs & Solvers concepts documentation, the Graph REST Tutorial, and/or some graph examples before using this endpoint.

Parameters
[in]graphNameName of the graph resource to generate.
[in]directedGraphIf set to true, the graph will be directed. If set to false, the graph will not be directed. Consult Directed Graphs for more details. Supported values:
  • true
  • false
The default value is true.
[in]nodesNodes represent fundamental topological units of a graph. Nodes must be specified using identifiers; identifiers are grouped as combinations. Identifiers can be used with existing column names, e.g., 'table.column AS NODE_ID', expressions, e.g., 'ST_MAKEPOINT(column1, column2) AS NODE_WKTPOINT', or constant values, e.g., '{9, 10, 11} AS NODE_ID'. If using constant values in an identifier combination, the number of values specified must match across the combination.
[in]edgesEdges represent the required fundamental topological unit of a graph that typically connect nodes. Edges must be specified using identifiers; identifiers are grouped as combinations. Identifiers can be used with existing column names, e.g., 'table.column AS EDGE_ID', expressions, e.g., 'SUBSTR(column, 1, 6) AS EDGE_NODE1_NAME', or constant values, e.g., "{'family', 'coworker'} AS EDGE_LABEL". If using constant values in an identifier combination, the number of values specified must match across the combination.
[in]weightsWeights represent a method of informing the graph solver of the cost of including a given edge in a solution. Weights must be specified using identifiers; identifiers are grouped as combinations. Identifiers can be used with existing column names, e.g., 'table.column AS WEIGHTS_EDGE_ID', expressions, e.g., 'ST_LENGTH(wkt) AS WEIGHTS_VALUESPECIFIED', or constant values, e.g., '{4, 15} AS WEIGHTS_VALUESPECIFIED'. If using constant values in an identifier combination, the number of values specified must match across the combination.
[in]restrictionsRestrictions represent a method of informing the graph solver which edges and/or nodes should be ignored for the solution. Restrictions must be specified using identifiers; identifiers are grouped as combinations. Identifiers can be used with existing column names, e.g., 'table.column AS RESTRICTIONS_EDGE_ID', expressions, e.g., 'column/2 AS RESTRICTIONS_VALUECOMPARED', or constant values, e.g., '{0, 0, 0, 1} AS RESTRICTIONS_ONOFFCOMPARED'. If using constant values in an identifier combination, the number of values specified must match across the combination.
[in]optionsOptional parameters. The default value is an empty map.
Returns
Response object containing the result of the operation.

◆ createGraph() [4/4]

CreateGraphResponse& gpudb::GPUdb::createGraph ( const std::string &  graphName,
const bool  directedGraph,
const std::vector< std::string > &  nodes,
const std::vector< std::string > &  edges,
const std::vector< std::string > &  weights,
const std::vector< std::string > &  restrictions,
const std::map< std::string, std::string > &  options,
CreateGraphResponse response_ 
) const

Creates a new graph network using given nodes, edges, weights, and restrictions.

IMPORTANT: It's highly recommended that you review the Graphs & Solvers concepts documentation, the Graph REST Tutorial, and/or some graph examples before using this endpoint.

Parameters
[in]graphNameName of the graph resource to generate.
[in]directedGraphIf set to true, the graph will be directed. If set to false, the graph will not be directed. Consult Directed Graphs for more details. Supported values:
  • true
  • false
The default value is true.
[in]nodesNodes represent fundamental topological units of a graph. Nodes must be specified using identifiers; identifiers are grouped as combinations. Identifiers can be used with existing column names, e.g., 'table.column AS NODE_ID', expressions, e.g., 'ST_MAKEPOINT(column1, column2) AS NODE_WKTPOINT', or constant values, e.g., '{9, 10, 11} AS NODE_ID'. If using constant values in an identifier combination, the number of values specified must match across the combination.
[in]edgesEdges represent the required fundamental topological unit of a graph that typically connect nodes. Edges must be specified using identifiers; identifiers are grouped as combinations. Identifiers can be used with existing column names, e.g., 'table.column AS EDGE_ID', expressions, e.g., 'SUBSTR(column, 1, 6) AS EDGE_NODE1_NAME', or constant values, e.g., "{'family', 'coworker'} AS EDGE_LABEL". If using constant values in an identifier combination, the number of values specified must match across the combination.
[in]weightsWeights represent a method of informing the graph solver of the cost of including a given edge in a solution. Weights must be specified using identifiers; identifiers are grouped as combinations. Identifiers can be used with existing column names, e.g., 'table.column AS WEIGHTS_EDGE_ID', expressions, e.g., 'ST_LENGTH(wkt) AS WEIGHTS_VALUESPECIFIED', or constant values, e.g., '{4, 15} AS WEIGHTS_VALUESPECIFIED'. If using constant values in an identifier combination, the number of values specified must match across the combination.
[in]restrictionsRestrictions represent a method of informing the graph solver which edges and/or nodes should be ignored for the solution. Restrictions must be specified using identifiers; identifiers are grouped as combinations. Identifiers can be used with existing column names, e.g., 'table.column AS RESTRICTIONS_EDGE_ID', expressions, e.g., 'column/2 AS RESTRICTIONS_VALUECOMPARED', or constant values, e.g., '{0, 0, 0, 1} AS RESTRICTIONS_ONOFFCOMPARED'. If using constant values in an identifier combination, the number of values specified must match across the combination.
[in]optionsOptional parameters. The default value is an empty map.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ createJob() [1/4]

CreateJobResponse gpudb::GPUdb::createJob ( const CreateJobRequest request_) const

Create a job which will run asynchronously.

The response returns a job ID, which can be used to query the status and result of the job. The status and the result of the job upon completion can be requested by getJob.

Parameters
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

◆ createJob() [2/4]

CreateJobResponse& gpudb::GPUdb::createJob ( const CreateJobRequest request_,
CreateJobResponse response_ 
) const

Create a job which will run asynchronously.

The response returns a job ID, which can be used to query the status and result of the job. The status and the result of the job upon completion can be requested by getJob.

Parameters
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ createJob() [3/4]

CreateJobResponse gpudb::GPUdb::createJob ( const std::string &  endpoint,
const std::string &  requestEncoding,
const std::vector< uint8_t > &  data,
const std::string &  dataStr,
const std::map< std::string, std::string > &  options 
) const

Create a job which will run asynchronously.

The response returns a job ID, which can be used to query the status and result of the job. The status and the result of the job upon completion can be requested by getJob.

Parameters
[in]endpointIndicates which endpoint to execute, e.g. '/alter/table'.
[in]requestEncodingThe encoding of the request payload for the job. Supported values: The default value is create_job_binary.
[in]dataBinary-encoded payload for the job to be run asynchronously. The payload must contain the relevant input parameters for the endpoint indicated in endpoint. Please see the documentation for the appropriate endpoint to see what values must (or can) be specified. If this parameter is used, then requestEncoding must be binary or snappy.
[in]dataStrJSON-encoded payload for the job to be run asynchronously. The payload must contain the relevant input parameters for the endpoint indicated in endpoint. Please see the documentation for the appropriate endpoint to see what values must (or can) be specified. If this parameter is used, then requestEncoding must be json.
[in]optionsOptional parameters. The default value is an empty map.
Returns
Response object containing the result of the operation.

◆ createJob() [4/4]

CreateJobResponse& gpudb::GPUdb::createJob ( const std::string &  endpoint,
const std::string &  requestEncoding,
const std::vector< uint8_t > &  data,
const std::string &  dataStr,
const std::map< std::string, std::string > &  options,
CreateJobResponse response_ 
) const

Create a job which will run asynchronously.

The response returns a job ID, which can be used to query the status and result of the job. The status and the result of the job upon completion can be requested by getJob.

Parameters
[in]endpointIndicates which endpoint to execute, e.g. '/alter/table'.
[in]requestEncodingThe encoding of the request payload for the job. Supported values: The default value is create_job_binary.
[in]dataBinary-encoded payload for the job to be run asynchronously. The payload must contain the relevant input parameters for the endpoint indicated in endpoint. Please see the documentation for the appropriate endpoint to see what values must (or can) be specified. If this parameter is used, then requestEncoding must be binary or snappy.
[in]dataStrJSON-encoded payload for the job to be run asynchronously. The payload must contain the relevant input parameters for the endpoint indicated in endpoint. Please see the documentation for the appropriate endpoint to see what values must (or can) be specified. If this parameter is used, then requestEncoding must be json.
[in]optionsOptional parameters. The default value is an empty map.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ createJoinTable() [1/4]

CreateJoinTableResponse gpudb::GPUdb::createJoinTable ( const CreateJoinTableRequest request_) const

Creates a table that is the result of a SQL JOIN.

For join details and examples see: Joins. For limitations, see Join Limitations and Cautions.

Parameters
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

◆ createJoinTable() [2/4]

CreateJoinTableResponse& gpudb::GPUdb::createJoinTable ( const CreateJoinTableRequest request_,
CreateJoinTableResponse response_ 
) const

Creates a table that is the result of a SQL JOIN.

For join details and examples see: Joins. For limitations, see Join Limitations and Cautions.

Parameters
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ createJoinTable() [3/4]

CreateJoinTableResponse gpudb::GPUdb::createJoinTable ( const std::string &  joinTableName,
const std::vector< std::string > &  tableNames,
const std::vector< std::string > &  columnNames,
const std::vector< std::string > &  expressions,
const std::map< std::string, std::string > &  options 
) const

Creates a table that is the result of a SQL JOIN.

For join details and examples see: Joins. For limitations, see Join Limitations and Cautions.

Parameters
[in]joinTableNameName of the join table to be created, in [schema_name.]table_name format, using standard name resolution rules and meeting table naming criteria.
[in]tableNamesThe list of table names composing the join, each in [schema_name.]table_name format, using standard name resolution rules. Corresponds to a SQL statement FROM clause.
[in]columnNamesList of member table columns or column expressions to be included in the join. Columns can be prefixed with 'table_id.column_name', where 'table_id' is the table name or alias. Columns can be aliased via the syntax 'column_name as alias'. Wild cards '*' can be used to include all columns across member tables or 'table_id.*' for all of a single table's columns. Columns and column expressions composing the join must be uniquely named or aliased–therefore, the '*' wild card cannot be used if column names aren't unique across all tables.
[in]expressionsAn optional list of expressions to combine and filter the joined tables. Corresponds to a SQL statement WHERE clause. For details see: expressions. The default value is an empty vector.
[in]optionsOptional parameters. The default value is an empty map.
Returns
Response object containing the result of the operation.

◆ createJoinTable() [4/4]

CreateJoinTableResponse& gpudb::GPUdb::createJoinTable ( const std::string &  joinTableName,
const std::vector< std::string > &  tableNames,
const std::vector< std::string > &  columnNames,
const std::vector< std::string > &  expressions,
const std::map< std::string, std::string > &  options,
CreateJoinTableResponse response_ 
) const

Creates a table that is the result of a SQL JOIN.

For join details and examples see: Joins. For limitations, see Join Limitations and Cautions.

Parameters
[in]joinTableNameName of the join table to be created, in [schema_name.]table_name format, using standard name resolution rules and meeting table naming criteria.
[in]tableNamesThe list of table names composing the join, each in [schema_name.]table_name format, using standard name resolution rules. Corresponds to a SQL statement FROM clause.
[in]columnNamesList of member table columns or column expressions to be included in the join. Columns can be prefixed with 'table_id.column_name', where 'table_id' is the table name or alias. Columns can be aliased via the syntax 'column_name as alias'. Wild cards '*' can be used to include all columns across member tables or 'table_id.*' for all of a single table's columns. Columns and column expressions composing the join must be uniquely named or aliased–therefore, the '*' wild card cannot be used if column names aren't unique across all tables.
[in]expressionsAn optional list of expressions to combine and filter the joined tables. Corresponds to a SQL statement WHERE clause. For details see: expressions. The default value is an empty vector.
[in]optionsOptional parameters. The default value is an empty map.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ createMaterializedView() [1/4]

CreateMaterializedViewResponse gpudb::GPUdb::createMaterializedView ( const CreateMaterializedViewRequest request_) const

Initiates the process of creating a materialized view, reserving the view's name to prevent other views or tables from being created with that name.

For materialized view details and examples, see Materialized Views.

The response contains viewId, which is used to tag each subsequent operation (projection, union, aggregation, filter, or join) that will compose the view.

Parameters
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

◆ createMaterializedView() [2/4]

CreateMaterializedViewResponse& gpudb::GPUdb::createMaterializedView ( const CreateMaterializedViewRequest request_,
CreateMaterializedViewResponse response_ 
) const

Initiates the process of creating a materialized view, reserving the view's name to prevent other views or tables from being created with that name.

For materialized view details and examples, see Materialized Views.

The response contains viewId, which is used to tag each subsequent operation (projection, union, aggregation, filter, or join) that will compose the view.

Parameters
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ createMaterializedView() [3/4]

CreateMaterializedViewResponse gpudb::GPUdb::createMaterializedView ( const std::string &  tableName,
const std::map< std::string, std::string > &  options 
) const

Initiates the process of creating a materialized view, reserving the view's name to prevent other views or tables from being created with that name.

For materialized view details and examples, see Materialized Views.

The response contains viewId, which is used to tag each subsequent operation (projection, union, aggregation, filter, or join) that will compose the view.

Parameters
[in]tableNameName of the table to be created that is the top-level table of the materialized view, in [schema_name.]table_name format, using standard name resolution rules and meeting table naming criteria.
[in]optionsOptional parameters. The default value is an empty map.
Returns
Response object containing the result of the operation.

◆ createMaterializedView() [4/4]

CreateMaterializedViewResponse& gpudb::GPUdb::createMaterializedView ( const std::string &  tableName,
const std::map< std::string, std::string > &  options,
CreateMaterializedViewResponse response_ 
) const

Initiates the process of creating a materialized view, reserving the view's name to prevent other views or tables from being created with that name.

For materialized view details and examples, see Materialized Views.

The response contains viewId, which is used to tag each subsequent operation (projection, union, aggregation, filter, or join) that will compose the view.

Parameters
[in]tableNameName of the table to be created that is the top-level table of the materialized view, in [schema_name.]table_name format, using standard name resolution rules and meeting table naming criteria.
[in]optionsOptional parameters. The default value is an empty map.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ createProc() [1/4]

CreateProcResponse gpudb::GPUdb::createProc ( const CreateProcRequest request_) const

Creates an instance (proc) of the user-defined functions (UDF) specified by the given command, options, and files, and makes it available for execution.

Parameters
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

◆ createProc() [2/4]

CreateProcResponse& gpudb::GPUdb::createProc ( const CreateProcRequest request_,
CreateProcResponse response_ 
) const

Creates an instance (proc) of the user-defined functions (UDF) specified by the given command, options, and files, and makes it available for execution.

Parameters
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ createProc() [3/4]

CreateProcResponse gpudb::GPUdb::createProc ( const std::string &  procName,
const std::string &  executionMode,
const std::map< std::string, std::vector< uint8_t > > &  files,
const std::string &  command,
const std::vector< std::string > &  args,
const std::map< std::string, std::string > &  options 
) const

Creates an instance (proc) of the user-defined functions (UDF) specified by the given command, options, and files, and makes it available for execution.

Parameters
[in]procNameName of the proc to be created. Must not be the name of a currently existing proc.
[in]executionModeThe execution mode of the proc. Supported values:
  • create_proc_distributed: Input table data will be divided into data segments that are distributed across all nodes in the cluster, and the proc command will be invoked once per data segment in parallel. Output table data from each invocation will be saved to the same node as the corresponding input data.
  • create_proc_nondistributed: The proc command will be invoked only once per execution, and will not have direct access to any tables named as input or output table parameters in the call to executeProc. It will, however, be able to access the database using native API calls.
The default value is create_proc_distributed.
[in]filesA map of the files that make up the proc. The keys of the map are file names, and the values are the binary contents of the files. The file names may include subdirectory names (e.g. 'subdir/file') but must not resolve to a directory above the root for the proc. Files may be loaded from existing files in KiFS. Those file names should be prefixed with the uri kifs:// and the values in the map should be empty. The default value is an empty map.
[in]commandThe command (excluding arguments) that will be invoked when the proc is executed. It will be invoked from the directory containing the proc files and may be any command that can be resolved from that directory. It need not refer to a file actually in that directory; for example, it could be 'java' if the proc is a Java application; however, any necessary external programs must be preinstalled on every database node. If the command refers to a file in that directory, it must be preceded with './' as per Linux convention. If not specified, and exactly one file is provided in files, that file will be invoked. The default value is ''.
[in]argsAn array of command-line arguments that will be passed to command when the proc is executed. The default value is an empty vector.
[in]optionsOptional parameters.
  • create_proc_max_concurrency_per_node: The maximum number of concurrent instances of the proc that will be executed per node. 0 allows unlimited concurrency. The default value is '0'.
  • create_proc_set_environment: A python environment to use when executing the proc. Must be an existing environment, else an error will be returned. The default value is ''.
The default value is an empty map.
Returns
Response object containing the result of the operation.

◆ createProc() [4/4]

CreateProcResponse& gpudb::GPUdb::createProc ( const std::string &  procName,
const std::string &  executionMode,
const std::map< std::string, std::vector< uint8_t > > &  files,
const std::string &  command,
const std::vector< std::string > &  args,
const std::map< std::string, std::string > &  options,
CreateProcResponse response_ 
) const

Creates an instance (proc) of the user-defined functions (UDF) specified by the given command, options, and files, and makes it available for execution.

Parameters
[in]procNameName of the proc to be created. Must not be the name of a currently existing proc.
[in]executionModeThe execution mode of the proc. Supported values:
  • create_proc_distributed: Input table data will be divided into data segments that are distributed across all nodes in the cluster, and the proc command will be invoked once per data segment in parallel. Output table data from each invocation will be saved to the same node as the corresponding input data.
  • create_proc_nondistributed: The proc command will be invoked only once per execution, and will not have direct access to any tables named as input or output table parameters in the call to executeProc. It will, however, be able to access the database using native API calls.
The default value is create_proc_distributed.
[in]filesA map of the files that make up the proc. The keys of the map are file names, and the values are the binary contents of the files. The file names may include subdirectory names (e.g. 'subdir/file') but must not resolve to a directory above the root for the proc. Files may be loaded from existing files in KiFS. Those file names should be prefixed with the uri kifs:// and the values in the map should be empty. The default value is an empty map.
[in]commandThe command (excluding arguments) that will be invoked when the proc is executed. It will be invoked from the directory containing the proc files and may be any command that can be resolved from that directory. It need not refer to a file actually in that directory; for example, it could be 'java' if the proc is a Java application; however, any necessary external programs must be preinstalled on every database node. If the command refers to a file in that directory, it must be preceded with './' as per Linux convention. If not specified, and exactly one file is provided in files, that file will be invoked. The default value is ''.
[in]argsAn array of command-line arguments that will be passed to command when the proc is executed. The default value is an empty vector.
[in]optionsOptional parameters.
  • create_proc_max_concurrency_per_node: The maximum number of concurrent instances of the proc that will be executed per node. 0 allows unlimited concurrency. The default value is '0'.
  • create_proc_set_environment: A python environment to use when executing the proc. Must be an existing environment, else an error will be returned. The default value is ''.
The default value is an empty map.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ createProjection() [1/4]

CreateProjectionResponse gpudb::GPUdb::createProjection ( const CreateProjectionRequest request_) const

Creates a new projection of an existing table.

A projection represents a subset of the columns (potentially including derived columns) of a table.

For projection details and examples, see Projections. For limitations, see Projection Limitations and Cautions.

Window functions, which can perform operations like moving averages, are available through this endpoint as well as getRecordsByColumn.

A projection can be created with a different shard key than the source table. By specifying shard_key, the projection will be sharded according to the specified columns, regardless of how the source table is sharded. The source table can even be unsharded or replicated.

If tableName is empty, selection is performed against a single-row virtual table. This can be useful in executing temporal (NOW()), identity (USER()), or constant-based functions (GEODIST(-77.11, 38.88, -71.06, 42.36)).

Parameters
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

◆ createProjection() [2/4]

CreateProjectionResponse& gpudb::GPUdb::createProjection ( const CreateProjectionRequest request_,
CreateProjectionResponse response_ 
) const

Creates a new projection of an existing table.

A projection represents a subset of the columns (potentially including derived columns) of a table.

For projection details and examples, see Projections. For limitations, see Projection Limitations and Cautions.

Window functions, which can perform operations like moving averages, are available through this endpoint as well as getRecordsByColumn.

A projection can be created with a different shard key than the source table. By specifying shard_key, the projection will be sharded according to the specified columns, regardless of how the source table is sharded. The source table can even be unsharded or replicated.

If tableName is empty, selection is performed against a single-row virtual table. This can be useful in executing temporal (NOW()), identity (USER()), or constant-based functions (GEODIST(-77.11, 38.88, -71.06, 42.36)).

Parameters
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ createProjection() [3/4]

CreateProjectionResponse gpudb::GPUdb::createProjection ( const std::string &  tableName,
const std::string &  projectionName,
const std::vector< std::string > &  columnNames,
const std::map< std::string, std::string > &  options 
) const

Creates a new projection of an existing table.

A projection represents a subset of the columns (potentially including derived columns) of a table.

For projection details and examples, see Projections. For limitations, see Projection Limitations and Cautions.

Window functions, which can perform operations like moving averages, are available through this endpoint as well as getRecordsByColumn.

A projection can be created with a different shard key than the source table. By specifying shard_key, the projection will be sharded according to the specified columns, regardless of how the source table is sharded. The source table can even be unsharded or replicated.

If tableName is empty, selection is performed against a single-row virtual table. This can be useful in executing temporal (NOW()), identity (USER()), or constant-based functions (GEODIST(-77.11, 38.88, -71.06, 42.36)).

Parameters
[in]tableNameName of the existing table on which the projection is to be applied, in [schema_name.]table_name format, using standard name resolution rules. An empty table name creates a projection from a single-row virtual table, where columns specified should be constants or constant expressions.
[in]projectionNameName of the projection to be created, in [schema_name.]table_name format, using standard name resolution rules and meeting table naming criteria.
[in]columnNamesList of columns from tableName to be included in the projection. Can include derived columns. Can be specified as aliased via the syntax 'column_name as alias'.
[in]optionsOptional parameters. The default value is an empty map.
Returns
Response object containing the result of the operation.

◆ createProjection() [4/4]

CreateProjectionResponse& gpudb::GPUdb::createProjection ( const std::string &  tableName,
const std::string &  projectionName,
const std::vector< std::string > &  columnNames,
const std::map< std::string, std::string > &  options,
CreateProjectionResponse response_ 
) const

Creates a new projection of an existing table.

A projection represents a subset of the columns (potentially including derived columns) of a table.

For projection details and examples, see Projections. For limitations, see Projection Limitations and Cautions.

Window functions, which can perform operations like moving averages, are available through this endpoint as well as getRecordsByColumn.

A projection can be created with a different shard key than the source table. By specifying shard_key, the projection will be sharded according to the specified columns, regardless of how the source table is sharded. The source table can even be unsharded or replicated.

If tableName is empty, selection is performed against a single-row virtual table. This can be useful in executing temporal (NOW()), identity (USER()), or constant-based functions (GEODIST(-77.11, 38.88, -71.06, 42.36)).

Parameters
[in]tableNameName of the existing table on which the projection is to be applied, in [schema_name.]table_name format, using standard name resolution rules. An empty table name creates a projection from a single-row virtual table, where columns specified should be constants or constant expressions.
[in]projectionNameName of the projection to be created, in [schema_name.]table_name format, using standard name resolution rules and meeting table naming criteria.
[in]columnNamesList of columns from tableName to be included in the projection. Can include derived columns. Can be specified as aliased via the syntax 'column_name as alias'.
[in]optionsOptional parameters. The default value is an empty map.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ createResourceGroup() [1/4]

CreateResourceGroupResponse gpudb::GPUdb::createResourceGroup ( const CreateResourceGroupRequest request_) const

Creates a new resource group to facilitate resource management.

Parameters
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

◆ createResourceGroup() [2/4]

CreateResourceGroupResponse& gpudb::GPUdb::createResourceGroup ( const CreateResourceGroupRequest request_,
CreateResourceGroupResponse response_ 
) const

Creates a new resource group to facilitate resource management.

Parameters
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ createResourceGroup() [3/4]

CreateResourceGroupResponse gpudb::GPUdb::createResourceGroup ( const std::string &  name,
const std::map< std::string, std::map< std::string, std::string > > &  tierAttributes,
const std::string &  ranking,
const std::string &  adjoiningResourceGroup,
const std::map< std::string, std::string > &  options 
) const

Creates a new resource group to facilitate resource management.

Parameters
[in]nameName of the group to be created. Must contain only letters, digits, and underscores, and cannot begin with a digit. Must not match existing resource group name.
[in]tierAttributesOptional map containing tier names and their respective attribute group limits. The only valid attribute limit that can be set is max_memory (in bytes) for the VRAM & RAM tiers. For instance, to set max VRAM capacity to 1GB and max RAM capacity to 10GB, use: {'VRAM':{'max_memory':'1000000000'}, 'RAM':{'max_memory':'10000000000'}}. The default value is an empty map.
[in]rankingIndicates the relative ranking among existing resource groups where this new resource group will be placed. When using before or after, specify which resource group this one will be inserted before or after in adjoiningResourceGroup. Supported values:
[in]adjoiningResourceGroupIf ranking is before or after, this field indicates the resource group before or after which the current group will be placed; otherwise, leave blank. The default value is ''.
[in]optionsOptional parameters. The default value is an empty map.
Returns
Response object containing the result of the operation.

◆ createResourceGroup() [4/4]

CreateResourceGroupResponse& gpudb::GPUdb::createResourceGroup ( const std::string &  name,
const std::map< std::string, std::map< std::string, std::string > > &  tierAttributes,
const std::string &  ranking,
const std::string &  adjoiningResourceGroup,
const std::map< std::string, std::string > &  options,
CreateResourceGroupResponse response_ 
) const

Creates a new resource group to facilitate resource management.

Parameters
[in]nameName of the group to be created. Must contain only letters, digits, and underscores, and cannot begin with a digit. Must not match existing resource group name.
[in]tierAttributesOptional map containing tier names and their respective attribute group limits. The only valid attribute limit that can be set is max_memory (in bytes) for the VRAM & RAM tiers. For instance, to set max VRAM capacity to 1GB and max RAM capacity to 10GB, use: {'VRAM':{'max_memory':'1000000000'}, 'RAM':{'max_memory':'10000000000'}}. The default value is an empty map.
[in]rankingIndicates the relative ranking among existing resource groups where this new resource group will be placed. When using before or after, specify which resource group this one will be inserted before or after in adjoiningResourceGroup. Supported values:
[in]adjoiningResourceGroupIf ranking is before or after, this field indicates the resource group before or after which the current group will be placed; otherwise, leave blank. The default value is ''.
[in]optionsOptional parameters. The default value is an empty map.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ createRole() [1/4]

CreateRoleResponse gpudb::GPUdb::createRole ( const CreateRoleRequest request_) const

Creates a new role.

Attention
This method should be used for on-premise deployments only.
Parameters
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

◆ createRole() [2/4]

CreateRoleResponse& gpudb::GPUdb::createRole ( const CreateRoleRequest request_,
CreateRoleResponse response_ 
) const

Creates a new role.

Attention
This method should be used for on-premise deployments only.
Parameters
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ createRole() [3/4]

CreateRoleResponse gpudb::GPUdb::createRole ( const std::string &  name,
const std::map< std::string, std::string > &  options 
) const

Creates a new role.

Attention
This method should be used for on-premise deployments only.
Parameters
[in]nameName of the role to be created. Must contain only lowercase letters, digits, and underscores, and cannot begin with a digit. Must not be the same name as an existing user or role.
[in]optionsOptional parameters. The default value is an empty map.
Returns
Response object containing the result of the operation.

◆ createRole() [4/4]

CreateRoleResponse& gpudb::GPUdb::createRole ( const std::string &  name,
const std::map< std::string, std::string > &  options,
CreateRoleResponse response_ 
) const

Creates a new role.

Attention
This method should be used for on-premise deployments only.
Parameters
[in]nameName of the role to be created. Must contain only lowercase letters, digits, and underscores, and cannot begin with a digit. Must not be the same name as an existing user or role.
[in]optionsOptional parameters. The default value is an empty map.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ createSchema() [1/4]

CreateSchemaResponse gpudb::GPUdb::createSchema ( const CreateSchemaRequest request_) const

Creates a SQL-style schema.

Schemas are containers for tables and views. Multiple tables and views can be defined with the same name in different schemas.

Parameters
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

◆ createSchema() [2/4]

CreateSchemaResponse& gpudb::GPUdb::createSchema ( const CreateSchemaRequest request_,
CreateSchemaResponse response_ 
) const

Creates a SQL-style schema.

Schemas are containers for tables and views. Multiple tables and views can be defined with the same name in different schemas.

Parameters
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ createSchema() [3/4]

CreateSchemaResponse gpudb::GPUdb::createSchema ( const std::string &  schemaName,
const std::map< std::string, std::string > &  options 
) const

Creates a SQL-style schema.

Schemas are containers for tables and views. Multiple tables and views can be defined with the same name in different schemas.

Parameters
[in]schemaNameName of the schema to be created. Has the same naming restrictions as tables.
[in]optionsOptional parameters. The default value is an empty map.
Returns
Response object containing the result of the operation.

◆ createSchema() [4/4]

CreateSchemaResponse& gpudb::GPUdb::createSchema ( const std::string &  schemaName,
const std::map< std::string, std::string > &  options,
CreateSchemaResponse response_ 
) const

Creates a SQL-style schema.

Schemas are containers for tables and views. Multiple tables and views can be defined with the same name in different schemas.

Parameters
[in]schemaNameName of the schema to be created. Has the same naming restrictions as tables.
[in]optionsOptional parameters. The default value is an empty map.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ createTable() [1/4]

CreateTableResponse gpudb::GPUdb::createTable ( const CreateTableRequest request_) const

Creates a new table.

If a new table is being created, the type of the table is given by typeId, which must be the ID of a currently registered type (i.e. one created via createType).

A table may optionally be designated to use a replicated distribution scheme, or be assigned: foreign keys to other tables, a partitioning scheme, and/or a tier strategy.

Parameters
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

◆ createTable() [2/4]

CreateTableResponse& gpudb::GPUdb::createTable ( const CreateTableRequest request_,
CreateTableResponse response_ 
) const

Creates a new table.

If a new table is being created, the type of the table is given by typeId, which must be the ID of a currently registered type (i.e. one created via createType).

A table may optionally be designated to use a replicated distribution scheme, or be assigned: foreign keys to other tables, a partitioning scheme, and/or a tier strategy.

Parameters
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ createTable() [3/4]

CreateTableResponse gpudb::GPUdb::createTable ( const std::string &  tableName,
const std::string &  typeId,
const std::map< std::string, std::string > &  options 
) const

Creates a new table.

If a new table is being created, the type of the table is given by typeId, which must be the ID of a currently registered type (i.e. one created via createType).

A table may optionally be designated to use a replicated distribution scheme, or be assigned: foreign keys to other tables, a partitioning scheme, and/or a tier strategy.

Parameters
[in]tableNameName of the table to be created, in [schema_name.]table_name format, using standard name resolution rules and meeting table naming criteria. Error for requests with existing table of the same name and type ID may be suppressed by using the no_error_if_exists option.
[in]typeIdID of a currently registered type. All objects added to the newly created table will be of this type.
[in]optionsOptional parameters. The default value is an empty map.
Returns
Response object containing the result of the operation.

◆ createTable() [4/4]

CreateTableResponse& gpudb::GPUdb::createTable ( const std::string &  tableName,
const std::string &  typeId,
const std::map< std::string, std::string > &  options,
CreateTableResponse response_ 
) const

Creates a new table.

If a new table is being created, the type of the table is given by typeId, which must be the ID of a currently registered type (i.e. one created via createType).

A table may optionally be designated to use a replicated distribution scheme, or be assigned: foreign keys to other tables, a partitioning scheme, and/or a tier strategy.

Parameters
[in]tableNameName of the table to be created, in [schema_name.]table_name format, using standard name resolution rules and meeting table naming criteria. Error for requests with existing table of the same name and type ID may be suppressed by using the no_error_if_exists option.
[in]typeIdID of a currently registered type. All objects added to the newly created table will be of this type.
[in]optionsOptional parameters. The default value is an empty map.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ createTableExternal() [1/4]

CreateTableExternalResponse gpudb::GPUdb::createTableExternal ( const CreateTableExternalRequest request_) const

Creates a new external table, which is a local database object whose source data is located externally to the database.

The source data can be located either in KiFS; on the cluster, accessible to the database; or remotely, accessible via a pre-defined external data source.

The external table can have its structure defined explicitly, via createTableOptions, which contains many of the options from createTable; or defined implicitly, inferred from the source data.

Parameters
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

◆ createTableExternal() [2/4]

CreateTableExternalResponse& gpudb::GPUdb::createTableExternal ( const CreateTableExternalRequest request_,
CreateTableExternalResponse response_ 
) const

Creates a new external table, which is a local database object whose source data is located externally to the database.

The source data can be located either in KiFS; on the cluster, accessible to the database; or remotely, accessible via a pre-defined external data source.

The external table can have its structure defined explicitly, via createTableOptions, which contains many of the options from createTable; or defined implicitly, inferred from the source data.

Parameters
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ createTableExternal() [3/4]

CreateTableExternalResponse gpudb::GPUdb::createTableExternal ( const std::string &  tableName,
const std::vector< std::string > &  filepaths,
const std::map< std::string, std::map< std::string, std::string > > &  modifyColumns,
const std::map< std::string, std::string > &  createTableOptions,
const std::map< std::string, std::string > &  options 
) const

Creates a new external table, which is a local database object whose source data is located externally to the database.

The source data can be located either in KiFS; on the cluster, accessible to the database; or remotely, accessible via a pre-defined external data source.

The external table can have its structure defined explicitly, via createTableOptions, which contains many of the options from createTable; or defined implicitly, inferred from the source data.

Parameters
[in]tableNameName of the table to be created, in [schema_name.]table_name format, using standard name resolution rules and meeting table naming criteria.
[in]filepathsA list of file paths from which data will be sourced; For paths in KiFS, use the uri prefix of kifs:// followed by the path to a file or directory. File matching by prefix is supported, e.g. kifs://dir/file would match dir/file_1 and dir/file_2. When prefix matching is used, the path must start with a full, valid KiFS directory name. If an external data source is specified in datasource_name, these file paths must resolve to accessible files at that data source location. Prefix matching is supported. If the data source is hdfs, prefixes must be aligned with directories, i.e. partial file names will not match. If no data source is specified, the files are assumed to be local to the database and must all be accessible to the gpudb user, residing on the path (or relative to the path) specified by the external files directory in the Kinetica configuration file. Wildcards (*) can be used to specify a group of files. Prefix matching is supported, the prefixes must be aligned with directories. If the first path ends in .tsv, the text delimiter will be defaulted to a tab character. If the first path ends in .psv, the text delimiter will be defaulted to a pipe character (|).
[in]modifyColumnsNot implemented yet. The default value is an empty map.
[in]createTableOptionsOptions from createTable, allowing the structure of the table to be defined independently of the data source. The default value is an empty map.
[in]optionsOptional parameters. The default value is an empty map.
Returns
Response object containing the result of the operation.

◆ createTableExternal() [4/4]

CreateTableExternalResponse& gpudb::GPUdb::createTableExternal ( const std::string &  tableName,
const std::vector< std::string > &  filepaths,
const std::map< std::string, std::map< std::string, std::string > > &  modifyColumns,
const std::map< std::string, std::string > &  createTableOptions,
const std::map< std::string, std::string > &  options,
CreateTableExternalResponse response_ 
) const

Creates a new external table, which is a local database object whose source data is located externally to the database.

The source data can be located either in KiFS; on the cluster, accessible to the database; or remotely, accessible via a pre-defined external data source.

The external table can have its structure defined explicitly, via createTableOptions, which contains many of the options from createTable; or defined implicitly, inferred from the source data.

Parameters
[in]tableNameName of the table to be created, in [schema_name.]table_name format, using standard name resolution rules and meeting table naming criteria.
[in]filepathsA list of file paths from which data will be sourced; For paths in KiFS, use the uri prefix of kifs:// followed by the path to a file or directory. File matching by prefix is supported, e.g. kifs://dir/file would match dir/file_1 and dir/file_2. When prefix matching is used, the path must start with a full, valid KiFS directory name. If an external data source is specified in datasource_name, these file paths must resolve to accessible files at that data source location. Prefix matching is supported. If the data source is hdfs, prefixes must be aligned with directories, i.e. partial file names will not match. If no data source is specified, the files are assumed to be local to the database and must all be accessible to the gpudb user, residing on the path (or relative to the path) specified by the external files directory in the Kinetica configuration file. Wildcards (*) can be used to specify a group of files. Prefix matching is supported, the prefixes must be aligned with directories. If the first path ends in .tsv, the text delimiter will be defaulted to a tab character. If the first path ends in .psv, the text delimiter will be defaulted to a pipe character (|).
[in]modifyColumnsNot implemented yet. The default value is an empty map.
[in]createTableOptionsOptions from createTable, allowing the structure of the table to be defined independently of the data source. The default value is an empty map.
[in]optionsOptional parameters. The default value is an empty map.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ createTableMonitor() [1/4]

CreateTableMonitorResponse gpudb::GPUdb::createTableMonitor ( const CreateTableMonitorRequest request_) const

Creates a monitor that watches for a single table modification event type (insert, update, or delete) on a particular table (identified by tableName) and forwards event notifications to subscribers via ZMQ.

After this call completes, subscribe to the returned topicId on the ZMQ table monitor port (default 9002). Each time an operation of the given type on the table completes, a multipart message is published for that topic; the first part contains only the topic ID, and each subsequent part contains one binary-encoded Avro object that corresponds to the event and can be decoded using typeSchema. The monitor will continue to run (regardless of whether or not there are any subscribers) until deactivated with clearTableMonitor.

For more information on table monitors, see Table Monitors.

Parameters
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

◆ createTableMonitor() [2/4]

CreateTableMonitorResponse& gpudb::GPUdb::createTableMonitor ( const CreateTableMonitorRequest request_,
CreateTableMonitorResponse response_ 
) const

Creates a monitor that watches for a single table modification event type (insert, update, or delete) on a particular table (identified by tableName) and forwards event notifications to subscribers via ZMQ.

After this call completes, subscribe to the returned topicId on the ZMQ table monitor port (default 9002). Each time an operation of the given type on the table completes, a multipart message is published for that topic; the first part contains only the topic ID, and each subsequent part contains one binary-encoded Avro object that corresponds to the event and can be decoded using typeSchema. The monitor will continue to run (regardless of whether or not there are any subscribers) until deactivated with clearTableMonitor.

For more information on table monitors, see Table Monitors.

Parameters
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ createTableMonitor() [3/4]

CreateTableMonitorResponse gpudb::GPUdb::createTableMonitor ( const std::string &  tableName,
const std::map< std::string, std::string > &  options 
) const

Creates a monitor that watches for a single table modification event type (insert, update, or delete) on a particular table (identified by tableName) and forwards event notifications to subscribers via ZMQ.

After this call completes, subscribe to the returned topicId on the ZMQ table monitor port (default 9002). Each time an operation of the given type on the table completes, a multipart message is published for that topic; the first part contains only the topic ID, and each subsequent part contains one binary-encoded Avro object that corresponds to the event and can be decoded using typeSchema. The monitor will continue to run (regardless of whether or not there are any subscribers) until deactivated with clearTableMonitor.

For more information on table monitors, see Table Monitors.

Parameters
[in]tableNameName of the table to monitor, in [schema_name.]table_name format, using standard name resolution rules.
[in]optionsOptional parameters. The default value is an empty map.
Returns
Response object containing the result of the operation.

◆ createTableMonitor() [4/4]

CreateTableMonitorResponse& gpudb::GPUdb::createTableMonitor ( const std::string &  tableName,
const std::map< std::string, std::string > &  options,
CreateTableMonitorResponse response_ 
) const

Creates a monitor that watches for a single table modification event type (insert, update, or delete) on a particular table (identified by tableName) and forwards event notifications to subscribers via ZMQ.

After this call completes, subscribe to the returned topicId on the ZMQ table monitor port (default 9002). Each time an operation of the given type on the table completes, a multipart message is published for that topic; the first part contains only the topic ID, and each subsequent part contains one binary-encoded Avro object that corresponds to the event and can be decoded using typeSchema. The monitor will continue to run (regardless of whether or not there are any subscribers) until deactivated with clearTableMonitor.

For more information on table monitors, see Table Monitors.

Parameters
[in]tableNameName of the table to monitor, in [schema_name.]table_name format, using standard name resolution rules.
[in]optionsOptional parameters. The default value is an empty map.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ createTriggerByArea() [1/4]

CreateTriggerByAreaResponse gpudb::GPUdb::createTriggerByArea ( const CreateTriggerByAreaRequest request_) 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.) Once the trigger has been activated, any record added to the listed tables(s) via insertRecords 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) for any listening client to collect. Active triggers can be cancelled by using the clearTrigger endpoint or by clearing all relevant tables.

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

Parameters
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

◆ createTriggerByArea() [2/4]

CreateTriggerByAreaResponse& gpudb::GPUdb::createTriggerByArea ( const CreateTriggerByAreaRequest request_,
CreateTriggerByAreaResponse response_ 
) 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.) Once the trigger has been activated, any record added to the listed tables(s) via insertRecords 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) for any listening client to collect. Active triggers can be cancelled by using the clearTrigger endpoint or by clearing all relevant tables.

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

Parameters
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ createTriggerByArea() [3/4]

CreateTriggerByAreaResponse gpudb::GPUdb::createTriggerByArea ( 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 
) 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.) Once the trigger has been activated, any record added to the listed tables(s) via insertRecords 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) for any listening client to collect. Active triggers can be cancelled by using the clearTrigger endpoint or by clearing all relevant tables.

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

Parameters
[in]requestIdUser-created ID for the trigger. The ID can be alphanumeric, contain symbols, and must contain at least one character.
[in]tableNamesNames of the tables on which the trigger will be activated and maintained, each in [schema_name.]table_name format, using standard name resolution rules.
[in]xColumnNameName of a numeric column on which the trigger is activated. Usually 'x' for geospatial data points.
[in]xVectorThe respective coordinate values for the region on which the trigger is activated. This usually translates to the x-coordinates of a geospatial region.
[in]yColumnNameName of a second numeric column on which the trigger is activated. Usually 'y' for geospatial data points.
[in]yVectorThe 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]optionsOptional parameters. The default value is an empty map.
Returns
Response object containing the result of the operation.

◆ createTriggerByArea() [4/4]

CreateTriggerByAreaResponse& gpudb::GPUdb::createTriggerByArea ( 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,
CreateTriggerByAreaResponse response_ 
) 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.) Once the trigger has been activated, any record added to the listed tables(s) via insertRecords 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) for any listening client to collect. Active triggers can be cancelled by using the clearTrigger endpoint or by clearing all relevant tables.

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

Parameters
[in]requestIdUser-created ID for the trigger. The ID can be alphanumeric, contain symbols, and must contain at least one character.
[in]tableNamesNames of the tables on which the trigger will be activated and maintained, each in [schema_name.]table_name format, using standard name resolution rules.
[in]xColumnNameName of a numeric column on which the trigger is activated. Usually 'x' for geospatial data points.
[in]xVectorThe respective coordinate values for the region on which the trigger is activated. This usually translates to the x-coordinates of a geospatial region.
[in]yColumnNameName of a second numeric column on which the trigger is activated. Usually 'y' for geospatial data points.
[in]yVectorThe 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]optionsOptional parameters. The default value is an empty map.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ createTriggerByRange() [1/4]

CreateTriggerByRangeResponse gpudb::GPUdb::createTriggerByRange ( const CreateTriggerByRangeRequest request_) const

Sets up a simple range trigger for a column_name for one or more tables.

Once the trigger has been activated, any record added to the listed tables(s) via insertRecords with the chosen column_name's value falling within the specified range will trip the trigger. All such records will be queued at the trigger port (by default '9001' but able to be retrieved via showSystemStatus) for any listening client to collect. Active triggers can be cancelled by using the clearTrigger endpoint or by clearing all relevant tables.

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

Parameters
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

◆ createTriggerByRange() [2/4]

CreateTriggerByRangeResponse& gpudb::GPUdb::createTriggerByRange ( const CreateTriggerByRangeRequest request_,
CreateTriggerByRangeResponse response_ 
) const

Sets up a simple range trigger for a column_name for one or more tables.

Once the trigger has been activated, any record added to the listed tables(s) via insertRecords with the chosen column_name's value falling within the specified range will trip the trigger. All such records will be queued at the trigger port (by default '9001' but able to be retrieved via showSystemStatus) for any listening client to collect. Active triggers can be cancelled by using the clearTrigger endpoint or by clearing all relevant tables.

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

Parameters
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ createTriggerByRange() [3/4]

CreateTriggerByRangeResponse gpudb::GPUdb::createTriggerByRange ( const std::string &  requestId,
const std::vector< std::string > &  tableNames,
const std::string &  columnName,
const double  min,
const double  max,
const std::map< std::string, std::string > &  options 
) const

Sets up a simple range trigger for a column_name for one or more tables.

Once the trigger has been activated, any record added to the listed tables(s) via insertRecords with the chosen column_name's value falling within the specified range will trip the trigger. All such records will be queued at the trigger port (by default '9001' but able to be retrieved via showSystemStatus) for any listening client to collect. Active triggers can be cancelled by using the clearTrigger endpoint or by clearing all relevant tables.

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

Parameters
[in]requestIdUser-created ID for the trigger. The ID can be alphanumeric, contain symbols, and must contain at least one character.
[in]tableNamesTables on which the trigger will be active, each in [schema_name.]table_name format, using standard name resolution rules.
[in]columnNameName of a numeric column_name on which the trigger is activated.
[in]minThe lower bound (inclusive) for the trigger range.
[in]maxThe upper bound (inclusive) for the trigger range.
[in]optionsOptional parameters. The default value is an empty map.
Returns
Response object containing the result of the operation.

◆ createTriggerByRange() [4/4]

CreateTriggerByRangeResponse& gpudb::GPUdb::createTriggerByRange ( const std::string &  requestId,
const std::vector< std::string > &  tableNames,
const std::string &  columnName,
const double  min,
const double  max,
const std::map< std::string, std::string > &  options,
CreateTriggerByRangeResponse response_ 
) const

Sets up a simple range trigger for a column_name for one or more tables.

Once the trigger has been activated, any record added to the listed tables(s) via insertRecords with the chosen column_name's value falling within the specified range will trip the trigger. All such records will be queued at the trigger port (by default '9001' but able to be retrieved via showSystemStatus) for any listening client to collect. Active triggers can be cancelled by using the clearTrigger endpoint or by clearing all relevant tables.

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

Parameters
[in]requestIdUser-created ID for the trigger. The ID can be alphanumeric, contain symbols, and must contain at least one character.
[in]tableNamesTables on which the trigger will be active, each in [schema_name.]table_name format, using standard name resolution rules.
[in]columnNameName of a numeric column_name on which the trigger is activated.
[in]minThe lower bound (inclusive) for the trigger range.
[in]maxThe upper bound (inclusive) for the trigger range.
[in]optionsOptional parameters. The default value is an empty map.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ createType() [1/4]

CreateTypeResponse gpudb::GPUdb::createType ( const CreateTypeRequest request_) const

Creates a new type describing the layout of a table.

The type definition is a JSON string describing the fields (i.e. columns) of the type. Each field consists of a name and a data type. Supported data types are: double, float, int, long, string, and bytes. In addition, one or more properties can be specified for each column which customize the memory usage and query availability of that column. Note that some properties are mutually exclusive–i.e. they cannot be specified for any given column simultaneously. One example of mutually exclusive properties are data and store_only.

A single primary key and/or single shard key can be set across one or more columns. If a primary key is specified, then a uniqueness constraint is enforced, in that only a single object can exist with a given primary key column value (or set of values for the key columns, if using a composite primary key). When inserting data into a table with a primary key, depending on the parameters in the request, incoming objects with primary key values that match existing objects will either overwrite (i.e. update) the existing object or will be skipped and not added into the set.

Example of a type definition with some of the parameters:

{"type":"record",
"name":"point",
"fields":[{"name":"msg_id","type":"string"},
{"name":"x","type":"double"},
{"name":"y","type":"double"},
{"name":"TIMESTAMP","type":"double"},
{"name":"source","type":"string"},
{"name":"group_id","type":"string"},
{"name":"OBJECT_ID","type":"string"}]
}

Properties:

{"group_id":["store_only"],
"msg_id":["store_only","text_search"]
}
Parameters
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

◆ createType() [2/4]

CreateTypeResponse& gpudb::GPUdb::createType ( const CreateTypeRequest request_,
CreateTypeResponse response_ 
) const

Creates a new type describing the layout of a table.

The type definition is a JSON string describing the fields (i.e. columns) of the type. Each field consists of a name and a data type. Supported data types are: double, float, int, long, string, and bytes. In addition, one or more properties can be specified for each column which customize the memory usage and query availability of that column. Note that some properties are mutually exclusive–i.e. they cannot be specified for any given column simultaneously. One example of mutually exclusive properties are data and store_only.

A single primary key and/or single shard key can be set across one or more columns. If a primary key is specified, then a uniqueness constraint is enforced, in that only a single object can exist with a given primary key column value (or set of values for the key columns, if using a composite primary key). When inserting data into a table with a primary key, depending on the parameters in the request, incoming objects with primary key values that match existing objects will either overwrite (i.e. update) the existing object or will be skipped and not added into the set.

Example of a type definition with some of the parameters:

{"type":"record",
"name":"point",
"fields":[{"name":"msg_id","type":"string"},
{"name":"x","type":"double"},
{"name":"y","type":"double"},
{"name":"TIMESTAMP","type":"double"},
{"name":"source","type":"string"},
{"name":"group_id","type":"string"},
{"name":"OBJECT_ID","type":"string"}]
}

Properties:

{"group_id":["store_only"],
"msg_id":["store_only","text_search"]
}
Parameters
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ createType() [3/4]

CreateTypeResponse gpudb::GPUdb::createType ( const std::string &  typeDefinition,
const std::string &  label,
const std::map< std::string, std::vector< std::string > > &  properties,
const std::map< std::string, std::string > &  options 
) const

Creates a new type describing the layout of a table.

The type definition is a JSON string describing the fields (i.e. columns) of the type. Each field consists of a name and a data type. Supported data types are: double, float, int, long, string, and bytes. In addition, one or more properties can be specified for each column which customize the memory usage and query availability of that column. Note that some properties are mutually exclusive–i.e. they cannot be specified for any given column simultaneously. One example of mutually exclusive properties are data and store_only.

A single primary key and/or single shard key can be set across one or more columns. If a primary key is specified, then a uniqueness constraint is enforced, in that only a single object can exist with a given primary key column value (or set of values for the key columns, if using a composite primary key). When inserting data into a table with a primary key, depending on the parameters in the request, incoming objects with primary key values that match existing objects will either overwrite (i.e. update) the existing object or will be skipped and not added into the set.

Example of a type definition with some of the parameters:

{"type":"record",
"name":"point",
"fields":[{"name":"msg_id","type":"string"},
{"name":"x","type":"double"},
{"name":"y","type":"double"},
{"name":"TIMESTAMP","type":"double"},
{"name":"source","type":"string"},
{"name":"group_id","type":"string"},
{"name":"OBJECT_ID","type":"string"}]
}

Properties:

{"group_id":["store_only"],
"msg_id":["store_only","text_search"]
}
Parameters
[in]typeDefinitiona JSON string describing the columns of the type to be registered.
[in]labelA user-defined description string which can be used to differentiate between tables and types with otherwise identical schemas.
[in]propertiesEach key-value pair specifies the properties to use for a given column where the key is the column name. All keys used must be relevant column names for the given table. Specifying any property overrides the default properties for that column (which is based on the column's data type). Valid values are:
  • create_type_data: Default property for all numeric and string type columns; makes the column available for GPU queries.
  • create_type_text_search: Valid only for select 'string' columns. Enables full text search–see Full Text Search for details and applicable string column types. Can be set independently of data and store_only.
  • create_type_store_only: Persist the column value but do not make it available to queries (e.g. filter)-i.e. it is mutually exclusive to the data property. Any 'bytes' type column must have a store_only property. This property reduces system memory usage.
  • create_type_disk_optimized: Works in conjunction with the data property for string columns. This property reduces system disk usage by disabling reverse string lookups. Queries like filter, filterByList, and filterByValue work as usual but aggregateUnique and aggregateGroupBy are not allowed on columns with this property.
  • create_type_timestamp: Valid only for 'long' columns. Indicates that this field represents a timestamp and will be provided in milliseconds since the Unix epoch: 00:00:00 Jan 1 1970. Dates represented by a timestamp must fall between the year 1000 and the year 2900.
  • create_type_ulong: Valid only for 'string' columns. It represents an unsigned long integer data type. The string can only be interpreted as an unsigned long data type with minimum value of zero, and maximum value of 18446744073709551615.
  • create_type_uuid: Valid only for 'string' columns. It represents an uuid data type. Internally, it is stored as a 128-bit integer.
  • create_type_decimal: Valid only for 'string' columns. It represents a SQL type NUMERIC(19, 4) data type. There can be up to 15 digits before the decimal point and up to four digits in the fractional part. The value can be positive or negative (indicated by a minus sign at the beginning). This property is mutually exclusive with the text_search property.
  • create_type_date: Valid only for 'string' columns. Indicates that this field represents a date and will be provided in the format 'YYYY-MM-DD'. The allowable range is 1000-01-01 through 2900-01-01. This property is mutually exclusive with the text_search property.
  • create_type_time: Valid only for 'string' columns. Indicates that this field represents a time-of-day and will be provided in the format 'HH:MM:SS.mmm'. The allowable range is 00:00:00.000 through 23:59:59.999. This property is mutually exclusive with the text_search property.
  • create_type_datetime: Valid only for 'string' columns. Indicates that this field represents a datetime and will be provided in the format 'YYYY-MM-DD HH:MM:SS.mmm'. The allowable range is 1000-01-01 00:00:00.000 through 2900-01-01 23:59:59.999. This property is mutually exclusive with the text_search property.
  • create_type_char1: This property provides optimized memory, disk and query performance for string columns. Strings with this property must be no longer than 1 character.
  • create_type_char2: This property provides optimized memory, disk and query performance for string columns. Strings with this property must be no longer than 2 characters.
  • create_type_char4: This property provides optimized memory, disk and query performance for string columns. Strings with this property must be no longer than 4 characters.
  • create_type_char8: This property provides optimized memory, disk and query performance for string columns. Strings with this property must be no longer than 8 characters.
  • create_type_char16: This property provides optimized memory, disk and query performance for string columns. Strings with this property must be no longer than 16 characters.
  • create_type_char32: This property provides optimized memory, disk and query performance for string columns. Strings with this property must be no longer than 32 characters.
  • create_type_char64: This property provides optimized memory, disk and query performance for string columns. Strings with this property must be no longer than 64 characters.
  • create_type_char128: This property provides optimized memory, disk and query performance for string columns. Strings with this property must be no longer than 128 characters.
  • create_type_char256: This property provides optimized memory, disk and query performance for string columns. Strings with this property must be no longer than 256 characters.
  • create_type_boolean: This property provides optimized memory and query performance for int columns. Ints with this property must be between 0 and 1(inclusive)
  • create_type_int8: This property provides optimized memory and query performance for int columns. Ints with this property must be between -128 and +127 (inclusive)
  • create_type_int16: This property provides optimized memory and query performance for int columns. Ints with this property must be between -32768 and +32767 (inclusive)
  • create_type_ipv4: This property provides optimized memory, disk and query performance for string columns representing IPv4 addresses (i.e. 192.168.1.1). Strings with this property must be of the form: A.B.C.D where A, B, C and D are in the range of 0-255.
  • create_type_array: Valid only for 'string' columns. Indicates that this field contains an array. The value type and (optionally) the item count should be specified in parenthesis; e.g., 'array(int, 10)' for a 10-integer array. Both 'array(int)' and 'array(int, -1)' will designate an unlimited-length integer array, though no bounds checking is performed on arrays of any length.
  • create_type_json: Valid only for 'string' columns. Indicates that this field contains values in JSON format.
  • create_type_vector: Valid only for 'bytes' columns. Indicates that this field contains a vector of floats. The length should be specified in parenthesis, e.g., 'vector(1000)'.
  • create_type_wkt: Valid only for 'string' and 'bytes' columns. Indicates that this field contains geospatial geometry objects in Well-Known Text (WKT) or Well-Known Binary (WKB) format.
  • create_type_primary_key: This property indicates that this column will be part of (or the entire) primary key.
  • create_type_soft_primary_key: This property indicates that this column will be part of (or the entire) soft primary key.
  • create_type_shard_key: This property indicates that this column will be part of (or the entire) shard key.
  • create_type_nullable: This property indicates that this column is nullable. However, setting this property is insufficient for making the column nullable. The user must declare the type of the column as a union between its regular type and 'null' in the avro schema for the record type in typeDefinition. For example, if a column is of type integer and is nullable, then the entry for the column in the avro schema must be: ['int', 'null']. The C++, C#, Java, and Python APIs have built-in convenience for bypassing setting the avro schema by hand. For those languages, one can use this property as usual and not have to worry about the avro schema for the record.
  • create_type_dict: This property indicates that this column should be dictionary encoded. It can only be used in conjunction with restricted string (charN), int, long or date columns. Dictionary encoding is best for columns where the cardinality (the number of unique values) is expected to be low. This property can save a large amount of memory.
  • create_type_init_with_now: For 'date', 'time', 'datetime', or 'timestamp' column types, replace empty strings and invalid timestamps with 'NOW()' upon insert.
  • create_type_init_with_uuid: For 'uuid' type, replace empty strings and invalid UUID values with randomly-generated UUIDs upon insert.
  • create_type_update_with_now: For 'date', 'time', 'datetime', or 'timestamp' column types, always update the field with 'NOW()' upon any update.
The default value is an empty map.
[in]optionsOptional parameters. The default value is an empty map.
Returns
Response object containing the result of the operation.

◆ createType() [4/4]

CreateTypeResponse& gpudb::GPUdb::createType ( const std::string &  typeDefinition,
const std::string &  label,
const std::map< std::string, std::vector< std::string > > &  properties,
const std::map< std::string, std::string > &  options,
CreateTypeResponse response_ 
) const

Creates a new type describing the layout of a table.

The type definition is a JSON string describing the fields (i.e. columns) of the type. Each field consists of a name and a data type. Supported data types are: double, float, int, long, string, and bytes. In addition, one or more properties can be specified for each column which customize the memory usage and query availability of that column. Note that some properties are mutually exclusive–i.e. they cannot be specified for any given column simultaneously. One example of mutually exclusive properties are data and store_only.

A single primary key and/or single shard key can be set across one or more columns. If a primary key is specified, then a uniqueness constraint is enforced, in that only a single object can exist with a given primary key column value (or set of values for the key columns, if using a composite primary key). When inserting data into a table with a primary key, depending on the parameters in the request, incoming objects with primary key values that match existing objects will either overwrite (i.e. update) the existing object or will be skipped and not added into the set.

Example of a type definition with some of the parameters:

{"type":"record",
"name":"point",
"fields":[{"name":"msg_id","type":"string"},
{"name":"x","type":"double"},
{"name":"y","type":"double"},
{"name":"TIMESTAMP","type":"double"},
{"name":"source","type":"string"},
{"name":"group_id","type":"string"},
{"name":"OBJECT_ID","type":"string"}]
}

Properties:

{"group_id":["store_only"],
"msg_id":["store_only","text_search"]
}
Parameters
[in]typeDefinitiona JSON string describing the columns of the type to be registered.
[in]labelA user-defined description string which can be used to differentiate between tables and types with otherwise identical schemas.
[in]propertiesEach key-value pair specifies the properties to use for a given column where the key is the column name. All keys used must be relevant column names for the given table. Specifying any property overrides the default properties for that column (which is based on the column's data type). Valid values are:
  • create_type_data: Default property for all numeric and string type columns; makes the column available for GPU queries.
  • create_type_text_search: Valid only for select 'string' columns. Enables full text search–see Full Text Search for details and applicable string column types. Can be set independently of data and store_only.
  • create_type_store_only: Persist the column value but do not make it available to queries (e.g. filter)-i.e. it is mutually exclusive to the data property. Any 'bytes' type column must have a store_only property. This property reduces system memory usage.
  • create_type_disk_optimized: Works in conjunction with the data property for string columns. This property reduces system disk usage by disabling reverse string lookups. Queries like filter, filterByList, and filterByValue work as usual but aggregateUnique and aggregateGroupBy are not allowed on columns with this property.
  • create_type_timestamp: Valid only for 'long' columns. Indicates that this field represents a timestamp and will be provided in milliseconds since the Unix epoch: 00:00:00 Jan 1 1970. Dates represented by a timestamp must fall between the year 1000 and the year 2900.
  • create_type_ulong: Valid only for 'string' columns. It represents an unsigned long integer data type. The string can only be interpreted as an unsigned long data type with minimum value of zero, and maximum value of 18446744073709551615.
  • create_type_uuid: Valid only for 'string' columns. It represents an uuid data type. Internally, it is stored as a 128-bit integer.
  • create_type_decimal: Valid only for 'string' columns. It represents a SQL type NUMERIC(19, 4) data type. There can be up to 15 digits before the decimal point and up to four digits in the fractional part. The value can be positive or negative (indicated by a minus sign at the beginning). This property is mutually exclusive with the text_search property.
  • create_type_date: Valid only for 'string' columns. Indicates that this field represents a date and will be provided in the format 'YYYY-MM-DD'. The allowable range is 1000-01-01 through 2900-01-01. This property is mutually exclusive with the text_search property.
  • create_type_time: Valid only for 'string' columns. Indicates that this field represents a time-of-day and will be provided in the format 'HH:MM:SS.mmm'. The allowable range is 00:00:00.000 through 23:59:59.999. This property is mutually exclusive with the text_search property.
  • create_type_datetime: Valid only for 'string' columns. Indicates that this field represents a datetime and will be provided in the format 'YYYY-MM-DD HH:MM:SS.mmm'. The allowable range is 1000-01-01 00:00:00.000 through 2900-01-01 23:59:59.999. This property is mutually exclusive with the text_search property.
  • create_type_char1: This property provides optimized memory, disk and query performance for string columns. Strings with this property must be no longer than 1 character.
  • create_type_char2: This property provides optimized memory, disk and query performance for string columns. Strings with this property must be no longer than 2 characters.
  • create_type_char4: This property provides optimized memory, disk and query performance for string columns. Strings with this property must be no longer than 4 characters.
  • create_type_char8: This property provides optimized memory, disk and query performance for string columns. Strings with this property must be no longer than 8 characters.
  • create_type_char16: This property provides optimized memory, disk and query performance for string columns. Strings with this property must be no longer than 16 characters.
  • create_type_char32: This property provides optimized memory, disk and query performance for string columns. Strings with this property must be no longer than 32 characters.
  • create_type_char64: This property provides optimized memory, disk and query performance for string columns. Strings with this property must be no longer than 64 characters.
  • create_type_char128: This property provides optimized memory, disk and query performance for string columns. Strings with this property must be no longer than 128 characters.
  • create_type_char256: This property provides optimized memory, disk and query performance for string columns. Strings with this property must be no longer than 256 characters.
  • create_type_boolean: This property provides optimized memory and query performance for int columns. Ints with this property must be between 0 and 1(inclusive)
  • create_type_int8: This property provides optimized memory and query performance for int columns. Ints with this property must be between -128 and +127 (inclusive)
  • create_type_int16: This property provides optimized memory and query performance for int columns. Ints with this property must be between -32768 and +32767 (inclusive)
  • create_type_ipv4: This property provides optimized memory, disk and query performance for string columns representing IPv4 addresses (i.e. 192.168.1.1). Strings with this property must be of the form: A.B.C.D where A, B, C and D are in the range of 0-255.
  • create_type_array: Valid only for 'string' columns. Indicates that this field contains an array. The value type and (optionally) the item count should be specified in parenthesis; e.g., 'array(int, 10)' for a 10-integer array. Both 'array(int)' and 'array(int, -1)' will designate an unlimited-length integer array, though no bounds checking is performed on arrays of any length.
  • create_type_json: Valid only for 'string' columns. Indicates that this field contains values in JSON format.
  • create_type_vector: Valid only for 'bytes' columns. Indicates that this field contains a vector of floats. The length should be specified in parenthesis, e.g., 'vector(1000)'.
  • create_type_wkt: Valid only for 'string' and 'bytes' columns. Indicates that this field contains geospatial geometry objects in Well-Known Text (WKT) or Well-Known Binary (WKB) format.
  • create_type_primary_key: This property indicates that this column will be part of (or the entire) primary key.
  • create_type_soft_primary_key: This property indicates that this column will be part of (or the entire) soft primary key.
  • create_type_shard_key: This property indicates that this column will be part of (or the entire) shard key.
  • create_type_nullable: This property indicates that this column is nullable. However, setting this property is insufficient for making the column nullable. The user must declare the type of the column as a union between its regular type and 'null' in the avro schema for the record type in typeDefinition. For example, if a column is of type integer and is nullable, then the entry for the column in the avro schema must be: ['int', 'null']. The C++, C#, Java, and Python APIs have built-in convenience for bypassing setting the avro schema by hand. For those languages, one can use this property as usual and not have to worry about the avro schema for the record.
  • create_type_dict: This property indicates that this column should be dictionary encoded. It can only be used in conjunction with restricted string (charN), int, long or date columns. Dictionary encoding is best for columns where the cardinality (the number of unique values) is expected to be low. This property can save a large amount of memory.
  • create_type_init_with_now: For 'date', 'time', 'datetime', or 'timestamp' column types, replace empty strings and invalid timestamps with 'NOW()' upon insert.
  • create_type_init_with_uuid: For 'uuid' type, replace empty strings and invalid UUID values with randomly-generated UUIDs upon insert.
  • create_type_update_with_now: For 'date', 'time', 'datetime', or 'timestamp' column types, always update the field with 'NOW()' upon any update.
The default value is an empty map.
[in]optionsOptional parameters. The default value is an empty map.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ createUnion() [1/4]

CreateUnionResponse gpudb::GPUdb::createUnion ( const CreateUnionRequest request_) const

Merges data from one or more tables with comparable data types into a new table.

The following merges are supported:

UNION (DISTINCT/ALL) - For data set union details and examples, see Union. For limitations, see Union Limitations and Cautions.

INTERSECT (DISTINCT/ALL) - For data set intersection details and examples, see Intersect. For limitations, see Intersect Limitations.

EXCEPT (DISTINCT/ALL) - For data set subtraction details and examples, see Except. For limitations, see Except Limitations.

MERGE VIEWS - For a given set of filtered views on a single table, creates a single filtered view containing all of the unique records across all of the given filtered data sets.

Non-charN 'string' and 'bytes' column types cannot be merged, nor can columns marked as store-only.

Parameters
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

◆ createUnion() [2/4]

CreateUnionResponse& gpudb::GPUdb::createUnion ( const CreateUnionRequest request_,
CreateUnionResponse response_ 
) const

Merges data from one or more tables with comparable data types into a new table.

The following merges are supported:

UNION (DISTINCT/ALL) - For data set union details and examples, see Union. For limitations, see Union Limitations and Cautions.

INTERSECT (DISTINCT/ALL) - For data set intersection details and examples, see Intersect. For limitations, see Intersect Limitations.

EXCEPT (DISTINCT/ALL) - For data set subtraction details and examples, see Except. For limitations, see Except Limitations.

MERGE VIEWS - For a given set of filtered views on a single table, creates a single filtered view containing all of the unique records across all of the given filtered data sets.

Non-charN 'string' and 'bytes' column types cannot be merged, nor can columns marked as store-only.

Parameters
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ createUnion() [3/4]

CreateUnionResponse gpudb::GPUdb::createUnion ( const std::string &  tableName,
const std::vector< std::string > &  tableNames,
const std::vector< std::vector< std::string > > &  inputColumnNames,
const std::vector< std::string > &  outputColumnNames,
const std::map< std::string, std::string > &  options 
) const

Merges data from one or more tables with comparable data types into a new table.

The following merges are supported:

UNION (DISTINCT/ALL) - For data set union details and examples, see Union. For limitations, see Union Limitations and Cautions.

INTERSECT (DISTINCT/ALL) - For data set intersection details and examples, see Intersect. For limitations, see Intersect Limitations.

EXCEPT (DISTINCT/ALL) - For data set subtraction details and examples, see Except. For limitations, see Except Limitations.

MERGE VIEWS - For a given set of filtered views on a single table, creates a single filtered view containing all of the unique records across all of the given filtered data sets.

Non-charN 'string' and 'bytes' column types cannot be merged, nor can columns marked as store-only.

Parameters
[in]tableNameName of the table to be created, in [schema_name.]table_name format, using standard name resolution rules and meeting table naming criteria.
[in]tableNamesThe list of table names to merge, in [schema_name.]table_name format, using standard name resolution rules. Must contain the names of one or more existing tables.
[in]inputColumnNamesThe list of columns from each of the corresponding input tables.
[in]outputColumnNamesThe list of names of the columns to be stored in the output table.
[in]optionsOptional parameters. The default value is an empty map.
Returns
Response object containing the result of the operation.

◆ createUnion() [4/4]

CreateUnionResponse& gpudb::GPUdb::createUnion ( const std::string &  tableName,
const std::vector< std::string > &  tableNames,
const std::vector< std::vector< std::string > > &  inputColumnNames,
const std::vector< std::string > &  outputColumnNames,
const std::map< std::string, std::string > &  options,
CreateUnionResponse response_ 
) const

Merges data from one or more tables with comparable data types into a new table.

The following merges are supported:

UNION (DISTINCT/ALL) - For data set union details and examples, see Union. For limitations, see Union Limitations and Cautions.

INTERSECT (DISTINCT/ALL) - For data set intersection details and examples, see Intersect. For limitations, see Intersect Limitations.

EXCEPT (DISTINCT/ALL) - For data set subtraction details and examples, see Except. For limitations, see Except Limitations.

MERGE VIEWS - For a given set of filtered views on a single table, creates a single filtered view containing all of the unique records across all of the given filtered data sets.

Non-charN 'string' and 'bytes' column types cannot be merged, nor can columns marked as store-only.

Parameters
[in]tableNameName of the table to be created, in [schema_name.]table_name format, using standard name resolution rules and meeting table naming criteria.
[in]tableNamesThe list of table names to merge, in [schema_name.]table_name format, using standard name resolution rules. Must contain the names of one or more existing tables.
[in]inputColumnNamesThe list of columns from each of the corresponding input tables.
[in]outputColumnNamesThe list of names of the columns to be stored in the output table.
[in]optionsOptional parameters. The default value is an empty map.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ createUserExternal() [1/4]

CreateUserExternalResponse gpudb::GPUdb::createUserExternal ( const CreateUserExternalRequest request_) const

Creates a new external user (a user whose credentials are managed by an external LDAP).

Attention
This method should be used for on-premise deployments only.
Parameters
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

◆ createUserExternal() [2/4]

CreateUserExternalResponse& gpudb::GPUdb::createUserExternal ( const CreateUserExternalRequest request_,
CreateUserExternalResponse response_ 
) const

Creates a new external user (a user whose credentials are managed by an external LDAP).

Attention
This method should be used for on-premise deployments only.
Parameters
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ createUserExternal() [3/4]

CreateUserExternalResponse gpudb::GPUdb::createUserExternal ( const std::string &  name,
const std::map< std::string, std::string > &  options 
) const

Creates a new external user (a user whose credentials are managed by an external LDAP).

Attention
This method should be used for on-premise deployments only.
Parameters
[in]nameName of the user to be created. Must exactly match the user's name in the external LDAP, prefixed with a . Must not be the same name as an existing user.
[in]optionsOptional parameters. The default value is an empty map.
Returns
Response object containing the result of the operation.

◆ createUserExternal() [4/4]

CreateUserExternalResponse& gpudb::GPUdb::createUserExternal ( const std::string &  name,
const std::map< std::string, std::string > &  options,
CreateUserExternalResponse response_ 
) const

Creates a new external user (a user whose credentials are managed by an external LDAP).

Attention
This method should be used for on-premise deployments only.
Parameters
[in]nameName of the user to be created. Must exactly match the user's name in the external LDAP, prefixed with a . Must not be the same name as an existing user.
[in]optionsOptional parameters. The default value is an empty map.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ createUserInternal() [1/4]

CreateUserInternalResponse gpudb::GPUdb::createUserInternal ( const CreateUserInternalRequest request_) const

Creates a new internal user (a user whose credentials are managed by the database system).

Parameters
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

◆ createUserInternal() [2/4]

CreateUserInternalResponse& gpudb::GPUdb::createUserInternal ( const CreateUserInternalRequest request_,
CreateUserInternalResponse response_ 
) const

Creates a new internal user (a user whose credentials are managed by the database system).

Parameters
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ createUserInternal() [3/4]

CreateUserInternalResponse gpudb::GPUdb::createUserInternal ( const std::string &  name,
const std::string &  password,
const std::map< std::string, std::string > &  options 
) const

Creates a new internal user (a user whose credentials are managed by the database system).

Parameters
[in]nameName of the user to be created. Must contain only lowercase letters, digits, and underscores, and cannot begin with a digit. Must not be the same name as an existing user or role.
[in]passwordInitial password of the user to be created. May be an empty string for no password.
[in]optionsOptional parameters. The default value is an empty map.
Returns
Response object containing the result of the operation.

◆ createUserInternal() [4/4]

CreateUserInternalResponse& gpudb::GPUdb::createUserInternal ( const std::string &  name,
const std::string &  password,
const std::map< std::string, std::string > &  options,
CreateUserInternalResponse response_ 
) const

Creates a new internal user (a user whose credentials are managed by the database system).

Parameters
[in]nameName of the user to be created. Must contain only lowercase letters, digits, and underscores, and cannot begin with a digit. Must not be the same name as an existing user or role.
[in]passwordInitial password of the user to be created. May be an empty string for no password.
[in]optionsOptional parameters. The default value is an empty map.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ createVideo() [1/4]

CreateVideoResponse gpudb::GPUdb::createVideo ( const CreateVideoRequest request_) const

Creates a job to generate a sequence of raster images that visualize data over a specified time.

Parameters
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

◆ createVideo() [2/4]

CreateVideoResponse& gpudb::GPUdb::createVideo ( const CreateVideoRequest request_,
CreateVideoResponse response_ 
) const

Creates a job to generate a sequence of raster images that visualize data over a specified time.

Parameters
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ createVideo() [3/4]

CreateVideoResponse gpudb::GPUdb::createVideo ( const std::string &  attribute,
const std::string &  begin,
const double  durationSeconds,
const std::string &  end,
const double  framesPerSecond,
const std::string &  style,
const std::string &  path,
const std::string &  styleParameters,
const std::map< std::string, std::string > &  options 
) const

Creates a job to generate a sequence of raster images that visualize data over a specified time.

Parameters
[in]attributeThe animated attribute to map to the video's frames. Must be present in the LAYERS specified for the visualization. This is often a time-related field but may be any numeric type.
[in]beginThe start point for the video. Accepts an expression evaluable over the attribute.
[in]durationSecondsSeconds of video to produce
[in]endThe end point for the video. Accepts an expression evaluable over the attribute.
[in]framesPerSecondThe presentation frame rate of the encoded video in frames per second.
[in]styleThe name of the visualize mode; should correspond to the schema used for the styleParameters field. Supported values:
[in]pathFully-qualified KiFS path. Write access is required. A file must not exist at that path, unless replace_if_exists is true.
[in]styleParametersA string containing the JSON-encoded visualize request. Must correspond to the visualize mode specified in the style field.
[in]optionsOptional parameters. The default value is an empty map.
Returns
Response object containing the result of the operation.

◆ createVideo() [4/4]

CreateVideoResponse& gpudb::GPUdb::createVideo ( const std::string &  attribute,
const std::string &  begin,
const double  durationSeconds,
const std::string &  end,
const double  framesPerSecond,
const std::string &  style,
const std::string &  path,
const std::string &  styleParameters,
const std::map< std::string, std::string > &  options,
CreateVideoResponse response_ 
) const

Creates a job to generate a sequence of raster images that visualize data over a specified time.

Parameters
[in]attributeThe animated attribute to map to the video's frames. Must be present in the LAYERS specified for the visualization. This is often a time-related field but may be any numeric type.
[in]beginThe start point for the video. Accepts an expression evaluable over the attribute.
[in]durationSecondsSeconds of video to produce
[in]endThe end point for the video. Accepts an expression evaluable over the attribute.
[in]framesPerSecondThe presentation frame rate of the encoded video in frames per second.
[in]styleThe name of the visualize mode; should correspond to the schema used for the styleParameters field. Supported values:
[in]pathFully-qualified KiFS path. Write access is required. A file must not exist at that path, unless replace_if_exists is true.
[in]styleParametersA string containing the JSON-encoded visualize request. Must correspond to the visualize mode specified in the style field.
[in]optionsOptional parameters. The default value is an empty map.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ deleteDirectory() [1/4]

DeleteDirectoryResponse gpudb::GPUdb::deleteDirectory ( const DeleteDirectoryRequest request_) const

Deletes a directory from KiFS.

Parameters
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

◆ deleteDirectory() [2/4]

DeleteDirectoryResponse& gpudb::GPUdb::deleteDirectory ( const DeleteDirectoryRequest request_,
DeleteDirectoryResponse response_ 
) const

Deletes a directory from KiFS.

Parameters
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ deleteDirectory() [3/4]

DeleteDirectoryResponse gpudb::GPUdb::deleteDirectory ( const std::string &  directoryName,
const std::map< std::string, std::string > &  options 
) const

Deletes a directory from KiFS.

Parameters
[in]directoryNameName of the directory in KiFS to be deleted. The directory must contain no files, unless recursive is true
[in]optionsOptional parameters. The default value is an empty map.
Returns
Response object containing the result of the operation.

◆ deleteDirectory() [4/4]

DeleteDirectoryResponse& gpudb::GPUdb::deleteDirectory ( const std::string &  directoryName,
const std::map< std::string, std::string > &  options,
DeleteDirectoryResponse response_ 
) const

Deletes a directory from KiFS.

Parameters
[in]directoryNameName of the directory in KiFS to be deleted. The directory must contain no files, unless recursive is true
[in]optionsOptional parameters. The default value is an empty map.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ deleteFiles() [1/4]

DeleteFilesResponse gpudb::GPUdb::deleteFiles ( const DeleteFilesRequest request_) const

Deletes one or more files from KiFS.

Parameters
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

◆ deleteFiles() [2/4]

DeleteFilesResponse& gpudb::GPUdb::deleteFiles ( const DeleteFilesRequest request_,
DeleteFilesResponse response_ 
) const

Deletes one or more files from KiFS.

Parameters
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ deleteFiles() [3/4]

DeleteFilesResponse gpudb::GPUdb::deleteFiles ( const std::vector< std::string > &  fileNames,
const std::map< std::string, std::string > &  options 
) const

Deletes one or more files from KiFS.

Parameters
[in]fileNamesAn array of names of files to be deleted. File paths may contain wildcard characters after the KiFS directory delimeter. Accepted wildcard characters are asterisk (*) to represent any string of zero or more characters, and question mark (?) to indicate a single character.
[in]optionsOptional parameters. The default value is an empty map.
Returns
Response object containing the result of the operation.

◆ deleteFiles() [4/4]

DeleteFilesResponse& gpudb::GPUdb::deleteFiles ( const std::vector< std::string > &  fileNames,
const std::map< std::string, std::string > &  options,
DeleteFilesResponse response_ 
) const

Deletes one or more files from KiFS.

Parameters
[in]fileNamesAn array of names of files to be deleted. File paths may contain wildcard characters after the KiFS directory delimeter. Accepted wildcard characters are asterisk (*) to represent any string of zero or more characters, and question mark (?) to indicate a single character.
[in]optionsOptional parameters. The default value is an empty map.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ deleteGraph() [1/4]

DeleteGraphResponse gpudb::GPUdb::deleteGraph ( const DeleteGraphRequest request_) const

Deletes an existing graph from the graph server and/or persist.

Parameters
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

◆ deleteGraph() [2/4]

DeleteGraphResponse& gpudb::GPUdb::deleteGraph ( const DeleteGraphRequest request_,
DeleteGraphResponse response_ 
) const

Deletes an existing graph from the graph server and/or persist.

Parameters
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ deleteGraph() [3/4]

DeleteGraphResponse gpudb::GPUdb::deleteGraph ( const std::string &  graphName,
const std::map< std::string, std::string > &  options 
) const

Deletes an existing graph from the graph server and/or persist.

Parameters
[in]graphNameName of the graph to be deleted.
[in]optionsOptional parameters. The default value is an empty map.
Returns
Response object containing the result of the operation.

◆ deleteGraph() [4/4]

DeleteGraphResponse& gpudb::GPUdb::deleteGraph ( const std::string &  graphName,
const std::map< std::string, std::string > &  options,
DeleteGraphResponse response_ 
) const

Deletes an existing graph from the graph server and/or persist.

Parameters
[in]graphNameName of the graph to be deleted.
[in]optionsOptional parameters. The default value is an empty map.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ deleteProc() [1/4]

DeleteProcResponse gpudb::GPUdb::deleteProc ( const DeleteProcRequest request_) const

Deletes a proc.

Any currently running instances of the proc will be killed.

Parameters
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

◆ deleteProc() [2/4]

DeleteProcResponse& gpudb::GPUdb::deleteProc ( const DeleteProcRequest request_,
DeleteProcResponse response_ 
) const

Deletes a proc.

Any currently running instances of the proc will be killed.

Parameters
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ deleteProc() [3/4]

DeleteProcResponse gpudb::GPUdb::deleteProc ( const std::string &  procName,
const std::map< std::string, std::string > &  options 
) const

Deletes a proc.

Any currently running instances of the proc will be killed.

Parameters
[in]procNameName of the proc to be deleted. Must be the name of a currently existing proc.
[in]optionsOptional parameters. The default value is an empty map.
Returns
Response object containing the result of the operation.

◆ deleteProc() [4/4]

DeleteProcResponse& gpudb::GPUdb::deleteProc ( const std::string &  procName,
const std::map< std::string, std::string > &  options,
DeleteProcResponse response_ 
) const

Deletes a proc.

Any currently running instances of the proc will be killed.

Parameters
[in]procNameName of the proc to be deleted. Must be the name of a currently existing proc.
[in]optionsOptional parameters. The default value is an empty map.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ deleteRecords() [1/4]

DeleteRecordsResponse gpudb::GPUdb::deleteRecords ( const DeleteRecordsRequest request_) const

Deletes record(s) matching the provided criteria from the given table.

The record selection criteria can either be one or more expressions (matching multiple records), a single record identified by record_id options, or all records when using delete_all_records. Note that the three selection criteria are mutually exclusive. This operation cannot be run on a view. The operation is synchronous meaning that a response will not be available until the request is completely processed and all the matching records are deleted.

Parameters
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

◆ deleteRecords() [2/4]

DeleteRecordsResponse& gpudb::GPUdb::deleteRecords ( const DeleteRecordsRequest request_,
DeleteRecordsResponse response_ 
) const

Deletes record(s) matching the provided criteria from the given table.

The record selection criteria can either be one or more expressions (matching multiple records), a single record identified by record_id options, or all records when using delete_all_records. Note that the three selection criteria are mutually exclusive. This operation cannot be run on a view. The operation is synchronous meaning that a response will not be available until the request is completely processed and all the matching records are deleted.

Parameters
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ deleteRecords() [3/4]

DeleteRecordsResponse gpudb::GPUdb::deleteRecords ( const std::string &  tableName,
const std::vector< std::string > &  expressions,
const std::map< std::string, std::string > &  options 
) const

Deletes record(s) matching the provided criteria from the given table.

The record selection criteria can either be one or more expressions (matching multiple records), a single record identified by record_id options, or all records when using delete_all_records. Note that the three selection criteria are mutually exclusive. This operation cannot be run on a view. The operation is synchronous meaning that a response will not be available until the request is completely processed and all the matching records are deleted.

Parameters
[in]tableNameName of the table from which to delete records, in [schema_name.]table_name format, using standard name resolution rules. Must contain the name of an existing table; not applicable to views.
[in]expressionsA list of the actual predicates, one for each select; format should follow the guidelines provided here. Specifying one or more expressions is mutually exclusive to specifying record_id in the options.
[in]optionsOptional parameters. The default value is an empty map.
Returns
Response object containing the result of the operation.

◆ deleteRecords() [4/4]

DeleteRecordsResponse& gpudb::GPUdb::deleteRecords ( const std::string &  tableName,
const std::vector< std::string > &  expressions,
const std::map< std::string, std::string > &  options,
DeleteRecordsResponse response_ 
) const

Deletes record(s) matching the provided criteria from the given table.

The record selection criteria can either be one or more expressions (matching multiple records), a single record identified by record_id options, or all records when using delete_all_records. Note that the three selection criteria are mutually exclusive. This operation cannot be run on a view. The operation is synchronous meaning that a response will not be available until the request is completely processed and all the matching records are deleted.

Parameters
[in]tableNameName of the table from which to delete records, in [schema_name.]table_name format, using standard name resolution rules. Must contain the name of an existing table; not applicable to views.
[in]expressionsA list of the actual predicates, one for each select; format should follow the guidelines provided here. Specifying one or more expressions is mutually exclusive to specifying record_id in the options.
[in]optionsOptional parameters. The default value is an empty map.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ deleteResourceGroup() [1/4]

DeleteResourceGroupResponse gpudb::GPUdb::deleteResourceGroup ( const DeleteResourceGroupRequest request_) const

Deletes a resource group.

Parameters
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

◆ deleteResourceGroup() [2/4]

DeleteResourceGroupResponse& gpudb::GPUdb::deleteResourceGroup ( const DeleteResourceGroupRequest request_,
DeleteResourceGroupResponse response_ 
) const

Deletes a resource group.

Parameters
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ deleteResourceGroup() [3/4]

DeleteResourceGroupResponse gpudb::GPUdb::deleteResourceGroup ( const std::string &  name,
const std::map< std::string, std::string > &  options 
) const

Deletes a resource group.

Parameters
[in]nameName of the resource group to be deleted.
[in]optionsOptional parameters. The default value is an empty map.
Returns
Response object containing the result of the operation.

◆ deleteResourceGroup() [4/4]

DeleteResourceGroupResponse& gpudb::GPUdb::deleteResourceGroup ( const std::string &  name,
const std::map< std::string, std::string > &  options,
DeleteResourceGroupResponse response_ 
) const

Deletes a resource group.

Parameters
[in]nameName of the resource group to be deleted.
[in]optionsOptional parameters. The default value is an empty map.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ deleteRole() [1/4]

DeleteRoleResponse gpudb::GPUdb::deleteRole ( const DeleteRoleRequest request_) const

Deletes an existing role.

Attention
This method should be used for on-premise deployments only.
Parameters
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

◆ deleteRole() [2/4]

DeleteRoleResponse& gpudb::GPUdb::deleteRole ( const DeleteRoleRequest request_,
DeleteRoleResponse response_ 
) const

Deletes an existing role.

Attention
This method should be used for on-premise deployments only.
Parameters
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ deleteRole() [3/4]

DeleteRoleResponse gpudb::GPUdb::deleteRole ( const std::string &  name,
const std::map< std::string, std::string > &  options 
) const

Deletes an existing role.

Attention
This method should be used for on-premise deployments only.
Parameters
[in]nameName of the role to be deleted. Must be an existing role.
[in]optionsOptional parameters. The default value is an empty map.
Returns
Response object containing the result of the operation.

◆ deleteRole() [4/4]

DeleteRoleResponse& gpudb::GPUdb::deleteRole ( const std::string &  name,
const std::map< std::string, std::string > &  options,
DeleteRoleResponse response_ 
) const

Deletes an existing role.

Attention
This method should be used for on-premise deployments only.
Parameters
[in]nameName of the role to be deleted. Must be an existing role.
[in]optionsOptional parameters. The default value is an empty map.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ deleteUser() [1/4]

DeleteUserResponse gpudb::GPUdb::deleteUser ( const DeleteUserRequest request_) const

Deletes an existing user.

Attention
This method should be used for on-premise deployments only.
Parameters
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

◆ deleteUser() [2/4]

DeleteUserResponse& gpudb::GPUdb::deleteUser ( const DeleteUserRequest request_,
DeleteUserResponse response_ 
) const

Deletes an existing user.

Attention
This method should be used for on-premise deployments only.
Parameters
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ deleteUser() [3/4]

DeleteUserResponse gpudb::GPUdb::deleteUser ( const std::string &  name,
const std::map< std::string, std::string > &  options 
) const

Deletes an existing user.

Attention
This method should be used for on-premise deployments only.
Parameters
[in]nameName of the user to be deleted. Must be an existing user.
[in]optionsOptional parameters. The default value is an empty map.
Returns
Response object containing the result of the operation.

◆ deleteUser() [4/4]

DeleteUserResponse& gpudb::GPUdb::deleteUser ( const std::string &  name,
const std::map< std::string, std::string > &  options,
DeleteUserResponse response_ 
) const

Deletes an existing user.

Attention
This method should be used for on-premise deployments only.
Parameters
[in]nameName of the user to be deleted. Must be an existing user.
[in]optionsOptional parameters. The default value is an empty map.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ downloadFiles() [1/4]

DownloadFilesResponse gpudb::GPUdb::downloadFiles ( const DownloadFilesRequest request_) const

Downloads one or more files from KiFS.

Parameters
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

◆ downloadFiles() [2/4]

DownloadFilesResponse& gpudb::GPUdb::downloadFiles ( const DownloadFilesRequest request_,
DownloadFilesResponse response_ 
) const

Downloads one or more files from KiFS.

Parameters
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ downloadFiles() [3/4]

DownloadFilesResponse gpudb::GPUdb::downloadFiles ( const std::vector< std::string > &  fileNames,
const std::vector< int64_t > &  readOffsets,
const std::vector< int64_t > &  readLengths,
const std::map< std::string, std::string > &  options 
) const

Downloads one or more files from KiFS.

Parameters
[in]fileNamesAn array of the file names to download from KiFS. File paths may contain wildcard characters after the KiFS directory delimeter. Accepted wildcard characters are asterisk (*) to represent any string of zero or more characters, and question mark (?) to indicate a single character.
[in]readOffsetsAn array of starting byte offsets from which to read each respective file in fileNames. Must either be empty or the same length as fileNames. If empty, files are downloaded in their entirety. If not empty, readLengths must also not be empty.
[in]readLengthsArray of number of bytes to read from each respective file in fileNames. Must either be empty or the same length as fileNames. If empty, files are downloaded in their entirety. If not empty, readOffsets must also not be empty.
[in]optionsOptional parameters. The default value is an empty map.
Returns
Response object containing the result of the operation.

◆ downloadFiles() [4/4]

DownloadFilesResponse& gpudb::GPUdb::downloadFiles ( const std::vector< std::string > &  fileNames,
const std::vector< int64_t > &  readOffsets,
const std::vector< int64_t > &  readLengths,
const std::map< std::string, std::string > &  options,
DownloadFilesResponse response_ 
) const

Downloads one or more files from KiFS.

Parameters
[in]fileNamesAn array of the file names to download from KiFS. File paths may contain wildcard characters after the KiFS directory delimeter. Accepted wildcard characters are asterisk (*) to represent any string of zero or more characters, and question mark (?) to indicate a single character.
[in]readOffsetsAn array of starting byte offsets from which to read each respective file in fileNames. Must either be empty or the same length as fileNames. If empty, files are downloaded in their entirety. If not empty, readLengths must also not be empty.
[in]readLengthsArray of number of bytes to read from each respective file in fileNames. Must either be empty or the same length as fileNames. If empty, files are downloaded in their entirety. If not empty, readOffsets must also not be empty.
[in]optionsOptional parameters. The default value is an empty map.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ dropCredential() [1/4]

DropCredentialResponse gpudb::GPUdb::dropCredential ( const DropCredentialRequest request_) const

Drop an existing credential.

Parameters
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

◆ dropCredential() [2/4]

DropCredentialResponse& gpudb::GPUdb::dropCredential ( const DropCredentialRequest request_,
DropCredentialResponse response_ 
) const

Drop an existing credential.

Parameters
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ dropCredential() [3/4]

DropCredentialResponse gpudb::GPUdb::dropCredential ( const std::string &  credentialName,
const std::map< std::string, std::string > &  options 
) const

Drop an existing credential.

Parameters
[in]credentialNameName of the credential to be dropped. Must be an existing credential.
[in]optionsOptional parameters. The default value is an empty map.
Returns
Response object containing the result of the operation.

◆ dropCredential() [4/4]

DropCredentialResponse& gpudb::GPUdb::dropCredential ( const std::string &  credentialName,
const std::map< std::string, std::string > &  options,
DropCredentialResponse response_ 
) const

Drop an existing credential.

Parameters
[in]credentialNameName of the credential to be dropped. Must be an existing credential.
[in]optionsOptional parameters. The default value is an empty map.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ dropDatasink() [1/4]

DropDatasinkResponse gpudb::GPUdb::dropDatasink ( const DropDatasinkRequest request_) const

Drops an existing data sink.

By default, if any table monitors use this sink as a destination, the request will be blocked unless option clear_table_monitors is true.

Parameters
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

◆ dropDatasink() [2/4]

DropDatasinkResponse& gpudb::GPUdb::dropDatasink ( const DropDatasinkRequest request_,
DropDatasinkResponse response_ 
) const

Drops an existing data sink.

By default, if any table monitors use this sink as a destination, the request will be blocked unless option clear_table_monitors is true.

Parameters
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ dropDatasink() [3/4]

DropDatasinkResponse gpudb::GPUdb::dropDatasink ( const std::string &  name,
const std::map< std::string, std::string > &  options 
) const

Drops an existing data sink.

By default, if any table monitors use this sink as a destination, the request will be blocked unless option clear_table_monitors is true.

Parameters
[in]nameName of the data sink to be dropped. Must be an existing data sink.
[in]optionsOptional parameters. The default value is an empty map.
Returns
Response object containing the result of the operation.

◆ dropDatasink() [4/4]

DropDatasinkResponse& gpudb::GPUdb::dropDatasink ( const std::string &  name,
const std::map< std::string, std::string > &  options,
DropDatasinkResponse response_ 
) const

Drops an existing data sink.

By default, if any table monitors use this sink as a destination, the request will be blocked unless option clear_table_monitors is true.

Parameters
[in]nameName of the data sink to be dropped. Must be an existing data sink.
[in]optionsOptional parameters. The default value is an empty map.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ dropDatasource() [1/4]

DropDatasourceResponse gpudb::GPUdb::dropDatasource ( const DropDatasourceRequest request_) const

Drops an existing data source.

Any external tables that depend on the data source must be dropped before it can be dropped.

Parameters
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

◆ dropDatasource() [2/4]

DropDatasourceResponse& gpudb::GPUdb::dropDatasource ( const DropDatasourceRequest request_,
DropDatasourceResponse response_ 
) const

Drops an existing data source.

Any external tables that depend on the data source must be dropped before it can be dropped.

Parameters
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ dropDatasource() [3/4]

DropDatasourceResponse gpudb::GPUdb::dropDatasource ( const std::string &  name,
const std::map< std::string, std::string > &  options 
) const

Drops an existing data source.

Any external tables that depend on the data source must be dropped before it can be dropped.

Parameters
[in]nameName of the data source to be dropped. Must be an existing data source.
[in]optionsOptional parameters. The default value is an empty map.
Returns
Response object containing the result of the operation.

◆ dropDatasource() [4/4]

DropDatasourceResponse& gpudb::GPUdb::dropDatasource ( const std::string &  name,
const std::map< std::string, std::string > &  options,
DropDatasourceResponse response_ 
) const

Drops an existing data source.

Any external tables that depend on the data source must be dropped before it can be dropped.

Parameters
[in]nameName of the data source to be dropped. Must be an existing data source.
[in]optionsOptional parameters. The default value is an empty map.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ dropEnvironment() [1/4]

DropEnvironmentResponse gpudb::GPUdb::dropEnvironment ( const DropEnvironmentRequest request_) const

Drop an existing user-defined function (UDF) environment.

Parameters
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

◆ dropEnvironment() [2/4]

DropEnvironmentResponse& gpudb::GPUdb::dropEnvironment ( const DropEnvironmentRequest request_,
DropEnvironmentResponse response_ 
) const

Drop an existing user-defined function (UDF) environment.

Parameters
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ dropEnvironment() [3/4]

DropEnvironmentResponse gpudb::GPUdb::dropEnvironment ( const std::string &  environmentName,
const std::map< std::string, std::string > &  options 
) const

Drop an existing user-defined function (UDF) environment.

Parameters
[in]environmentNameName of the environment to be dropped. Must be an existing environment.
[in]optionsOptional parameters. The default value is an empty map.
Returns
Response object containing the result of the operation.

◆ dropEnvironment() [4/4]

DropEnvironmentResponse& gpudb::GPUdb::dropEnvironment ( const std::string &  environmentName,
const std::map< std::string, std::string > &  options,
DropEnvironmentResponse response_ 
) const

Drop an existing user-defined function (UDF) environment.

Parameters
[in]environmentNameName of the environment to be dropped. Must be an existing environment.
[in]optionsOptional parameters. The default value is an empty map.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ dropSchema() [1/4]

DropSchemaResponse gpudb::GPUdb::dropSchema ( const DropSchemaRequest request_) const

Drops an existing SQL-style schema, specified in schemaName.

Parameters
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

◆ dropSchema() [2/4]

DropSchemaResponse& gpudb::GPUdb::dropSchema ( const DropSchemaRequest request_,
DropSchemaResponse response_ 
) const

Drops an existing SQL-style schema, specified in schemaName.

Parameters
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ dropSchema() [3/4]

DropSchemaResponse gpudb::GPUdb::dropSchema ( const std::string &  schemaName,
const std::map< std::string, std::string > &  options 
) const

Drops an existing SQL-style schema, specified in schemaName.

Parameters
[in]schemaNameName of the schema to be dropped. Must be an existing schema.
[in]optionsOptional parameters. The default value is an empty map.
Returns
Response object containing the result of the operation.

◆ dropSchema() [4/4]

DropSchemaResponse& gpudb::GPUdb::dropSchema ( const std::string &  schemaName,
const std::map< std::string, std::string > &  options,
DropSchemaResponse response_ 
) const

Drops an existing SQL-style schema, specified in schemaName.

Parameters
[in]schemaNameName of the schema to be dropped. Must be an existing schema.
[in]optionsOptional parameters. The default value is an empty map.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ execute() [1/5]

long gpudb::GPUdb::execute ( const std::string &  sql)

This method is used to execute a SQL statement (e.g., DML, DDL).

It returns the number of rows affected by the statement.

Parameters
sql- The SQL query to execute
Returns
- number of rows affected by the execution of statement

◆ execute() [2/5]

long gpudb::GPUdb::execute ( const std::string &  sql,
const std::string &  parameters 
)

This method is used to execute a SQL statement (e.g., DML, DDL).

It returns the number of rows affected by the statement.

Parameters
sql- The SQL query to execute
parameters- Query parameters for the SQL query. Can be empty.
Returns
- number of rows affected by the execution of statement

◆ execute() [3/5]

long gpudb::GPUdb::execute ( const std::string &  sql,
const std::string &  parameters,
const std::map< std::string, std::string > &  options 
)

This method is used to execute a SQL statement (e.g., DML, DDL).

It returns the number of rows affected by the statement.

Parameters
sql- The SQL query to execute
parameters- Query parameters for the SQL query. Can be empty.
options- Optional parameters for the execute call.
Returns
- number of rows affected by the execution of statement

◆ execute() [4/5]

template<typename T >
long gpudb::GPUdb::execute ( const std::string &  sql,
const std::vector< T > &  parameters 
)

◆ execute() [5/5]

template<typename T >
long gpudb::GPUdb::execute ( const std::string &  sql,
const std::vector< T > &  parameters,
const std::map< std::string, std::string > &  options 
)

◆ executeProc() [1/4]

ExecuteProcResponse gpudb::GPUdb::executeProc ( const ExecuteProcRequest request_) const

Executes a proc.

This endpoint is asynchronous and does not wait for the proc to complete before returning.

If the proc being executed is distributed, inputTableNames & inputColumnNames may be passed to the proc to use for reading data, and outputTableNames may be passed to the proc to use for writing data.

If the proc being executed is non-distributed, these table parameters will be ignored.

Parameters
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

◆ executeProc() [2/4]

ExecuteProcResponse& gpudb::GPUdb::executeProc ( const ExecuteProcRequest request_,
ExecuteProcResponse response_ 
) const

Executes a proc.

This endpoint is asynchronous and does not wait for the proc to complete before returning.

If the proc being executed is distributed, inputTableNames & inputColumnNames may be passed to the proc to use for reading data, and outputTableNames may be passed to the proc to use for writing data.

If the proc being executed is non-distributed, these table parameters will be ignored.

Parameters
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ executeProc() [3/4]

ExecuteProcResponse gpudb::GPUdb::executeProc ( const std::string &  procName,
const std::map< std::string, std::string > &  params,
const std::map< std::string, std::vector< uint8_t > > &  binParams,
const std::vector< std::string > &  inputTableNames,
const std::map< std::string, std::vector< std::string > > &  inputColumnNames,
const std::vector< std::string > &  outputTableNames,
const std::map< std::string, std::string > &  options 
) const

Executes a proc.

This endpoint is asynchronous and does not wait for the proc to complete before returning.

If the proc being executed is distributed, inputTableNames & inputColumnNames may be passed to the proc to use for reading data, and outputTableNames may be passed to the proc to use for writing data.

If the proc being executed is non-distributed, these table parameters will be ignored.

Parameters
[in]procNameName of the proc to execute. Must be the name of a currently existing proc.
[in]paramsA map containing named parameters to pass to the proc. Each key/value pair specifies the name of a parameter and its value. The default value is an empty map.
[in]binParamsA map containing named binary parameters to pass to the proc. Each key/value pair specifies the name of a parameter and its value. The default value is an empty map.
[in]inputTableNamesNames of the tables containing data to be passed to the proc. Each name specified must be the name of a currently existing table, in [schema_name.]table_name format, using standard name resolution rules. If no table names are specified, no data will be passed to the proc. This parameter is ignored if the proc has a non-distributed execution mode. The default value is an empty vector.
[in]inputColumnNamesMap of table names from inputTableNames to lists of names of columns from those tables that will be passed to the proc. Each column name specified must be the name of an existing column in the corresponding table. If a table name from inputTableNames is not included, all columns from that table will be passed to the proc. This parameter is ignored if the proc has a non-distributed execution mode. The default value is an empty map.
[in]outputTableNamesNames of the tables to which output data from the proc will be written, each in [schema_name.]table_name format, using standard name resolution rules and meeting table naming criteria. If a specified table does not exist, it will automatically be created with the same schema as the corresponding table (by order) from inputTableNames, excluding any primary and shard keys. If a specified table is a non-persistent result table, it must not have primary or shard keys. If no table names are specified, no output data can be returned from the proc. This parameter is ignored if the proc has a non-distributed execution mode. The default value is an empty vector.
[in]optionsOptional parameters. The default value is an empty map.
Returns
Response object containing the result of the operation.

◆ executeProc() [4/4]

ExecuteProcResponse& gpudb::GPUdb::executeProc ( const std::string &  procName,
const std::map< std::string, std::string > &  params,
const std::map< std::string, std::vector< uint8_t > > &  binParams,
const std::vector< std::string > &  inputTableNames,
const std::map< std::string, std::vector< std::string > > &  inputColumnNames,
const std::vector< std::string > &  outputTableNames,
const std::map< std::string, std::string > &  options,
ExecuteProcResponse response_ 
) const

Executes a proc.

This endpoint is asynchronous and does not wait for the proc to complete before returning.

If the proc being executed is distributed, inputTableNames & inputColumnNames may be passed to the proc to use for reading data, and outputTableNames may be passed to the proc to use for writing data.

If the proc being executed is non-distributed, these table parameters will be ignored.

Parameters
[in]procNameName of the proc to execute. Must be the name of a currently existing proc.
[in]paramsA map containing named parameters to pass to the proc. Each key/value pair specifies the name of a parameter and its value. The default value is an empty map.
[in]binParamsA map containing named binary parameters to pass to the proc. Each key/value pair specifies the name of a parameter and its value. The default value is an empty map.
[in]inputTableNamesNames of the tables containing data to be passed to the proc. Each name specified must be the name of a currently existing table, in [schema_name.]table_name format, using standard name resolution rules. If no table names are specified, no data will be passed to the proc. This parameter is ignored if the proc has a non-distributed execution mode. The default value is an empty vector.
[in]inputColumnNamesMap of table names from inputTableNames to lists of names of columns from those tables that will be passed to the proc. Each column name specified must be the name of an existing column in the corresponding table. If a table name from inputTableNames is not included, all columns from that table will be passed to the proc. This parameter is ignored if the proc has a non-distributed execution mode. The default value is an empty map.
[in]outputTableNamesNames of the tables to which output data from the proc will be written, each in [schema_name.]table_name format, using standard name resolution rules and meeting table naming criteria. If a specified table does not exist, it will automatically be created with the same schema as the corresponding table (by order) from inputTableNames, excluding any primary and shard keys. If a specified table is a non-persistent result table, it must not have primary or shard keys. If no table names are specified, no output data can be returned from the proc. This parameter is ignored if the proc has a non-distributed execution mode. The default value is an empty vector.
[in]optionsOptional parameters. The default value is an empty map.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ executeSql() [1/4]

ExecuteSqlResponse gpudb::GPUdb::executeSql ( const ExecuteSqlRequest request_) const

Execute a SQL statement (query, DML, or DDL).

See SQL Support for the complete set of supported SQL commands.

Parameters
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

◆ executeSql() [2/4]

ExecuteSqlResponse& gpudb::GPUdb::executeSql ( const ExecuteSqlRequest request_,
ExecuteSqlResponse response_ 
) const

Execute a SQL statement (query, DML, or DDL).

See SQL Support for the complete set of supported SQL commands.

Parameters
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ executeSql() [3/4]

ExecuteSqlResponse gpudb::GPUdb::executeSql ( const std::string &  statement,
const int64_t  offset,
const int64_t  limit,
const std::string &  requestSchemaStr,
const std::vector< std::vector< uint8_t > > &  data,
const std::map< std::string, std::string > &  options 
) const

Execute a SQL statement (query, DML, or DDL).

See SQL Support for the complete set of supported SQL commands.

Parameters
[in]statementSQL statement (query, DML, or DDL) to be executed
[in]offsetA positive integer indicating the number of initial results to skip (this can be useful for paging through the results). The 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 maximum number of results allowed by the server should be returned. The number of records returned will never exceed the server's own limit, defined by the max_get_records_size parameter in the server configuration. Use hasMoreRecords to see if more records exist in the result to be fetched, and offset & limit to request subsequent pages of results. The default value is -9999.
[in]requestSchemaStrAvro schema of data. The default value is ''.
[in]dataAn array of binary-encoded data for the records to be binded to the SQL query. Or use query_parameters to pass the data in JSON format. The default value is an empty vector.
[in]optionsOptional parameters. The default value is an empty map.
Returns
Response object containing the result of the operation.

◆ executeSql() [4/4]

ExecuteSqlResponse& gpudb::GPUdb::executeSql ( const std::string &  statement,
const int64_t  offset,
const int64_t  limit,
const std::string &  requestSchemaStr,
const std::vector< std::vector< uint8_t > > &  data,
const std::map< std::string, std::string > &  options,
ExecuteSqlResponse response_ 
) const

Execute a SQL statement (query, DML, or DDL).

See SQL Support for the complete set of supported SQL commands.

Parameters
[in]statementSQL statement (query, DML, or DDL) to be executed
[in]offsetA positive integer indicating the number of initial results to skip (this can be useful for paging through the results). The 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 maximum number of results allowed by the server should be returned. The number of records returned will never exceed the server's own limit, defined by the max_get_records_size parameter in the server configuration. Use hasMoreRecords to see if more records exist in the result to be fetched, and offset & limit to request subsequent pages of results. The default value is -9999.
[in]requestSchemaStrAvro schema of data. The default value is ''.
[in]dataAn array of binary-encoded data for the records to be binded to the SQL query. Or use query_parameters to pass the data in JSON format. The default value is an empty vector.
[in]optionsOptional parameters. The default value is an empty map.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ executeSqlRaw() [1/2]

RawExecuteSqlResponse gpudb::GPUdb::executeSqlRaw ( const ExecuteSqlRequest request_) const

Execute a SQL statement (query, DML, or DDL).

See SQL Support for the complete set of supported SQL commands.

Parameters
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

◆ executeSqlRaw() [2/2]

RawExecuteSqlResponse& gpudb::GPUdb::executeSqlRaw ( const ExecuteSqlRequest request_,
RawExecuteSqlResponse response_ 
) const

Execute a SQL statement (query, DML, or DDL).

See SQL Support for the complete set of supported SQL commands.

Parameters
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ exportQueryMetrics() [1/4]

ExportQueryMetricsResponse gpudb::GPUdb::exportQueryMetrics ( const ExportQueryMetricsRequest request_) const

Export query metrics to a given destination.

Returns query metrics.

Parameters
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

◆ exportQueryMetrics() [2/4]

ExportQueryMetricsResponse& gpudb::GPUdb::exportQueryMetrics ( const ExportQueryMetricsRequest request_,
ExportQueryMetricsResponse response_ 
) const

Export query metrics to a given destination.

Returns query metrics.

Parameters
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ exportQueryMetrics() [3/4]

ExportQueryMetricsResponse gpudb::GPUdb::exportQueryMetrics ( const std::map< std::string, std::string > &  options) const

Export query metrics to a given destination.

Returns query metrics.

Parameters
[in]optionsOptional parameters. The default value is an empty map.
Returns
Response object containing the result of the operation.

◆ exportQueryMetrics() [4/4]

ExportQueryMetricsResponse& gpudb::GPUdb::exportQueryMetrics ( const std::map< std::string, std::string > &  options,
ExportQueryMetricsResponse response_ 
) const

Export query metrics to a given destination.

Returns query metrics.

Parameters
[in]optionsOptional parameters. The default value is an empty map.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ exportRecordsToFiles() [1/4]

ExportRecordsToFilesResponse gpudb::GPUdb::exportRecordsToFiles ( const ExportRecordsToFilesRequest request_) const

Export records from a table to files.

All tables can be exported, in full or partial (see columns_to_export and columns_to_skip). Additional filtering can be applied when using export table with expression through SQL. Default destination is KIFS, though other storage types (Azure, S3, GCS, and HDFS) are supported through datasink_name; see createDatasink.

Server's local file system is not supported. Default file format is delimited text. See options for different file types and different options for each file type. Table is saved to a single file if within max file size limits (may vary depending on datasink type). If not, then table is split into multiple files; these may be smaller than the max size limit.

All filenames created are returned in the response.

Parameters
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

◆ exportRecordsToFiles() [2/4]

ExportRecordsToFilesResponse& gpudb::GPUdb::exportRecordsToFiles ( const ExportRecordsToFilesRequest request_,
ExportRecordsToFilesResponse response_ 
) const

Export records from a table to files.

All tables can be exported, in full or partial (see columns_to_export and columns_to_skip). Additional filtering can be applied when using export table with expression through SQL. Default destination is KIFS, though other storage types (Azure, S3, GCS, and HDFS) are supported through datasink_name; see createDatasink.

Server's local file system is not supported. Default file format is delimited text. See options for different file types and different options for each file type. Table is saved to a single file if within max file size limits (may vary depending on datasink type). If not, then table is split into multiple files; these may be smaller than the max size limit.

All filenames created are returned in the response.

Parameters
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ exportRecordsToFiles() [3/4]

ExportRecordsToFilesResponse gpudb::GPUdb::exportRecordsToFiles ( const std::string &  tableName,
const std::string &  filepath,
const std::map< std::string, std::string > &  options 
) const

Export records from a table to files.

All tables can be exported, in full or partial (see columns_to_export and columns_to_skip). Additional filtering can be applied when using export table with expression through SQL. Default destination is KIFS, though other storage types (Azure, S3, GCS, and HDFS) are supported through datasink_name; see createDatasink.

Server's local file system is not supported. Default file format is delimited text. See options for different file types and different options for each file type. Table is saved to a single file if within max file size limits (may vary depending on datasink type). If not, then table is split into multiple files; these may be smaller than the max size limit.

All filenames created are returned in the response.

Parameters
[in]tableName
[in]filepathPath to data export target. If filepath has a file extension, it is read as the name of a file. If filepath is a directory, then the source table name with a random UUID appended will be used as the name of each exported file, all written to that directory. If filepath is a filename, then all exported files will have a random UUID appended to the given name. In either case, the target directory specified or implied must exist. The names of all exported files are returned in the response.
[in]optionsOptional parameters. The default value is an empty map.
Returns
Response object containing the result of the operation.

◆ exportRecordsToFiles() [4/4]

ExportRecordsToFilesResponse& gpudb::GPUdb::exportRecordsToFiles ( const std::string &  tableName,
const std::string &  filepath,
const std::map< std::string, std::string > &  options,
ExportRecordsToFilesResponse response_ 
) const

Export records from a table to files.

All tables can be exported, in full or partial (see columns_to_export and columns_to_skip). Additional filtering can be applied when using export table with expression through SQL. Default destination is KIFS, though other storage types (Azure, S3, GCS, and HDFS) are supported through datasink_name; see createDatasink.

Server's local file system is not supported. Default file format is delimited text. See options for different file types and different options for each file type. Table is saved to a single file if within max file size limits (may vary depending on datasink type). If not, then table is split into multiple files; these may be smaller than the max size limit.

All filenames created are returned in the response.

Parameters
[in]tableName
[in]filepathPath to data export target. If filepath has a file extension, it is read as the name of a file. If filepath is a directory, then the source table name with a random UUID appended will be used as the name of each exported file, all written to that directory. If filepath is a filename, then all exported files will have a random UUID appended to the given name. In either case, the target directory specified or implied must exist. The names of all exported files are returned in the response.
[in]optionsOptional parameters. The default value is an empty map.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ exportRecordsToTable() [1/4]

ExportRecordsToTableResponse gpudb::GPUdb::exportRecordsToTable ( const ExportRecordsToTableRequest request_) const

Exports records from source table to the specified target table in an external database.

Parameters
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

◆ exportRecordsToTable() [2/4]

ExportRecordsToTableResponse& gpudb::GPUdb::exportRecordsToTable ( const ExportRecordsToTableRequest request_,
ExportRecordsToTableResponse response_ 
) const

Exports records from source table to the specified target table in an external database.

Parameters
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ exportRecordsToTable() [3/4]

ExportRecordsToTableResponse gpudb::GPUdb::exportRecordsToTable ( const std::string &  tableName,
const std::string &  remoteQuery,
const std::map< std::string, std::string > &  options 
) const

Exports records from source table to the specified target table in an external database.

Parameters
[in]tableNameName of the table from which the data will be exported to remote database, in [schema_name.]table_name format, using standard name resolution rules.
[in]remoteQueryParameterized insert query to export gpudb table data into remote database. The default value is ''.
[in]optionsOptional parameters. The default value is an empty map.
Returns
Response object containing the result of the operation.

◆ exportRecordsToTable() [4/4]

ExportRecordsToTableResponse& gpudb::GPUdb::exportRecordsToTable ( const std::string &  tableName,
const std::string &  remoteQuery,
const std::map< std::string, std::string > &  options,
ExportRecordsToTableResponse response_ 
) const

Exports records from source table to the specified target table in an external database.

Parameters
[in]tableNameName of the table from which the data will be exported to remote database, in [schema_name.]table_name format, using standard name resolution rules.
[in]remoteQueryParameterized insert query to export gpudb table data into remote database. The default value is ''.
[in]optionsOptional parameters. The default value is an empty map.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ filter() [1/4]

FilterResponse gpudb::GPUdb::filter ( const FilterRequest request_) const

Filters data based on the specified expression.

The results are stored in a result set with the given viewName.

For details see Expressions.

The response message contains the number of points for which the expression evaluated to be true, which is equivalent to the size of the result view.

Parameters
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

◆ filter() [2/4]

FilterResponse& gpudb::GPUdb::filter ( const FilterRequest request_,
FilterResponse response_ 
) const

Filters data based on the specified expression.

The results are stored in a result set with the given viewName.

For details see Expressions.

The response message contains the number of points for which the expression evaluated to be true, which is equivalent to the size of the result view.

Parameters
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ filter() [3/4]

FilterResponse gpudb::GPUdb::filter ( const std::string &  tableName,
const std::string &  viewName,
const std::string &  expression,
const std::map< std::string, std::string > &  options 
) const

Filters data based on the specified expression.

The results are stored in a result set with the given viewName.

For details see Expressions.

The response message contains the number of points for which the expression evaluated to be true, which is equivalent to the size of the result view.

Parameters
[in]tableNameName of the table to filter, in [schema_name.]table_name format, using standard name resolution rules. This may be the name of a table or a view (when chaining queries).
[in]viewNameIf provided, then this will be the name of the view containing the results, in [schema_name.]view_name format, using standard name resolution rules and meeting table naming criteria. Must not be an already existing table or view. The default value is ''.
[in]expressionThe select expression to filter the specified table. For details see Expressions.
[in]optionsOptional parameters.
  • filter_create_temp_table: If true, a unique temporary table name will be generated in the sys_temp schema and used in place of viewName. This is always allowed even if the caller does not have permission to create tables. The generated name is returned in qualified_view_name. Supported values: The default value is filter_false.
  • filter_collection_name: [DEPRECATED–please specify the containing schema for the view as part of viewName and use createSchema to create the schema if non-existent] Name of a schema for the newly created view. If the schema is non-existent, it will be automatically created.
  • filter_view_id: view this filtered-view is part of. The default value is ''.
  • filter_ttl: Sets the TTL of the view specified in viewName.
The default value is an empty map.
Returns
Response object containing the result of the operation.

◆ filter() [4/4]

FilterResponse& gpudb::GPUdb::filter ( const std::string &  tableName,
const std::string &  viewName,
const std::string &  expression,
const std::map< std::string, std::string > &  options,
FilterResponse response_ 
) const

Filters data based on the specified expression.

The results are stored in a result set with the given viewName.

For details see Expressions.

The response message contains the number of points for which the expression evaluated to be true, which is equivalent to the size of the result view.

Parameters
[in]tableNameName of the table to filter, in [schema_name.]table_name format, using standard name resolution rules. This may be the name of a table or a view (when chaining queries).
[in]viewNameIf provided, then this will be the name of the view containing the results, in [schema_name.]view_name format, using standard name resolution rules and meeting table naming criteria. Must not be an already existing table or view. The default value is ''.
[in]expressionThe select expression to filter the specified table. For details see Expressions.
[in]optionsOptional parameters.
  • filter_create_temp_table: If true, a unique temporary table name will be generated in the sys_temp schema and used in place of viewName. This is always allowed even if the caller does not have permission to create tables. The generated name is returned in qualified_view_name. Supported values: The default value is filter_false.
  • filter_collection_name: [DEPRECATED–please specify the containing schema for the view as part of viewName and use createSchema to create the schema if non-existent] Name of a schema for the newly created view. If the schema is non-existent, it will be automatically created.
  • filter_view_id: view this filtered-view is part of. The default value is ''.
  • filter_ttl: Sets the TTL of the view specified in viewName.
The default value is an empty map.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ filterByArea() [1/4]

FilterByAreaResponse gpudb::GPUdb::filterByArea ( const FilterByAreaRequest request_) const

Calculates which objects from a table are within a named area of interest (NAI/polygon).

The operation is synchronous, meaning that a response will not be returned until all the matching objects are fully available. The response payload provides the count of the resulting set. A new resultant set (view) which satisfies the input NAI restriction specification is created with the name viewName passed in as part of the input.

Parameters
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

◆ filterByArea() [2/4]

FilterByAreaResponse& gpudb::GPUdb::filterByArea ( const FilterByAreaRequest request_,
FilterByAreaResponse response_ 
) const

Calculates which objects from a table are within a named area of interest (NAI/polygon).

The operation is synchronous, meaning that a response will not be returned until all the matching objects are fully available. The response payload provides the count of the resulting set. A new resultant set (view) which satisfies the input NAI restriction specification is created with the name viewName passed in as part of the input.

Parameters
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ filterByArea() [3/4]

FilterByAreaResponse gpudb::GPUdb::filterByArea ( const std::string &  tableName,
const std::string &  viewName,
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 
) const

Calculates which objects from a table are within a named area of interest (NAI/polygon).

The operation is synchronous, meaning that a response will not be returned until all the matching objects are fully available. The response payload provides the count of the resulting set. A new resultant set (view) which satisfies the input NAI restriction specification is created with the name viewName passed in as part of the input.

Parameters
[in]tableNameName of the table to filter, in [schema_name.]table_name format, using standard name resolution rules. This may be the name of a table or a view (when chaining queries).
[in]viewNameIf provided, then this will be the name of the view containing the results, in [schema_name.]view_name format, using standard name resolution rules and meeting table naming criteria. Must not be an already existing table or view. The default value is ''.
[in]xColumnNameName of the column containing the x values to be filtered.
[in]xVectorList of x coordinates of the vertices of the polygon representing the area to be filtered.
[in]yColumnNameName of the column containing the y values to be filtered.
[in]yVectorList of y coordinates of the vertices of the polygon representing the area to be filtered.
[in]optionsOptional parameters. The default value is an empty map.
Returns
Response object containing the result of the operation.

◆ filterByArea() [4/4]

FilterByAreaResponse& gpudb::GPUdb::filterByArea ( const std::string &  tableName,
const std::string &  viewName,
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,
FilterByAreaResponse response_ 
) const

Calculates which objects from a table are within a named area of interest (NAI/polygon).

The operation is synchronous, meaning that a response will not be returned until all the matching objects are fully available. The response payload provides the count of the resulting set. A new resultant set (view) which satisfies the input NAI restriction specification is created with the name viewName passed in as part of the input.

Parameters
[in]tableNameName of the table to filter, in [schema_name.]table_name format, using standard name resolution rules. This may be the name of a table or a view (when chaining queries).
[in]viewNameIf provided, then this will be the name of the view containing the results, in [schema_name.]view_name format, using standard name resolution rules and meeting table naming criteria. Must not be an already existing table or view. The default value is ''.
[in]xColumnNameName of the column containing the x values to be filtered.
[in]xVectorList of x coordinates of the vertices of the polygon representing the area to be filtered.
[in]yColumnNameName of the column containing the y values to be filtered.
[in]yVectorList of y coordinates of the vertices of the polygon representing the area to be filtered.
[in]optionsOptional parameters. The default value is an empty map.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ filterByAreaGeometry() [1/4]

FilterByAreaGeometryResponse gpudb::GPUdb::filterByAreaGeometry ( const FilterByAreaGeometryRequest request_) const

Calculates which geospatial geometry objects from a table intersect a named area of interest (NAI/polygon).

The operation is synchronous, meaning that a response will not be returned until all the matching objects are fully available. The response payload provides the count of the resulting set. A new resultant set (view) which satisfies the input NAI restriction specification is created with the name viewName passed in as part of the input.

Parameters
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

◆ filterByAreaGeometry() [2/4]

FilterByAreaGeometryResponse& gpudb::GPUdb::filterByAreaGeometry ( const FilterByAreaGeometryRequest request_,
FilterByAreaGeometryResponse response_ 
) const

Calculates which geospatial geometry objects from a table intersect a named area of interest (NAI/polygon).

The operation is synchronous, meaning that a response will not be returned until all the matching objects are fully available. The response payload provides the count of the resulting set. A new resultant set (view) which satisfies the input NAI restriction specification is created with the name viewName passed in as part of the input.

Parameters
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ filterByAreaGeometry() [3/4]

FilterByAreaGeometryResponse gpudb::GPUdb::filterByAreaGeometry ( const std::string &  tableName,
const std::string &  viewName,
const std::string &  columnName,
const std::vector< double > &  xVector,
const std::vector< double > &  yVector,
const std::map< std::string, std::string > &  options 
) const

Calculates which geospatial geometry objects from a table intersect a named area of interest (NAI/polygon).

The operation is synchronous, meaning that a response will not be returned until all the matching objects are fully available. The response payload provides the count of the resulting set. A new resultant set (view) which satisfies the input NAI restriction specification is created with the name viewName passed in as part of the input.

Parameters
[in]tableNameName of the table to filter, in [schema_name.]table_name format, using standard name resolution rules. This may be the name of a table or a view (when chaining queries).
[in]viewNameIf provided, then this will be the name of the view containing the results, in [schema_name.]view_name format, using standard name resolution rules and meeting table naming criteria. Must not be an already existing table or view. The default value is ''.
[in]columnNameName of the geospatial geometry column to be filtered.
[in]xVectorList of x coordinates of the vertices of the polygon representing the area to be filtered.
[in]yVectorList of y coordinates of the vertices of the polygon representing the area to be filtered.
[in]optionsOptional parameters. The default value is an empty map.
Returns
Response object containing the result of the operation.

◆ filterByAreaGeometry() [4/4]

FilterByAreaGeometryResponse& gpudb::GPUdb::filterByAreaGeometry ( const std::string &  tableName,
const std::string &  viewName,
const std::string &  columnName,
const std::vector< double > &  xVector,
const std::vector< double > &  yVector,
const std::map< std::string, std::string > &  options,
FilterByAreaGeometryResponse response_ 
) const

Calculates which geospatial geometry objects from a table intersect a named area of interest (NAI/polygon).

The operation is synchronous, meaning that a response will not be returned until all the matching objects are fully available. The response payload provides the count of the resulting set. A new resultant set (view) which satisfies the input NAI restriction specification is created with the name viewName passed in as part of the input.

Parameters
[in]tableNameName of the table to filter, in [schema_name.]table_name format, using standard name resolution rules. This may be the name of a table or a view (when chaining queries).
[in]viewNameIf provided, then this will be the name of the view containing the results, in [schema_name.]view_name format, using standard name resolution rules and meeting table naming criteria. Must not be an already existing table or view. The default value is ''.
[in]columnNameName of the geospatial geometry column to be filtered.
[in]xVectorList of x coordinates of the vertices of the polygon representing the area to be filtered.
[in]yVectorList of y coordinates of the vertices of the polygon representing the area to be filtered.
[in]optionsOptional parameters. The default value is an empty map.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ filterByBox() [1/4]

FilterByBoxResponse gpudb::GPUdb::filterByBox ( const FilterByBoxRequest request_) const

Calculates how many objects within the given table lie in a rectangular box.

The operation is synchronous, meaning that a response will not be returned until all the objects are fully available. The response payload provides the count of the resulting set. A new resultant set which satisfies the input NAI restriction specification is also created when a viewName is passed in as part of the input payload.

Parameters
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

◆ filterByBox() [2/4]

FilterByBoxResponse& gpudb::GPUdb::filterByBox ( const FilterByBoxRequest request_,
FilterByBoxResponse response_ 
) const

Calculates how many objects within the given table lie in a rectangular box.

The operation is synchronous, meaning that a response will not be returned until all the objects are fully available. The response payload provides the count of the resulting set. A new resultant set which satisfies the input NAI restriction specification is also created when a viewName is passed in as part of the input payload.

Parameters
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ filterByBox() [3/4]

FilterByBoxResponse gpudb::GPUdb::filterByBox ( const std::string &  tableName,
const std::string &  viewName,
const std::string &  xColumnName,
const double  minX,
const double  maxX,
const std::string &  yColumnName,
const double  minY,
const double  maxY,
const std::map< std::string, std::string > &  options 
) const

Calculates how many objects within the given table lie in a rectangular box.

The operation is synchronous, meaning that a response will not be returned until all the objects are fully available. The response payload provides the count of the resulting set. A new resultant set which satisfies the input NAI restriction specification is also created when a viewName is passed in as part of the input payload.

Parameters
[in]tableNameName of the table on which the bounding box operation will be performed, in [schema_name.]table_name format, using standard name resolution rules. Must be an existing table.
[in]viewNameIf provided, then this will be the name of the view containing the results, in [schema_name.]view_name format, using standard name resolution rules and meeting table naming criteria. Must not be an already existing table or view. The default value is ''.
[in]xColumnNameName of the column on which to perform the bounding box query. Must be a valid numeric column.
[in]minXLower bound for the column chosen by xColumnName. Must be less than or equal to maxX.
[in]maxXUpper bound for xColumnName. Must be greater than or equal to minX.
[in]yColumnNameName of a column on which to perform the bounding box query. Must be a valid numeric column.
[in]minYLower bound for yColumnName. Must be less than or equal to maxY.
[in]maxYUpper bound for yColumnName. Must be greater than or equal to minY.
[in]optionsOptional parameters. The default value is an empty map.
Returns
Response object containing the result of the operation.

◆ filterByBox() [4/4]

FilterByBoxResponse& gpudb::GPUdb::filterByBox ( const std::string &  tableName,
const std::string &  viewName,
const std::string &  xColumnName,
const double  minX,
const double  maxX,
const std::string &  yColumnName,
const double  minY,
const double  maxY,
const std::map< std::string, std::string > &  options,
FilterByBoxResponse response_ 
) const

Calculates how many objects within the given table lie in a rectangular box.

The operation is synchronous, meaning that a response will not be returned until all the objects are fully available. The response payload provides the count of the resulting set. A new resultant set which satisfies the input NAI restriction specification is also created when a viewName is passed in as part of the input payload.

Parameters
[in]tableNameName of the table on which the bounding box operation will be performed, in [schema_name.]table_name format, using standard name resolution rules. Must be an existing table.
[in]viewNameIf provided, then this will be the name of the view containing the results, in [schema_name.]view_name format, using standard name resolution rules and meeting table naming criteria. Must not be an already existing table or view. The default value is ''.
[in]xColumnNameName of the column on which to perform the bounding box query. Must be a valid numeric column.
[in]minXLower bound for the column chosen by xColumnName. Must be less than or equal to maxX.
[in]maxXUpper bound for xColumnName. Must be greater than or equal to minX.
[in]yColumnNameName of a column on which to perform the bounding box query. Must be a valid numeric column.
[in]minYLower bound for yColumnName. Must be less than or equal to maxY.
[in]maxYUpper bound for yColumnName. Must be greater than or equal to minY.
[in]optionsOptional parameters. The default value is an empty map.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ filterByBoxGeometry() [1/4]

FilterByBoxGeometryResponse gpudb::GPUdb::filterByBoxGeometry ( const FilterByBoxGeometryRequest request_) const

Calculates which geospatial geometry objects from a table intersect a rectangular box.

The operation is synchronous, meaning that a response will not be returned until all the objects are fully available. The response payload provides the count of the resulting set. A new resultant set which satisfies the input NAI restriction specification is also created when a viewName is passed in as part of the input payload.

Parameters
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

◆ filterByBoxGeometry() [2/4]

FilterByBoxGeometryResponse& gpudb::GPUdb::filterByBoxGeometry ( const FilterByBoxGeometryRequest request_,
FilterByBoxGeometryResponse response_ 
) const

Calculates which geospatial geometry objects from a table intersect a rectangular box.

The operation is synchronous, meaning that a response will not be returned until all the objects are fully available. The response payload provides the count of the resulting set. A new resultant set which satisfies the input NAI restriction specification is also created when a viewName is passed in as part of the input payload.

Parameters
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ filterByBoxGeometry() [3/4]

FilterByBoxGeometryResponse gpudb::GPUdb::filterByBoxGeometry ( const std::string &  tableName,
const std::string &  viewName,
const std::string &  columnName,
const double  minX,
const double  maxX,
const double  minY,
const double  maxY,
const std::map< std::string, std::string > &  options 
) const

Calculates which geospatial geometry objects from a table intersect a rectangular box.

The operation is synchronous, meaning that a response will not be returned until all the objects are fully available. The response payload provides the count of the resulting set. A new resultant set which satisfies the input NAI restriction specification is also created when a viewName is passed in as part of the input payload.

Parameters
[in]tableNameName of the table on which the bounding box operation will be performed, in [schema_name.]table_name format, using standard name resolution rules. Must be an existing table.
[in]viewNameIf provided, then this will be the name of the view containing the results, in [schema_name.]view_name format, using standard name resolution rules and meeting table naming criteria. Must not be an already existing table or view. The default value is ''.
[in]columnNameName of the geospatial geometry column to be filtered.
[in]minXLower bound for the x-coordinate of the rectangular box. Must be less than or equal to maxX.
[in]maxXUpper bound for the x-coordinate of the rectangular box. Must be greater than or equal to minX.
[in]minYLower bound for the y-coordinate of the rectangular box. Must be less than or equal to maxY.
[in]maxYUpper bound for the y-coordinate of the rectangular box. Must be greater than or equal to minY.
[in]optionsOptional parameters. The default value is an empty map.
Returns
Response object containing the result of the operation.

◆ filterByBoxGeometry() [4/4]

FilterByBoxGeometryResponse& gpudb::GPUdb::filterByBoxGeometry ( const std::string &  tableName,
const std::string &  viewName,
const std::string &  columnName,
const double  minX,
const double  maxX,
const double  minY,
const double  maxY,
const std::map< std::string, std::string > &  options,
FilterByBoxGeometryResponse response_ 
) const

Calculates which geospatial geometry objects from a table intersect a rectangular box.

The operation is synchronous, meaning that a response will not be returned until all the objects are fully available. The response payload provides the count of the resulting set. A new resultant set which satisfies the input NAI restriction specification is also created when a viewName is passed in as part of the input payload.

Parameters
[in]tableNameName of the table on which the bounding box operation will be performed, in [schema_name.]table_name format, using standard name resolution rules. Must be an existing table.
[in]viewNameIf provided, then this will be the name of the view containing the results, in [schema_name.]view_name format, using standard name resolution rules and meeting table naming criteria. Must not be an already existing table or view. The default value is ''.
[in]columnNameName of the geospatial geometry column to be filtered.
[in]minXLower bound for the x-coordinate of the rectangular box. Must be less than or equal to maxX.
[in]maxXUpper bound for the x-coordinate of the rectangular box. Must be greater than or equal to minX.
[in]minYLower bound for the y-coordinate of the rectangular box. Must be less than or equal to maxY.
[in]maxYUpper bound for the y-coordinate of the rectangular box. Must be greater than or equal to minY.
[in]optionsOptional parameters. The default value is an empty map.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ filterByGeometry() [1/4]

FilterByGeometryResponse gpudb::GPUdb::filterByGeometry ( const FilterByGeometryRequest request_) const

Applies a geometry filter against a geospatial geometry column in a given table or view.

The filtering geometry is provided by inputWkt.

Parameters
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

◆ filterByGeometry() [2/4]

FilterByGeometryResponse& gpudb::GPUdb::filterByGeometry ( const FilterByGeometryRequest request_,
FilterByGeometryResponse response_ 
) const

Applies a geometry filter against a geospatial geometry column in a given table or view.

The filtering geometry is provided by inputWkt.

Parameters
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ filterByGeometry() [3/4]

FilterByGeometryResponse gpudb::GPUdb::filterByGeometry ( const std::string &  tableName,
const std::string &  viewName,
const std::string &  columnName,
const std::string &  inputWkt,
const std::string &  operation,
const std::map< std::string, std::string > &  options 
) const

Applies a geometry filter against a geospatial geometry column in a given table or view.

The filtering geometry is provided by inputWkt.

Parameters
[in]tableNameName of the table on which the filter by geometry will be performed, in [schema_name.]table_name format, using standard name resolution rules. Must be an existing table or view containing a geospatial geometry column.
[in]viewNameIf provided, then this will be the name of the view containing the results, in [schema_name.]view_name format, using standard name resolution rules and meeting table naming criteria. Must not be an already existing table or view. The default value is ''.
[in]columnNameName of the column to be used in the filter. Must be a geospatial geometry column.
[in]inputWktA geometry in WKT format that will be used to filter the objects in tableName. The default value is ''.
[in]operationThe geometric filtering operation to perform. Supported values:
[in]optionsOptional parameters. The default value is an empty map.
Returns
Response object containing the result of the operation.

◆ filterByGeometry() [4/4]

FilterByGeometryResponse& gpudb::GPUdb::filterByGeometry ( const std::string &  tableName,
const std::string &  viewName,
const std::string &  columnName,
const std::string &  inputWkt,
const std::string &  operation,
const std::map< std::string, std::string > &  options,
FilterByGeometryResponse response_ 
) const

Applies a geometry filter against a geospatial geometry column in a given table or view.

The filtering geometry is provided by inputWkt.

Parameters
[in]tableNameName of the table on which the filter by geometry will be performed, in [schema_name.]table_name format, using standard name resolution rules. Must be an existing table or view containing a geospatial geometry column.
[in]viewNameIf provided, then this will be the name of the view containing the results, in [schema_name.]view_name format, using standard name resolution rules and meeting table naming criteria. Must not be an already existing table or view. The default value is ''.
[in]columnNameName of the column to be used in the filter. Must be a geospatial geometry column.
[in]inputWktA geometry in WKT format that will be used to filter the objects in tableName. The default value is ''.
[in]operationThe geometric filtering operation to perform. Supported values:
[in]optionsOptional parameters. The default value is an empty map.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ filterByList() [1/4]

FilterByListResponse gpudb::GPUdb::filterByList ( const FilterByListRequest request_) const

Calculates which records from a table have values in the given list for the corresponding column.

The operation is synchronous, meaning that a response will not be returned until all the objects are fully available. The response payload provides the count of the resulting set. A new resultant set (view) which satisfies the input filter specification is also created if a viewName is passed in as part of the request.

For example, if a type definition has the columns 'x' and 'y', then a filter by list query with the column map {"x":["10.1", "2.3"], "y":["0.0", "-31.5", "42.0"]} will return the count of all data points whose x and y values match both in the respective x- and y-lists, e.g., "x = 10.1 and y = 0.0", "x = 2.3 and y = -31.5", etc. However, a record with "x = 10.1 and y = -31.5" or "x = 2.3 and y = 0.0" would not be returned because the values in the given lists do not correspond.

Parameters
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

◆ filterByList() [2/4]

FilterByListResponse& gpudb::GPUdb::filterByList ( const FilterByListRequest request_,
FilterByListResponse response_ 
) const

Calculates which records from a table have values in the given list for the corresponding column.

The operation is synchronous, meaning that a response will not be returned until all the objects are fully available. The response payload provides the count of the resulting set. A new resultant set (view) which satisfies the input filter specification is also created if a viewName is passed in as part of the request.

For example, if a type definition has the columns 'x' and 'y', then a filter by list query with the column map {"x":["10.1", "2.3"], "y":["0.0", "-31.5", "42.0"]} will return the count of all data points whose x and y values match both in the respective x- and y-lists, e.g., "x = 10.1 and y = 0.0", "x = 2.3 and y = -31.5", etc. However, a record with "x = 10.1 and y = -31.5" or "x = 2.3 and y = 0.0" would not be returned because the values in the given lists do not correspond.

Parameters
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ filterByList() [3/4]

FilterByListResponse gpudb::GPUdb::filterByList ( const std::string &  tableName,
const std::string &  viewName,
const std::map< std::string, std::vector< std::string > > &  columnValuesMap,
const std::map< std::string, std::string > &  options 
) const

Calculates which records from a table have values in the given list for the corresponding column.

The operation is synchronous, meaning that a response will not be returned until all the objects are fully available. The response payload provides the count of the resulting set. A new resultant set (view) which satisfies the input filter specification is also created if a viewName is passed in as part of the request.

For example, if a type definition has the columns 'x' and 'y', then a filter by list query with the column map {"x":["10.1", "2.3"], "y":["0.0", "-31.5", "42.0"]} will return the count of all data points whose x and y values match both in the respective x- and y-lists, e.g., "x = 10.1 and y = 0.0", "x = 2.3 and y = -31.5", etc. However, a record with "x = 10.1 and y = -31.5" or "x = 2.3 and y = 0.0" would not be returned because the values in the given lists do not correspond.

Parameters
[in]tableNameName of the table to filter, in [schema_name.]table_name format, using standard name resolution rules. This may be the name of a table or a view (when chaining queries).
[in]viewNameIf provided, then this will be the name of the view containing the results, in [schema_name.]view_name format, using standard name resolution rules and meeting table naming criteria. Must not be an already existing table or view. The default value is ''.
[in]columnValuesMapList of values for the corresponding column in the table
[in]optionsOptional parameters. The default value is an empty map.
Returns
Response object containing the result of the operation.

◆ filterByList() [4/4]

FilterByListResponse& gpudb::GPUdb::filterByList ( const std::string &  tableName,
const std::string &  viewName,
const std::map< std::string, std::vector< std::string > > &  columnValuesMap,
const std::map< std::string, std::string > &  options,
FilterByListResponse response_ 
) const

Calculates which records from a table have values in the given list for the corresponding column.

The operation is synchronous, meaning that a response will not be returned until all the objects are fully available. The response payload provides the count of the resulting set. A new resultant set (view) which satisfies the input filter specification is also created if a viewName is passed in as part of the request.

For example, if a type definition has the columns 'x' and 'y', then a filter by list query with the column map {"x":["10.1", "2.3"], "y":["0.0", "-31.5", "42.0"]} will return the count of all data points whose x and y values match both in the respective x- and y-lists, e.g., "x = 10.1 and y = 0.0", "x = 2.3 and y = -31.5", etc. However, a record with "x = 10.1 and y = -31.5" or "x = 2.3 and y = 0.0" would not be returned because the values in the given lists do not correspond.

Parameters
[in]tableNameName of the table to filter, in [schema_name.]table_name format, using standard name resolution rules. This may be the name of a table or a view (when chaining queries).
[in]viewNameIf provided, then this will be the name of the view containing the results, in [schema_name.]view_name format, using standard name resolution rules and meeting table naming criteria. Must not be an already existing table or view. The default value is ''.
[in]columnValuesMapList of values for the corresponding column in the table
[in]optionsOptional parameters. The default value is an empty map.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ filterByRadius() [1/4]

FilterByRadiusResponse gpudb::GPUdb::filterByRadius ( const FilterByRadiusRequest request_) const

Calculates which objects from a table lie within a circle with the given radius and center point (i.e. circular NAI).

The operation is synchronous, meaning that a response will not be returned until all the objects are fully available. The response payload provides the count of the resulting set. A new resultant set (view) which satisfies the input circular NAI restriction specification is also created if a viewName is passed in as part of the request.

For track data, all track points that lie within the circle plus one point on either side of the circle (if the track goes beyond the circle) will be included in the result.

Parameters
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

◆ filterByRadius() [2/4]

FilterByRadiusResponse& gpudb::GPUdb::filterByRadius ( const FilterByRadiusRequest request_,
FilterByRadiusResponse response_ 
) const

Calculates which objects from a table lie within a circle with the given radius and center point (i.e. circular NAI).

The operation is synchronous, meaning that a response will not be returned until all the objects are fully available. The response payload provides the count of the resulting set. A new resultant set (view) which satisfies the input circular NAI restriction specification is also created if a viewName is passed in as part of the request.

For track data, all track points that lie within the circle plus one point on either side of the circle (if the track goes beyond the circle) will be included in the result.

Parameters
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ filterByRadius() [3/4]

FilterByRadiusResponse gpudb::GPUdb::filterByRadius ( const std::string &  tableName,
const std::string &  viewName,
const std::string &  xColumnName,
const double  xCenter,
const std::string &  yColumnName,
const double  yCenter,
const double  radius,
const std::map< std::string, std::string > &  options 
) const

Calculates which objects from a table lie within a circle with the given radius and center point (i.e. circular NAI).

The operation is synchronous, meaning that a response will not be returned until all the objects are fully available. The response payload provides the count of the resulting set. A new resultant set (view) which satisfies the input circular NAI restriction specification is also created if a viewName is passed in as part of the request.

For track data, all track points that lie within the circle plus one point on either side of the circle (if the track goes beyond the circle) will be included in the result.

Parameters
[in]tableNameName of the table on which the filter by radius operation will be performed, in [schema_name.]table_name format, using standard name resolution rules. Must be an existing table.
[in]viewNameIf provided, then this will be the name of the view containing the results, in [schema_name.]view_name format, using standard name resolution rules and meeting table naming criteria. Must not be an already existing table or view. The default value is ''.
[in]xColumnNameName of the column to be used for the x-coordinate (the longitude) of the center.
[in]xCenterValue of the longitude of the center. Must be within [-180.0, 180.0]. The minimum allowed value is -180. The maximum allowed value is 180.
[in]yColumnNameName of the column to be used for the y-coordinate-the latitude-of the center.
[in]yCenterValue of the latitude of the center. Must be within [-90.0, 90.0]. The minimum allowed value is -90. The maximum allowed value is 90.
[in]radiusThe radius of the circle within which the search will be performed. Must be a non-zero positive value. It is in meters; so, for example, a value of '42000' means 42 km. The minimum allowed value is 0. The maximum allowed value is MAX_INT.
[in]optionsOptional parameters. The default value is an empty map.
Returns
Response object containing the result of the operation.

◆ filterByRadius() [4/4]

FilterByRadiusResponse& gpudb::GPUdb::filterByRadius ( const std::string &  tableName,
const std::string &  viewName,
const std::string &  xColumnName,
const double  xCenter,
const std::string &  yColumnName,
const double  yCenter,
const double  radius,
const std::map< std::string, std::string > &  options,
FilterByRadiusResponse response_ 
) const

Calculates which objects from a table lie within a circle with the given radius and center point (i.e. circular NAI).

The operation is synchronous, meaning that a response will not be returned until all the objects are fully available. The response payload provides the count of the resulting set. A new resultant set (view) which satisfies the input circular NAI restriction specification is also created if a viewName is passed in as part of the request.

For track data, all track points that lie within the circle plus one point on either side of the circle (if the track goes beyond the circle) will be included in the result.

Parameters
[in]tableNameName of the table on which the filter by radius operation will be performed, in [schema_name.]table_name format, using standard name resolution rules. Must be an existing table.
[in]viewNameIf provided, then this will be the name of the view containing the results, in [schema_name.]view_name format, using standard name resolution rules and meeting table naming criteria. Must not be an already existing table or view. The default value is ''.
[in]xColumnNameName of the column to be used for the x-coordinate (the longitude) of the center.
[in]xCenterValue of the longitude of the center. Must be within [-180.0, 180.0]. The minimum allowed value is -180. The maximum allowed value is 180.
[in]yColumnNameName of the column to be used for the y-coordinate-the latitude-of the center.
[in]yCenterValue of the latitude of the center. Must be within [-90.0, 90.0]. The minimum allowed value is -90. The maximum allowed value is 90.
[in]radiusThe radius of the circle within which the search will be performed. Must be a non-zero positive value. It is in meters; so, for example, a value of '42000' means 42 km. The minimum allowed value is 0. The maximum allowed value is MAX_INT.
[in]optionsOptional parameters. The default value is an empty map.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ filterByRadiusGeometry() [1/4]

FilterByRadiusGeometryResponse gpudb::GPUdb::filterByRadiusGeometry ( const FilterByRadiusGeometryRequest request_) const

Calculates which geospatial geometry objects from a table intersect a circle with the given radius and center point (i.e. circular NAI).

The operation is synchronous, meaning that a response will not be returned until all the objects are fully available. The response payload provides the count of the resulting set. A new resultant set (view) which satisfies the input circular NAI restriction specification is also created if a viewName is passed in as part of the request.

Parameters
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

◆ filterByRadiusGeometry() [2/4]

FilterByRadiusGeometryResponse& gpudb::GPUdb::filterByRadiusGeometry ( const FilterByRadiusGeometryRequest request_,
FilterByRadiusGeometryResponse response_ 
) const

Calculates which geospatial geometry objects from a table intersect a circle with the given radius and center point (i.e. circular NAI).

The operation is synchronous, meaning that a response will not be returned until all the objects are fully available. The response payload provides the count of the resulting set. A new resultant set (view) which satisfies the input circular NAI restriction specification is also created if a viewName is passed in as part of the request.

Parameters
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ filterByRadiusGeometry() [3/4]

FilterByRadiusGeometryResponse gpudb::GPUdb::filterByRadiusGeometry ( const std::string &  tableName,
const std::string &  viewName,
const std::string &  columnName,
const double  xCenter,
const double  yCenter,
const double  radius,
const std::map< std::string, std::string > &  options 
) const

Calculates which geospatial geometry objects from a table intersect a circle with the given radius and center point (i.e. circular NAI).

The operation is synchronous, meaning that a response will not be returned until all the objects are fully available. The response payload provides the count of the resulting set. A new resultant set (view) which satisfies the input circular NAI restriction specification is also created if a viewName is passed in as part of the request.

Parameters
[in]tableNameName of the table on which the filter by radius operation will be performed, in [schema_name.]table_name format, using standard name resolution rules. Must be an existing table.
[in]viewNameIf provided, then this will be the name of the view containing the results, in [schema_name.]view_name format, using standard name resolution rules and meeting table naming criteria. Must not be an already existing table or view. The default value is ''.
[in]columnNameName of the geospatial geometry column to be filtered.
[in]xCenterValue of the longitude of the center. Must be within [-180.0, 180.0]. The minimum allowed value is -180. The maximum allowed value is 180.
[in]yCenterValue of the latitude of the center. Must be within [-90.0, 90.0]. The minimum allowed value is -90. The maximum allowed value is 90.
[in]radiusThe radius of the circle within which the search will be performed. Must be a non-zero positive value. It is in meters; so, for example, a value of '42000' means 42 km. The minimum allowed value is 0. The maximum allowed value is MAX_INT.
[in]optionsOptional parameters. The default value is an empty map.
Returns
Response object containing the result of the operation.

◆ filterByRadiusGeometry() [4/4]

FilterByRadiusGeometryResponse& gpudb::GPUdb::filterByRadiusGeometry ( const std::string &  tableName,
const std::string &  viewName,
const std::string &  columnName,
const double  xCenter,
const double  yCenter,
const double  radius,
const std::map< std::string, std::string > &  options,
FilterByRadiusGeometryResponse response_ 
) const

Calculates which geospatial geometry objects from a table intersect a circle with the given radius and center point (i.e. circular NAI).

The operation is synchronous, meaning that a response will not be returned until all the objects are fully available. The response payload provides the count of the resulting set. A new resultant set (view) which satisfies the input circular NAI restriction specification is also created if a viewName is passed in as part of the request.

Parameters
[in]tableNameName of the table on which the filter by radius operation will be performed, in [schema_name.]table_name format, using standard name resolution rules. Must be an existing table.
[in]viewNameIf provided, then this will be the name of the view containing the results, in [schema_name.]view_name format, using standard name resolution rules and meeting table naming criteria. Must not be an already existing table or view. The default value is ''.
[in]columnNameName of the geospatial geometry column to be filtered.
[in]xCenterValue of the longitude of the center. Must be within [-180.0, 180.0]. The minimum allowed value is -180. The maximum allowed value is 180.
[in]yCenterValue of the latitude of the center. Must be within [-90.0, 90.0]. The minimum allowed value is -90. The maximum allowed value is 90.
[in]radiusThe radius of the circle within which the search will be performed. Must be a non-zero positive value. It is in meters; so, for example, a value of '42000' means 42 km. The minimum allowed value is 0. The maximum allowed value is MAX_INT.
[in]optionsOptional parameters. The default value is an empty map.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ filterByRange() [1/4]

FilterByRangeResponse gpudb::GPUdb::filterByRange ( const FilterByRangeRequest request_) const

Calculates which objects from a table have a column that is within the given bounds.

An object from the table identified by tableName is added to the view viewName if its column is within [lowerBound, upperBound] (inclusive). The operation is synchronous. The response provides a count of the number of objects which passed the bound filter. Although this functionality can also be accomplished with the standard filter function, it is more efficient.

For track objects, the count reflects how many points fall within the given bounds (which may not include all the track points of any given track).

Parameters
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

◆ filterByRange() [2/4]

FilterByRangeResponse& gpudb::GPUdb::filterByRange ( const FilterByRangeRequest request_,
FilterByRangeResponse response_ 
) const

Calculates which objects from a table have a column that is within the given bounds.

An object from the table identified by tableName is added to the view viewName if its column is within [lowerBound, upperBound] (inclusive). The operation is synchronous. The response provides a count of the number of objects which passed the bound filter. Although this functionality can also be accomplished with the standard filter function, it is more efficient.

For track objects, the count reflects how many points fall within the given bounds (which may not include all the track points of any given track).

Parameters
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ filterByRange() [3/4]

FilterByRangeResponse gpudb::GPUdb::filterByRange ( const std::string &  tableName,
const std::string &  viewName,
const std::string &  columnName,
const double  lowerBound,
const double  upperBound,
const std::map< std::string, std::string > &  options 
) const

Calculates which objects from a table have a column that is within the given bounds.

An object from the table identified by tableName is added to the view viewName if its column is within [lowerBound, upperBound] (inclusive). The operation is synchronous. The response provides a count of the number of objects which passed the bound filter. Although this functionality can also be accomplished with the standard filter function, it is more efficient.

For track objects, the count reflects how many points fall within the given bounds (which may not include all the track points of any given track).

Parameters
[in]tableNameName of the table on which the filter by range operation will be performed, in [schema_name.]table_name format, using standard name resolution rules. Must be an existing table.
[in]viewNameIf provided, then this will be the name of the view containing the results, in [schema_name.]view_name format, using standard name resolution rules and meeting table naming criteria. Must not be an already existing table or view. The default value is ''.
[in]columnNameName of a column on which the operation would be applied.
[in]lowerBoundValue of the lower bound (inclusive).
[in]upperBoundValue of the upper bound (inclusive).
[in]optionsOptional parameters. The default value is an empty map.
Returns
Response object containing the result of the operation.

◆ filterByRange() [4/4]

FilterByRangeResponse& gpudb::GPUdb::filterByRange ( const std::string &  tableName,
const std::string &  viewName,
const std::string &  columnName,
const double  lowerBound,
const double  upperBound,
const std::map< std::string, std::string > &  options,
FilterByRangeResponse response_ 
) const

Calculates which objects from a table have a column that is within the given bounds.

An object from the table identified by tableName is added to the view viewName if its column is within [lowerBound, upperBound] (inclusive). The operation is synchronous. The response provides a count of the number of objects which passed the bound filter. Although this functionality can also be accomplished with the standard filter function, it is more efficient.

For track objects, the count reflects how many points fall within the given bounds (which may not include all the track points of any given track).

Parameters
[in]tableNameName of the table on which the filter by range operation will be performed, in [schema_name.]table_name format, using standard name resolution rules. Must be an existing table.
[in]viewNameIf provided, then this will be the name of the view containing the results, in [schema_name.]view_name format, using standard name resolution rules and meeting table naming criteria. Must not be an already existing table or view. The default value is ''.
[in]columnNameName of a column on which the operation would be applied.
[in]lowerBoundValue of the lower bound (inclusive).
[in]upperBoundValue of the upper bound (inclusive).
[in]optionsOptional parameters. The default value is an empty map.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ filterBySeries() [1/4]

FilterBySeriesResponse gpudb::GPUdb::filterBySeries ( const FilterBySeriesRequest request_) const

Filters objects matching all points of the given track (works only on track type data).

It allows users to specify a particular track to find all other points in the table that fall within specified ranges (spatial and temporal) of all points of the given track. Additionally, the user can specify another track to see if the two intersect (or go close to each other within the specified ranges). The user also has the flexibility of using different metrics for the spatial distance calculation: Euclidean (flat geometry) or Great Circle (spherical geometry to approximate the Earth's surface distances). The filtered points are stored in a newly created result set. The return value of the function is the number of points in the resultant set (view).

This operation is synchronous, meaning that a response will not be returned until all the objects are fully available.

Parameters
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

◆ filterBySeries() [2/4]

FilterBySeriesResponse& gpudb::GPUdb::filterBySeries ( const FilterBySeriesRequest request_,
FilterBySeriesResponse response_ 
) const

Filters objects matching all points of the given track (works only on track type data).

It allows users to specify a particular track to find all other points in the table that fall within specified ranges (spatial and temporal) of all points of the given track. Additionally, the user can specify another track to see if the two intersect (or go close to each other within the specified ranges). The user also has the flexibility of using different metrics for the spatial distance calculation: Euclidean (flat geometry) or Great Circle (spherical geometry to approximate the Earth's surface distances). The filtered points are stored in a newly created result set. The return value of the function is the number of points in the resultant set (view).

This operation is synchronous, meaning that a response will not be returned until all the objects are fully available.

Parameters
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ filterBySeries() [3/4]

FilterBySeriesResponse gpudb::GPUdb::filterBySeries ( const std::string &  tableName,
const std::string &  viewName,
const std::string &  trackId,
const std::vector< std::string > &  targetTrackIds,
const std::map< std::string, std::string > &  options 
) const

Filters objects matching all points of the given track (works only on track type data).

It allows users to specify a particular track to find all other points in the table that fall within specified ranges (spatial and temporal) of all points of the given track. Additionally, the user can specify another track to see if the two intersect (or go close to each other within the specified ranges). The user also has the flexibility of using different metrics for the spatial distance calculation: Euclidean (flat geometry) or Great Circle (spherical geometry to approximate the Earth's surface distances). The filtered points are stored in a newly created result set. The return value of the function is the number of points in the resultant set (view).

This operation is synchronous, meaning that a response will not be returned until all the objects are fully available.

Parameters
[in]tableNameName of the table on which the filter by track operation will be performed, in [schema_name.]table_name format, using standard name resolution rules. Must be a currently existing table with a track present.
[in]viewNameIf provided, then this will be the name of the view containing the results, in [schema_name.]view_name format, using standard name resolution rules and meeting table naming criteria. Must not be an already existing table or view. The default value is ''.
[in]trackIdThe ID of the track which will act as the filtering points. Must be an existing track within the given table.
[in]targetTrackIdsUp to one track ID to intersect with the "filter" track. If any provided, it must be an valid track ID within the given set.
[in]optionsOptional parameters. The default value is an empty map.
Returns
Response object containing the result of the operation.

◆ filterBySeries() [4/4]

FilterBySeriesResponse& gpudb::GPUdb::filterBySeries ( const std::string &  tableName,
const std::string &  viewName,
const std::string &  trackId,
const std::vector< std::string > &  targetTrackIds,
const std::map< std::string, std::string > &  options,
FilterBySeriesResponse response_ 
) const

Filters objects matching all points of the given track (works only on track type data).

It allows users to specify a particular track to find all other points in the table that fall within specified ranges (spatial and temporal) of all points of the given track. Additionally, the user can specify another track to see if the two intersect (or go close to each other within the specified ranges). The user also has the flexibility of using different metrics for the spatial distance calculation: Euclidean (flat geometry) or Great Circle (spherical geometry to approximate the Earth's surface distances). The filtered points are stored in a newly created result set. The return value of the function is the number of points in the resultant set (view).

This operation is synchronous, meaning that a response will not be returned until all the objects are fully available.

Parameters
[in]tableNameName of the table on which the filter by track operation will be performed, in [schema_name.]table_name format, using standard name resolution rules. Must be a currently existing table with a track present.
[in]viewNameIf provided, then this will be the name of the view containing the results, in [schema_name.]view_name format, using standard name resolution rules and meeting table naming criteria. Must not be an already existing table or view. The default value is ''.
[in]trackIdThe ID of the track which will act as the filtering points. Must be an existing track within the given table.
[in]targetTrackIdsUp to one track ID to intersect with the "filter" track. If any provided, it must be an valid track ID within the given set.
[in]optionsOptional parameters. The default value is an empty map.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ filterByString() [1/4]

FilterByStringResponse gpudb::GPUdb::filterByString ( const FilterByStringRequest request_) const

Calculates which objects from a table or view match a string expression for the given string columns.

Setting case_sensitive can modify case sensitivity in matching for all modes except search. For search mode details and limitations, see Full Text Search.

Parameters
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

◆ filterByString() [2/4]

FilterByStringResponse& gpudb::GPUdb::filterByString ( const FilterByStringRequest request_,
FilterByStringResponse response_ 
) const

Calculates which objects from a table or view match a string expression for the given string columns.

Setting case_sensitive can modify case sensitivity in matching for all modes except search. For search mode details and limitations, see Full Text Search.

Parameters
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ filterByString() [3/4]

FilterByStringResponse gpudb::GPUdb::filterByString ( const std::string &  tableName,
const std::string &  viewName,
const std::string &  expression,
const std::string &  mode,
const std::vector< std::string > &  columnNames,
const std::map< std::string, std::string > &  options 
) const

Calculates which objects from a table or view match a string expression for the given string columns.

Setting case_sensitive can modify case sensitivity in matching for all modes except search. For search mode details and limitations, see Full Text Search.

Parameters
[in]tableNameName of the table on which the filter operation will be performed, in [schema_name.]table_name format, using standard name resolution rules. Must be an existing table or view.
[in]viewNameIf provided, then this will be the name of the view containing the results, in [schema_name.]view_name format, using standard name resolution rules and meeting table naming criteria. Must not be an already existing table or view. The default value is ''.
[in]expressionThe expression with which to filter the table.
[in]modeThe string filtering mode to apply. See below for details. Supported values:
  • filter_by_string_search: Full text search query with wildcards and boolean operators. Note that for this mode, no column can be specified in columnNames; all string columns of the table that have text search enabled will be searched.
  • filter_by_string_equals: Exact whole-string match (accelerated).
  • filter_by_string_contains: Partial substring match (not accelerated). If the column is a string type (non-charN) and the number of records is too large, it will return 0.
  • filter_by_string_starts_with: Strings that start with the given expression (not accelerated). If the column is a string type (non-charN) and the number of records is too large, it will return 0.
  • filter_by_string_regex: Full regular expression search (not accelerated). If the column is a string type (non-charN) and the number of records is too large, it will return 0.
[in]columnNamesList of columns on which to apply the filter. Ignored for search mode.
[in]optionsOptional parameters. The default value is an empty map.
Returns
Response object containing the result of the operation.

◆ filterByString() [4/4]

FilterByStringResponse& gpudb::GPUdb::filterByString ( const std::string &  tableName,
const std::string &  viewName,
const std::string &  expression,
const std::string &  mode,
const std::vector< std::string > &  columnNames,
const std::map< std::string, std::string > &  options,
FilterByStringResponse response_ 
) const

Calculates which objects from a table or view match a string expression for the given string columns.

Setting case_sensitive can modify case sensitivity in matching for all modes except search. For search mode details and limitations, see Full Text Search.

Parameters
[in]tableNameName of the table on which the filter operation will be performed, in [schema_name.]table_name format, using standard name resolution rules. Must be an existing table or view.
[in]viewNameIf provided, then this will be the name of the view containing the results, in [schema_name.]view_name format, using standard name resolution rules and meeting table naming criteria. Must not be an already existing table or view. The default value is ''.
[in]expressionThe expression with which to filter the table.
[in]modeThe string filtering mode to apply. See below for details. Supported values:
  • filter_by_string_search: Full text search query with wildcards and boolean operators. Note that for this mode, no column can be specified in columnNames; all string columns of the table that have text search enabled will be searched.
  • filter_by_string_equals: Exact whole-string match (accelerated).
  • filter_by_string_contains: Partial substring match (not accelerated). If the column is a string type (non-charN) and the number of records is too large, it will return 0.
  • filter_by_string_starts_with: Strings that start with the given expression (not accelerated). If the column is a string type (non-charN) and the number of records is too large, it will return 0.
  • filter_by_string_regex: Full regular expression search (not accelerated). If the column is a string type (non-charN) and the number of records is too large, it will return 0.
[in]columnNamesList of columns on which to apply the filter. Ignored for search mode.
[in]optionsOptional parameters. The default value is an empty map.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ filterByTable() [1/4]

FilterByTableResponse gpudb::GPUdb::filterByTable ( const FilterByTableRequest request_) const

Filters objects in one table based on objects in another table.

The user must specify matching column types from the two tables (i.e. the target table from which objects will be filtered and the source table based on which the filter will be created); the column names need not be the same. If a viewName is specified, then the filtered objects will then be put in a newly created view. The operation is synchronous, meaning that a response will not be returned until all objects are fully available in the result view. The return value contains the count (i.e. the size) of the resulting view.

Parameters
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

◆ filterByTable() [2/4]

FilterByTableResponse& gpudb::GPUdb::filterByTable ( const FilterByTableRequest request_,
FilterByTableResponse response_ 
) const

Filters objects in one table based on objects in another table.

The user must specify matching column types from the two tables (i.e. the target table from which objects will be filtered and the source table based on which the filter will be created); the column names need not be the same. If a viewName is specified, then the filtered objects will then be put in a newly created view. The operation is synchronous, meaning that a response will not be returned until all objects are fully available in the result view. The return value contains the count (i.e. the size) of the resulting view.

Parameters
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ filterByTable() [3/4]

FilterByTableResponse gpudb::GPUdb::filterByTable ( const std::string &  tableName,
const std::string &  viewName,
const std::string &  columnName,
const std::string &  sourceTableName,
const std::string &  sourceTableColumnName,
const std::map< std::string, std::string > &  options 
) const

Filters objects in one table based on objects in another table.

The user must specify matching column types from the two tables (i.e. the target table from which objects will be filtered and the source table based on which the filter will be created); the column names need not be the same. If a viewName is specified, then the filtered objects will then be put in a newly created view. The operation is synchronous, meaning that a response will not be returned until all objects are fully available in the result view. The return value contains the count (i.e. the size) of the resulting view.

Parameters
[in]tableNameName of the table whose data will be filtered, in [schema_name.]table_name format, using standard name resolution rules. Must be an existing table.
[in]viewNameIf provided, then this will be the name of the view containing the results, in [schema_name.]view_name format, using standard name resolution rules and meeting table naming criteria. Must not be an already existing table or view. The default value is ''.
[in]columnNameName of the column by whose value the data will be filtered from the table designated by tableName.
[in]sourceTableNameName of the table whose data will be compared against in the table called tableName, in [schema_name.]table_name format, using standard name resolution rules. Must be an existing table.
[in]sourceTableColumnNameName of the column in the sourceTableName whose values will be used as the filter for table tableName. Must be a geospatial geometry column if in 'spatial' mode; otherwise, Must match the type of the columnName.
[in]optionsOptional parameters. The default value is an empty map.
Returns
Response object containing the result of the operation.

◆ filterByTable() [4/4]

FilterByTableResponse& gpudb::GPUdb::filterByTable ( const std::string &  tableName,
const std::string &  viewName,
const std::string &  columnName,
const std::string &  sourceTableName,
const std::string &  sourceTableColumnName,
const std::map< std::string, std::string > &  options,
FilterByTableResponse response_ 
) const

Filters objects in one table based on objects in another table.

The user must specify matching column types from the two tables (i.e. the target table from which objects will be filtered and the source table based on which the filter will be created); the column names need not be the same. If a viewName is specified, then the filtered objects will then be put in a newly created view. The operation is synchronous, meaning that a response will not be returned until all objects are fully available in the result view. The return value contains the count (i.e. the size) of the resulting view.

Parameters
[in]tableNameName of the table whose data will be filtered, in [schema_name.]table_name format, using standard name resolution rules. Must be an existing table.
[in]viewNameIf provided, then this will be the name of the view containing the results, in [schema_name.]view_name format, using standard name resolution rules and meeting table naming criteria. Must not be an already existing table or view. The default value is ''.
[in]columnNameName of the column by whose value the data will be filtered from the table designated by tableName.
[in]sourceTableNameName of the table whose data will be compared against in the table called tableName, in [schema_name.]table_name format, using standard name resolution rules. Must be an existing table.
[in]sourceTableColumnNameName of the column in the sourceTableName whose values will be used as the filter for table tableName. Must be a geospatial geometry column if in 'spatial' mode; otherwise, Must match the type of the columnName.
[in]optionsOptional parameters. The default value is an empty map.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ filterByValue() [1/4]

FilterByValueResponse gpudb::GPUdb::filterByValue ( const FilterByValueRequest request_) const

Calculates which objects from a table has a particular value for a particular column.

The input parameters provide a way to specify either a String or a Double valued column and a desired value for the column on which the filter is performed. The operation is synchronous, meaning that a response will not be returned until all the objects are fully available. The response payload provides the count of the resulting set. A new result view which satisfies the input filter restriction specification is also created with a view name passed in as part of the input payload. Although this functionality can also be accomplished with the standard filter function, it is more efficient.

Parameters
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

◆ filterByValue() [2/4]

FilterByValueResponse& gpudb::GPUdb::filterByValue ( const FilterByValueRequest request_,
FilterByValueResponse response_ 
) const

Calculates which objects from a table has a particular value for a particular column.

The input parameters provide a way to specify either a String or a Double valued column and a desired value for the column on which the filter is performed. The operation is synchronous, meaning that a response will not be returned until all the objects are fully available. The response payload provides the count of the resulting set. A new result view which satisfies the input filter restriction specification is also created with a view name passed in as part of the input payload. Although this functionality can also be accomplished with the standard filter function, it is more efficient.

Parameters
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ filterByValue() [3/4]

FilterByValueResponse gpudb::GPUdb::filterByValue ( const std::string &  tableName,
const std::string &  viewName,
const bool  isString,
const double  value,
const std::string &  valueStr,
const std::string &  columnName,
const std::map< std::string, std::string > &  options 
) const

Calculates which objects from a table has a particular value for a particular column.

The input parameters provide a way to specify either a String or a Double valued column and a desired value for the column on which the filter is performed. The operation is synchronous, meaning that a response will not be returned until all the objects are fully available. The response payload provides the count of the resulting set. A new result view which satisfies the input filter restriction specification is also created with a view name passed in as part of the input payload. Although this functionality can also be accomplished with the standard filter function, it is more efficient.

Parameters
[in]tableNameName of an existing table on which to perform the calculation, in [schema_name.]table_name format, using standard name resolution rules.
[in]viewNameIf provided, then this will be the name of the view containing the results, in [schema_name.]view_name format, using standard name resolution rules and meeting table naming criteria. Must not be an already existing table or view. The default value is ''.
[in]isStringIndicates whether the value being searched for is string or numeric.
[in]valueThe value to search for. The default value is 0.
[in]valueStrThe string value to search for. The default value is ''.
[in]columnNameName of a column on which the filter by value would be applied.
[in]optionsOptional parameters. The default value is an empty map.
Returns
Response object containing the result of the operation.

◆ filterByValue() [4/4]

FilterByValueResponse& gpudb::GPUdb::filterByValue ( const std::string &  tableName,
const std::string &  viewName,
const bool  isString,
const double  value,
const std::string &  valueStr,
const std::string &  columnName,
const std::map< std::string, std::string > &  options,
FilterByValueResponse response_ 
) const

Calculates which objects from a table has a particular value for a particular column.

The input parameters provide a way to specify either a String or a Double valued column and a desired value for the column on which the filter is performed. The operation is synchronous, meaning that a response will not be returned until all the objects are fully available. The response payload provides the count of the resulting set. A new result view which satisfies the input filter restriction specification is also created with a view name passed in as part of the input payload. Although this functionality can also be accomplished with the standard filter function, it is more efficient.

Parameters
[in]tableNameName of an existing table on which to perform the calculation, in [schema_name.]table_name format, using standard name resolution rules.
[in]viewNameIf provided, then this will be the name of the view containing the results, in [schema_name.]view_name format, using standard name resolution rules and meeting table naming criteria. Must not be an already existing table or view. The default value is ''.
[in]isStringIndicates whether the value being searched for is string or numeric.
[in]valueThe value to search for. The default value is 0.
[in]valueStrThe string value to search for. The default value is ''.
[in]columnNameName of a column on which the filter by value would be applied.
[in]optionsOptional parameters. The default value is an empty map.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ getApiVersion()

static std::string gpudb::GPUdb::getApiVersion ( )
inlinestatic

Definition at line 177 of file GPUdb.hpp.

◆ getBypassSslCertCheck()

bool gpudb::GPUdb::getBypassSslCertCheck ( ) const

◆ getExecutor()

avro::ExecutorPtr gpudb::GPUdb::getExecutor ( ) const

◆ getHASyncMode()

HASynchronicityMode gpudb::GPUdb::getHASyncMode ( ) const

◆ getHmUrl()

const HttpUrl& gpudb::GPUdb::getHmUrl ( ) const

◆ getHmUrls()

const std::vector<HttpUrl>& gpudb::GPUdb::getHmUrls ( ) const

◆ getHttpHeaders()

const std::map<std::string, std::string>& gpudb::GPUdb::getHttpHeaders ( ) const

◆ getJob() [1/4]

GetJobResponse gpudb::GPUdb::getJob ( const GetJobRequest request_) const

Get the status and result of asynchronously running job.

See the createJob for starting an asynchronous job. Some fields of the response are filled only after the submitted job has finished execution.

Parameters
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

◆ getJob() [2/4]

GetJobResponse& gpudb::GPUdb::getJob ( const GetJobRequest request_,
GetJobResponse response_ 
) const

Get the status and result of asynchronously running job.

See the createJob for starting an asynchronous job. Some fields of the response are filled only after the submitted job has finished execution.

Parameters
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ getJob() [3/4]

GetJobResponse gpudb::GPUdb::getJob ( const int64_t  jobId,
const std::map< std::string, std::string > &  options 
) const

Get the status and result of asynchronously running job.

See the createJob for starting an asynchronous job. Some fields of the response are filled only after the submitted job has finished execution.

Parameters
[in]jobIdA unique identifier for the job whose status and result is to be fetched.
[in]optionsOptional parameters. The default value is an empty map.
Returns
Response object containing the result of the operation.

◆ getJob() [4/4]

GetJobResponse& gpudb::GPUdb::getJob ( const int64_t  jobId,
const std::map< std::string, std::string > &  options,
GetJobResponse response_ 
) const

Get the status and result of asynchronously running job.

See the createJob for starting an asynchronous job. Some fields of the response are filled only after the submitted job has finished execution.

Parameters
[in]jobIdA unique identifier for the job whose status and result is to be fetched.
[in]optionsOptional parameters. The default value is an empty map.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ getOauthToken()

const std::string& gpudb::GPUdb::getOauthToken ( ) const

◆ getPassword()

const std::string& gpudb::GPUdb::getPassword ( ) const

◆ getPrimaryURL()

const std::string& gpudb::GPUdb::getPrimaryURL ( ) const

Return a string containing the URL for the primary cluster; empty string otherwise.

◆ getRecords() [1/20]

template<>
GetRecordsResponse<boost::any> gpudb::GPUdb::getRecords ( const GetRecordsRequest request_) const

Retrieves records from a given table, optionally filtered by an expression and/or sorted by a column.

This operation can be performed on tables and views. Records can be returned encoded as binary, json, or geojson.

This operation supports paging through the data via the offset and limit parameters. Note that when paging through a table, if the table (or the underlying table in case of a view) is updated (records are inserted, deleted or modified) the records retrieved may differ between calls based on the updates applied.

Parameters
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

◆ getRecords() [2/20]

template<>
GetRecordsResponse<boost::any> gpudb::GPUdb::getRecords ( const GetRecordsRequest request_) const

Retrieves records from a given table, optionally filtered by an expression and/or sorted by a column.

This operation can be performed on tables and views. Records can be returned encoded as binary, json, or geojson.

This operation supports paging through the data via the offset and limit parameters. Note that when paging through a table, if the table (or the underlying table in case of a view) is updated (records are inserted, deleted or modified) the records retrieved may differ between calls based on the updates applied.

Parameters
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

◆ getRecords() [3/20]

template<>
GetRecordsResponse<boost::any>& gpudb::GPUdb::getRecords ( const GetRecordsRequest request_,
GetRecordsResponse< boost::any > &  response_ 
) const

Retrieves records from a given table, optionally filtered by an expression and/or sorted by a column.

This operation can be performed on tables and views. Records can be returned encoded as binary, json, or geojson.

This operation supports paging through the data via the offset and limit parameters. Note that when paging through a table, if the table (or the underlying table in case of a view) is updated (records are inserted, deleted or modified) the records retrieved may differ between calls based on the updates applied.

Parameters
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ getRecords() [4/20]

template<>
GetRecordsResponse<boost::any>& gpudb::GPUdb::getRecords ( const GetRecordsRequest request_,
GetRecordsResponse< boost::any > &  response_ 
) const

Retrieves records from a given table, optionally filtered by an expression and/or sorted by a column.

This operation can be performed on tables and views. Records can be returned encoded as binary, json, or geojson.

This operation supports paging through the data via the offset and limit parameters. Note that when paging through a table, if the table (or the underlying table in case of a view) is updated (records are inserted, deleted or modified) the records retrieved may differ between calls based on the updates applied.

Parameters
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ getRecords() [5/20]

template<>
GetRecordsResponse<boost::any> gpudb::GPUdb::getRecords ( const std::string &  tableName,
const int64_t  offset,
const int64_t  limit,
const std::map< std::string, std::string > &  options 
) const

Retrieves records from a given table, optionally filtered by an expression and/or sorted by a column.

This operation can be performed on tables and views. Records can be returned encoded as binary, json, or geojson.

This operation supports paging through the data via the offset and limit parameters. Note that when paging through a table, if the table (or the underlying table in case of a view) is updated (records are inserted, deleted or modified) the records retrieved may differ between calls based on the updates applied.

Parameters
[in]tableNameName of the table or view from which the records will be fetched, in [schema_name.]table_name format, using standard name resolution rules.
[in]offsetA positive integer indicating the number of initial results to skip (this can be useful for paging through the results). The 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 maximum number of results allowed by the server should be returned. The number of records returned will never exceed the server's own limit, defined by the max_get_records_size parameter in the server configuration. Use hasMoreRecords to see if more records exist in the result to be fetched, and offset & limit to request subsequent pages of results. The default value is -9999.
[in]options The default value is an empty map.
Returns
Response object containing the result of the operation.

◆ getRecords() [6/20]

template<>
GetRecordsResponse<boost::any> gpudb::GPUdb::getRecords ( const std::string &  tableName,
const int64_t  offset,
const int64_t  limit,
const std::map< std::string, std::string > &  options 
) const

Retrieves records from a given table, optionally filtered by an expression and/or sorted by a column.

This operation can be performed on tables and views. Records can be returned encoded as binary, json, or geojson.

This operation supports paging through the data via the offset and limit parameters. Note that when paging through a table, if the table (or the underlying table in case of a view) is updated (records are inserted, deleted or modified) the records retrieved may differ between calls based on the updates applied.

Parameters
[in]tableNameName of the table or view from which the records will be fetched, in [schema_name.]table_name format, using standard name resolution rules.
[in]offsetA positive integer indicating the number of initial results to skip (this can be useful for paging through the results). The 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 maximum number of results allowed by the server should be returned. The number of records returned will never exceed the server's own limit, defined by the max_get_records_size parameter in the server configuration. Use hasMoreRecords to see if more records exist in the result to be fetched, and offset & limit to request subsequent pages of results. The default value is -9999.
[in]options The default value is an empty map.
Returns
Response object containing the result of the operation.

◆ getRecords() [7/20]

template<>
GetRecordsResponse<boost::any>& gpudb::GPUdb::getRecords ( const std::string &  tableName,
const int64_t  offset,
const int64_t  limit,
const std::map< std::string, std::string > &  options,
GetRecordsResponse< boost::any > &  response_ 
) const

Retrieves records from a given table, optionally filtered by an expression and/or sorted by a column.

This operation can be performed on tables and views. Records can be returned encoded as binary, json, or geojson.

This operation supports paging through the data via the offset and limit parameters. Note that when paging through a table, if the table (or the underlying table in case of a view) is updated (records are inserted, deleted or modified) the records retrieved may differ between calls based on the updates applied.

Parameters
[in]tableNameName of the table or view from which the records will be fetched, in [schema_name.]table_name format, using standard name resolution rules.
[in]offsetA positive integer indicating the number of initial results to skip (this can be useful for paging through the results). The 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 maximum number of results allowed by the server should be returned. The number of records returned will never exceed the server's own limit, defined by the max_get_records_size parameter in the server configuration. Use hasMoreRecords to see if more records exist in the result to be fetched, and offset & limit to request subsequent pages of results. The default value is -9999.
[in]options The default value is an empty map.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ getRecords() [8/20]

template<>
GetRecordsResponse<boost::any>& gpudb::GPUdb::getRecords ( const std::string &  tableName,
const int64_t  offset,
const int64_t  limit,
const std::map< std::string, std::string > &  options,
GetRecordsResponse< boost::any > &  response_ 
) const

Retrieves records from a given table, optionally filtered by an expression and/or sorted by a column.

This operation can be performed on tables and views. Records can be returned encoded as binary, json, or geojson.

This operation supports paging through the data via the offset and limit parameters. Note that when paging through a table, if the table (or the underlying table in case of a view) is updated (records are inserted, deleted or modified) the records retrieved may differ between calls based on the updates applied.

Parameters
[in]tableNameName of the table or view from which the records will be fetched, in [schema_name.]table_name format, using standard name resolution rules.
[in]offsetA positive integer indicating the number of initial results to skip (this can be useful for paging through the results). The 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 maximum number of results allowed by the server should be returned. The number of records returned will never exceed the server's own limit, defined by the max_get_records_size parameter in the server configuration. Use hasMoreRecords to see if more records exist in the result to be fetched, and offset & limit to request subsequent pages of results. The default value is -9999.
[in]options The default value is an empty map.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ getRecords() [9/20]

template<typename TResponse >
GetRecordsResponse<TResponse> gpudb::GPUdb::getRecords ( const GetRecordsRequest request_) const
inline

Retrieves records from a given table, optionally filtered by an expression and/or sorted by a column.

This operation can be performed on tables and views. Records can be returned encoded as binary, json, or geojson.

This operation supports paging through the data via the offset and limit parameters. Note that when paging through a table, if the table (or the underlying table in case of a view) is updated (records are inserted, deleted or modified) the records retrieved may differ between calls based on the updates applied.

Template Parameters
TResponseThe type of object being retrieved.
Parameters
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

Definition at line 28712 of file GPUdb.hpp.

◆ getRecords() [10/20]

template<typename TResponse >
GetRecordsResponse<TResponse>& gpudb::GPUdb::getRecords ( const GetRecordsRequest request_,
GetRecordsResponse< TResponse > &  response_ 
) const
inline

Retrieves records from a given table, optionally filtered by an expression and/or sorted by a column.

This operation can be performed on tables and views. Records can be returned encoded as binary, json, or geojson.

This operation supports paging through the data via the offset and limit parameters. Note that when paging through a table, if the table (or the underlying table in case of a view) is updated (records are inserted, deleted or modified) the records retrieved may differ between calls based on the updates applied.

Template Parameters
TResponseThe type of object being retrieved.
Parameters
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

Definition at line 28754 of file GPUdb.hpp.

◆ getRecords() [11/20]

template<typename TResponse >
GetRecordsResponse<TResponse> gpudb::GPUdb::getRecords ( const std::string &  tableName,
const int64_t  offset,
const int64_t  limit,
const std::map< std::string, std::string > &  options 
) const
inline

Retrieves records from a given table, optionally filtered by an expression and/or sorted by a column.

This operation can be performed on tables and views. Records can be returned encoded as binary, json, or geojson.

This operation supports paging through the data via the offset and limit parameters. Note that when paging through a table, if the table (or the underlying table in case of a view) is updated (records are inserted, deleted or modified) the records retrieved may differ between calls based on the updates applied.

Template Parameters
TResponseThe type of object being retrieved.
Parameters
[in]tableNameName of the table or view from which the records will be fetched, in [schema_name.]table_name format, using standard name resolution rules.
[in]offsetA positive integer indicating the number of initial results to skip (this can be useful for paging through the results). The 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 maximum number of results allowed by the server should be returned. The number of records returned will never exceed the server's own limit, defined by the max_get_records_size parameter in the server configuration. Use hasMoreRecords to see if more records exist in the result to be fetched, and offset & limit to request subsequent pages of results. The default value is -9999.
[in]options The default value is an empty map.
Returns
Response object containing the result of the operation.

Definition at line 28854 of file GPUdb.hpp.

◆ getRecords() [12/20]

template<typename TResponse >
GetRecordsResponse<TResponse>& gpudb::GPUdb::getRecords ( const std::string &  tableName,
const int64_t  offset,
const int64_t  limit,
const std::map< std::string, std::string > &  options,
GetRecordsResponse< TResponse > &  response_ 
) const
inline

Retrieves records from a given table, optionally filtered by an expression and/or sorted by a column.

This operation can be performed on tables and views. Records can be returned encoded as binary, json, or geojson.

This operation supports paging through the data via the offset and limit parameters. Note that when paging through a table, if the table (or the underlying table in case of a view) is updated (records are inserted, deleted or modified) the records retrieved may differ between calls based on the updates applied.

Template Parameters
TResponseThe type of object being retrieved.
Parameters
[in]tableNameName of the table or view from which the records will be fetched, in [schema_name.]table_name format, using standard name resolution rules.
[in]offsetA positive integer indicating the number of initial results to skip (this can be useful for paging through the results). The 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 maximum number of results allowed by the server should be returned. The number of records returned will never exceed the server's own limit, defined by the max_get_records_size parameter in the server configuration. Use hasMoreRecords to see if more records exist in the result to be fetched, and offset & limit to request subsequent pages of results. The default value is -9999.
[in]options The default value is an empty map.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

Definition at line 28961 of file GPUdb.hpp.

◆ getRecords() [13/20]

template<typename TResponse >
GetRecordsResponse<TResponse> gpudb::GPUdb::getRecords ( const ::avro::ValidSchema &  schema_,
const GetRecordsRequest request_ 
) const
inline

Retrieves records from a given table, optionally filtered by an expression and/or sorted by a column.

This operation can be performed on tables and views. Records can be returned encoded as binary, json, or geojson.

This operation supports paging through the data via the offset and limit parameters. Note that when paging through a table, if the table (or the underlying table in case of a view) is updated (records are inserted, deleted or modified) the records retrieved may differ between calls based on the updates applied.

Template Parameters
TResponseThe type of object being retrieved.
Parameters
[in]schema_Avro schema object used for decoding returned objects.
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

Definition at line 29007 of file GPUdb.hpp.

◆ getRecords() [14/20]

template<typename TResponse >
GetRecordsResponse<TResponse> gpudb::GPUdb::getRecords ( const Type type_,
const GetRecordsRequest request_ 
) const
inline

Retrieves records from a given table, optionally filtered by an expression and/or sorted by a column.

This operation can be performed on tables and views. Records can be returned encoded as binary, json, or geojson.

This operation supports paging through the data via the offset and limit parameters. Note that when paging through a table, if the table (or the underlying table in case of a view) is updated (records are inserted, deleted or modified) the records retrieved may differ between calls based on the updates applied.

Template Parameters
TResponseThe type of object being retrieved.
Parameters
[in]type_Type object used for decoding returned objects.
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

Definition at line 29049 of file GPUdb.hpp.

◆ getRecords() [15/20]

template<typename TResponse >
GetRecordsResponse<TResponse>& gpudb::GPUdb::getRecords ( const ::avro::ValidSchema &  schema_,
const GetRecordsRequest request_,
GetRecordsResponse< TResponse > &  response_ 
) const
inline

Retrieves records from a given table, optionally filtered by an expression and/or sorted by a column.

This operation can be performed on tables and views. Records can be returned encoded as binary, json, or geojson.

This operation supports paging through the data via the offset and limit parameters. Note that when paging through a table, if the table (or the underlying table in case of a view) is updated (records are inserted, deleted or modified) the records retrieved may differ between calls based on the updates applied.

Template Parameters
TResponseThe type of object being retrieved.
Parameters
[in]schema_Avro schema object used for decoding returned objects.
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

Definition at line 29093 of file GPUdb.hpp.

◆ getRecords() [16/20]

template<typename TResponse >
GetRecordsResponse<TResponse>& gpudb::GPUdb::getRecords ( const Type type_,
const GetRecordsRequest request_,
GetRecordsResponse< TResponse > &  response_ 
) const
inline

Retrieves records from a given table, optionally filtered by an expression and/or sorted by a column.

This operation can be performed on tables and views. Records can be returned encoded as binary, json, or geojson.

This operation supports paging through the data via the offset and limit parameters. Note that when paging through a table, if the table (or the underlying table in case of a view) is updated (records are inserted, deleted or modified) the records retrieved may differ between calls based on the updates applied.

Template Parameters
TResponseThe type of object being retrieved.
Parameters
[in]type_Type object used for decoding returned objects.
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

Definition at line 29137 of file GPUdb.hpp.

◆ getRecords() [17/20]

template<typename TResponse >
GetRecordsResponse<TResponse> gpudb::GPUdb::getRecords ( const ::avro::ValidSchema &  schema_,
const std::string &  tableName,
const int64_t  offset,
const int64_t  limit,
const std::map< std::string, std::string > &  options 
) const
inline

Retrieves records from a given table, optionally filtered by an expression and/or sorted by a column.

This operation can be performed on tables and views. Records can be returned encoded as binary, json, or geojson.

This operation supports paging through the data via the offset and limit parameters. Note that when paging through a table, if the table (or the underlying table in case of a view) is updated (records are inserted, deleted or modified) the records retrieved may differ between calls based on the updates applied.

Template Parameters
TResponseThe type of object being retrieved.
Parameters
[in]schema_Avro schema object used for decoding returned objects.
[in]tableNameName of the table or view from which the records will be fetched, in [schema_name.]table_name format, using standard name resolution rules.
[in]offsetA positive integer indicating the number of initial results to skip (this can be useful for paging through the results). The 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 maximum number of results allowed by the server should be returned. The number of records returned will never exceed the server's own limit, defined by the max_get_records_size parameter in the server configuration. Use hasMoreRecords to see if more records exist in the result to be fetched, and offset & limit to request subsequent pages of results. The default value is -9999.
[in]options The default value is an empty map.
Returns
Response object containing the result of the operation.

Definition at line 29239 of file GPUdb.hpp.

◆ getRecords() [18/20]

template<typename TResponse >
GetRecordsResponse<TResponse> gpudb::GPUdb::getRecords ( const Type type_,
const std::string &  tableName,
const int64_t  offset,
const int64_t  limit,
const std::map< std::string, std::string > &  options 
) const
inline

Retrieves records from a given table, optionally filtered by an expression and/or sorted by a column.

This operation can be performed on tables and views. Records can be returned encoded as binary, json, or geojson.

This operation supports paging through the data via the offset and limit parameters. Note that when paging through a table, if the table (or the underlying table in case of a view) is updated (records are inserted, deleted or modified) the records retrieved may differ between calls based on the updates applied.

Template Parameters
TResponseThe type of object being retrieved.
Parameters
[in]type_Type object used for decoding returned objects.
[in]tableNameName of the table or view from which the records will be fetched, in [schema_name.]table_name format, using standard name resolution rules.
[in]offsetA positive integer indicating the number of initial results to skip (this can be useful for paging through the results). The 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 maximum number of results allowed by the server should be returned. The number of records returned will never exceed the server's own limit, defined by the max_get_records_size parameter in the server configuration. Use hasMoreRecords to see if more records exist in the result to be fetched, and offset & limit to request subsequent pages of results. The default value is -9999.
[in]options The default value is an empty map.
Returns
Response object containing the result of the operation.

Definition at line 29346 of file GPUdb.hpp.

◆ getRecords() [19/20]

template<typename TResponse >
GetRecordsResponse<TResponse>& gpudb::GPUdb::getRecords ( const ::avro::ValidSchema &  schema_,
const std::string &  tableName,
const int64_t  offset,
const int64_t  limit,
const std::map< std::string, std::string > &  options,
GetRecordsResponse< TResponse > &  response_ 
) const
inline

Retrieves records from a given table, optionally filtered by an expression and/or sorted by a column.

This operation can be performed on tables and views. Records can be returned encoded as binary, json, or geojson.

This operation supports paging through the data via the offset and limit parameters. Note that when paging through a table, if the table (or the underlying table in case of a view) is updated (records are inserted, deleted or modified) the records retrieved may differ between calls based on the updates applied.

Template Parameters
TResponseThe type of object being retrieved.
Parameters
[in]schema_Avro schema object used for decoding returned objects.
[in]tableNameName of the table or view from which the records will be fetched, in [schema_name.]table_name format, using standard name resolution rules.
[in]offsetA positive integer indicating the number of initial results to skip (this can be useful for paging through the results). The 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 maximum number of results allowed by the server should be returned. The number of records returned will never exceed the server's own limit, defined by the max_get_records_size parameter in the server configuration. Use hasMoreRecords to see if more records exist in the result to be fetched, and offset & limit to request subsequent pages of results. The default value is -9999.
[in]options The default value is an empty map.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

Definition at line 29455 of file GPUdb.hpp.

◆ getRecords() [20/20]

template<typename TResponse >
GetRecordsResponse<TResponse>& gpudb::GPUdb::getRecords ( const Type type_,
const std::string &  tableName,
const int64_t  offset,
const int64_t  limit,
const std::map< std::string, std::string > &  options,
GetRecordsResponse< TResponse > &  response_ 
) const
inline

Retrieves records from a given table, optionally filtered by an expression and/or sorted by a column.

This operation can be performed on tables and views. Records can be returned encoded as binary, json, or geojson.

This operation supports paging through the data via the offset and limit parameters. Note that when paging through a table, if the table (or the underlying table in case of a view) is updated (records are inserted, deleted or modified) the records retrieved may differ between calls based on the updates applied.

Template Parameters
TResponseThe type of object being retrieved.
Parameters
[in]type_Type object used for decoding returned objects.
[in]tableNameName of the table or view from which the records will be fetched, in [schema_name.]table_name format, using standard name resolution rules.
[in]offsetA positive integer indicating the number of initial results to skip (this can be useful for paging through the results). The 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 maximum number of results allowed by the server should be returned. The number of records returned will never exceed the server's own limit, defined by the max_get_records_size parameter in the server configuration. Use hasMoreRecords to see if more records exist in the result to be fetched, and offset & limit to request subsequent pages of results. The default value is -9999.
[in]options The default value is an empty map.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

Definition at line 29564 of file GPUdb.hpp.

◆ getRecordsByColumn() [1/4]

GetRecordsByColumnResponse gpudb::GPUdb::getRecordsByColumn ( const GetRecordsByColumnRequest request_) const

For a given table, retrieves the values from the requested column(s).

Maps of column name to the array of values as well as the column data type are returned. This endpoint supports pagination with the offset and limit parameters.

Window functions, which can perform operations like moving averages, are available through this endpoint as well as createProjection.

When using pagination, if the table (or the underlying table in the case of a view) is modified (records are inserted, updated, or deleted) during a call to the endpoint, the records or values retrieved may differ between calls based on the type of the update, e.g., the contiguity across pages cannot be relied upon.

If tableName is empty, selection is performed against a single-row virtual table. This can be useful in executing temporal (NOW()), identity (USER()), or constant-based functions (GEODIST(-77.11, 38.88, -71.06, 42.36)).

The response is returned as a dynamic schema. For details see: dynamic schemas documentation.

Parameters
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

◆ getRecordsByColumn() [2/4]

GetRecordsByColumnResponse& gpudb::GPUdb::getRecordsByColumn ( const GetRecordsByColumnRequest request_,
GetRecordsByColumnResponse response_ 
) const

For a given table, retrieves the values from the requested column(s).

Maps of column name to the array of values as well as the column data type are returned. This endpoint supports pagination with the offset and limit parameters.

Window functions, which can perform operations like moving averages, are available through this endpoint as well as createProjection.

When using pagination, if the table (or the underlying table in the case of a view) is modified (records are inserted, updated, or deleted) during a call to the endpoint, the records or values retrieved may differ between calls based on the type of the update, e.g., the contiguity across pages cannot be relied upon.

If tableName is empty, selection is performed against a single-row virtual table. This can be useful in executing temporal (NOW()), identity (USER()), or constant-based functions (GEODIST(-77.11, 38.88, -71.06, 42.36)).

The response is returned as a dynamic schema. For details see: dynamic schemas documentation.

Parameters
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ getRecordsByColumn() [3/4]

GetRecordsByColumnResponse gpudb::GPUdb::getRecordsByColumn ( const std::string &  tableName,
const std::vector< std::string > &  columnNames,
const int64_t  offset,
const int64_t  limit,
const std::map< std::string, std::string > &  options 
) const

For a given table, retrieves the values from the requested column(s).

Maps of column name to the array of values as well as the column data type are returned. This endpoint supports pagination with the offset and limit parameters.

Window functions, which can perform operations like moving averages, are available through this endpoint as well as createProjection.

When using pagination, if the table (or the underlying table in the case of a view) is modified (records are inserted, updated, or deleted) during a call to the endpoint, the records or values retrieved may differ between calls based on the type of the update, e.g., the contiguity across pages cannot be relied upon.

If tableName is empty, selection is performed against a single-row virtual table. This can be useful in executing temporal (NOW()), identity (USER()), or constant-based functions (GEODIST(-77.11, 38.88, -71.06, 42.36)).

The response is returned as a dynamic schema. For details see: dynamic schemas documentation.

Parameters
[in]tableNameName of the table or view on which this operation will be performed, in [schema_name.]table_name format, using standard name resolution rules. An empty table name retrieves one record from a single-row virtual table, where columns specified should be constants or constant expressions.
[in]columnNamesThe list of column values to retrieve.
[in]offsetA positive integer indicating the number of initial results to skip (this can be useful for paging through the results). The 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 maximum number of results allowed by the server should be returned. The number of records returned will never exceed the server's own limit, defined by the max_get_records_size parameter in the server configuration. Use hasMoreRecords to see if more records exist in the result to be fetched, and offset & limit to request subsequent pages of results. The default value is -9999.
[in]options The default value is an empty map.
Returns
Response object containing the result of the operation.

◆ getRecordsByColumn() [4/4]

GetRecordsByColumnResponse& gpudb::GPUdb::getRecordsByColumn ( const std::string &  tableName,
const std::vector< std::string > &  columnNames,
const int64_t  offset,
const int64_t  limit,
const std::map< std::string, std::string > &  options,
GetRecordsByColumnResponse response_ 
) const

For a given table, retrieves the values from the requested column(s).

Maps of column name to the array of values as well as the column data type are returned. This endpoint supports pagination with the offset and limit parameters.

Window functions, which can perform operations like moving averages, are available through this endpoint as well as createProjection.

When using pagination, if the table (or the underlying table in the case of a view) is modified (records are inserted, updated, or deleted) during a call to the endpoint, the records or values retrieved may differ between calls based on the type of the update, e.g., the contiguity across pages cannot be relied upon.

If tableName is empty, selection is performed against a single-row virtual table. This can be useful in executing temporal (NOW()), identity (USER()), or constant-based functions (GEODIST(-77.11, 38.88, -71.06, 42.36)).

The response is returned as a dynamic schema. For details see: dynamic schemas documentation.

Parameters
[in]tableNameName of the table or view on which this operation will be performed, in [schema_name.]table_name format, using standard name resolution rules. An empty table name retrieves one record from a single-row virtual table, where columns specified should be constants or constant expressions.
[in]columnNamesThe list of column values to retrieve.
[in]offsetA positive integer indicating the number of initial results to skip (this can be useful for paging through the results). The 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 maximum number of results allowed by the server should be returned. The number of records returned will never exceed the server's own limit, defined by the max_get_records_size parameter in the server configuration. Use hasMoreRecords to see if more records exist in the result to be fetched, and offset & limit to request subsequent pages of results. The default value is -9999.
[in]options The default value is an empty map.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ getRecordsByColumnRaw() [1/2]

RawGetRecordsByColumnResponse gpudb::GPUdb::getRecordsByColumnRaw ( const GetRecordsByColumnRequest request_) const

For a given table, retrieves the values from the requested column(s).

Maps of column name to the array of values as well as the column data type are returned. This endpoint supports pagination with the offset and limit parameters.

Window functions, which can perform operations like moving averages, are available through this endpoint as well as createProjection.

When using pagination, if the table (or the underlying table in the case of a view) is modified (records are inserted, updated, or deleted) during a call to the endpoint, the records or values retrieved may differ between calls based on the type of the update, e.g., the contiguity across pages cannot be relied upon.

If tableName is empty, selection is performed against a single-row virtual table. This can be useful in executing temporal (NOW()), identity (USER()), or constant-based functions (GEODIST(-77.11, 38.88, -71.06, 42.36)).

The response is returned as a dynamic schema. For details see: dynamic schemas documentation.

Parameters
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

◆ getRecordsByColumnRaw() [2/2]

RawGetRecordsByColumnResponse& gpudb::GPUdb::getRecordsByColumnRaw ( const GetRecordsByColumnRequest request_,
RawGetRecordsByColumnResponse response_ 
) const

For a given table, retrieves the values from the requested column(s).

Maps of column name to the array of values as well as the column data type are returned. This endpoint supports pagination with the offset and limit parameters.

Window functions, which can perform operations like moving averages, are available through this endpoint as well as createProjection.

When using pagination, if the table (or the underlying table in the case of a view) is modified (records are inserted, updated, or deleted) during a call to the endpoint, the records or values retrieved may differ between calls based on the type of the update, e.g., the contiguity across pages cannot be relied upon.

If tableName is empty, selection is performed against a single-row virtual table. This can be useful in executing temporal (NOW()), identity (USER()), or constant-based functions (GEODIST(-77.11, 38.88, -71.06, 42.36)).

The response is returned as a dynamic schema. For details see: dynamic schemas documentation.

Parameters
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ getRecordsBySeries() [1/20]

template<>
GetRecordsBySeriesResponse<boost::any> gpudb::GPUdb::getRecordsBySeries ( const GetRecordsBySeriesRequest request_) const

Retrieves the complete series/track records from the given worldTableName based on the partial track information contained in the tableName.

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

In contrast to getRecords this returns records grouped by series/track. So if offset is 0 and limit is 5 this operation would return the first 5 series/tracks in tableName. Each series/track will be returned sorted by their TIMESTAMP column.

Parameters
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

◆ getRecordsBySeries() [2/20]

template<>
GetRecordsBySeriesResponse<boost::any> gpudb::GPUdb::getRecordsBySeries ( const GetRecordsBySeriesRequest request_) const

Retrieves the complete series/track records from the given worldTableName based on the partial track information contained in the tableName.

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

In contrast to getRecords this returns records grouped by series/track. So if offset is 0 and limit is 5 this operation would return the first 5 series/tracks in tableName. Each series/track will be returned sorted by their TIMESTAMP column.

Parameters
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

◆ getRecordsBySeries() [3/20]

template<>
GetRecordsBySeriesResponse<boost::any>& gpudb::GPUdb::getRecordsBySeries ( const GetRecordsBySeriesRequest request_,
GetRecordsBySeriesResponse< boost::any > &  response_ 
) const

Retrieves the complete series/track records from the given worldTableName based on the partial track information contained in the tableName.

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

In contrast to getRecords this returns records grouped by series/track. So if offset is 0 and limit is 5 this operation would return the first 5 series/tracks in tableName. Each series/track will be returned sorted by their TIMESTAMP column.

Parameters
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ getRecordsBySeries() [4/20]

template<>
GetRecordsBySeriesResponse<boost::any>& gpudb::GPUdb::getRecordsBySeries ( const GetRecordsBySeriesRequest request_,
GetRecordsBySeriesResponse< boost::any > &  response_ 
) const

Retrieves the complete series/track records from the given worldTableName based on the partial track information contained in the tableName.

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

In contrast to getRecords this returns records grouped by series/track. So if offset is 0 and limit is 5 this operation would return the first 5 series/tracks in tableName. Each series/track will be returned sorted by their TIMESTAMP column.

Parameters
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ getRecordsBySeries() [5/20]

template<>
GetRecordsBySeriesResponse<boost::any> gpudb::GPUdb::getRecordsBySeries ( const std::string &  tableName,
const std::string &  worldTableName,
const int32_t  offset,
const int32_t  limit,
const std::map< std::string, std::string > &  options 
) const

Retrieves the complete series/track records from the given worldTableName based on the partial track information contained in the tableName.

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

In contrast to getRecords this returns records grouped by series/track. So if offset is 0 and limit is 5 this operation would return the first 5 series/tracks in tableName. Each series/track will be returned sorted by their TIMESTAMP column.

Parameters
[in]tableNameName of the table or view for which series/tracks will be fetched, in [schema_name.]table_name format, using standard name resolution rules.
[in]worldTableNameName of the table containing the complete series/track information to be returned for the tracks present in the tableName, in [schema_name.]table_name format, using standard name resolution rules. Typically this is used when retrieving series/tracks from a view (which contains partial series/tracks) but the user wants to retrieve the entire original series/tracks. Can be blank.
[in]offsetA positive integer indicating the number of initial series/tracks to skip (useful for paging through the results). The 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 series/tracks to be returned. Or END_OF_SET (-9999) to indicate that the max number of results should be returned. The default value is 250.
[in]optionsOptional parameters. The default value is an empty map.
Returns
Response object containing the result of the operation.

◆ getRecordsBySeries() [6/20]

template<>
GetRecordsBySeriesResponse<boost::any> gpudb::GPUdb::getRecordsBySeries ( const std::string &  tableName,
const std::string &  worldTableName,
const int32_t  offset,
const int32_t  limit,
const std::map< std::string, std::string > &  options 
) const

Retrieves the complete series/track records from the given worldTableName based on the partial track information contained in the tableName.

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

In contrast to getRecords this returns records grouped by series/track. So if offset is 0 and limit is 5 this operation would return the first 5 series/tracks in tableName. Each series/track will be returned sorted by their TIMESTAMP column.

Parameters
[in]tableNameName of the table or view for which series/tracks will be fetched, in [schema_name.]table_name format, using standard name resolution rules.
[in]worldTableNameName of the table containing the complete series/track information to be returned for the tracks present in the tableName, in [schema_name.]table_name format, using standard name resolution rules. Typically this is used when retrieving series/tracks from a view (which contains partial series/tracks) but the user wants to retrieve the entire original series/tracks. Can be blank.
[in]offsetA positive integer indicating the number of initial series/tracks to skip (useful for paging through the results). The 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 series/tracks to be returned. Or END_OF_SET (-9999) to indicate that the max number of results should be returned. The default value is 250.
[in]optionsOptional parameters. The default value is an empty map.
Returns
Response object containing the result of the operation.

◆ getRecordsBySeries() [7/20]

template<>
GetRecordsBySeriesResponse<boost::any>& gpudb::GPUdb::getRecordsBySeries ( const std::string &  tableName,
const std::string &  worldTableName,
const int32_t  offset,
const int32_t  limit,
const std::map< std::string, std::string > &  options,
GetRecordsBySeriesResponse< boost::any > &  response_ 
) const

Retrieves the complete series/track records from the given worldTableName based on the partial track information contained in the tableName.

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

In contrast to getRecords this returns records grouped by series/track. So if offset is 0 and limit is 5 this operation would return the first 5 series/tracks in tableName. Each series/track will be returned sorted by their TIMESTAMP column.

Parameters
[in]tableNameName of the table or view for which series/tracks will be fetched, in [schema_name.]table_name format, using standard name resolution rules.
[in]worldTableNameName of the table containing the complete series/track information to be returned for the tracks present in the tableName, in [schema_name.]table_name format, using standard name resolution rules. Typically this is used when retrieving series/tracks from a view (which contains partial series/tracks) but the user wants to retrieve the entire original series/tracks. Can be blank.
[in]offsetA positive integer indicating the number of initial series/tracks to skip (useful for paging through the results). The 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 series/tracks to be returned. Or END_OF_SET (-9999) to indicate that the max number of results should be returned. The default value is 250.
[in]optionsOptional parameters. The default value is an empty map.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ getRecordsBySeries() [8/20]

template<>
GetRecordsBySeriesResponse<boost::any>& gpudb::GPUdb::getRecordsBySeries ( const std::string &  tableName,
const std::string &  worldTableName,
const int32_t  offset,
const int32_t  limit,
const std::map< std::string, std::string > &  options,
GetRecordsBySeriesResponse< boost::any > &  response_ 
) const

Retrieves the complete series/track records from the given worldTableName based on the partial track information contained in the tableName.

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

In contrast to getRecords this returns records grouped by series/track. So if offset is 0 and limit is 5 this operation would return the first 5 series/tracks in tableName. Each series/track will be returned sorted by their TIMESTAMP column.

Parameters
[in]tableNameName of the table or view for which series/tracks will be fetched, in [schema_name.]table_name format, using standard name resolution rules.
[in]worldTableNameName of the table containing the complete series/track information to be returned for the tracks present in the tableName, in [schema_name.]table_name format, using standard name resolution rules. Typically this is used when retrieving series/tracks from a view (which contains partial series/tracks) but the user wants to retrieve the entire original series/tracks. Can be blank.
[in]offsetA positive integer indicating the number of initial series/tracks to skip (useful for paging through the results). The 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 series/tracks to be returned. Or END_OF_SET (-9999) to indicate that the max number of results should be returned. The default value is 250.
[in]optionsOptional parameters. The default value is an empty map.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ getRecordsBySeries() [9/20]

template<typename TResponse >
GetRecordsBySeriesResponse<TResponse> gpudb::GPUdb::getRecordsBySeries ( const GetRecordsBySeriesRequest request_) const
inline

Retrieves the complete series/track records from the given worldTableName based on the partial track information contained in the tableName.

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

In contrast to getRecords this returns records grouped by series/track. So if offset is 0 and limit is 5 this operation would return the first 5 series/tracks in tableName. Each series/track will be returned sorted by their TIMESTAMP column.

Template Parameters
TResponseThe type of object being retrieved.
Parameters
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

Definition at line 30110 of file GPUdb.hpp.

◆ getRecordsBySeries() [10/20]

template<typename TResponse >
GetRecordsBySeriesResponse<TResponse>& gpudb::GPUdb::getRecordsBySeries ( const GetRecordsBySeriesRequest request_,
GetRecordsBySeriesResponse< TResponse > &  response_ 
) const
inline

Retrieves the complete series/track records from the given worldTableName based on the partial track information contained in the tableName.

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

In contrast to getRecords this returns records grouped by series/track. So if offset is 0 and limit is 5 this operation would return the first 5 series/tracks in tableName. Each series/track will be returned sorted by their TIMESTAMP column.

Template Parameters
TResponseThe type of object being retrieved.
Parameters
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

Definition at line 30162 of file GPUdb.hpp.

◆ getRecordsBySeries() [11/20]

template<typename TResponse >
GetRecordsBySeriesResponse<TResponse> gpudb::GPUdb::getRecordsBySeries ( const std::string &  tableName,
const std::string &  worldTableName,
const int32_t  offset,
const int32_t  limit,
const std::map< std::string, std::string > &  options 
) const
inline

Retrieves the complete series/track records from the given worldTableName based on the partial track information contained in the tableName.

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

In contrast to getRecords this returns records grouped by series/track. So if offset is 0 and limit is 5 this operation would return the first 5 series/tracks in tableName. Each series/track will be returned sorted by their TIMESTAMP column.

Template Parameters
TResponseThe type of object being retrieved.
Parameters
[in]tableNameName of the table or view for which series/tracks will be fetched, in [schema_name.]table_name format, using standard name resolution rules.
[in]worldTableNameName of the table containing the complete series/track information to be returned for the tracks present in the tableName, in [schema_name.]table_name format, using standard name resolution rules. Typically this is used when retrieving series/tracks from a view (which contains partial series/tracks) but the user wants to retrieve the entire original series/tracks. Can be blank.
[in]offsetA positive integer indicating the number of initial series/tracks to skip (useful for paging through the results). The 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 series/tracks to be returned. Or END_OF_SET (-9999) to indicate that the max number of results should be returned. The default value is 250.
[in]optionsOptional parameters. The default value is an empty map.
Returns
Response object containing the result of the operation.

Definition at line 30231 of file GPUdb.hpp.

◆ getRecordsBySeries() [12/20]

template<typename TResponse >
GetRecordsBySeriesResponse<TResponse>& gpudb::GPUdb::getRecordsBySeries ( const std::string &  tableName,
const std::string &  worldTableName,
const int32_t  offset,
const int32_t  limit,
const std::map< std::string, std::string > &  options,
GetRecordsBySeriesResponse< TResponse > &  response_ 
) const
inline

Retrieves the complete series/track records from the given worldTableName based on the partial track information contained in the tableName.

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

In contrast to getRecords this returns records grouped by series/track. So if offset is 0 and limit is 5 this operation would return the first 5 series/tracks in tableName. Each series/track will be returned sorted by their TIMESTAMP column.

Template Parameters
TResponseThe type of object being retrieved.
Parameters
[in]tableNameName of the table or view for which series/tracks will be fetched, in [schema_name.]table_name format, using standard name resolution rules.
[in]worldTableNameName of the table containing the complete series/track information to be returned for the tracks present in the tableName, in [schema_name.]table_name format, using standard name resolution rules. Typically this is used when retrieving series/tracks from a view (which contains partial series/tracks) but the user wants to retrieve the entire original series/tracks. Can be blank.
[in]offsetA positive integer indicating the number of initial series/tracks to skip (useful for paging through the results). The 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 series/tracks to be returned. Or END_OF_SET (-9999) to indicate that the max number of results should be returned. The default value is 250.
[in]optionsOptional parameters. The default value is an empty map.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

Definition at line 30309 of file GPUdb.hpp.

◆ getRecordsBySeries() [13/20]

template<typename TResponse >
GetRecordsBySeriesResponse<TResponse> gpudb::GPUdb::getRecordsBySeries ( const ::avro::ValidSchema &  schema_,
const GetRecordsBySeriesRequest request_ 
) const
inline

Retrieves the complete series/track records from the given worldTableName based on the partial track information contained in the tableName.

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

In contrast to getRecords this returns records grouped by series/track. So if offset is 0 and limit is 5 this operation would return the first 5 series/tracks in tableName. Each series/track will be returned sorted by their TIMESTAMP column.

Template Parameters
TResponseThe type of object being retrieved.
Parameters
[in]schema_Avro schema object used for decoding returned objects.
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

Definition at line 30368 of file GPUdb.hpp.

◆ getRecordsBySeries() [14/20]

template<typename TResponse >
GetRecordsBySeriesResponse<TResponse> gpudb::GPUdb::getRecordsBySeries ( const Type type_,
const GetRecordsBySeriesRequest request_ 
) const
inline

Retrieves the complete series/track records from the given worldTableName based on the partial track information contained in the tableName.

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

In contrast to getRecords this returns records grouped by series/track. So if offset is 0 and limit is 5 this operation would return the first 5 series/tracks in tableName. Each series/track will be returned sorted by their TIMESTAMP column.

Template Parameters
TResponseThe type of object being retrieved.
Parameters
[in]type_Type object used for decoding returned objects.
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

Definition at line 30420 of file GPUdb.hpp.

◆ getRecordsBySeries() [15/20]

template<typename TResponse >
GetRecordsBySeriesResponse<TResponse>& gpudb::GPUdb::getRecordsBySeries ( const ::avro::ValidSchema &  schema_,
const GetRecordsBySeriesRequest request_,
GetRecordsBySeriesResponse< TResponse > &  response_ 
) const
inline

Retrieves the complete series/track records from the given worldTableName based on the partial track information contained in the tableName.

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

In contrast to getRecords this returns records grouped by series/track. So if offset is 0 and limit is 5 this operation would return the first 5 series/tracks in tableName. Each series/track will be returned sorted by their TIMESTAMP column.

Template Parameters
TResponseThe type of object being retrieved.
Parameters
[in]schema_Avro schema object used for decoding returned objects.
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

Definition at line 30475 of file GPUdb.hpp.

◆ getRecordsBySeries() [16/20]

template<typename TResponse >
GetRecordsBySeriesResponse<TResponse>& gpudb::GPUdb::getRecordsBySeries ( const Type type_,
const GetRecordsBySeriesRequest request_,
GetRecordsBySeriesResponse< TResponse > &  response_ 
) const
inline

Retrieves the complete series/track records from the given worldTableName based on the partial track information contained in the tableName.

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

In contrast to getRecords this returns records grouped by series/track. So if offset is 0 and limit is 5 this operation would return the first 5 series/tracks in tableName. Each series/track will be returned sorted by their TIMESTAMP column.

Template Parameters
TResponseThe type of object being retrieved.
Parameters
[in]type_Type object used for decoding returned objects.
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

Definition at line 30529 of file GPUdb.hpp.

◆ getRecordsBySeries() [17/20]

template<typename TResponse >
GetRecordsBySeriesResponse<TResponse> gpudb::GPUdb::getRecordsBySeries ( const ::avro::ValidSchema &  schema_,
const std::string &  tableName,
const std::string &  worldTableName,
const int32_t  offset,
const int32_t  limit,
const std::map< std::string, std::string > &  options 
) const
inline

Retrieves the complete series/track records from the given worldTableName based on the partial track information contained in the tableName.

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

In contrast to getRecords this returns records grouped by series/track. So if offset is 0 and limit is 5 this operation would return the first 5 series/tracks in tableName. Each series/track will be returned sorted by their TIMESTAMP column.

Template Parameters
TResponseThe type of object being retrieved.
Parameters
[in]schema_Avro schema object used for decoding returned objects.
[in]tableNameName of the table or view for which series/tracks will be fetched, in [schema_name.]table_name format, using standard name resolution rules.
[in]worldTableNameName of the table containing the complete series/track information to be returned for the tracks present in the tableName, in [schema_name.]table_name format, using standard name resolution rules. Typically this is used when retrieving series/tracks from a view (which contains partial series/tracks) but the user wants to retrieve the entire original series/tracks. Can be blank.
[in]offsetA positive integer indicating the number of initial series/tracks to skip (useful for paging through the results). The 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 series/tracks to be returned. Or END_OF_SET (-9999) to indicate that the max number of results should be returned. The default value is 250.
[in]optionsOptional parameters. The default value is an empty map.
Returns
Response object containing the result of the operation.

Definition at line 30600 of file GPUdb.hpp.

◆ getRecordsBySeries() [18/20]

template<typename TResponse >
GetRecordsBySeriesResponse<TResponse> gpudb::GPUdb::getRecordsBySeries ( const Type type_,
const std::string &  tableName,
const std::string &  worldTableName,
const int32_t  offset,
const int32_t  limit,
const std::map< std::string, std::string > &  options 
) const
inline

Retrieves the complete series/track records from the given worldTableName based on the partial track information contained in the tableName.

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

In contrast to getRecords this returns records grouped by series/track. So if offset is 0 and limit is 5 this operation would return the first 5 series/tracks in tableName. Each series/track will be returned sorted by their TIMESTAMP column.

Template Parameters
TResponseThe type of object being retrieved.
Parameters
[in]type_Type object used for decoding returned objects.
[in]tableNameName of the table or view for which series/tracks will be fetched, in [schema_name.]table_name format, using standard name resolution rules.
[in]worldTableNameName of the table containing the complete series/track information to be returned for the tracks present in the tableName, in [schema_name.]table_name format, using standard name resolution rules. Typically this is used when retrieving series/tracks from a view (which contains partial series/tracks) but the user wants to retrieve the entire original series/tracks. Can be blank.
[in]offsetA positive integer indicating the number of initial series/tracks to skip (useful for paging through the results). The 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 series/tracks to be returned. Or END_OF_SET (-9999) to indicate that the max number of results should be returned. The default value is 250.
[in]optionsOptional parameters. The default value is an empty map.
Returns
Response object containing the result of the operation.

Definition at line 30678 of file GPUdb.hpp.

◆ getRecordsBySeries() [19/20]

template<typename TResponse >
GetRecordsBySeriesResponse<TResponse>& gpudb::GPUdb::getRecordsBySeries ( const ::avro::ValidSchema &  schema_,
const std::string &  tableName,
const std::string &  worldTableName,
const int32_t  offset,
const int32_t  limit,
const std::map< std::string, std::string > &  options,
GetRecordsBySeriesResponse< TResponse > &  response_ 
) const
inline

Retrieves the complete series/track records from the given worldTableName based on the partial track information contained in the tableName.

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

In contrast to getRecords this returns records grouped by series/track. So if offset is 0 and limit is 5 this operation would return the first 5 series/tracks in tableName. Each series/track will be returned sorted by their TIMESTAMP column.

Template Parameters
TResponseThe type of object being retrieved.
Parameters
[in]schema_Avro schema object used for decoding returned objects.
[in]tableNameName of the table or view for which series/tracks will be fetched, in [schema_name.]table_name format, using standard name resolution rules.
[in]worldTableNameName of the table containing the complete series/track information to be returned for the tracks present in the tableName, in [schema_name.]table_name format, using standard name resolution rules. Typically this is used when retrieving series/tracks from a view (which contains partial series/tracks) but the user wants to retrieve the entire original series/tracks. Can be blank.
[in]offsetA positive integer indicating the number of initial series/tracks to skip (useful for paging through the results). The 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 series/tracks to be returned. Or END_OF_SET (-9999) to indicate that the max number of results should be returned. The default value is 250.
[in]optionsOptional parameters. The default value is an empty map.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

Definition at line 30758 of file GPUdb.hpp.

◆ getRecordsBySeries() [20/20]

template<typename TResponse >
GetRecordsBySeriesResponse<TResponse>& gpudb::GPUdb::getRecordsBySeries ( const Type type_,
const std::string &  tableName,
const std::string &  worldTableName,
const int32_t  offset,
const int32_t  limit,
const std::map< std::string, std::string > &  options,
GetRecordsBySeriesResponse< TResponse > &  response_ 
) const
inline

Retrieves the complete series/track records from the given worldTableName based on the partial track information contained in the tableName.

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

In contrast to getRecords this returns records grouped by series/track. So if offset is 0 and limit is 5 this operation would return the first 5 series/tracks in tableName. Each series/track will be returned sorted by their TIMESTAMP column.

Template Parameters
TResponseThe type of object being retrieved.
Parameters
[in]type_Type object used for decoding returned objects.
[in]tableNameName of the table or view for which series/tracks will be fetched, in [schema_name.]table_name format, using standard name resolution rules.
[in]worldTableNameName of the table containing the complete series/track information to be returned for the tracks present in the tableName, in [schema_name.]table_name format, using standard name resolution rules. Typically this is used when retrieving series/tracks from a view (which contains partial series/tracks) but the user wants to retrieve the entire original series/tracks. Can be blank.
[in]offsetA positive integer indicating the number of initial series/tracks to skip (useful for paging through the results). The 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 series/tracks to be returned. Or END_OF_SET (-9999) to indicate that the max number of results should be returned. The default value is 250.
[in]optionsOptional parameters. The default value is an empty map.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

Definition at line 30838 of file GPUdb.hpp.

◆ getRecordsBySeriesRaw() [1/2]

RawGetRecordsBySeriesResponse gpudb::GPUdb::getRecordsBySeriesRaw ( const GetRecordsBySeriesRequest request_) const

Retrieves the complete series/track records from the given worldTableName based on the partial track information contained in the tableName.

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

In contrast to getRecordsRaw this returns records grouped by series/track. So if offset is 0 and limit is 5 this operation would return the first 5 series/tracks in tableName. Each series/track will be returned sorted by their TIMESTAMP column.

Parameters
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

◆ getRecordsBySeriesRaw() [2/2]

RawGetRecordsBySeriesResponse& gpudb::GPUdb::getRecordsBySeriesRaw ( const GetRecordsBySeriesRequest request_,
RawGetRecordsBySeriesResponse response_ 
) const

Retrieves the complete series/track records from the given worldTableName based on the partial track information contained in the tableName.

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

In contrast to getRecordsRaw this returns records grouped by series/track. So if offset is 0 and limit is 5 this operation would return the first 5 series/tracks in tableName. Each series/track will be returned sorted by their TIMESTAMP column.

Parameters
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ getRecordsFromCollection() [1/20]

template<>
GetRecordsFromCollectionResponse<boost::any> gpudb::GPUdb::getRecordsFromCollection ( const GetRecordsFromCollectionRequest request_) const

Retrieves records from a collection.

The operation can optionally return the record IDs which can be used in certain queries such as deleteRecords.

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 views using this operation. (DEPRECATED)

Parameters
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

◆ getRecordsFromCollection() [2/20]

template<>
GetRecordsFromCollectionResponse<boost::any> gpudb::GPUdb::getRecordsFromCollection ( const GetRecordsFromCollectionRequest request_) const

Retrieves records from a collection.

The operation can optionally return the record IDs which can be used in certain queries such as deleteRecords.

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 views using this operation. (DEPRECATED)

Parameters
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

◆ getRecordsFromCollection() [3/20]

template<>
GetRecordsFromCollectionResponse<boost::any>& gpudb::GPUdb::getRecordsFromCollection ( const GetRecordsFromCollectionRequest request_,
GetRecordsFromCollectionResponse< boost::any > &  response_ 
) const

Retrieves records from a collection.

The operation can optionally return the record IDs which can be used in certain queries such as deleteRecords.

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 views using this operation. (DEPRECATED)

Parameters
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ getRecordsFromCollection() [4/20]

template<>
GetRecordsFromCollectionResponse<boost::any>& gpudb::GPUdb::getRecordsFromCollection ( const GetRecordsFromCollectionRequest request_,
GetRecordsFromCollectionResponse< boost::any > &  response_ 
) const

Retrieves records from a collection.

The operation can optionally return the record IDs which can be used in certain queries such as deleteRecords.

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 views using this operation. (DEPRECATED)

Parameters
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ getRecordsFromCollection() [5/20]

template<>
GetRecordsFromCollectionResponse<boost::any> gpudb::GPUdb::getRecordsFromCollection ( const std::string &  tableName,
const int64_t  offset,
const int64_t  limit,
const std::map< std::string, std::string > &  options 
) const

Retrieves records from a collection.

The operation can optionally return the record IDs which can be used in certain queries such as deleteRecords.

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 views using this operation. (DEPRECATED)

Parameters
[in]tableNameName of the collection or table from which records are to be retrieved, in [schema_name.]table_name format, using standard name resolution rules. Must be an existing collection or table.
[in]offsetA positive integer indicating the number of initial results to skip (this can be useful for paging through the results). The 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 maximum number of results allowed by the server should be returned. The number of records returned will never exceed the server's own limit, defined by the max_get_records_size parameter in the server configuration. Use offset & limit to request subsequent pages of results. The default value is -9999.
[in]options The default value is an empty map.
Returns
Response object containing the result of the operation.

◆ getRecordsFromCollection() [6/20]

template<>
GetRecordsFromCollectionResponse<boost::any> gpudb::GPUdb::getRecordsFromCollection ( const std::string &  tableName,
const int64_t  offset,
const int64_t  limit,
const std::map< std::string, std::string > &  options 
) const

Retrieves records from a collection.

The operation can optionally return the record IDs which can be used in certain queries such as deleteRecords.

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 views using this operation. (DEPRECATED)

Parameters
[in]tableNameName of the collection or table from which records are to be retrieved, in [schema_name.]table_name format, using standard name resolution rules. Must be an existing collection or table.
[in]offsetA positive integer indicating the number of initial results to skip (this can be useful for paging through the results). The 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 maximum number of results allowed by the server should be returned. The number of records returned will never exceed the server's own limit, defined by the max_get_records_size parameter in the server configuration. Use offset & limit to request subsequent pages of results. The default value is -9999.
[in]options The default value is an empty map.
Returns
Response object containing the result of the operation.

◆ getRecordsFromCollection() [7/20]

template<>
GetRecordsFromCollectionResponse<boost::any>& gpudb::GPUdb::getRecordsFromCollection ( const std::string &  tableName,
const int64_t  offset,
const int64_t  limit,
const std::map< std::string, std::string > &  options,
GetRecordsFromCollectionResponse< boost::any > &  response_ 
) const

Retrieves records from a collection.

The operation can optionally return the record IDs which can be used in certain queries such as deleteRecords.

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 views using this operation. (DEPRECATED)

Parameters
[in]tableNameName of the collection or table from which records are to be retrieved, in [schema_name.]table_name format, using standard name resolution rules. Must be an existing collection or table.
[in]offsetA positive integer indicating the number of initial results to skip (this can be useful for paging through the results). The 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 maximum number of results allowed by the server should be returned. The number of records returned will never exceed the server's own limit, defined by the max_get_records_size parameter in the server configuration. Use offset & limit to request subsequent pages of results. The default value is -9999.
[in]options The default value is an empty map.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ getRecordsFromCollection() [8/20]

template<>
GetRecordsFromCollectionResponse<boost::any>& gpudb::GPUdb::getRecordsFromCollection ( const std::string &  tableName,
const int64_t  offset,
const int64_t  limit,
const std::map< std::string, std::string > &  options,
GetRecordsFromCollectionResponse< boost::any > &  response_ 
) const

Retrieves records from a collection.

The operation can optionally return the record IDs which can be used in certain queries such as deleteRecords.

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 views using this operation. (DEPRECATED)

Parameters
[in]tableNameName of the collection or table from which records are to be retrieved, in [schema_name.]table_name format, using standard name resolution rules. Must be an existing collection or table.
[in]offsetA positive integer indicating the number of initial results to skip (this can be useful for paging through the results). The 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 maximum number of results allowed by the server should be returned. The number of records returned will never exceed the server's own limit, defined by the max_get_records_size parameter in the server configuration. Use offset & limit to request subsequent pages of results. The default value is -9999.
[in]options The default value is an empty map.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ getRecordsFromCollection() [9/20]

template<typename TResponse >
GetRecordsFromCollectionResponse<TResponse> gpudb::GPUdb::getRecordsFromCollection ( const GetRecordsFromCollectionRequest request_) const
inline

Retrieves records from a collection.

The operation can optionally return the record IDs which can be used in certain queries such as deleteRecords.

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 views using this operation. (DEPRECATED)

Template Parameters
TResponseThe type of object being retrieved.
Parameters
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

Definition at line 30938 of file GPUdb.hpp.

◆ getRecordsFromCollection() [10/20]

template<typename TResponse >
GetRecordsFromCollectionResponse<TResponse>& gpudb::GPUdb::getRecordsFromCollection ( const GetRecordsFromCollectionRequest request_,
GetRecordsFromCollectionResponse< TResponse > &  response_ 
) const
inline

Retrieves records from a collection.

The operation can optionally return the record IDs which can be used in certain queries such as deleteRecords.

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 views using this operation. (DEPRECATED)

Template Parameters
TResponseThe type of object being retrieved.
Parameters
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

Definition at line 30981 of file GPUdb.hpp.

◆ getRecordsFromCollection() [11/20]

template<typename TResponse >
GetRecordsFromCollectionResponse<TResponse> gpudb::GPUdb::getRecordsFromCollection ( const std::string &  tableName,
const int64_t  offset,
const int64_t  limit,
const std::map< std::string, std::string > &  options 
) const
inline

Retrieves records from a collection.

The operation can optionally return the record IDs which can be used in certain queries such as deleteRecords.

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 views using this operation. (DEPRECATED)

Template Parameters
TResponseThe type of object being retrieved.
Parameters
[in]tableNameName of the collection or table from which records are to be retrieved, in [schema_name.]table_name format, using standard name resolution rules. Must be an existing collection or table.
[in]offsetA positive integer indicating the number of initial results to skip (this can be useful for paging through the results). The 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 maximum number of results allowed by the server should be returned. The number of records returned will never exceed the server's own limit, defined by the max_get_records_size parameter in the server configuration. Use offset & limit to request subsequent pages of results. The default value is -9999.
[in]options The default value is an empty map.
Returns
Response object containing the result of the operation.

Definition at line 31063 of file GPUdb.hpp.

◆ getRecordsFromCollection() [12/20]

template<typename TResponse >
GetRecordsFromCollectionResponse<TResponse>& gpudb::GPUdb::getRecordsFromCollection ( const std::string &  tableName,
const int64_t  offset,
const int64_t  limit,
const std::map< std::string, std::string > &  options,
GetRecordsFromCollectionResponse< TResponse > &  response_ 
) const
inline

Retrieves records from a collection.

The operation can optionally return the record IDs which can be used in certain queries such as deleteRecords.

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 views using this operation. (DEPRECATED)

Template Parameters
TResponseThe type of object being retrieved.
Parameters
[in]tableNameName of the collection or table from which records are to be retrieved, in [schema_name.]table_name format, using standard name resolution rules. Must be an existing collection or table.
[in]offsetA positive integer indicating the number of initial results to skip (this can be useful for paging through the results). The 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 maximum number of results allowed by the server should be returned. The number of records returned will never exceed the server's own limit, defined by the max_get_records_size parameter in the server configuration. Use offset & limit to request subsequent pages of results. The default value is -9999.
[in]options The default value is an empty map.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

Definition at line 31154 of file GPUdb.hpp.

◆ getRecordsFromCollection() [13/20]

template<typename TResponse >
GetRecordsFromCollectionResponse<TResponse> gpudb::GPUdb::getRecordsFromCollection ( const ::avro::ValidSchema &  schema_,
const GetRecordsFromCollectionRequest request_ 
) const
inline

Retrieves records from a collection.

The operation can optionally return the record IDs which can be used in certain queries such as deleteRecords.

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 views using this operation. (DEPRECATED)

Template Parameters
TResponseThe type of object being retrieved.
Parameters
[in]schema_Avro schema object used for decoding returned objects.
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

Definition at line 31200 of file GPUdb.hpp.

◆ getRecordsFromCollection() [14/20]

template<typename TResponse >
GetRecordsFromCollectionResponse<TResponse> gpudb::GPUdb::getRecordsFromCollection ( const Type type_,
const GetRecordsFromCollectionRequest request_ 
) const
inline

Retrieves records from a collection.

The operation can optionally return the record IDs which can be used in certain queries such as deleteRecords.

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 views using this operation. (DEPRECATED)

Template Parameters
TResponseThe type of object being retrieved.
Parameters
[in]type_Type object used for decoding returned objects.
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

Definition at line 31242 of file GPUdb.hpp.

◆ getRecordsFromCollection() [15/20]

template<typename TResponse >
GetRecordsFromCollectionResponse<TResponse>& gpudb::GPUdb::getRecordsFromCollection ( const ::avro::ValidSchema &  schema_,
const GetRecordsFromCollectionRequest request_,
GetRecordsFromCollectionResponse< TResponse > &  response_ 
) const
inline

Retrieves records from a collection.

The operation can optionally return the record IDs which can be used in certain queries such as deleteRecords.

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 views using this operation. (DEPRECATED)

Template Parameters
TResponseThe type of object being retrieved.
Parameters
[in]schema_Avro schema object used for decoding returned objects.
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

Definition at line 31288 of file GPUdb.hpp.

◆ getRecordsFromCollection() [16/20]

template<typename TResponse >
GetRecordsFromCollectionResponse<TResponse>& gpudb::GPUdb::getRecordsFromCollection ( const Type type_,
const GetRecordsFromCollectionRequest request_,
GetRecordsFromCollectionResponse< TResponse > &  response_ 
) const
inline

Retrieves records from a collection.

The operation can optionally return the record IDs which can be used in certain queries such as deleteRecords.

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 views using this operation. (DEPRECATED)

Template Parameters
TResponseThe type of object being retrieved.
Parameters
[in]type_Type object used for decoding returned objects.
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

Definition at line 31334 of file GPUdb.hpp.

◆ getRecordsFromCollection() [17/20]

template<typename TResponse >
GetRecordsFromCollectionResponse<TResponse> gpudb::GPUdb::getRecordsFromCollection ( const ::avro::ValidSchema &  schema_,
const std::string &  tableName,
const int64_t  offset,
const int64_t  limit,
const std::map< std::string, std::string > &  options 
) const
inline

Retrieves records from a collection.

The operation can optionally return the record IDs which can be used in certain queries such as deleteRecords.

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 views using this operation. (DEPRECATED)

Template Parameters
TResponseThe type of object being retrieved.
Parameters
[in]schema_Avro schema object used for decoding returned objects.
[in]tableNameName of the collection or table from which records are to be retrieved, in [schema_name.]table_name format, using standard name resolution rules. Must be an existing collection or table.
[in]offsetA positive integer indicating the number of initial results to skip (this can be useful for paging through the results). The 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 maximum number of results allowed by the server should be returned. The number of records returned will never exceed the server's own limit, defined by the max_get_records_size parameter in the server configuration. Use offset & limit to request subsequent pages of results. The default value is -9999.
[in]options The default value is an empty map.
Returns
Response object containing the result of the operation.

Definition at line 31418 of file GPUdb.hpp.

◆ getRecordsFromCollection() [18/20]

template<typename TResponse >
GetRecordsFromCollectionResponse<TResponse> gpudb::GPUdb::getRecordsFromCollection ( const Type type_,
const std::string &  tableName,
const int64_t  offset,
const int64_t  limit,
const std::map< std::string, std::string > &  options 
) const
inline

Retrieves records from a collection.

The operation can optionally return the record IDs which can be used in certain queries such as deleteRecords.

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 views using this operation. (DEPRECATED)

Template Parameters
TResponseThe type of object being retrieved.
Parameters
[in]type_Type object used for decoding returned objects.
[in]tableNameName of the collection or table from which records are to be retrieved, in [schema_name.]table_name format, using standard name resolution rules. Must be an existing collection or table.
[in]offsetA positive integer indicating the number of initial results to skip (this can be useful for paging through the results). The 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 maximum number of results allowed by the server should be returned. The number of records returned will never exceed the server's own limit, defined by the max_get_records_size parameter in the server configuration. Use offset & limit to request subsequent pages of results. The default value is -9999.
[in]options The default value is an empty map.
Returns
Response object containing the result of the operation.

Definition at line 31507 of file GPUdb.hpp.

◆ getRecordsFromCollection() [19/20]

template<typename TResponse >
GetRecordsFromCollectionResponse<TResponse>& gpudb::GPUdb::getRecordsFromCollection ( const ::avro::ValidSchema &  schema_,
const std::string &  tableName,
const int64_t  offset,
const int64_t  limit,
const std::map< std::string, std::string > &  options,
GetRecordsFromCollectionResponse< TResponse > &  response_ 
) const
inline

Retrieves records from a collection.

The operation can optionally return the record IDs which can be used in certain queries such as deleteRecords.

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 views using this operation. (DEPRECATED)

Template Parameters
TResponseThe type of object being retrieved.
Parameters
[in]schema_Avro schema object used for decoding returned objects.
[in]tableNameName of the collection or table from which records are to be retrieved, in [schema_name.]table_name format, using standard name resolution rules. Must be an existing collection or table.
[in]offsetA positive integer indicating the number of initial results to skip (this can be useful for paging through the results). The 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 maximum number of results allowed by the server should be returned. The number of records returned will never exceed the server's own limit, defined by the max_get_records_size parameter in the server configuration. Use offset & limit to request subsequent pages of results. The default value is -9999.
[in]options The default value is an empty map.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

Definition at line 31600 of file GPUdb.hpp.

◆ getRecordsFromCollection() [20/20]

template<typename TResponse >
GetRecordsFromCollectionResponse<TResponse>& gpudb::GPUdb::getRecordsFromCollection ( const Type type_,
const std::string &  tableName,
const int64_t  offset,
const int64_t  limit,
const std::map< std::string, std::string > &  options,
GetRecordsFromCollectionResponse< TResponse > &  response_ 
) const
inline

Retrieves records from a collection.

The operation can optionally return the record IDs which can be used in certain queries such as deleteRecords.

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 views using this operation. (DEPRECATED)

Template Parameters
TResponseThe type of object being retrieved.
Parameters
[in]type_Type object used for decoding returned objects.
[in]tableNameName of the collection or table from which records are to be retrieved, in [schema_name.]table_name format, using standard name resolution rules. Must be an existing collection or table.
[in]offsetA positive integer indicating the number of initial results to skip (this can be useful for paging through the results). The 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 maximum number of results allowed by the server should be returned. The number of records returned will never exceed the server's own limit, defined by the max_get_records_size parameter in the server configuration. Use offset & limit to request subsequent pages of results. The default value is -9999.
[in]options The default value is an empty map.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

Definition at line 31693 of file GPUdb.hpp.

◆ getRecordsFromCollectionRaw() [1/2]

RawGetRecordsFromCollectionResponse gpudb::GPUdb::getRecordsFromCollectionRaw ( const GetRecordsFromCollectionRequest request_) const

Retrieves records from a collection.

The operation can optionally return the record IDs which can be used in certain queries such as deleteRecords.

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 views using this operation. (DEPRECATED)

Parameters
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

◆ getRecordsFromCollectionRaw() [2/2]

RawGetRecordsFromCollectionResponse& gpudb::GPUdb::getRecordsFromCollectionRaw ( const GetRecordsFromCollectionRequest request_,
RawGetRecordsFromCollectionResponse response_ 
) const

Retrieves records from a collection.

The operation can optionally return the record IDs which can be used in certain queries such as deleteRecords.

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 views using this operation. (DEPRECATED)

Parameters
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ getRecordsRaw() [1/2]

RawGetRecordsResponse gpudb::GPUdb::getRecordsRaw ( const GetRecordsRequest request_) const

Retrieves records from a given table, optionally filtered by an expression and/or sorted by a column.

This operation can be performed on tables and views. Records can be returned encoded as binary, json, or geojson.

This operation supports paging through the data via the offset and limit parameters. Note that when paging through a table, if the table (or the underlying table in case of a view) is updated (records are inserted, deleted or modified) the records retrieved may differ between calls based on the updates applied.

Parameters
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

◆ getRecordsRaw() [2/2]

RawGetRecordsResponse& gpudb::GPUdb::getRecordsRaw ( const GetRecordsRequest request_,
RawGetRecordsResponse response_ 
) const

Retrieves records from a given table, optionally filtered by an expression and/or sorted by a column.

This operation can be performed on tables and views. Records can be returned encoded as binary, json, or geojson.

This operation supports paging through the data via the offset and limit parameters. Note that when paging through a table, if the table (or the underlying table in case of a view) is updated (records are inserted, deleted or modified) the records retrieved may differ between calls based on the updates applied.

Parameters
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ getSslContext()

boost::asio::ssl::context* gpudb::GPUdb::getSslContext ( ) const

◆ getThreadCount()

size_t gpudb::GPUdb::getThreadCount ( ) const

◆ getTimeout()

size_t gpudb::GPUdb::getTimeout ( ) const

◆ getUrl()

const HttpUrl& gpudb::GPUdb::getUrl ( ) const

◆ getUrls()

const std::vector<HttpUrl>& gpudb::GPUdb::getUrls ( ) const

◆ getUsername()

const std::string& gpudb::GPUdb::getUsername ( ) const

◆ getUseSnappy()

bool gpudb::GPUdb::getUseSnappy ( ) const

◆ grantPermission() [1/4]

GrantPermissionResponse gpudb::GPUdb::grantPermission ( const GrantPermissionRequest request_) const

Grant user or role the specified permission on the specified object.

Parameters
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

◆ grantPermission() [2/4]

GrantPermissionResponse& gpudb::GPUdb::grantPermission ( const GrantPermissionRequest request_,
GrantPermissionResponse response_ 
) const

Grant user or role the specified permission on the specified object.

Parameters
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ grantPermission() [3/4]

GrantPermissionResponse gpudb::GPUdb::grantPermission ( const std::string &  principal,
const std::string &  object,
const std::string &  objectType,
const std::string &  permission,
const std::map< std::string, std::string > &  options 
) const

Grant user or role the specified permission on the specified object.

Parameters
[in]principalName of the user or role for which the permission is being granted. Must be an existing user or role. The default value is ''.
[in]objectName of object permission is being granted to. It is recommended to use a fully-qualified name when possible.
[in]objectTypeThe type of object being granted to. Supported values:
[in]permissionPermission being granted. Supported values:
[in]optionsOptional parameters. The default value is an empty map.
Returns
Response object containing the result of the operation.

◆ grantPermission() [4/4]

GrantPermissionResponse& gpudb::GPUdb::grantPermission ( const std::string &  principal,
const std::string &  object,
const std::string &  objectType,
const std::string &  permission,
const std::map< std::string, std::string > &  options,
GrantPermissionResponse response_ 
) const

Grant user or role the specified permission on the specified object.

Parameters
[in]principalName of the user or role for which the permission is being granted. Must be an existing user or role. The default value is ''.
[in]objectName of object permission is being granted to. It is recommended to use a fully-qualified name when possible.
[in]objectTypeThe type of object being granted to. Supported values:
[in]permissionPermission being granted. Supported values:
[in]optionsOptional parameters. The default value is an empty map.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ grantPermissionCredential() [1/4]

GrantPermissionCredentialResponse gpudb::GPUdb::grantPermissionCredential ( const GrantPermissionCredentialRequest request_) const

Grants a credential-level permission to a user or role.

Parameters
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

◆ grantPermissionCredential() [2/4]

GrantPermissionCredentialResponse& gpudb::GPUdb::grantPermissionCredential ( const GrantPermissionCredentialRequest request_,
GrantPermissionCredentialResponse response_ 
) const

Grants a credential-level permission to a user or role.

Parameters
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ grantPermissionCredential() [3/4]

GrantPermissionCredentialResponse gpudb::GPUdb::grantPermissionCredential ( const std::string &  name,
const std::string &  permission,
const std::string &  credentialName,
const std::map< std::string, std::string > &  options 
) const

Grants a credential-level permission to a user or role.

Parameters
[in]nameName of the user or role to which the permission will be granted. Must be an existing user or role.
[in]permissionPermission to grant to the user or role. Supported values:
[in]credentialNameName of the credential on which the permission will be granted. Must be an existing credential, or an empty string to grant access on all credentials.
[in]optionsOptional parameters. The default value is an empty map.
Returns
Response object containing the result of the operation.

◆ grantPermissionCredential() [4/4]

GrantPermissionCredentialResponse& gpudb::GPUdb::grantPermissionCredential ( const std::string &  name,
const std::string &  permission,
const std::string &  credentialName,
const std::map< std::string, std::string > &  options,
GrantPermissionCredentialResponse response_ 
) const

Grants a credential-level permission to a user or role.

Parameters
[in]nameName of the user or role to which the permission will be granted. Must be an existing user or role.
[in]permissionPermission to grant to the user or role. Supported values:
[in]credentialNameName of the credential on which the permission will be granted. Must be an existing credential, or an empty string to grant access on all credentials.
[in]optionsOptional parameters. The default value is an empty map.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ grantPermissionDatasource() [1/4]

GrantPermissionDatasourceResponse gpudb::GPUdb::grantPermissionDatasource ( const GrantPermissionDatasourceRequest request_) const

Grants a data source permission to a user or role.

Parameters
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

◆ grantPermissionDatasource() [2/4]

GrantPermissionDatasourceResponse& gpudb::GPUdb::grantPermissionDatasource ( const GrantPermissionDatasourceRequest request_,
GrantPermissionDatasourceResponse response_ 
) const

Grants a data source permission to a user or role.

Parameters
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ grantPermissionDatasource() [3/4]

GrantPermissionDatasourceResponse gpudb::GPUdb::grantPermissionDatasource ( const std::string &  name,
const std::string &  permission,
const std::string &  datasourceName,
const std::map< std::string, std::string > &  options 
) const

Grants a data source permission to a user or role.

Parameters
[in]nameName of the user or role to which the permission will be granted. Must be an existing user or role.
[in]permissionPermission to grant to the user or role. Supported values:
[in]datasourceNameName of the data source on which the permission will be granted. Must be an existing data source, or an empty string to grant permission on all data sources.
[in]optionsOptional parameters. The default value is an empty map.
Returns
Response object containing the result of the operation.

◆ grantPermissionDatasource() [4/4]

GrantPermissionDatasourceResponse& gpudb::GPUdb::grantPermissionDatasource ( const std::string &  name,
const std::string &  permission,
const std::string &  datasourceName,
const std::map< std::string, std::string > &  options,
GrantPermissionDatasourceResponse response_ 
) const

Grants a data source permission to a user or role.

Parameters
[in]nameName of the user or role to which the permission will be granted. Must be an existing user or role.
[in]permissionPermission to grant to the user or role. Supported values:
[in]datasourceNameName of the data source on which the permission will be granted. Must be an existing data source, or an empty string to grant permission on all data sources.
[in]optionsOptional parameters. The default value is an empty map.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ grantPermissionDirectory() [1/4]

GrantPermissionDirectoryResponse gpudb::GPUdb::grantPermissionDirectory ( const GrantPermissionDirectoryRequest request_) const

Grants a KiFS directory-level permission to a user or role.

Parameters
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

◆ grantPermissionDirectory() [2/4]

GrantPermissionDirectoryResponse& gpudb::GPUdb::grantPermissionDirectory ( const GrantPermissionDirectoryRequest request_,
GrantPermissionDirectoryResponse response_ 
) const

Grants a KiFS directory-level permission to a user or role.

Parameters
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ grantPermissionDirectory() [3/4]

GrantPermissionDirectoryResponse gpudb::GPUdb::grantPermissionDirectory ( const std::string &  name,
const std::string &  permission,
const std::string &  directoryName,
const std::map< std::string, std::string > &  options 
) const

Grants a KiFS directory-level permission to a user or role.

Parameters
[in]nameName of the user or role to which the permission will be granted. Must be an existing user or role.
[in]permissionPermission to grant to the user or role. Supported values:
[in]directoryNameName of the KiFS directory to which the permission grants access. An empty directory name grants access to all KiFS directories
[in]optionsOptional parameters. The default value is an empty map.
Returns
Response object containing the result of the operation.

◆ grantPermissionDirectory() [4/4]

GrantPermissionDirectoryResponse& gpudb::GPUdb::grantPermissionDirectory ( const std::string &  name,
const std::string &  permission,
const std::string &  directoryName,
const std::map< std::string, std::string > &  options,
GrantPermissionDirectoryResponse response_ 
) const

Grants a KiFS directory-level permission to a user or role.

Parameters
[in]nameName of the user or role to which the permission will be granted. Must be an existing user or role.
[in]permissionPermission to grant to the user or role. Supported values:
[in]directoryNameName of the KiFS directory to which the permission grants access. An empty directory name grants access to all KiFS directories
[in]optionsOptional parameters. The default value is an empty map.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ grantPermissionProc() [1/4]

GrantPermissionProcResponse gpudb::GPUdb::grantPermissionProc ( const GrantPermissionProcRequest request_) const

Grants a proc-level permission to a user or role.

Parameters
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

◆ grantPermissionProc() [2/4]

GrantPermissionProcResponse& gpudb::GPUdb::grantPermissionProc ( const GrantPermissionProcRequest request_,
GrantPermissionProcResponse response_ 
) const

Grants a proc-level permission to a user or role.

Parameters
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ grantPermissionProc() [3/4]

GrantPermissionProcResponse gpudb::GPUdb::grantPermissionProc ( const std::string &  name,
const std::string &  permission,
const std::string &  procName,
const std::map< std::string, std::string > &  options 
) const

Grants a proc-level permission to a user or role.

Parameters
[in]nameName of the user or role to which the permission will be granted. Must be an existing user or role.
[in]permissionPermission to grant to the user or role. Supported values:
[in]procNameName of the proc to which the permission grants access. Must be an existing proc, or an empty string to grant access to all procs.
[in]optionsOptional parameters. The default value is an empty map.
Returns
Response object containing the result of the operation.

◆ grantPermissionProc() [4/4]

GrantPermissionProcResponse& gpudb::GPUdb::grantPermissionProc ( const std::string &  name,
const std::string &  permission,
const std::string &  procName,
const std::map< std::string, std::string > &  options,
GrantPermissionProcResponse response_ 
) const

Grants a proc-level permission to a user or role.

Parameters
[in]nameName of the user or role to which the permission will be granted. Must be an existing user or role.
[in]permissionPermission to grant to the user or role. Supported values:
[in]procNameName of the proc to which the permission grants access. Must be an existing proc, or an empty string to grant access to all procs.
[in]optionsOptional parameters. The default value is an empty map.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ grantPermissionSystem() [1/4]

GrantPermissionSystemResponse gpudb::GPUdb::grantPermissionSystem ( const GrantPermissionSystemRequest request_) const

Grants a system-level permission to a user or role.

Parameters
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

◆ grantPermissionSystem() [2/4]

GrantPermissionSystemResponse& gpudb::GPUdb::grantPermissionSystem ( const GrantPermissionSystemRequest request_,
GrantPermissionSystemResponse response_ 
) const

Grants a system-level permission to a user or role.

Parameters
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ grantPermissionSystem() [3/4]

GrantPermissionSystemResponse gpudb::GPUdb::grantPermissionSystem ( const std::string &  name,
const std::string &  permission,
const std::map< std::string, std::string > &  options 
) const

Grants a system-level permission to a user or role.

Parameters
[in]nameName of the user or role to which the permission will be granted. Must be an existing user or role.
[in]permissionPermission to grant to the user or role. Supported values:
[in]optionsOptional parameters. The default value is an empty map.
Returns
Response object containing the result of the operation.

◆ grantPermissionSystem() [4/4]

GrantPermissionSystemResponse& gpudb::GPUdb::grantPermissionSystem ( const std::string &  name,
const std::string &  permission,
const std::map< std::string, std::string > &  options,
GrantPermissionSystemResponse response_ 
) const

Grants a system-level permission to a user or role.

Parameters
[in]nameName of the user or role to which the permission will be granted. Must be an existing user or role.
[in]permissionPermission to grant to the user or role. Supported values:
[in]optionsOptional parameters. The default value is an empty map.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ grantPermissionTable() [1/4]

GrantPermissionTableResponse gpudb::GPUdb::grantPermissionTable ( const GrantPermissionTableRequest request_) const

Grants a table-level permission to a user or role.

Parameters
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

◆ grantPermissionTable() [2/4]

GrantPermissionTableResponse& gpudb::GPUdb::grantPermissionTable ( const GrantPermissionTableRequest request_,
GrantPermissionTableResponse response_ 
) const

Grants a table-level permission to a user or role.

Parameters
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ grantPermissionTable() [3/4]

GrantPermissionTableResponse gpudb::GPUdb::grantPermissionTable ( const std::string &  name,
const std::string &  permission,
const std::string &  tableName,
const std::string &  filterExpression,
const std::map< std::string, std::string > &  options 
) const

Grants a table-level permission to a user or role.

Parameters
[in]nameName of the user or role to which the permission will be granted. Must be an existing user or role.
[in]permissionPermission to grant to the user or role. Supported values:
[in]tableNameName of the table to which the permission grants access, in [schema_name.]table_name format, using standard name resolution rules. Must be an existing table, view, or schema. If a schema, the permission also applies to tables and views in the schema.
[in]filterExpressionOptional filter expression to apply to this grant. Only rows that match the filter will be affected. The default value is ''.
[in]optionsOptional parameters. The default value is an empty map.
Returns
Response object containing the result of the operation.

◆ grantPermissionTable() [4/4]

GrantPermissionTableResponse& gpudb::GPUdb::grantPermissionTable ( const std::string &  name,
const std::string &  permission,
const std::string &  tableName,
const std::string &  filterExpression,
const std::map< std::string, std::string > &  options,
GrantPermissionTableResponse response_ 
) const

Grants a table-level permission to a user or role.

Parameters
[in]nameName of the user or role to which the permission will be granted. Must be an existing user or role.
[in]permissionPermission to grant to the user or role. Supported values:
[in]tableNameName of the table to which the permission grants access, in [schema_name.]table_name format, using standard name resolution rules. Must be an existing table, view, or schema. If a schema, the permission also applies to tables and views in the schema.
[in]filterExpressionOptional filter expression to apply to this grant. Only rows that match the filter will be affected. The default value is ''.
[in]optionsOptional parameters. The default value is an empty map.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ grantRole() [1/4]

GrantRoleResponse gpudb::GPUdb::grantRole ( const GrantRoleRequest request_) const

Grants membership in a role to a user or role.

Parameters
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

◆ grantRole() [2/4]

GrantRoleResponse& gpudb::GPUdb::grantRole ( const GrantRoleRequest request_,
GrantRoleResponse response_ 
) const

Grants membership in a role to a user or role.

Parameters
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ grantRole() [3/4]

GrantRoleResponse gpudb::GPUdb::grantRole ( const std::string &  role,
const std::string &  member,
const std::map< std::string, std::string > &  options 
) const

Grants membership in a role to a user or role.

Parameters
[in]roleName of the role in which membership will be granted. Must be an existing role.
[in]memberName of the user or role that will be granted membership in role. Must be an existing user or role.
[in]optionsOptional parameters. The default value is an empty map.
Returns
Response object containing the result of the operation.

◆ grantRole() [4/4]

GrantRoleResponse& gpudb::GPUdb::grantRole ( const std::string &  role,
const std::string &  member,
const std::map< std::string, std::string > &  options,
GrantRoleResponse response_ 
) const

Grants membership in a role to a user or role.

Parameters
[in]roleName of the role in which membership will be granted. Must be an existing role.
[in]memberName of the user or role that will be granted membership in role. Must be an existing user or role.
[in]optionsOptional parameters. The default value is an empty map.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ hasPermission() [1/4]

HasPermissionResponse gpudb::GPUdb::hasPermission ( const HasPermissionRequest request_) const

Checks if the specified user has the specified permission on the specified object.

Parameters
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

◆ hasPermission() [2/4]

HasPermissionResponse& gpudb::GPUdb::hasPermission ( const HasPermissionRequest request_,
HasPermissionResponse response_ 
) const

Checks if the specified user has the specified permission on the specified object.

Parameters
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ hasPermission() [3/4]

HasPermissionResponse gpudb::GPUdb::hasPermission ( const std::string &  principal,
const std::string &  object,
const std::string &  objectType,
const std::string &  permission,
const std::map< std::string, std::string > &  options 
) const

Checks if the specified user has the specified permission on the specified object.

Parameters
[in]principalName of the user for which the permission is being checked. Must be an existing user. If blank, will use the current user. The default value is ''.
[in]objectName of object to check for the requested permission. It is recommended to use a fully-qualified name when possible.
[in]objectTypeThe type of object being checked. Supported values:
[in]permissionPermission to check for. Supported values:
[in]optionsOptional parameters. The default value is an empty map.
Returns
Response object containing the result of the operation.

◆ hasPermission() [4/4]

HasPermissionResponse& gpudb::GPUdb::hasPermission ( const std::string &  principal,
const std::string &  object,
const std::string &  objectType,
const std::string &  permission,
const std::map< std::string, std::string > &  options,
HasPermissionResponse response_ 
) const

Checks if the specified user has the specified permission on the specified object.

Parameters
[in]principalName of the user for which the permission is being checked. Must be an existing user. If blank, will use the current user. The default value is ''.
[in]objectName of object to check for the requested permission. It is recommended to use a fully-qualified name when possible.
[in]objectTypeThe type of object being checked. Supported values:
[in]permissionPermission to check for. Supported values:
[in]optionsOptional parameters. The default value is an empty map.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ hasProc() [1/4]

HasProcResponse gpudb::GPUdb::hasProc ( const HasProcRequest request_) const

Checks the existence of a proc with the given name.

Parameters
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

◆ hasProc() [2/4]

HasProcResponse& gpudb::GPUdb::hasProc ( const HasProcRequest request_,
HasProcResponse response_ 
) const

Checks the existence of a proc with the given name.

Parameters
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ hasProc() [3/4]

HasProcResponse gpudb::GPUdb::hasProc ( const std::string &  procName,
const std::map< std::string, std::string > &  options 
) const

Checks the existence of a proc with the given name.

Parameters
[in]procNameName of the proc to check for existence.
[in]optionsOptional parameters. The default value is an empty map.
Returns
Response object containing the result of the operation.

◆ hasProc() [4/4]

HasProcResponse& gpudb::GPUdb::hasProc ( const std::string &  procName,
const std::map< std::string, std::string > &  options,
HasProcResponse response_ 
) const

Checks the existence of a proc with the given name.

Parameters
[in]procNameName of the proc to check for existence.
[in]optionsOptional parameters. The default value is an empty map.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ hasRole() [1/4]

HasRoleResponse gpudb::GPUdb::hasRole ( const HasRoleRequest request_) const

Checks if the specified user has the specified role.

Parameters
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

◆ hasRole() [2/4]

HasRoleResponse& gpudb::GPUdb::hasRole ( const HasRoleRequest request_,
HasRoleResponse response_ 
) const

Checks if the specified user has the specified role.

Parameters
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ hasRole() [3/4]

HasRoleResponse gpudb::GPUdb::hasRole ( const std::string &  principal,
const std::string &  role,
const std::map< std::string, std::string > &  options 
) const

Checks if the specified user has the specified role.

Parameters
[in]principalName of the user for which role membersih is being checked. Must be an existing user. If blank, will use the current user. The default value is ''.
[in]roleName of role to check for membership.
[in]optionsOptional parameters. The default value is an empty map.
Returns
Response object containing the result of the operation.

◆ hasRole() [4/4]

HasRoleResponse& gpudb::GPUdb::hasRole ( const std::string &  principal,
const std::string &  role,
const std::map< std::string, std::string > &  options,
HasRoleResponse response_ 
) const

Checks if the specified user has the specified role.

Parameters
[in]principalName of the user for which role membersih is being checked. Must be an existing user. If blank, will use the current user. The default value is ''.
[in]roleName of role to check for membership.
[in]optionsOptional parameters. The default value is an empty map.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ hasSchema() [1/4]

HasSchemaResponse gpudb::GPUdb::hasSchema ( const HasSchemaRequest request_) const

Checks for the existence of a schema with the given name.

Parameters
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

◆ hasSchema() [2/4]

HasSchemaResponse& gpudb::GPUdb::hasSchema ( const HasSchemaRequest request_,
HasSchemaResponse response_ 
) const

Checks for the existence of a schema with the given name.

Parameters
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ hasSchema() [3/4]

HasSchemaResponse gpudb::GPUdb::hasSchema ( const std::string &  schemaName,
const std::map< std::string, std::string > &  options 
) const

Checks for the existence of a schema with the given name.

Parameters
[in]schemaNameName of the schema to check for existence, in root, using standard name resolution rules.
[in]optionsOptional parameters. The default value is an empty map.
Returns
Response object containing the result of the operation.

◆ hasSchema() [4/4]

HasSchemaResponse& gpudb::GPUdb::hasSchema ( const std::string &  schemaName,
const std::map< std::string, std::string > &  options,
HasSchemaResponse response_ 
) const

Checks for the existence of a schema with the given name.

Parameters
[in]schemaNameName of the schema to check for existence, in root, using standard name resolution rules.
[in]optionsOptional parameters. The default value is an empty map.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ hasTable() [1/4]

HasTableResponse gpudb::GPUdb::hasTable ( const HasTableRequest request_) const

Checks for the existence of a table with the given name.

Parameters
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

◆ hasTable() [2/4]

HasTableResponse& gpudb::GPUdb::hasTable ( const HasTableRequest request_,
HasTableResponse response_ 
) const

Checks for the existence of a table with the given name.

Parameters
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ hasTable() [3/4]

HasTableResponse gpudb::GPUdb::hasTable ( const std::string &  tableName,
const std::map< std::string, std::string > &  options 
) const

Checks for the existence of a table with the given name.

Parameters
[in]tableNameName of the table to check for existence, in [schema_name.]table_name format, using standard name resolution rules.
[in]optionsOptional parameters. The default value is an empty map.
Returns
Response object containing the result of the operation.

◆ hasTable() [4/4]

HasTableResponse& gpudb::GPUdb::hasTable ( const std::string &  tableName,
const std::map< std::string, std::string > &  options,
HasTableResponse response_ 
) const

Checks for the existence of a table with the given name.

Parameters
[in]tableNameName of the table to check for existence, in [schema_name.]table_name format, using standard name resolution rules.
[in]optionsOptional parameters. The default value is an empty map.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ hasType() [1/4]

HasTypeResponse gpudb::GPUdb::hasType ( const HasTypeRequest request_) const

Check for the existence of a type.

Parameters
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

◆ hasType() [2/4]

HasTypeResponse& gpudb::GPUdb::hasType ( const HasTypeRequest request_,
HasTypeResponse response_ 
) const

Check for the existence of a type.

Parameters
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ hasType() [3/4]

HasTypeResponse gpudb::GPUdb::hasType ( const std::string &  typeId,
const std::map< std::string, std::string > &  options 
) const

Check for the existence of a type.

Parameters
[in]typeIdId of the type returned in response to createType request.
[in]optionsOptional parameters. The default value is an empty map.
Returns
Response object containing the result of the operation.

◆ hasType() [4/4]

HasTypeResponse& gpudb::GPUdb::hasType ( const std::string &  typeId,
const std::map< std::string, std::string > &  options,
HasTypeResponse response_ 
) const

Check for the existence of a type.

Parameters
[in]typeIdId of the type returned in response to createType request.
[in]optionsOptional parameters. The default value is an empty map.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ insertRecords() [1/4]

template<typename TRequest >
InsertRecordsResponse gpudb::GPUdb::insertRecords ( const InsertRecordsRequest< TRequest > &  request_) const
inline

Adds multiple records to the specified table.

The operation is synchronous, meaning that a response will not be returned until all the records are fully inserted and available. The response payload provides the counts of the number of records actually inserted and/or updated, and can provide the unique identifier of each added record.

The options parameter can be used to customize this function's behavior.

The update_on_existing_pk option specifies the record collision policy for inserting into a table with a primary key, but is ignored if no primary key exists.

The return_record_ids option indicates that the database should return the unique identifiers of inserted records.

Template Parameters
TRequestThe type of object being added.
Parameters
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

Definition at line 33401 of file GPUdb.hpp.

◆ insertRecords() [2/4]

template<typename TRequest >
InsertRecordsResponse& gpudb::GPUdb::insertRecords ( const InsertRecordsRequest< TRequest > &  request_,
InsertRecordsResponse response_ 
) const
inline

Adds multiple records to the specified table.

The operation is synchronous, meaning that a response will not be returned until all the records are fully inserted and available. The response payload provides the counts of the number of records actually inserted and/or updated, and can provide the unique identifier of each added record.

The options parameter can be used to customize this function's behavior.

The update_on_existing_pk option specifies the record collision policy for inserting into a table with a primary key, but is ignored if no primary key exists.

The return_record_ids option indicates that the database should return the unique identifiers of inserted records.

Template Parameters
TRequestThe type of object being added.
Parameters
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

Definition at line 33442 of file GPUdb.hpp.

◆ insertRecords() [3/4]

template<typename TRequest >
InsertRecordsResponse gpudb::GPUdb::insertRecords ( const std::string &  tableName,
const std::vector< TRequest > &  data,
const std::map< std::string, std::string > &  options 
) const
inline

Adds multiple records to the specified table.

The operation is synchronous, meaning that a response will not be returned until all the records are fully inserted and available. The response payload provides the counts of the number of records actually inserted and/or updated, and can provide the unique identifier of each added record.

The options parameter can be used to customize this function's behavior.

The update_on_existing_pk option specifies the record collision policy for inserting into a table with a primary key, but is ignored if no primary key exists.

The return_record_ids option indicates that the database should return the unique identifiers of inserted records.

Template Parameters
TRequestThe type of object being added.
Parameters
[in]tableNameName of table to which the records are to be added, in [schema_name.]table_name format, using standard name resolution rules. Must be an existing table.
[in]dataAn array of binary-encoded data for the records to be added. All records must be of the same type as that of the table. Empty array if listEncoding is json.
[in]optionsOptional parameters. The default value is an empty map.
Returns
Response object containing the result of the operation.

Definition at line 33652 of file GPUdb.hpp.

◆ insertRecords() [4/4]

template<typename TRequest >
InsertRecordsResponse& gpudb::GPUdb::insertRecords ( const std::string &  tableName,
const std::vector< TRequest > &  data,
const std::map< std::string, std::string > &  options,
InsertRecordsResponse response_ 
) const
inline

Adds multiple records to the specified table.

The operation is synchronous, meaning that a response will not be returned until all the records are fully inserted and available. The response payload provides the counts of the number of records actually inserted and/or updated, and can provide the unique identifier of each added record.

The options parameter can be used to customize this function's behavior.

The update_on_existing_pk option specifies the record collision policy for inserting into a table with a primary key, but is ignored if no primary key exists.

The return_record_ids option indicates that the database should return the unique identifiers of inserted records.

Template Parameters
TRequestThe type of object being added.
Parameters
[in]tableNameName of table to which the records are to be added, in [schema_name.]table_name format, using standard name resolution rules. Must be an existing table.
[in]dataAn array of binary-encoded data for the records to be added. All records must be of the same type as that of the table. Empty array if listEncoding is json.
[in]optionsOptional parameters. The default value is an empty map.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

Definition at line 33866 of file GPUdb.hpp.

◆ insertRecordsFromFiles() [1/4]

InsertRecordsFromFilesResponse gpudb::GPUdb::insertRecordsFromFiles ( const InsertRecordsFromFilesRequest request_) const

Reads from one or more files and inserts the data into a new or existing table.

The source data can be located either in KiFS; on the cluster, accessible to the database; or remotely, accessible via a pre-defined external data source.

For delimited text files, there are two loading schemes: positional and name-based. The name-based loading scheme is enabled when the file has a header present and text_has_header is set to true. In this scheme, the source file(s) field names must match the target table's column names exactly; however, the source file can have more fields than the target table has columns. If error_handling is set to permissive, the source file can have fewer fields than the target table has columns. If the name-based loading scheme is being used, names matching the file header's names may be provided to columns_to_load instead of numbers, but ranges are not supported.

Note: Due to data being loaded in parallel, there is no insertion order guaranteed. For tables with primary keys, in the case of a primary key collision, this means it is indeterminate which record will be inserted first and remain, while the rest of the colliding key records are discarded.

Returns once all files are processed.

Parameters
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

◆ insertRecordsFromFiles() [2/4]

InsertRecordsFromFilesResponse& gpudb::GPUdb::insertRecordsFromFiles ( const InsertRecordsFromFilesRequest request_,
InsertRecordsFromFilesResponse response_ 
) const

Reads from one or more files and inserts the data into a new or existing table.

The source data can be located either in KiFS; on the cluster, accessible to the database; or remotely, accessible via a pre-defined external data source.

For delimited text files, there are two loading schemes: positional and name-based. The name-based loading scheme is enabled when the file has a header present and text_has_header is set to true. In this scheme, the source file(s) field names must match the target table's column names exactly; however, the source file can have more fields than the target table has columns. If error_handling is set to permissive, the source file can have fewer fields than the target table has columns. If the name-based loading scheme is being used, names matching the file header's names may be provided to columns_to_load instead of numbers, but ranges are not supported.

Note: Due to data being loaded in parallel, there is no insertion order guaranteed. For tables with primary keys, in the case of a primary key collision, this means it is indeterminate which record will be inserted first and remain, while the rest of the colliding key records are discarded.

Returns once all files are processed.

Parameters
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ insertRecordsFromFiles() [3/4]

InsertRecordsFromFilesResponse gpudb::GPUdb::insertRecordsFromFiles ( const std::string &  tableName,
const std::vector< std::string > &  filepaths,
const std::map< std::string, std::map< std::string, std::string > > &  modifyColumns,
const std::map< std::string, std::string > &  createTableOptions,
const std::map< std::string, std::string > &  options 
) const

Reads from one or more files and inserts the data into a new or existing table.

The source data can be located either in KiFS; on the cluster, accessible to the database; or remotely, accessible via a pre-defined external data source.

For delimited text files, there are two loading schemes: positional and name-based. The name-based loading scheme is enabled when the file has a header present and text_has_header is set to true. In this scheme, the source file(s) field names must match the target table's column names exactly; however, the source file can have more fields than the target table has columns. If error_handling is set to permissive, the source file can have fewer fields than the target table has columns. If the name-based loading scheme is being used, names matching the file header's names may be provided to columns_to_load instead of numbers, but ranges are not supported.

Note: Due to data being loaded in parallel, there is no insertion order guaranteed. For tables with primary keys, in the case of a primary key collision, this means it is indeterminate which record will be inserted first and remain, while the rest of the colliding key records are discarded.

Returns once all files are processed.

Parameters
[in]tableNameName of the table into which the data will be inserted, in [schema_name.]table_name format, using standard name resolution rules. If the table does not exist, the table will be created using either an existing type_id or the type inferred from the file, and the new table name will have to meet standard table naming criteria.
[in]filepathsA list of file paths from which data will be sourced; For paths in KiFS, use the uri prefix of kifs:// followed by the path to a file or directory. File matching by prefix is supported, e.g. kifs://dir/file would match dir/file_1 and dir/file_2. When prefix matching is used, the path must start with a full, valid KiFS directory name. If an external data source is specified in datasource_name, these file paths must resolve to accessible files at that data source location. Prefix matching is supported. If the data source is hdfs, prefixes must be aligned with directories, i.e. partial file names will not match. If no data source is specified, the files are assumed to be local to the database and must all be accessible to the gpudb user, residing on the path (or relative to the path) specified by the external files directory in the Kinetica configuration file. Wildcards (*) can be used to specify a group of files. Prefix matching is supported, the prefixes must be aligned with directories. If the first path ends in .tsv, the text delimiter will be defaulted to a tab character. If the first path ends in .psv, the text delimiter will be defaulted to a pipe character (|).
[in]modifyColumnsNot implemented yet. The default value is an empty map.
[in]createTableOptionsOptions from createTable, allowing the structure of the table to be defined independently of the data source, when creating the target table. The default value is an empty map.
[in]optionsOptional parameters. The default value is an empty map.
Returns
Response object containing the result of the operation.

◆ insertRecordsFromFiles() [4/4]

InsertRecordsFromFilesResponse& gpudb::GPUdb::insertRecordsFromFiles ( const std::string &  tableName,
const std::vector< std::string > &  filepaths,
const std::map< std::string, std::map< std::string, std::string > > &  modifyColumns,
const std::map< std::string, std::string > &  createTableOptions,
const std::map< std::string, std::string > &  options,
InsertRecordsFromFilesResponse response_ 
) const

Reads from one or more files and inserts the data into a new or existing table.

The source data can be located either in KiFS; on the cluster, accessible to the database; or remotely, accessible via a pre-defined external data source.

For delimited text files, there are two loading schemes: positional and name-based. The name-based loading scheme is enabled when the file has a header present and text_has_header is set to true. In this scheme, the source file(s) field names must match the target table's column names exactly; however, the source file can have more fields than the target table has columns. If error_handling is set to permissive, the source file can have fewer fields than the target table has columns. If the name-based loading scheme is being used, names matching the file header's names may be provided to columns_to_load instead of numbers, but ranges are not supported.

Note: Due to data being loaded in parallel, there is no insertion order guaranteed. For tables with primary keys, in the case of a primary key collision, this means it is indeterminate which record will be inserted first and remain, while the rest of the colliding key records are discarded.

Returns once all files are processed.

Parameters
[in]tableNameName of the table into which the data will be inserted, in [schema_name.]table_name format, using standard name resolution rules. If the table does not exist, the table will be created using either an existing type_id or the type inferred from the file, and the new table name will have to meet standard table naming criteria.
[in]filepathsA list of file paths from which data will be sourced; For paths in KiFS, use the uri prefix of kifs:// followed by the path to a file or directory. File matching by prefix is supported, e.g. kifs://dir/file would match dir/file_1 and dir/file_2. When prefix matching is used, the path must start with a full, valid KiFS directory name. If an external data source is specified in datasource_name, these file paths must resolve to accessible files at that data source location. Prefix matching is supported. If the data source is hdfs, prefixes must be aligned with directories, i.e. partial file names will not match. If no data source is specified, the files are assumed to be local to the database and must all be accessible to the gpudb user, residing on the path (or relative to the path) specified by the external files directory in the Kinetica configuration file. Wildcards (*) can be used to specify a group of files. Prefix matching is supported, the prefixes must be aligned with directories. If the first path ends in .tsv, the text delimiter will be defaulted to a tab character. If the first path ends in .psv, the text delimiter will be defaulted to a pipe character (|).
[in]modifyColumnsNot implemented yet. The default value is an empty map.
[in]createTableOptionsOptions from createTable, allowing the structure of the table to be defined independently of the data source, when creating the target table. The default value is an empty map.
[in]optionsOptional parameters. The default value is an empty map.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ insertRecordsFromPayload() [1/4]

InsertRecordsFromPayloadResponse gpudb::GPUdb::insertRecordsFromPayload ( const InsertRecordsFromPayloadRequest request_) const

Reads from the given text-based or binary payload and inserts the data into a new or existing table.

The table will be created if it doesn't already exist.

Returns once all records are processed.

Parameters
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

◆ insertRecordsFromPayload() [2/4]

InsertRecordsFromPayloadResponse& gpudb::GPUdb::insertRecordsFromPayload ( const InsertRecordsFromPayloadRequest request_,
InsertRecordsFromPayloadResponse response_ 
) const

Reads from the given text-based or binary payload and inserts the data into a new or existing table.

The table will be created if it doesn't already exist.

Returns once all records are processed.

Parameters
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ insertRecordsFromPayload() [3/4]

InsertRecordsFromPayloadResponse gpudb::GPUdb::insertRecordsFromPayload ( const std::string &  tableName,
const std::string &  dataText,
const std::vector< uint8_t > &  dataBytes,
const std::map< std::string, std::map< std::string, std::string > > &  modifyColumns,
const std::map< std::string, std::string > &  createTableOptions,
const std::map< std::string, std::string > &  options 
) const

Reads from the given text-based or binary payload and inserts the data into a new or existing table.

The table will be created if it doesn't already exist.

Returns once all records are processed.

Parameters
[in]tableNameName of the table into which the data will be inserted, in [schema_name.]table_name format, using standard name resolution rules. If the table does not exist, the table will be created using either an existing type_id or the type inferred from the payload, and the new table name will have to meet standard table naming criteria.
[in]dataTextRecords formatted as delimited text
[in]dataBytesRecords formatted as binary data
[in]modifyColumnsNot implemented yet. The default value is an empty map.
[in]createTableOptionsOptions used when creating the target table. Includes type to use. The other options match those in createTable. The default value is an empty map.
[in]optionsOptional parameters. The default value is an empty map.
Returns
Response object containing the result of the operation.

◆ insertRecordsFromPayload() [4/4]

InsertRecordsFromPayloadResponse& gpudb::GPUdb::insertRecordsFromPayload ( const std::string &  tableName,
const std::string &  dataText,
const std::vector< uint8_t > &  dataBytes,
const std::map< std::string, std::map< std::string, std::string > > &  modifyColumns,
const std::map< std::string, std::string > &  createTableOptions,
const std::map< std::string, std::string > &  options,
InsertRecordsFromPayloadResponse response_ 
) const

Reads from the given text-based or binary payload and inserts the data into a new or existing table.

The table will be created if it doesn't already exist.

Returns once all records are processed.

Parameters
[in]tableNameName of the table into which the data will be inserted, in [schema_name.]table_name format, using standard name resolution rules. If the table does not exist, the table will be created using either an existing type_id or the type inferred from the payload, and the new table name will have to meet standard table naming criteria.
[in]dataTextRecords formatted as delimited text
[in]dataBytesRecords formatted as binary data
[in]modifyColumnsNot implemented yet. The default value is an empty map.
[in]createTableOptionsOptions used when creating the target table. Includes type to use. The other options match those in createTable. The default value is an empty map.
[in]optionsOptional parameters. The default value is an empty map.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ insertRecordsFromQuery() [1/4]

InsertRecordsFromQueryResponse gpudb::GPUdb::insertRecordsFromQuery ( const InsertRecordsFromQueryRequest request_) const

Computes remote query result and inserts the result data into a new or existing table.

Parameters
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

◆ insertRecordsFromQuery() [2/4]

InsertRecordsFromQueryResponse& gpudb::GPUdb::insertRecordsFromQuery ( const InsertRecordsFromQueryRequest request_,
InsertRecordsFromQueryResponse response_ 
) const

Computes remote query result and inserts the result data into a new or existing table.

Parameters
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ insertRecordsFromQuery() [3/4]

InsertRecordsFromQueryResponse gpudb::GPUdb::insertRecordsFromQuery ( const std::string &  tableName,
const std::string &  remoteQuery,
const std::map< std::string, std::map< std::string, std::string > > &  modifyColumns,
const std::map< std::string, std::string > &  createTableOptions,
const std::map< std::string, std::string > &  options 
) const

Computes remote query result and inserts the result data into a new or existing table.

Parameters
[in]tableNameName of the table into which the data will be inserted, in [schema_name.]table_name format, using standard name resolution rules. If the table does not exist, the table will be created using either an existing type_id or the type inferred from the remote query, and the new table name will have to meet standard table naming criteria.
[in]remoteQueryQuery for which result data needs to be imported
[in]modifyColumnsNot implemented yet. The default value is an empty map.
[in]createTableOptionsOptions used when creating the target table. The default value is an empty map.
[in]optionsOptional parameters. The default value is an empty map.
Returns
Response object containing the result of the operation.

◆ insertRecordsFromQuery() [4/4]

InsertRecordsFromQueryResponse& gpudb::GPUdb::insertRecordsFromQuery ( const std::string &  tableName,
const std::string &  remoteQuery,
const std::map< std::string, std::map< std::string, std::string > > &  modifyColumns,
const std::map< std::string, std::string > &  createTableOptions,
const std::map< std::string, std::string > &  options,
InsertRecordsFromQueryResponse response_ 
) const

Computes remote query result and inserts the result data into a new or existing table.

Parameters
[in]tableNameName of the table into which the data will be inserted, in [schema_name.]table_name format, using standard name resolution rules. If the table does not exist, the table will be created using either an existing type_id or the type inferred from the remote query, and the new table name will have to meet standard table naming criteria.
[in]remoteQueryQuery for which result data needs to be imported
[in]modifyColumnsNot implemented yet. The default value is an empty map.
[in]createTableOptionsOptions used when creating the target table. The default value is an empty map.
[in]optionsOptional parameters. The default value is an empty map.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ insertRecordsRandom() [1/4]

InsertRecordsRandomResponse gpudb::GPUdb::insertRecordsRandom ( const InsertRecordsRandomRequest request_) const

Generates a specified number of random records and adds them to the given table.

There is an optional parameter that allows the user to customize the ranges of the column values. It also allows the user to specify linear profiles for some or all columns in which case linear values are generated rather than random ones. Only individual tables are supported for this operation.

This operation is synchronous, meaning that a response will not be returned until all random records are fully available.

Parameters
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

◆ insertRecordsRandom() [2/4]

InsertRecordsRandomResponse& gpudb::GPUdb::insertRecordsRandom ( const InsertRecordsRandomRequest request_,
InsertRecordsRandomResponse response_ 
) const

Generates a specified number of random records and adds them to the given table.

There is an optional parameter that allows the user to customize the ranges of the column values. It also allows the user to specify linear profiles for some or all columns in which case linear values are generated rather than random ones. Only individual tables are supported for this operation.

This operation is synchronous, meaning that a response will not be returned until all random records are fully available.

Parameters
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ insertRecordsRandom() [3/4]

InsertRecordsRandomResponse gpudb::GPUdb::insertRecordsRandom ( const std::string &  tableName,
const int64_t  count,
const std::map< std::string, std::map< std::string, double > > &  options 
) const

Generates a specified number of random records and adds them to the given table.

There is an optional parameter that allows the user to customize the ranges of the column values. It also allows the user to specify linear profiles for some or all columns in which case linear values are generated rather than random ones. Only individual tables are supported for this operation.

This operation is synchronous, meaning that a response will not be returned until all random records are fully available.

Parameters
[in]tableNameTable to which random records will be added, in [schema_name.]table_name format, using standard name resolution rules. Must be an existing table, not a view.
[in]countNumber of records to generate.
[in]optionsOptional parameter to pass in specifications for the randomness of the values. This map is different from the options parameter of most other endpoints in that it is a map of string to map of string to doubles, while most others are maps of string to string. In this map, the top level keys represent which column's parameters are being specified, while the internal keys represents which parameter is being specified. These parameters take on different meanings depending on the type of the column. Below follows a more detailed description of the map:
  • insert_records_random_seed: If provided, the internal random number generator will be initialized with the given value. The minimum is 0. This allows for the same set of random numbers to be generated across invocation of this endpoint in case the user wants to repeat the test. Since options, is a map of maps, we need an internal map to provide the seed value. For example, to pass 100 as the seed value through this parameter, you need something equivalent to: 'options' = {'seed': { 'value': 100 } }.
  • insert_records_random_all: This key indicates that the specifications relayed in the internal map are to be applied to all columns of the records.
    • insert_records_random_min: For numerical columns, the minimum of the generated values is set to this value. Default is -99999. For point, shape, and track columns, min for numeric 'x' and 'y' columns needs to be within [-180, 180] and [-90, 90], respectively. The default minimum possible values for these columns in such cases are -180.0 and -90.0. For the 'TIMESTAMP' column, the default minimum corresponds to Jan 1, 2010. For string columns, the minimum length of the randomly generated strings is set to this value (default is 0). If both minimum and maximum are provided, minimum must be less than or equal to max. If the min is outside the accepted ranges for strings columns and 'x' and 'y' columns for point/shape/track, then those parameters will not be set; however, an error will not be thrown in such a case. It is the responsibility of the user to use the all parameter judiciously.
    • insert_records_random_max: For numerical columns, the maximum of the generated values is set to this value. Default is 99999. For point, shape, and track columns, max for numeric 'x' and 'y' columns needs to be within [-180, 180] and [-90, 90], respectively. The default minimum possible values for these columns in such cases are 180.0 and 90.0. For string columns, the maximum length of the randomly generated strings. If both minimum and maximum are provided, max must be greater than or equal to min. If the max is outside the accepted ranges for strings columns and 'x' and 'y' columns for point/shape/track, then those parameters will not be set; however, an error will not be thrown in such a case. It is the responsibility of the user to use the all parameter judiciously.
    • insert_records_random_interval: If specified, generate values for all columns evenly spaced with the given interval value. If a max value is specified for a given column the data is randomly generated between min and max and decimated down to the interval. If no max is provided the data is linerally generated starting at the minimum value (instead of generating random data). For non-decimated string-type columns the interval value is ignored. Instead the values are generated following the pattern: 'attrname_creationIndex#', i.e. the column name suffixed with an underscore and a running counter (starting at 0). For string types with limited size (eg char4) the prefix is dropped. No nulls will be generated for nullable columns.
    • insert_records_random_null_percentage: If specified, then generate the given percentage of the count as nulls for all nullable columns. This option will be ignored for non-nullable columns. The value must be within the range [0, 1.0]. The default value is 5% (0.05).
    • insert_records_random_cardinality: If specified, limit the randomly generated values to a fixed set. Not allowed on a column with interval specified, and is not applicable to WKT or Track-specific columns. The value must be greater than 0. This option is disabled by default.
  • insert_records_random_attr_name: Use the desired column name in place of attr_name, and set the following parameters for the column specified. This overrides any parameter set by all.
    • insert_records_random_min: For numerical columns, the minimum of the generated values is set to this value. Default is -99999. For point, shape, and track columns, min for numeric 'x' and 'y' columns needs to be within [-180, 180] and [-90, 90], respectively. The default minimum possible values for these columns in such cases are -180.0 and -90.0. For the 'TIMESTAMP' column, the default minimum corresponds to Jan 1, 2010. For string columns, the minimum length of the randomly generated strings is set to this value (default is 0). If both minimum and maximum are provided, minimum must be less than or equal to max. If the min is outside the accepted ranges for strings columns and 'x' and 'y' columns for point/shape/track, then those parameters will not be set; however, an error will not be thrown in such a case. It is the responsibility of the user to use the all parameter judiciously.
    • insert_records_random_max: For numerical columns, the maximum of the generated values is set to this value. Default is 99999. For point, shape, and track columns, max for numeric 'x' and 'y' columns needs to be within [-180, 180] and [-90, 90], respectively. The default minimum possible values for these columns in such cases are 180.0 and 90.0. For string columns, the maximum length of the randomly generated strings. If both minimum and maximum are provided, max must be greater than or equal to min. If the max is outside the accepted ranges for strings columns and 'x' and 'y' columns for point/shape/track, then those parameters will not be set; however, an error will not be thrown in such a case. It is the responsibility of the user to use the all parameter judiciously.
    • insert_records_random_interval: If specified, generate values for all columns evenly spaced with the given interval value. If a max value is specified for a given column the data is randomly generated between min and max and decimated down to the interval. If no max is provided the data is linerally generated starting at the minimum value (instead of generating random data). For non-decimated string-type columns the interval value is ignored. Instead the values are generated following the pattern: 'attrname_creationIndex#', i.e. the column name suffixed with an underscore and a running counter (starting at 0). For string types with limited size (eg char4) the prefix is dropped. No nulls will be generated for nullable columns.
    • insert_records_random_null_percentage: If specified and if this column is nullable, then generate the given percentage of the count as nulls. This option will result in an error if the column is not nullable. The value must be within the range [0, 1.0]. The default value is 5% (0.05).
    • insert_records_random_cardinality: If specified, limit the randomly generated values to a fixed set. Not allowed on a column with interval specified, and is not applicable to WKT or Track-specific columns. The value must be greater than 0. This option is disabled by default.
  • insert_records_random_track_length: This key-map pair is only valid for track data sets (an error is thrown otherwise). No nulls would be generated for nullable columns.
    • insert_records_random_min: Minimum possible length for generated series; default is 100 records per series. Must be an integral value within the range [1, 500]. If both min and max are specified, min must be less than or equal to max. The minimum allowed value is 1. The maximum allowed value is 500.
    • insert_records_random_max: Maximum possible length for generated series; default is 500 records per series. Must be an integral value within the range [1, 500]. If both min and max are specified, max must be greater than or equal to min. The minimum allowed value is 1. The maximum allowed value is 500.
The default value is an empty map.
Returns
Response object containing the result of the operation.

◆ insertRecordsRandom() [4/4]

InsertRecordsRandomResponse& gpudb::GPUdb::insertRecordsRandom ( const std::string &  tableName,
const int64_t  count,
const std::map< std::string, std::map< std::string, double > > &  options,
InsertRecordsRandomResponse response_ 
) const

Generates a specified number of random records and adds them to the given table.

There is an optional parameter that allows the user to customize the ranges of the column values. It also allows the user to specify linear profiles for some or all columns in which case linear values are generated rather than random ones. Only individual tables are supported for this operation.

This operation is synchronous, meaning that a response will not be returned until all random records are fully available.

Parameters
[in]tableNameTable to which random records will be added, in [schema_name.]table_name format, using standard name resolution rules. Must be an existing table, not a view.
[in]countNumber of records to generate.
[in]optionsOptional parameter to pass in specifications for the randomness of the values. This map is different from the options parameter of most other endpoints in that it is a map of string to map of string to doubles, while most others are maps of string to string. In this map, the top level keys represent which column's parameters are being specified, while the internal keys represents which parameter is being specified. These parameters take on different meanings depending on the type of the column. Below follows a more detailed description of the map:
  • insert_records_random_seed: If provided, the internal random number generator will be initialized with the given value. The minimum is 0. This allows for the same set of random numbers to be generated across invocation of this endpoint in case the user wants to repeat the test. Since options, is a map of maps, we need an internal map to provide the seed value. For example, to pass 100 as the seed value through this parameter, you need something equivalent to: 'options' = {'seed': { 'value': 100 } }.
  • insert_records_random_all: This key indicates that the specifications relayed in the internal map are to be applied to all columns of the records.
    • insert_records_random_min: For numerical columns, the minimum of the generated values is set to this value. Default is -99999. For point, shape, and track columns, min for numeric 'x' and 'y' columns needs to be within [-180, 180] and [-90, 90], respectively. The default minimum possible values for these columns in such cases are -180.0 and -90.0. For the 'TIMESTAMP' column, the default minimum corresponds to Jan 1, 2010. For string columns, the minimum length of the randomly generated strings is set to this value (default is 0). If both minimum and maximum are provided, minimum must be less than or equal to max. If the min is outside the accepted ranges for strings columns and 'x' and 'y' columns for point/shape/track, then those parameters will not be set; however, an error will not be thrown in such a case. It is the responsibility of the user to use the all parameter judiciously.
    • insert_records_random_max: For numerical columns, the maximum of the generated values is set to this value. Default is 99999. For point, shape, and track columns, max for numeric 'x' and 'y' columns needs to be within [-180, 180] and [-90, 90], respectively. The default minimum possible values for these columns in such cases are 180.0 and 90.0. For string columns, the maximum length of the randomly generated strings. If both minimum and maximum are provided, max must be greater than or equal to min. If the max is outside the accepted ranges for strings columns and 'x' and 'y' columns for point/shape/track, then those parameters will not be set; however, an error will not be thrown in such a case. It is the responsibility of the user to use the all parameter judiciously.
    • insert_records_random_interval: If specified, generate values for all columns evenly spaced with the given interval value. If a max value is specified for a given column the data is randomly generated between min and max and decimated down to the interval. If no max is provided the data is linerally generated starting at the minimum value (instead of generating random data). For non-decimated string-type columns the interval value is ignored. Instead the values are generated following the pattern: 'attrname_creationIndex#', i.e. the column name suffixed with an underscore and a running counter (starting at 0). For string types with limited size (eg char4) the prefix is dropped. No nulls will be generated for nullable columns.
    • insert_records_random_null_percentage: If specified, then generate the given percentage of the count as nulls for all nullable columns. This option will be ignored for non-nullable columns. The value must be within the range [0, 1.0]. The default value is 5% (0.05).
    • insert_records_random_cardinality: If specified, limit the randomly generated values to a fixed set. Not allowed on a column with interval specified, and is not applicable to WKT or Track-specific columns. The value must be greater than 0. This option is disabled by default.
  • insert_records_random_attr_name: Use the desired column name in place of attr_name, and set the following parameters for the column specified. This overrides any parameter set by all.
    • insert_records_random_min: For numerical columns, the minimum of the generated values is set to this value. Default is -99999. For point, shape, and track columns, min for numeric 'x' and 'y' columns needs to be within [-180, 180] and [-90, 90], respectively. The default minimum possible values for these columns in such cases are -180.0 and -90.0. For the 'TIMESTAMP' column, the default minimum corresponds to Jan 1, 2010. For string columns, the minimum length of the randomly generated strings is set to this value (default is 0). If both minimum and maximum are provided, minimum must be less than or equal to max. If the min is outside the accepted ranges for strings columns and 'x' and 'y' columns for point/shape/track, then those parameters will not be set; however, an error will not be thrown in such a case. It is the responsibility of the user to use the all parameter judiciously.
    • insert_records_random_max: For numerical columns, the maximum of the generated values is set to this value. Default is 99999. For point, shape, and track columns, max for numeric 'x' and 'y' columns needs to be within [-180, 180] and [-90, 90], respectively. The default minimum possible values for these columns in such cases are 180.0 and 90.0. For string columns, the maximum length of the randomly generated strings. If both minimum and maximum are provided, max must be greater than or equal to min. If the max is outside the accepted ranges for strings columns and 'x' and 'y' columns for point/shape/track, then those parameters will not be set; however, an error will not be thrown in such a case. It is the responsibility of the user to use the all parameter judiciously.
    • insert_records_random_interval: If specified, generate values for all columns evenly spaced with the given interval value. If a max value is specified for a given column the data is randomly generated between min and max and decimated down to the interval. If no max is provided the data is linerally generated starting at the minimum value (instead of generating random data). For non-decimated string-type columns the interval value is ignored. Instead the values are generated following the pattern: 'attrname_creationIndex#', i.e. the column name suffixed with an underscore and a running counter (starting at 0). For string types with limited size (eg char4) the prefix is dropped. No nulls will be generated for nullable columns.
    • insert_records_random_null_percentage: If specified and if this column is nullable, then generate the given percentage of the count as nulls. This option will result in an error if the column is not nullable. The value must be within the range [0, 1.0]. The default value is 5% (0.05).
    • insert_records_random_cardinality: If specified, limit the randomly generated values to a fixed set. Not allowed on a column with interval specified, and is not applicable to WKT or Track-specific columns. The value must be greater than 0. This option is disabled by default.
  • insert_records_random_track_length: This key-map pair is only valid for track data sets (an error is thrown otherwise). No nulls would be generated for nullable columns.
    • insert_records_random_min: Minimum possible length for generated series; default is 100 records per series. Must be an integral value within the range [1, 500]. If both min and max are specified, min must be less than or equal to max. The minimum allowed value is 1. The maximum allowed value is 500.
    • insert_records_random_max: Maximum possible length for generated series; default is 500 records per series. Must be an integral value within the range [1, 500]. If both min and max are specified, max must be greater than or equal to min. The minimum allowed value is 1. The maximum allowed value is 500.
The default value is an empty map.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ insertRecordsRaw() [1/2]

InsertRecordsResponse gpudb::GPUdb::insertRecordsRaw ( const RawInsertRecordsRequest request_) const

Adds multiple records to the specified table.

The operation is synchronous, meaning that a response will not be returned until all the records are fully inserted and available. The response payload provides the counts of the number of records actually inserted and/or updated, and can provide the unique identifier of each added record.

The options parameter can be used to customize this function's behavior.

The update_on_existing_pk option specifies the record collision policy for inserting into a table with a primary key, but is ignored if no primary key exists.

The return_record_ids option indicates that the database should return the unique identifiers of inserted records.

Parameters
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

◆ insertRecordsRaw() [2/2]

InsertRecordsResponse& gpudb::GPUdb::insertRecordsRaw ( const RawInsertRecordsRequest request_,
InsertRecordsResponse response_ 
) const

Adds multiple records to the specified table.

The operation is synchronous, meaning that a response will not be returned until all the records are fully inserted and available. The response payload provides the counts of the number of records actually inserted and/or updated, and can provide the unique identifier of each added record.

The options parameter can be used to customize this function's behavior.

The update_on_existing_pk option specifies the record collision policy for inserting into a table with a primary key, but is ignored if no primary key exists.

The return_record_ids option indicates that the database should return the unique identifiers of inserted records.

Parameters
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ insertSymbol() [1/4]

InsertSymbolResponse gpudb::GPUdb::insertSymbol ( const InsertSymbolRequest request_) const

Adds a symbol or icon (i.e. an image) to represent data points when data is rendered visually.

Users must provide the symbol identifier (string), a format (currently supported: 'svg' and 'svg_path'), the data for the symbol, and any additional optional parameter (e.g. color). To have a symbol used for rendering create a table with a string column named 'SYMBOLCODE' (along with 'x' or 'y' for example). Then when the table is rendered (via WMS) if the 'dosymbology' parameter is 'true' then the value of the 'SYMBOLCODE' column is used to pick the symbol displayed for each point.

Parameters
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

◆ insertSymbol() [2/4]

InsertSymbolResponse& gpudb::GPUdb::insertSymbol ( const InsertSymbolRequest request_,
InsertSymbolResponse response_ 
) const

Adds a symbol or icon (i.e. an image) to represent data points when data is rendered visually.

Users must provide the symbol identifier (string), a format (currently supported: 'svg' and 'svg_path'), the data for the symbol, and any additional optional parameter (e.g. color). To have a symbol used for rendering create a table with a string column named 'SYMBOLCODE' (along with 'x' or 'y' for example). Then when the table is rendered (via WMS) if the 'dosymbology' parameter is 'true' then the value of the 'SYMBOLCODE' column is used to pick the symbol displayed for each point.

Parameters
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ insertSymbol() [3/4]

InsertSymbolResponse gpudb::GPUdb::insertSymbol ( const std::string &  symbolId,
const std::string &  symbolFormat,
const std::vector< uint8_t > &  symbolData,
const std::map< std::string, std::string > &  options 
) const

Adds a symbol or icon (i.e. an image) to represent data points when data is rendered visually.

Users must provide the symbol identifier (string), a format (currently supported: 'svg' and 'svg_path'), the data for the symbol, and any additional optional parameter (e.g. color). To have a symbol used for rendering create a table with a string column named 'SYMBOLCODE' (along with 'x' or 'y' for example). Then when the table is rendered (via WMS) if the 'dosymbology' parameter is 'true' then the value of the 'SYMBOLCODE' column is used to pick the symbol displayed for each point.

Parameters
[in]symbolIdThe id of the symbol being added. This is the same id that should be in the 'SYMBOLCODE' column for objects using this symbol
[in]symbolFormatSpecifies the symbol format. Must be either 'svg' or 'svg_path'. Supported values:
[in]symbolDataThe actual symbol data. If symbolFormat is 'svg' then this should be the raw bytes representing an svg file. If symbolFormat is svg path then this should be an svg path string, for example: 'M25.979,12.896,5.979,12.896,5.979,19.562,25.979,19.562z'
[in]optionsOptional parameters.
  • insert_symbol_color: If symbolFormat is 'svg' this is ignored. If symbolFormat is 'svg_path' then this option specifies the color (in RRGGBB hex format) of the path. For example, to have the path rendered in red, used 'FF0000'. If 'color' is not provided then '00FF00' (i.e. green) is used by default.
The default value is an empty map.
Returns
Response object containing the result of the operation.

◆ insertSymbol() [4/4]

InsertSymbolResponse& gpudb::GPUdb::insertSymbol ( const std::string &  symbolId,
const std::string &  symbolFormat,
const std::vector< uint8_t > &  symbolData,
const std::map< std::string, std::string > &  options,
InsertSymbolResponse response_ 
) const

Adds a symbol or icon (i.e. an image) to represent data points when data is rendered visually.

Users must provide the symbol identifier (string), a format (currently supported: 'svg' and 'svg_path'), the data for the symbol, and any additional optional parameter (e.g. color). To have a symbol used for rendering create a table with a string column named 'SYMBOLCODE' (along with 'x' or 'y' for example). Then when the table is rendered (via WMS) if the 'dosymbology' parameter is 'true' then the value of the 'SYMBOLCODE' column is used to pick the symbol displayed for each point.

Parameters
[in]symbolIdThe id of the symbol being added. This is the same id that should be in the 'SYMBOLCODE' column for objects using this symbol
[in]symbolFormatSpecifies the symbol format. Must be either 'svg' or 'svg_path'. Supported values:
[in]symbolDataThe actual symbol data. If symbolFormat is 'svg' then this should be the raw bytes representing an svg file. If symbolFormat is svg path then this should be an svg path string, for example: 'M25.979,12.896,5.979,12.896,5.979,19.562,25.979,19.562z'
[in]optionsOptional parameters.
  • insert_symbol_color: If symbolFormat is 'svg' this is ignored. If symbolFormat is 'svg_path' then this option specifies the color (in RRGGBB hex format) of the path. For example, to have the path rendered in red, used 'FF0000'. If 'color' is not provided then '00FF00' (i.e. green) is used by default.
The default value is an empty map.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ killProc() [1/4]

KillProcResponse gpudb::GPUdb::killProc ( const KillProcRequest request_) const

Kills a running proc instance.

Parameters
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

◆ killProc() [2/4]

KillProcResponse& gpudb::GPUdb::killProc ( const KillProcRequest request_,
KillProcResponse response_ 
) const

Kills a running proc instance.

Parameters
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ killProc() [3/4]

KillProcResponse gpudb::GPUdb::killProc ( const std::string &  runId,
const std::map< std::string, std::string > &  options 
) const

Kills a running proc instance.

Parameters
[in]runIdThe run ID of a running proc instance. If a proc with a matching run ID is not found or the proc instance has already completed, no procs will be killed. If not specified, all running proc instances will be killed. The default value is ''.
[in]optionsOptional parameters. The default value is an empty map.
Returns
Response object containing the result of the operation.

◆ killProc() [4/4]

KillProcResponse& gpudb::GPUdb::killProc ( const std::string &  runId,
const std::map< std::string, std::string > &  options,
KillProcResponse response_ 
) const

Kills a running proc instance.

Parameters
[in]runIdThe run ID of a running proc instance. If a proc with a matching run ID is not found or the proc instance has already completed, no procs will be killed. If not specified, all running proc instances will be killed. The default value is ''.
[in]optionsOptional parameters. The default value is an empty map.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ lockTable() [1/4]

LockTableResponse gpudb::GPUdb::lockTable ( const LockTableRequest request_) const

Manages global access to a table's data.

By default a table has a lockType of read_write, indicating all operations are permitted. A user may request a read_only or a write_only lock, after which only read or write operations, respectively, are permitted on the table until the lock is removed. When lockType is no_access then no operations are permitted on the table. The lock status can be queried by setting lockType to status.

Parameters
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

◆ lockTable() [2/4]

LockTableResponse& gpudb::GPUdb::lockTable ( const LockTableRequest request_,
LockTableResponse response_ 
) const

Manages global access to a table's data.

By default a table has a lockType of read_write, indicating all operations are permitted. A user may request a read_only or a write_only lock, after which only read or write operations, respectively, are permitted on the table until the lock is removed. When lockType is no_access then no operations are permitted on the table. The lock status can be queried by setting lockType to status.

Parameters
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ lockTable() [3/4]

LockTableResponse gpudb::GPUdb::lockTable ( const std::string &  tableName,
const std::string &  lockType,
const std::map< std::string, std::string > &  options 
) const

Manages global access to a table's data.

By default a table has a lockType of read_write, indicating all operations are permitted. A user may request a read_only or a write_only lock, after which only read or write operations, respectively, are permitted on the table until the lock is removed. When lockType is no_access then no operations are permitted on the table. The lock status can be queried by setting lockType to status.

Parameters
[in]tableNameName of the table to be locked, in [schema_name.]table_name format, using standard name resolution rules. It must be a currently existing table or view.
[in]lockTypeThe type of lock being applied to the table. Setting it to status will return the current lock status of the table without changing it. Supported values: The default value is lock_table_status.
[in]optionsOptional parameters. The default value is an empty map.
Returns
Response object containing the result of the operation.

◆ lockTable() [4/4]

LockTableResponse& gpudb::GPUdb::lockTable ( const std::string &  tableName,
const std::string &  lockType,
const std::map< std::string, std::string > &  options,
LockTableResponse response_ 
) const

Manages global access to a table's data.

By default a table has a lockType of read_write, indicating all operations are permitted. A user may request a read_only or a write_only lock, after which only read or write operations, respectively, are permitted on the table until the lock is removed. When lockType is no_access then no operations are permitted on the table. The lock status can be queried by setting lockType to status.

Parameters
[in]tableNameName of the table to be locked, in [schema_name.]table_name format, using standard name resolution rules. It must be a currently existing table or view.
[in]lockTypeThe type of lock being applied to the table. Setting it to status will return the current lock status of the table without changing it. Supported values: The default value is lock_table_status.
[in]optionsOptional parameters. The default value is an empty map.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ matchGraph() [1/4]

MatchGraphResponse gpudb::GPUdb::matchGraph ( const MatchGraphRequest request_) const

Matches a directed route implied by a given set of latitude/longitude points to an existing underlying road network graph using a given solution type.

IMPORTANT: It's highly recommended that you review the Graphs & Solvers concepts documentation, the Graph REST Tutorial, and/or some /match/graph examples before using this endpoint.

Parameters
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

◆ matchGraph() [2/4]

MatchGraphResponse& gpudb::GPUdb::matchGraph ( const MatchGraphRequest request_,
MatchGraphResponse response_ 
) const

Matches a directed route implied by a given set of latitude/longitude points to an existing underlying road network graph using a given solution type.

IMPORTANT: It's highly recommended that you review the Graphs & Solvers concepts documentation, the Graph REST Tutorial, and/or some /match/graph examples before using this endpoint.

Parameters
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ matchGraph() [3/4]

MatchGraphResponse gpudb::GPUdb::matchGraph ( const std::string &  graphName,
const std::vector< std::string > &  samplePoints,
const std::string &  solveMethod,
const std::string &  solutionTable,
const std::map< std::string, std::string > &  options 
) const

Matches a directed route implied by a given set of latitude/longitude points to an existing underlying road network graph using a given solution type.

IMPORTANT: It's highly recommended that you review the Graphs & Solvers concepts documentation, the Graph REST Tutorial, and/or some /match/graph examples before using this endpoint.

Parameters
[in]graphNameName of the underlying geospatial graph resource to match to using samplePoints.
[in]samplePointsSample points used to match to an underlying geospatial graph. Sample points must be specified using identifiers; identifiers are grouped as combinations. Identifiers can be used with: existing column names, e.g., 'table.column AS SAMPLE_X'; expressions, e.g., 'ST_MAKEPOINT(table.x, table.y) AS SAMPLE_WKTPOINT'; or constant values, e.g., '{1, 2, 10} AS SAMPLE_TRIPID'.
[in]solveMethodThe type of solver to use for graph matching. Supported values: The default value is match_graph_markov_chain.
[in]solutionTableThe name of the table used to store the results, in [schema_name.]table_name format, using standard name resolution rules and meeting table naming criteria. This table contains a track of geospatial points for the matched portion of the graph, a track ID, and a score value. Also outputs a details table containing a trip ID (that matches the track ID), the latitude/longitude pair, the timestamp the point was recorded at, and an edge ID corresponding to the matched road segment. Must not be an existing table of the same name. The default value is ''.
[in]optionsAdditional parameters. The default value is an empty map.
Returns
Response object containing the result of the operation.

◆ matchGraph() [4/4]

MatchGraphResponse& gpudb::GPUdb::matchGraph ( const std::string &  graphName,
const std::vector< std::string > &  samplePoints,
const std::string &  solveMethod,
const std::string &  solutionTable,
const std::map< std::string, std::string > &  options,
MatchGraphResponse response_ 
) const

Matches a directed route implied by a given set of latitude/longitude points to an existing underlying road network graph using a given solution type.

IMPORTANT: It's highly recommended that you review the Graphs & Solvers concepts documentation, the Graph REST Tutorial, and/or some /match/graph examples before using this endpoint.

Parameters
[in]graphNameName of the underlying geospatial graph resource to match to using samplePoints.
[in]samplePointsSample points used to match to an underlying geospatial graph. Sample points must be specified using identifiers; identifiers are grouped as combinations. Identifiers can be used with: existing column names, e.g., 'table.column AS SAMPLE_X'; expressions, e.g., 'ST_MAKEPOINT(table.x, table.y) AS SAMPLE_WKTPOINT'; or constant values, e.g., '{1, 2, 10} AS SAMPLE_TRIPID'.
[in]solveMethodThe type of solver to use for graph matching. Supported values: The default value is match_graph_markov_chain.
[in]solutionTableThe name of the table used to store the results, in [schema_name.]table_name format, using standard name resolution rules and meeting table naming criteria. This table contains a track of geospatial points for the matched portion of the graph, a track ID, and a score value. Also outputs a details table containing a trip ID (that matches the track ID), the latitude/longitude pair, the timestamp the point was recorded at, and an edge ID corresponding to the matched road segment. Must not be an existing table of the same name. The default value is ''.
[in]optionsAdditional parameters. The default value is an empty map.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ mergeRecords() [1/4]

MergeRecordsResponse gpudb::GPUdb::mergeRecords ( const MergeRecordsRequest request_) const

Create a new empty result table (specified by tableName), and insert all records from source tables (specified by sourceTableNames) based on the field mapping information (specified by fieldMaps).

For merge records details and examples, see Merge Records. For limitations, see Merge Records Limitations and Cautions.

The field map (specified by fieldMaps) holds the user-specified maps of target table column names to source table columns. The array of fieldMaps must match one-to-one with the sourceTableNames, e.g., there's a map present in fieldMaps for each table listed in sourceTableNames.

Parameters
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

◆ mergeRecords() [2/4]

MergeRecordsResponse& gpudb::GPUdb::mergeRecords ( const MergeRecordsRequest request_,
MergeRecordsResponse response_ 
) const

Create a new empty result table (specified by tableName), and insert all records from source tables (specified by sourceTableNames) based on the field mapping information (specified by fieldMaps).

For merge records details and examples, see Merge Records. For limitations, see Merge Records Limitations and Cautions.

The field map (specified by fieldMaps) holds the user-specified maps of target table column names to source table columns. The array of fieldMaps must match one-to-one with the sourceTableNames, e.g., there's a map present in fieldMaps for each table listed in sourceTableNames.

Parameters
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ mergeRecords() [3/4]

MergeRecordsResponse gpudb::GPUdb::mergeRecords ( const std::string &  tableName,
const std::vector< std::string > &  sourceTableNames,
const std::vector< std::map< std::string, std::string > > &  fieldMaps,
const std::map< std::string, std::string > &  options 
) const

Create a new empty result table (specified by tableName), and insert all records from source tables (specified by sourceTableNames) based on the field mapping information (specified by fieldMaps).

For merge records details and examples, see Merge Records. For limitations, see Merge Records Limitations and Cautions.

The field map (specified by fieldMaps) holds the user-specified maps of target table column names to source table columns. The array of fieldMaps must match one-to-one with the sourceTableNames, e.g., there's a map present in fieldMaps for each table listed in sourceTableNames.

Parameters
[in]tableNameThe name of the new result table for the records to be merged into, in [schema_name.]table_name format, using standard name resolution rules and meeting table naming criteria. Must NOT be an existing table.
[in]sourceTableNamesThe list of names of source tables to get the records from, each in [schema_name.]table_name format, using standard name resolution rules. Must be existing table names.
[in]fieldMapsContains a list of source/target column mappings, one mapping for each source table listed in sourceTableNames being merged into the target table specified by tableName. Each mapping contains the target column names (as keys) that the data in the mapped source columns or column expressions (as values) will be merged into. All of the source columns being merged into a given target column must match in type, as that type will determine the type of the new target column.
[in]optionsOptional parameters. The default value is an empty map.
Returns
Response object containing the result of the operation.

◆ mergeRecords() [4/4]

MergeRecordsResponse& gpudb::GPUdb::mergeRecords ( const std::string &  tableName,
const std::vector< std::string > &  sourceTableNames,
const std::vector< std::map< std::string, std::string > > &  fieldMaps,
const std::map< std::string, std::string > &  options,
MergeRecordsResponse response_ 
) const

Create a new empty result table (specified by tableName), and insert all records from source tables (specified by sourceTableNames) based on the field mapping information (specified by fieldMaps).

For merge records details and examples, see Merge Records. For limitations, see Merge Records Limitations and Cautions.

The field map (specified by fieldMaps) holds the user-specified maps of target table column names to source table columns. The array of fieldMaps must match one-to-one with the sourceTableNames, e.g., there's a map present in fieldMaps for each table listed in sourceTableNames.

Parameters
[in]tableNameThe name of the new result table for the records to be merged into, in [schema_name.]table_name format, using standard name resolution rules and meeting table naming criteria. Must NOT be an existing table.
[in]sourceTableNamesThe list of names of source tables to get the records from, each in [schema_name.]table_name format, using standard name resolution rules. Must be existing table names.
[in]fieldMapsContains a list of source/target column mappings, one mapping for each source table listed in sourceTableNames being merged into the target table specified by tableName. Each mapping contains the target column names (as keys) that the data in the mapped source columns or column expressions (as values) will be merged into. All of the source columns being merged into a given target column must match in type, as that type will determine the type of the new target column.
[in]optionsOptional parameters. The default value is an empty map.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ modifyGraph() [1/4]

ModifyGraphResponse gpudb::GPUdb::modifyGraph ( const ModifyGraphRequest request_) const

Update an existing graph network using given nodes, edges, weights, restrictions, and options.

IMPORTANT: It's highly recommended that you review the Graphs & Solvers concepts documentation, and Graph REST Tutorial before using this endpoint.

Parameters
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

◆ modifyGraph() [2/4]

ModifyGraphResponse& gpudb::GPUdb::modifyGraph ( const ModifyGraphRequest request_,
ModifyGraphResponse response_ 
) const

Update an existing graph network using given nodes, edges, weights, restrictions, and options.

IMPORTANT: It's highly recommended that you review the Graphs & Solvers concepts documentation, and Graph REST Tutorial before using this endpoint.

Parameters
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ modifyGraph() [3/4]

ModifyGraphResponse gpudb::GPUdb::modifyGraph ( const std::string &  graphName,
const std::vector< std::string > &  nodes,
const std::vector< std::string > &  edges,
const std::vector< std::string > &  weights,
const std::vector< std::string > &  restrictions,
const std::map< std::string, std::string > &  options 
) const

Update an existing graph network using given nodes, edges, weights, restrictions, and options.

IMPORTANT: It's highly recommended that you review the Graphs & Solvers concepts documentation, and Graph REST Tutorial before using this endpoint.

Parameters
[in]graphNameName of the graph resource to modify.
[in]nodesNodes with which to update existing nodes in graph specified by graphName. Review Nodes for more information. Nodes must be specified using identifiers; identifiers are grouped as combinations. Identifiers can be used with existing column names, e.g., 'table.column AS NODE_ID', expressions, e.g., 'ST_MAKEPOINT(column1, column2) AS NODE_WKTPOINT', or raw values, e.g., '{9, 10, 11} AS NODE_ID'. If using raw values in an identifier combination, the number of values specified must match across the combination. Identifier combination(s) do not have to match the method used to create the graph, e.g., if column names were specified to create the graph, expressions or raw values could also be used to modify the graph.
[in]edgesEdges with which to update existing edges in graph specified by graphName. Review Edges for more information. Edges must be specified using identifiers; identifiers are grouped as combinations. Identifiers can be used with existing column names, e.g., 'table.column AS EDGE_ID', expressions, e.g., 'SUBSTR(column, 1, 6) AS EDGE_NODE1_NAME', or raw values, e.g., "{'family', 'coworker'} AS EDGE_LABEL". If using raw values in an identifier combination, the number of values specified must match across the combination. Identifier combination(s) do not have to match the method used to create the graph, e.g., if column names were specified to create the graph, expressions or raw values could also be used to modify the graph.
[in]weightsWeights with which to update existing weights in graph specified by graphName. Review Weights for more information. Weights must be specified using identifiers; identifiers are grouped as combinations. Identifiers can be used with existing column names, e.g., 'table.column AS WEIGHTS_EDGE_ID', expressions, e.g., 'ST_LENGTH(wkt) AS WEIGHTS_VALUESPECIFIED', or raw values, e.g., '{4, 15} AS WEIGHTS_VALUESPECIFIED'. If using raw values in an identifier combination, the number of values specified must match across the combination. Identifier combination(s) do not have to match the method used to create the graph, e.g., if column names were specified to create the graph, expressions or raw values could also be used to modify the graph.
[in]restrictionsRestrictions with which to update existing restrictions in graph specified by graphName. Review Restrictions for more information. Restrictions must be specified using identifiers; identifiers are grouped as combinations. Identifiers can be used with existing column names, e.g., 'table.column AS RESTRICTIONS_EDGE_ID', expressions, e.g., 'column/2 AS RESTRICTIONS_VALUECOMPARED', or raw values, e.g., '{0, 0, 0, 1} AS RESTRICTIONS_ONOFFCOMPARED'. If using raw values in an identifier combination, the number of values specified must match across the combination. Identifier combination(s) do not have to match the method used to create the graph, e.g., if column names were specified to create the graph, expressions or raw values could also be used to modify the graph.
[in]optionsOptional parameters. The default value is an empty map.
Returns
Response object containing the result of the operation.

◆ modifyGraph() [4/4]

ModifyGraphResponse& gpudb::GPUdb::modifyGraph ( const std::string &  graphName,
const std::vector< std::string > &  nodes,
const std::vector< std::string > &  edges,
const std::vector< std::string > &  weights,
const std::vector< std::string > &  restrictions,
const std::map< std::string, std::string > &  options,
ModifyGraphResponse response_ 
) const

Update an existing graph network using given nodes, edges, weights, restrictions, and options.

IMPORTANT: It's highly recommended that you review the Graphs & Solvers concepts documentation, and Graph REST Tutorial before using this endpoint.

Parameters
[in]graphNameName of the graph resource to modify.
[in]nodesNodes with which to update existing nodes in graph specified by graphName. Review Nodes for more information. Nodes must be specified using identifiers; identifiers are grouped as combinations. Identifiers can be used with existing column names, e.g., 'table.column AS NODE_ID', expressions, e.g., 'ST_MAKEPOINT(column1, column2) AS NODE_WKTPOINT', or raw values, e.g., '{9, 10, 11} AS NODE_ID'. If using raw values in an identifier combination, the number of values specified must match across the combination. Identifier combination(s) do not have to match the method used to create the graph, e.g., if column names were specified to create the graph, expressions or raw values could also be used to modify the graph.
[in]edgesEdges with which to update existing edges in graph specified by graphName. Review Edges for more information. Edges must be specified using identifiers; identifiers are grouped as combinations. Identifiers can be used with existing column names, e.g., 'table.column AS EDGE_ID', expressions, e.g., 'SUBSTR(column, 1, 6) AS EDGE_NODE1_NAME', or raw values, e.g., "{'family', 'coworker'} AS EDGE_LABEL". If using raw values in an identifier combination, the number of values specified must match across the combination. Identifier combination(s) do not have to match the method used to create the graph, e.g., if column names were specified to create the graph, expressions or raw values could also be used to modify the graph.
[in]weightsWeights with which to update existing weights in graph specified by graphName. Review Weights for more information. Weights must be specified using identifiers; identifiers are grouped as combinations. Identifiers can be used with existing column names, e.g., 'table.column AS WEIGHTS_EDGE_ID', expressions, e.g., 'ST_LENGTH(wkt) AS WEIGHTS_VALUESPECIFIED', or raw values, e.g., '{4, 15} AS WEIGHTS_VALUESPECIFIED'. If using raw values in an identifier combination, the number of values specified must match across the combination. Identifier combination(s) do not have to match the method used to create the graph, e.g., if column names were specified to create the graph, expressions or raw values could also be used to modify the graph.
[in]restrictionsRestrictions with which to update existing restrictions in graph specified by graphName. Review Restrictions for more information. Restrictions must be specified using identifiers; identifiers are grouped as combinations. Identifiers can be used with existing column names, e.g., 'table.column AS RESTRICTIONS_EDGE_ID', expressions, e.g., 'column/2 AS RESTRICTIONS_VALUECOMPARED', or raw values, e.g., '{0, 0, 0, 1} AS RESTRICTIONS_ONOFFCOMPARED'. If using raw values in an identifier combination, the number of values specified must match across the combination. Identifier combination(s) do not have to match the method used to create the graph, e.g., if column names were specified to create the graph, expressions or raw values could also be used to modify the graph.
[in]optionsOptional parameters. The default value is an empty map.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ queryGraph() [1/4]

QueryGraphResponse gpudb::GPUdb::queryGraph ( const QueryGraphRequest request_) const

Employs a topological query on a graph generated a-priori by createGraph and returns a list of adjacent edge(s) or node(s), also known as an adjacency list, depending on what's been provided to the endpoint; providing edges will return nodes and providing nodes will return edges.

To determine the node(s) or edge(s) adjacent to a value from a given column, provide a list of values to queries. This field can be populated with column values from any table as long as the type is supported by the given identifier. See Query Identifiers for more information.

To return the adjacency list in the response, leave adjacencyTable empty.

IMPORTANT: It's highly recommended that you review the Graphs & Solvers concepts documentation, the Graph REST Tutorial, and/or some /match/graph examples before using this endpoint.

Parameters
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

◆ queryGraph() [2/4]

QueryGraphResponse& gpudb::GPUdb::queryGraph ( const QueryGraphRequest request_,
QueryGraphResponse response_ 
) const

Employs a topological query on a graph generated a-priori by createGraph and returns a list of adjacent edge(s) or node(s), also known as an adjacency list, depending on what's been provided to the endpoint; providing edges will return nodes and providing nodes will return edges.

To determine the node(s) or edge(s) adjacent to a value from a given column, provide a list of values to queries. This field can be populated with column values from any table as long as the type is supported by the given identifier. See Query Identifiers for more information.

To return the adjacency list in the response, leave adjacencyTable empty.

IMPORTANT: It's highly recommended that you review the Graphs & Solvers concepts documentation, the Graph REST Tutorial, and/or some /match/graph examples before using this endpoint.

Parameters
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ queryGraph() [3/4]

QueryGraphResponse gpudb::GPUdb::queryGraph ( const std::string &  graphName,
const std::vector< std::string > &  queries,
const std::vector< std::string > &  restrictions,
const std::string &  adjacencyTable,
const int32_t  rings,
const std::map< std::string, std::string > &  options 
) const

Employs a topological query on a graph generated a-priori by createGraph and returns a list of adjacent edge(s) or node(s), also known as an adjacency list, depending on what's been provided to the endpoint; providing edges will return nodes and providing nodes will return edges.

To determine the node(s) or edge(s) adjacent to a value from a given column, provide a list of values to queries. This field can be populated with column values from any table as long as the type is supported by the given identifier. See Query Identifiers for more information.

To return the adjacency list in the response, leave adjacencyTable empty.

IMPORTANT: It's highly recommended that you review the Graphs & Solvers concepts documentation, the Graph REST Tutorial, and/or some /match/graph examples before using this endpoint.

Parameters
[in]graphNameName of the graph resource to query.
[in]queriesNodes or edges to be queried specified using query identifiers. Identifiers can be used with existing column names, e.g., 'table.column AS QUERY_NODE_ID', raw values, e.g., '{0, 2} AS QUERY_NODE_ID', or expressions, e.g., 'ST_MAKEPOINT(table.x, table.y) AS QUERY_NODE_WKTPOINT'. Multiple values can be provided as long as the same identifier is used for all values. If using raw values in an identifier combination, the number of values specified must match across the combination.
[in]restrictionsAdditional restrictions to apply to the nodes/edges of an existing graph. Restrictions must be specified using identifiers; identifiers are grouped as combinations. Identifiers can be used with existing column names, e.g., 'table.column AS RESTRICTIONS_EDGE_ID', expressions, e.g., 'column/2 AS RESTRICTIONS_VALUECOMPARED', or raw values, e.g., '{0, 0, 0, 1} AS RESTRICTIONS_ONOFFCOMPARED'. If using raw values in an identifier combination, the number of values specified must match across the combination. The default value is an empty vector.
[in]adjacencyTableName of the table to store the resulting adjacencies, in [schema_name.]table_name format, using standard name resolution rules and meeting table naming criteria. If left blank, the query results are instead returned in the response. If the 'QUERY_TARGET_NODE_LABEL' query identifier is used in queries, then two additional columns will be available: 'PATH_ID' and 'RING_ID'. See Using Labels for more information. The default value is ''.
[in]ringsSets the number of rings around the node to query for adjacency, with '1' being the edges directly attached to the queried node. Also known as number of hops. For example, if it is set to '2', the edge(s) directly attached to the queried node(s) will be returned; in addition, the edge(s) attached to the node(s) attached to the initial ring of edge(s) surrounding the queried node(s) will be returned. If the value is set to '0', any nodes that meet the criteria in queries and restrictions will be returned. This parameter is only applicable when querying nodes. The default value is 1.
[in]optionsAdditional parameters. The default value is an empty map.
Returns
Response object containing the result of the operation.

◆ queryGraph() [4/4]

QueryGraphResponse& gpudb::GPUdb::queryGraph ( const std::string &  graphName,
const std::vector< std::string > &  queries,
const std::vector< std::string > &  restrictions,
const std::string &  adjacencyTable,
const int32_t  rings,
const std::map< std::string, std::string > &  options,
QueryGraphResponse response_ 
) const

Employs a topological query on a graph generated a-priori by createGraph and returns a list of adjacent edge(s) or node(s), also known as an adjacency list, depending on what's been provided to the endpoint; providing edges will return nodes and providing nodes will return edges.

To determine the node(s) or edge(s) adjacent to a value from a given column, provide a list of values to queries. This field can be populated with column values from any table as long as the type is supported by the given identifier. See Query Identifiers for more information.

To return the adjacency list in the response, leave adjacencyTable empty.

IMPORTANT: It's highly recommended that you review the Graphs & Solvers concepts documentation, the Graph REST Tutorial, and/or some /match/graph examples before using this endpoint.

Parameters
[in]graphNameName of the graph resource to query.
[in]queriesNodes or edges to be queried specified using query identifiers. Identifiers can be used with existing column names, e.g., 'table.column AS QUERY_NODE_ID', raw values, e.g., '{0, 2} AS QUERY_NODE_ID', or expressions, e.g., 'ST_MAKEPOINT(table.x, table.y) AS QUERY_NODE_WKTPOINT'. Multiple values can be provided as long as the same identifier is used for all values. If using raw values in an identifier combination, the number of values specified must match across the combination.
[in]restrictionsAdditional restrictions to apply to the nodes/edges of an existing graph. Restrictions must be specified using identifiers; identifiers are grouped as combinations. Identifiers can be used with existing column names, e.g., 'table.column AS RESTRICTIONS_EDGE_ID', expressions, e.g., 'column/2 AS RESTRICTIONS_VALUECOMPARED', or raw values, e.g., '{0, 0, 0, 1} AS RESTRICTIONS_ONOFFCOMPARED'. If using raw values in an identifier combination, the number of values specified must match across the combination. The default value is an empty vector.
[in]adjacencyTableName of the table to store the resulting adjacencies, in [schema_name.]table_name format, using standard name resolution rules and meeting table naming criteria. If left blank, the query results are instead returned in the response. If the 'QUERY_TARGET_NODE_LABEL' query identifier is used in queries, then two additional columns will be available: 'PATH_ID' and 'RING_ID'. See Using Labels for more information. The default value is ''.
[in]ringsSets the number of rings around the node to query for adjacency, with '1' being the edges directly attached to the queried node. Also known as number of hops. For example, if it is set to '2', the edge(s) directly attached to the queried node(s) will be returned; in addition, the edge(s) attached to the node(s) attached to the initial ring of edge(s) surrounding the queried node(s) will be returned. If the value is set to '0', any nodes that meet the criteria in queries and restrictions will be returned. This parameter is only applicable when querying nodes. The default value is 1.
[in]optionsAdditional parameters. The default value is an empty map.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ removeHttpHeader()

void gpudb::GPUdb::removeHttpHeader ( const std::string &  header)

Removes the given HTTP header from the map of additional HTTP headers to send to GPUdb with each request.

The user is not allowed to remove the following headers:

  • Authorization
  • Content-type
  • Content-length
  • ha_sync_mode
Parameters
headerthe HTTP header

See getHttpHeaders() See addHttpHeader(const std::string&, const std::string&)

◆ repartitionGraph() [1/4]

RepartitionGraphResponse gpudb::GPUdb::repartitionGraph ( const RepartitionGraphRequest request_) const

Rebalances an existing partitioned graph.

IMPORTANT: It's highly recommended that you review the Graphs & Solvers concepts documentation, the Graph REST Tutorial, and/or some graph examples before using this endpoint.

Parameters
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

◆ repartitionGraph() [2/4]

RepartitionGraphResponse& gpudb::GPUdb::repartitionGraph ( const RepartitionGraphRequest request_,
RepartitionGraphResponse response_ 
) const

Rebalances an existing partitioned graph.

IMPORTANT: It's highly recommended that you review the Graphs & Solvers concepts documentation, the Graph REST Tutorial, and/or some graph examples before using this endpoint.

Parameters
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ repartitionGraph() [3/4]

RepartitionGraphResponse gpudb::GPUdb::repartitionGraph ( const std::string &  graphName,
const std::map< std::string, std::string > &  options 
) const

Rebalances an existing partitioned graph.

IMPORTANT: It's highly recommended that you review the Graphs & Solvers concepts documentation, the Graph REST Tutorial, and/or some graph examples before using this endpoint.

Parameters
[in]graphNameName of the graph resource to rebalance.
[in]optionsOptional parameters.
  • repartition_graph_new_graph_name: If a non-empty value is specified, the original graph will be kept (non-default behaviour) and a new balanced graph will be created under this given name. When the value is empty (default), the generated 'balanced' graph will replace the original 'unbalanced' graph under the same graph name. The default value is ''.
  • repartition_graph_source_node: The distributed shortest path solve is run from this source node to all the nodes in the graph to create balaced partitions using the iso-distance levels of the solution. The source node is selected by the rebalance algorithm automatically (default case when the value is an empty string). Otherwise, the user specified node is used as the source. The default value is ''.
  • repartition_graph_sql_request_avro_json: The default value is ''.
The default value is an empty map.
Returns
Response object containing the result of the operation.

◆ repartitionGraph() [4/4]

RepartitionGraphResponse& gpudb::GPUdb::repartitionGraph ( const std::string &  graphName,
const std::map< std::string, std::string > &  options,
RepartitionGraphResponse response_ 
) const

Rebalances an existing partitioned graph.

IMPORTANT: It's highly recommended that you review the Graphs & Solvers concepts documentation, the Graph REST Tutorial, and/or some graph examples before using this endpoint.

Parameters
[in]graphNameName of the graph resource to rebalance.
[in]optionsOptional parameters.
  • repartition_graph_new_graph_name: If a non-empty value is specified, the original graph will be kept (non-default behaviour) and a new balanced graph will be created under this given name. When the value is empty (default), the generated 'balanced' graph will replace the original 'unbalanced' graph under the same graph name. The default value is ''.
  • repartition_graph_source_node: The distributed shortest path solve is run from this source node to all the nodes in the graph to create balaced partitions using the iso-distance levels of the solution. The source node is selected by the rebalance algorithm automatically (default case when the value is an empty string). Otherwise, the user specified node is used as the source. The default value is ''.
  • repartition_graph_sql_request_avro_json: The default value is ''.
The default value is an empty map.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ revokePermission() [1/4]

RevokePermissionResponse gpudb::GPUdb::revokePermission ( const RevokePermissionRequest request_) const

Revoke user or role the specified permission on the specified object.

Parameters
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

◆ revokePermission() [2/4]

RevokePermissionResponse& gpudb::GPUdb::revokePermission ( const RevokePermissionRequest request_,
RevokePermissionResponse response_ 
) const

Revoke user or role the specified permission on the specified object.

Parameters
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ revokePermission() [3/4]

RevokePermissionResponse gpudb::GPUdb::revokePermission ( const std::string &  principal,
const std::string &  object,
const std::string &  objectType,
const std::string &  permission,
const std::map< std::string, std::string > &  options 
) const

Revoke user or role the specified permission on the specified object.

Parameters
[in]principalName of the user or role for which the permission is being revoked. Must be an existing user or role. The default value is ''.
[in]objectName of object permission is being revoked from. It is recommended to use a fully-qualified name when possible.
[in]objectTypeThe type of object being revoked. Supported values:
[in]permissionPermission being revoked. Supported values:
[in]optionsOptional parameters. The default value is an empty map.
Returns
Response object containing the result of the operation.

◆ revokePermission() [4/4]

RevokePermissionResponse& gpudb::GPUdb::revokePermission ( const std::string &  principal,
const std::string &  object,
const std::string &  objectType,
const std::string &  permission,
const std::map< std::string, std::string > &  options,
RevokePermissionResponse response_ 
) const

Revoke user or role the specified permission on the specified object.

Parameters
[in]principalName of the user or role for which the permission is being revoked. Must be an existing user or role. The default value is ''.
[in]objectName of object permission is being revoked from. It is recommended to use a fully-qualified name when possible.
[in]objectTypeThe type of object being revoked. Supported values:
[in]permissionPermission being revoked. Supported values:
[in]optionsOptional parameters. The default value is an empty map.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ revokePermissionCredential() [1/4]

RevokePermissionCredentialResponse gpudb::GPUdb::revokePermissionCredential ( const RevokePermissionCredentialRequest request_) const

Revokes a credential-level permission from a user or role.

Parameters
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

◆ revokePermissionCredential() [2/4]

RevokePermissionCredentialResponse& gpudb::GPUdb::revokePermissionCredential ( const RevokePermissionCredentialRequest request_,
RevokePermissionCredentialResponse response_ 
) const

Revokes a credential-level permission from a user or role.

Parameters
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ revokePermissionCredential() [3/4]

RevokePermissionCredentialResponse gpudb::GPUdb::revokePermissionCredential ( const std::string &  name,
const std::string &  permission,
const std::string &  credentialName,
const std::map< std::string, std::string > &  options 
) const

Revokes a credential-level permission from a user or role.

Parameters
[in]nameName of the user or role from which the permission will be revoked. Must be an existing user or role.
[in]permissionPermission to revoke from the user or role. Supported values:
[in]credentialNameName of the credential on which the permission will be revoked. Must be an existing credential, or an empty string to revoke access on all credentials.
[in]optionsOptional parameters. The default value is an empty map.
Returns
Response object containing the result of the operation.

◆ revokePermissionCredential() [4/4]

RevokePermissionCredentialResponse& gpudb::GPUdb::revokePermissionCredential ( const std::string &  name,
const std::string &  permission,
const std::string &  credentialName,
const std::map< std::string, std::string > &  options,
RevokePermissionCredentialResponse response_ 
) const

Revokes a credential-level permission from a user or role.

Parameters
[in]nameName of the user or role from which the permission will be revoked. Must be an existing user or role.
[in]permissionPermission to revoke from the user or role. Supported values:
[in]credentialNameName of the credential on which the permission will be revoked. Must be an existing credential, or an empty string to revoke access on all credentials.
[in]optionsOptional parameters. The default value is an empty map.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ revokePermissionDatasource() [1/4]

RevokePermissionDatasourceResponse gpudb::GPUdb::revokePermissionDatasource ( const RevokePermissionDatasourceRequest request_) const

Revokes a data source permission from a user or role.

Parameters
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

◆ revokePermissionDatasource() [2/4]

RevokePermissionDatasourceResponse& gpudb::GPUdb::revokePermissionDatasource ( const RevokePermissionDatasourceRequest request_,
RevokePermissionDatasourceResponse response_ 
) const

Revokes a data source permission from a user or role.

Parameters
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ revokePermissionDatasource() [3/4]

RevokePermissionDatasourceResponse gpudb::GPUdb::revokePermissionDatasource ( const std::string &  name,
const std::string &  permission,
const std::string &  datasourceName,
const std::map< std::string, std::string > &  options 
) const

Revokes a data source permission from a user or role.

Parameters
[in]nameName of the user or role from which the permission will be revoked. Must be an existing user or role.
[in]permissionPermission to revoke from the user or role. Supported values:
[in]datasourceNameName of the data source on which the permission will be revoked. Must be an existing data source, or an empty string to revoke permission from all data sources.
[in]optionsOptional parameters. The default value is an empty map.
Returns
Response object containing the result of the operation.

◆ revokePermissionDatasource() [4/4]

RevokePermissionDatasourceResponse& gpudb::GPUdb::revokePermissionDatasource ( const std::string &  name,
const std::string &  permission,
const std::string &  datasourceName,
const std::map< std::string, std::string > &  options,
RevokePermissionDatasourceResponse response_ 
) const

Revokes a data source permission from a user or role.

Parameters
[in]nameName of the user or role from which the permission will be revoked. Must be an existing user or role.
[in]permissionPermission to revoke from the user or role. Supported values:
[in]datasourceNameName of the data source on which the permission will be revoked. Must be an existing data source, or an empty string to revoke permission from all data sources.
[in]optionsOptional parameters. The default value is an empty map.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ revokePermissionDirectory() [1/4]

RevokePermissionDirectoryResponse gpudb::GPUdb::revokePermissionDirectory ( const RevokePermissionDirectoryRequest request_) const

Revokes a KiFS directory-level permission from a user or role.

Parameters
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

◆ revokePermissionDirectory() [2/4]

RevokePermissionDirectoryResponse& gpudb::GPUdb::revokePermissionDirectory ( const RevokePermissionDirectoryRequest request_,
RevokePermissionDirectoryResponse response_ 
) const

Revokes a KiFS directory-level permission from a user or role.

Parameters
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ revokePermissionDirectory() [3/4]

RevokePermissionDirectoryResponse gpudb::GPUdb::revokePermissionDirectory ( const std::string &  name,
const std::string &  permission,
const std::string &  directoryName,
const std::map< std::string, std::string > &  options 
) const

Revokes a KiFS directory-level permission from a user or role.

Parameters
[in]nameName of the user or role from which the permission will be revoked. Must be an existing user or role.
[in]permissionPermission to revoke from the user or role. Supported values:
[in]directoryNameName of the KiFS directory to which the permission revokes access
[in]optionsOptional parameters. The default value is an empty map.
Returns
Response object containing the result of the operation.

◆ revokePermissionDirectory() [4/4]

RevokePermissionDirectoryResponse& gpudb::GPUdb::revokePermissionDirectory ( const std::string &  name,
const std::string &  permission,
const std::string &  directoryName,
const std::map< std::string, std::string > &  options,
RevokePermissionDirectoryResponse response_ 
) const

Revokes a KiFS directory-level permission from a user or role.

Parameters
[in]nameName of the user or role from which the permission will be revoked. Must be an existing user or role.
[in]permissionPermission to revoke from the user or role. Supported values:
[in]directoryNameName of the KiFS directory to which the permission revokes access
[in]optionsOptional parameters. The default value is an empty map.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ revokePermissionProc() [1/4]

RevokePermissionProcResponse gpudb::GPUdb::revokePermissionProc ( const RevokePermissionProcRequest request_) const

Revokes a proc-level permission from a user or role.

Parameters
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

◆ revokePermissionProc() [2/4]

RevokePermissionProcResponse& gpudb::GPUdb::revokePermissionProc ( const RevokePermissionProcRequest request_,
RevokePermissionProcResponse response_ 
) const

Revokes a proc-level permission from a user or role.

Parameters
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ revokePermissionProc() [3/4]

RevokePermissionProcResponse gpudb::GPUdb::revokePermissionProc ( const std::string &  name,
const std::string &  permission,
const std::string &  procName,
const std::map< std::string, std::string > &  options 
) const

Revokes a proc-level permission from a user or role.

Parameters
[in]nameName of the user or role from which the permission will be revoked. Must be an existing user or role.
[in]permissionPermission to revoke from the user or role. Supported values:
[in]procNameName of the proc to which the permission grants access. Must be an existing proc, or an empty string if the permission grants access to all procs.
[in]optionsOptional parameters. The default value is an empty map.
Returns
Response object containing the result of the operation.

◆ revokePermissionProc() [4/4]

RevokePermissionProcResponse& gpudb::GPUdb::revokePermissionProc ( const std::string &  name,
const std::string &  permission,
const std::string &  procName,
const std::map< std::string, std::string > &  options,
RevokePermissionProcResponse response_ 
) const

Revokes a proc-level permission from a user or role.

Parameters
[in]nameName of the user or role from which the permission will be revoked. Must be an existing user or role.
[in]permissionPermission to revoke from the user or role. Supported values:
[in]procNameName of the proc to which the permission grants access. Must be an existing proc, or an empty string if the permission grants access to all procs.
[in]optionsOptional parameters. The default value is an empty map.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ revokePermissionSystem() [1/4]

RevokePermissionSystemResponse gpudb::GPUdb::revokePermissionSystem ( const RevokePermissionSystemRequest request_) const

Revokes a system-level permission from a user or role.

Parameters
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

◆ revokePermissionSystem() [2/4]

RevokePermissionSystemResponse& gpudb::GPUdb::revokePermissionSystem ( const RevokePermissionSystemRequest request_,
RevokePermissionSystemResponse response_ 
) const

Revokes a system-level permission from a user or role.

Parameters
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ revokePermissionSystem() [3/4]

RevokePermissionSystemResponse gpudb::GPUdb::revokePermissionSystem ( const std::string &  name,
const std::string &  permission,
const std::map< std::string, std::string > &  options 
) const

Revokes a system-level permission from a user or role.

Parameters
[in]nameName of the user or role from which the permission will be revoked. Must be an existing user or role.
[in]permissionPermission to revoke from the user or role. Supported values:
[in]optionsOptional parameters. The default value is an empty map.
Returns
Response object containing the result of the operation.

◆ revokePermissionSystem() [4/4]

RevokePermissionSystemResponse& gpudb::GPUdb::revokePermissionSystem ( const std::string &  name,
const std::string &  permission,
const std::map< std::string, std::string > &  options,
RevokePermissionSystemResponse response_ 
) const

Revokes a system-level permission from a user or role.

Parameters
[in]nameName of the user or role from which the permission will be revoked. Must be an existing user or role.
[in]permissionPermission to revoke from the user or role. Supported values:
[in]optionsOptional parameters. The default value is an empty map.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ revokePermissionTable() [1/4]

RevokePermissionTableResponse gpudb::GPUdb::revokePermissionTable ( const RevokePermissionTableRequest request_) const

Revokes a table-level permission from a user or role.

Parameters
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

◆ revokePermissionTable() [2/4]

RevokePermissionTableResponse& gpudb::GPUdb::revokePermissionTable ( const RevokePermissionTableRequest request_,
RevokePermissionTableResponse response_ 
) const

Revokes a table-level permission from a user or role.

Parameters
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ revokePermissionTable() [3/4]

RevokePermissionTableResponse gpudb::GPUdb::revokePermissionTable ( const std::string &  name,
const std::string &  permission,
const std::string &  tableName,
const std::map< std::string, std::string > &  options 
) const

Revokes a table-level permission from a user or role.

Parameters
[in]nameName of the user or role from which the permission will be revoked. Must be an existing user or role.
[in]permissionPermission to revoke from the user or role. Supported values:
[in]tableNameName of the table to which the permission grants access, in [schema_name.]table_name format, using standard name resolution rules. Must be an existing table, view or schema.
[in]optionsOptional parameters. The default value is an empty map.
Returns
Response object containing the result of the operation.

◆ revokePermissionTable() [4/4]

RevokePermissionTableResponse& gpudb::GPUdb::revokePermissionTable ( const std::string &  name,
const std::string &  permission,
const std::string &  tableName,
const std::map< std::string, std::string > &  options,
RevokePermissionTableResponse response_ 
) const

Revokes a table-level permission from a user or role.

Parameters
[in]nameName of the user or role from which the permission will be revoked. Must be an existing user or role.
[in]permissionPermission to revoke from the user or role. Supported values:
[in]tableNameName of the table to which the permission grants access, in [schema_name.]table_name format, using standard name resolution rules. Must be an existing table, view or schema.
[in]optionsOptional parameters. The default value is an empty map.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ revokeRole() [1/4]

RevokeRoleResponse gpudb::GPUdb::revokeRole ( const RevokeRoleRequest request_) const

Revokes membership in a role from a user or role.

Parameters
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

◆ revokeRole() [2/4]

RevokeRoleResponse& gpudb::GPUdb::revokeRole ( const RevokeRoleRequest request_,
RevokeRoleResponse response_ 
) const

Revokes membership in a role from a user or role.

Parameters
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ revokeRole() [3/4]

RevokeRoleResponse gpudb::GPUdb::revokeRole ( const std::string &  role,
const std::string &  member,
const std::map< std::string, std::string > &  options 
) const

Revokes membership in a role from a user or role.

Parameters
[in]roleName of the role in which membership will be revoked. Must be an existing role.
[in]memberName of the user or role that will be revoked membership in role. Must be an existing user or role.
[in]optionsOptional parameters. The default value is an empty map.
Returns
Response object containing the result of the operation.

◆ revokeRole() [4/4]

RevokeRoleResponse& gpudb::GPUdb::revokeRole ( const std::string &  role,
const std::string &  member,
const std::map< std::string, std::string > &  options,
RevokeRoleResponse response_ 
) const

Revokes membership in a role from a user or role.

Parameters
[in]roleName of the role in which membership will be revoked. Must be an existing role.
[in]memberName of the user or role that will be revoked membership in role. Must be an existing user or role.
[in]optionsOptional parameters. The default value is an empty map.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ setHASyncMode()

void gpudb::GPUdb::setHASyncMode ( HASynchronicityMode  mode)

Sets the high-availability synchronization mode which will override the default mode.

◆ showCredential() [1/4]

ShowCredentialResponse gpudb::GPUdb::showCredential ( const ShowCredentialRequest request_) const

Shows information about a specified credential or all credentials.

Parameters
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

◆ showCredential() [2/4]

ShowCredentialResponse& gpudb::GPUdb::showCredential ( const ShowCredentialRequest request_,
ShowCredentialResponse response_ 
) const

Shows information about a specified credential or all credentials.

Parameters
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ showCredential() [3/4]

ShowCredentialResponse gpudb::GPUdb::showCredential ( const std::string &  credentialName,
const std::map< std::string, std::string > &  options 
) const

Shows information about a specified credential or all credentials.

Parameters
[in]credentialNameName of the credential on which to retrieve information. The name must refer to a currently existing credential. If '*' is specified, information about all credentials will be returned.
[in]optionsOptional parameters. The default value is an empty map.
Returns
Response object containing the result of the operation.

◆ showCredential() [4/4]

ShowCredentialResponse& gpudb::GPUdb::showCredential ( const std::string &  credentialName,
const std::map< std::string, std::string > &  options,
ShowCredentialResponse response_ 
) const

Shows information about a specified credential or all credentials.

Parameters
[in]credentialNameName of the credential on which to retrieve information. The name must refer to a currently existing credential. If '*' is specified, information about all credentials will be returned.
[in]optionsOptional parameters. The default value is an empty map.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ showDatasink() [1/4]

ShowDatasinkResponse gpudb::GPUdb::showDatasink ( const ShowDatasinkRequest request_) const

Shows information about a specified data sink or all data sinks.

Parameters
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

◆ showDatasink() [2/4]

ShowDatasinkResponse& gpudb::GPUdb::showDatasink ( const ShowDatasinkRequest request_,
ShowDatasinkResponse response_ 
) const

Shows information about a specified data sink or all data sinks.

Parameters
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ showDatasink() [3/4]

ShowDatasinkResponse gpudb::GPUdb::showDatasink ( const std::string &  name,
const std::map< std::string, std::string > &  options 
) const

Shows information about a specified data sink or all data sinks.

Parameters
[in]nameName of the data sink for which to retrieve information. The name must refer to a currently existing data sink. If '*' is specified, information about all data sinks will be returned.
[in]optionsOptional parameters. The default value is an empty map.
Returns
Response object containing the result of the operation.

◆ showDatasink() [4/4]

ShowDatasinkResponse& gpudb::GPUdb::showDatasink ( const std::string &  name,
const std::map< std::string, std::string > &  options,
ShowDatasinkResponse response_ 
) const

Shows information about a specified data sink or all data sinks.

Parameters
[in]nameName of the data sink for which to retrieve information. The name must refer to a currently existing data sink. If '*' is specified, information about all data sinks will be returned.
[in]optionsOptional parameters. The default value is an empty map.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ showDatasource() [1/4]

ShowDatasourceResponse gpudb::GPUdb::showDatasource ( const ShowDatasourceRequest request_) const

Shows information about a specified data source or all data sources.

Parameters
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

◆ showDatasource() [2/4]

ShowDatasourceResponse& gpudb::GPUdb::showDatasource ( const ShowDatasourceRequest request_,
ShowDatasourceResponse response_ 
) const

Shows information about a specified data source or all data sources.

Parameters
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ showDatasource() [3/4]

ShowDatasourceResponse gpudb::GPUdb::showDatasource ( const std::string &  name,
const std::map< std::string, std::string > &  options 
) const

Shows information about a specified data source or all data sources.

Parameters
[in]nameName of the data source for which to retrieve information. The name must refer to a currently existing data source. If '*' is specified, information about all data sources will be returned.
[in]optionsOptional parameters. The default value is an empty map.
Returns
Response object containing the result of the operation.

◆ showDatasource() [4/4]

ShowDatasourceResponse& gpudb::GPUdb::showDatasource ( const std::string &  name,
const std::map< std::string, std::string > &  options,
ShowDatasourceResponse response_ 
) const

Shows information about a specified data source or all data sources.

Parameters
[in]nameName of the data source for which to retrieve information. The name must refer to a currently existing data source. If '*' is specified, information about all data sources will be returned.
[in]optionsOptional parameters. The default value is an empty map.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ showDirectories() [1/4]

ShowDirectoriesResponse gpudb::GPUdb::showDirectories ( const ShowDirectoriesRequest request_) const

Shows information about directories in KiFS.

Can be used to show a single directory, or all directories.

Parameters
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

◆ showDirectories() [2/4]

ShowDirectoriesResponse& gpudb::GPUdb::showDirectories ( const ShowDirectoriesRequest request_,
ShowDirectoriesResponse response_ 
) const

Shows information about directories in KiFS.

Can be used to show a single directory, or all directories.

Parameters
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ showDirectories() [3/4]

ShowDirectoriesResponse gpudb::GPUdb::showDirectories ( const std::string &  directoryName,
const std::map< std::string, std::string > &  options 
) const

Shows information about directories in KiFS.

Can be used to show a single directory, or all directories.

Parameters
[in]directoryNameThe KiFS directory name to show. If empty, shows all directories. The default value is ''.
[in]optionsOptional parameters. The default value is an empty map.
Returns
Response object containing the result of the operation.

◆ showDirectories() [4/4]

ShowDirectoriesResponse& gpudb::GPUdb::showDirectories ( const std::string &  directoryName,
const std::map< std::string, std::string > &  options,
ShowDirectoriesResponse response_ 
) const

Shows information about directories in KiFS.

Can be used to show a single directory, or all directories.

Parameters
[in]directoryNameThe KiFS directory name to show. If empty, shows all directories. The default value is ''.
[in]optionsOptional parameters. The default value is an empty map.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ showEnvironment() [1/4]

ShowEnvironmentResponse gpudb::GPUdb::showEnvironment ( const ShowEnvironmentRequest request_) const

Shows information about a specified user-defined function (UDF) environment or all environments.

Returns detailed information about existing environments.

Parameters
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

◆ showEnvironment() [2/4]

ShowEnvironmentResponse& gpudb::GPUdb::showEnvironment ( const ShowEnvironmentRequest request_,
ShowEnvironmentResponse response_ 
) const

Shows information about a specified user-defined function (UDF) environment or all environments.

Returns detailed information about existing environments.

Parameters
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ showEnvironment() [3/4]

ShowEnvironmentResponse gpudb::GPUdb::showEnvironment ( const std::string &  environmentName,
const std::map< std::string, std::string > &  options 
) const

Shows information about a specified user-defined function (UDF) environment or all environments.

Returns detailed information about existing environments.

Parameters
[in]environmentNameName of the environment on which to retrieve information. The name must refer to a currently existing environment. If '*' or an empty value is specified, information about all environments will be returned. The default value is ''.
[in]optionsOptional parameters. The default value is an empty map.
Returns
Response object containing the result of the operation.

◆ showEnvironment() [4/4]

ShowEnvironmentResponse& gpudb::GPUdb::showEnvironment ( const std::string &  environmentName,
const std::map< std::string, std::string > &  options,
ShowEnvironmentResponse response_ 
) const

Shows information about a specified user-defined function (UDF) environment or all environments.

Returns detailed information about existing environments.

Parameters
[in]environmentNameName of the environment on which to retrieve information. The name must refer to a currently existing environment. If '*' or an empty value is specified, information about all environments will be returned. The default value is ''.
[in]optionsOptional parameters. The default value is an empty map.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ showFiles() [1/4]

ShowFilesResponse gpudb::GPUdb::showFiles ( const ShowFilesRequest request_) const

Shows information about files in KiFS.

Can be used for individual files, or to show all files in a given directory.

Parameters
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

◆ showFiles() [2/4]

ShowFilesResponse& gpudb::GPUdb::showFiles ( const ShowFilesRequest request_,
ShowFilesResponse response_ 
) const

Shows information about files in KiFS.

Can be used for individual files, or to show all files in a given directory.

Parameters
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ showFiles() [3/4]

ShowFilesResponse gpudb::GPUdb::showFiles ( const std::vector< std::string > &  paths,
const std::map< std::string, std::string > &  options 
) const

Shows information about files in KiFS.

Can be used for individual files, or to show all files in a given directory.

Parameters
[in]pathsFile paths to show. Each path can be a KiFS directory name, or a full path to a KiFS file. File paths may contain wildcard characters after the KiFS directory delimeter. Accepted wildcard characters are asterisk (*) to represent any string of zero or more characters, and question mark (?) to indicate a single character.
[in]optionsOptional parameters. The default value is an empty map.
Returns
Response object containing the result of the operation.

◆ showFiles() [4/4]

ShowFilesResponse& gpudb::GPUdb::showFiles ( const std::vector< std::string > &  paths,
const std::map< std::string, std::string > &  options,
ShowFilesResponse response_ 
) const

Shows information about files in KiFS.

Can be used for individual files, or to show all files in a given directory.

Parameters
[in]pathsFile paths to show. Each path can be a KiFS directory name, or a full path to a KiFS file. File paths may contain wildcard characters after the KiFS directory delimeter. Accepted wildcard characters are asterisk (*) to represent any string of zero or more characters, and question mark (?) to indicate a single character.
[in]optionsOptional parameters. The default value is an empty map.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ showGraph() [1/4]

ShowGraphResponse gpudb::GPUdb::showGraph ( const ShowGraphRequest request_) const

Shows information and characteristics of graphs that exist on the graph server.

Parameters
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

◆ showGraph() [2/4]

ShowGraphResponse& gpudb::GPUdb::showGraph ( const ShowGraphRequest request_,
ShowGraphResponse response_ 
) const

Shows information and characteristics of graphs that exist on the graph server.

Parameters
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ showGraph() [3/4]

ShowGraphResponse gpudb::GPUdb::showGraph ( const std::string &  graphName,
const std::map< std::string, std::string > &  options 
) const

Shows information and characteristics of graphs that exist on the graph server.

Parameters
[in]graphNameName of the graph on which to retrieve information. If left as the default value, information about all graphs is returned. The default value is ''.
[in]optionsOptional parameters. The default value is an empty map.
Returns
Response object containing the result of the operation.

◆ showGraph() [4/4]

ShowGraphResponse& gpudb::GPUdb::showGraph ( const std::string &  graphName,
const std::map< std::string, std::string > &  options,
ShowGraphResponse response_ 
) const

Shows information and characteristics of graphs that exist on the graph server.

Parameters
[in]graphNameName of the graph on which to retrieve information. If left as the default value, information about all graphs is returned. The default value is ''.
[in]optionsOptional parameters. The default value is an empty map.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ showProc() [1/4]

ShowProcResponse gpudb::GPUdb::showProc ( const ShowProcRequest request_) const

Shows information about a proc.

Parameters
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

◆ showProc() [2/4]

ShowProcResponse& gpudb::GPUdb::showProc ( const ShowProcRequest request_,
ShowProcResponse response_ 
) const

Shows information about a proc.

Parameters
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ showProc() [3/4]

ShowProcResponse gpudb::GPUdb::showProc ( const std::string &  procName,
const std::map< std::string, std::string > &  options 
) const

Shows information about a proc.

Parameters
[in]procNameName of the proc to show information about. If specified, must be the name of a currently existing proc. If not specified, information about all procs will be returned. The default value is ''.
[in]optionsOptional parameters. The default value is an empty map.
Returns
Response object containing the result of the operation.

◆ showProc() [4/4]

ShowProcResponse& gpudb::GPUdb::showProc ( const std::string &  procName,
const std::map< std::string, std::string > &  options,
ShowProcResponse response_ 
) const

Shows information about a proc.

Parameters
[in]procNameName of the proc to show information about. If specified, must be the name of a currently existing proc. If not specified, information about all procs will be returned. The default value is ''.
[in]optionsOptional parameters. The default value is an empty map.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ showProcStatus() [1/4]

ShowProcStatusResponse gpudb::GPUdb::showProcStatus ( const ShowProcStatusRequest request_) const

Shows the statuses of running or completed proc instances.

Results are grouped by run ID (as returned from executeProc) and data segment ID (each invocation of the proc command on a data segment is assigned a data segment ID).

Parameters
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

◆ showProcStatus() [2/4]

ShowProcStatusResponse& gpudb::GPUdb::showProcStatus ( const ShowProcStatusRequest request_,
ShowProcStatusResponse response_ 
) const

Shows the statuses of running or completed proc instances.

Results are grouped by run ID (as returned from executeProc) and data segment ID (each invocation of the proc command on a data segment is assigned a data segment ID).

Parameters
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ showProcStatus() [3/4]

ShowProcStatusResponse gpudb::GPUdb::showProcStatus ( const std::string &  runId,
const std::map< std::string, std::string > &  options 
) const

Shows the statuses of running or completed proc instances.

Results are grouped by run ID (as returned from executeProc) and data segment ID (each invocation of the proc command on a data segment is assigned a data segment ID).

Parameters
[in]runIdThe run ID of a specific proc instance for which the status will be returned. If a proc with a matching run ID is not found, the response will be empty. If not specified, the statuses of all executed proc instances will be returned. The default value is ''.
[in]optionsOptional parameters. The default value is an empty map.
Returns
Response object containing the result of the operation.

◆ showProcStatus() [4/4]

ShowProcStatusResponse& gpudb::GPUdb::showProcStatus ( const std::string &  runId,
const std::map< std::string, std::string > &  options,
ShowProcStatusResponse response_ 
) const

Shows the statuses of running or completed proc instances.

Results are grouped by run ID (as returned from executeProc) and data segment ID (each invocation of the proc command on a data segment is assigned a data segment ID).

Parameters
[in]runIdThe run ID of a specific proc instance for which the status will be returned. If a proc with a matching run ID is not found, the response will be empty. If not specified, the statuses of all executed proc instances will be returned. The default value is ''.
[in]optionsOptional parameters. The default value is an empty map.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ showResourceGroups() [1/4]

ShowResourceGroupsResponse gpudb::GPUdb::showResourceGroups ( const ShowResourceGroupsRequest request_) const

Requests resource group properties.

Returns detailed information about the requested resource groups.

Parameters
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

◆ showResourceGroups() [2/4]

ShowResourceGroupsResponse& gpudb::GPUdb::showResourceGroups ( const ShowResourceGroupsRequest request_,
ShowResourceGroupsResponse response_ 
) const

Requests resource group properties.

Returns detailed information about the requested resource groups.

Parameters
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ showResourceGroups() [3/4]

ShowResourceGroupsResponse gpudb::GPUdb::showResourceGroups ( const std::vector< std::string > &  names,
const std::map< std::string, std::string > &  options 
) const

Requests resource group properties.

Returns detailed information about the requested resource groups.

Parameters
[in]namesList of names of groups to be shown. A single entry with an empty string returns all groups.
[in]optionsOptional parameters. The default value is an empty map.
Returns
Response object containing the result of the operation.

◆ showResourceGroups() [4/4]

ShowResourceGroupsResponse& gpudb::GPUdb::showResourceGroups ( const std::vector< std::string > &  names,
const std::map< std::string, std::string > &  options,
ShowResourceGroupsResponse response_ 
) const

Requests resource group properties.

Returns detailed information about the requested resource groups.

Parameters
[in]namesList of names of groups to be shown. A single entry with an empty string returns all groups.
[in]optionsOptional parameters. The default value is an empty map.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ showResourceObjects() [1/4]

ShowResourceObjectsResponse gpudb::GPUdb::showResourceObjects ( const ShowResourceObjectsRequest request_) const

Returns information about the internal sub-components (tiered objects) which use resources of the system.

The request can either return results from actively used objects (default) or it can be used to query the status of the objects of a given list of tables. Returns detailed information about the requested resource objects.

Parameters
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

◆ showResourceObjects() [2/4]

ShowResourceObjectsResponse& gpudb::GPUdb::showResourceObjects ( const ShowResourceObjectsRequest request_,
ShowResourceObjectsResponse response_ 
) const

Returns information about the internal sub-components (tiered objects) which use resources of the system.

The request can either return results from actively used objects (default) or it can be used to query the status of the objects of a given list of tables. Returns detailed information about the requested resource objects.

Parameters
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ showResourceObjects() [3/4]

ShowResourceObjectsResponse gpudb::GPUdb::showResourceObjects ( const std::map< std::string, std::string > &  options) const

Returns information about the internal sub-components (tiered objects) which use resources of the system.

The request can either return results from actively used objects (default) or it can be used to query the status of the objects of a given list of tables. Returns detailed information about the requested resource objects.

Parameters
[in]optionsOptional parameters. The default value is an empty map.
Returns
Response object containing the result of the operation.

◆ showResourceObjects() [4/4]

ShowResourceObjectsResponse& gpudb::GPUdb::showResourceObjects ( const std::map< std::string, std::string > &  options,
ShowResourceObjectsResponse response_ 
) const

Returns information about the internal sub-components (tiered objects) which use resources of the system.

The request can either return results from actively used objects (default) or it can be used to query the status of the objects of a given list of tables. Returns detailed information about the requested resource objects.

Parameters
[in]optionsOptional parameters. The default value is an empty map.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ showResourceStatistics() [1/4]

ShowResourceStatisticsResponse gpudb::GPUdb::showResourceStatistics ( const ShowResourceStatisticsRequest request_) const

Requests various statistics for storage/memory tiers and resource groups.

Returns statistics on a per-rank basis.

Parameters
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

◆ showResourceStatistics() [2/4]

ShowResourceStatisticsResponse& gpudb::GPUdb::showResourceStatistics ( const ShowResourceStatisticsRequest request_,
ShowResourceStatisticsResponse response_ 
) const

Requests various statistics for storage/memory tiers and resource groups.

Returns statistics on a per-rank basis.

Parameters
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ showResourceStatistics() [3/4]

ShowResourceStatisticsResponse gpudb::GPUdb::showResourceStatistics ( const std::map< std::string, std::string > &  options) const

Requests various statistics for storage/memory tiers and resource groups.

Returns statistics on a per-rank basis.

Parameters
[in]optionsOptional parameters. The default value is an empty map.
Returns
Response object containing the result of the operation.

◆ showResourceStatistics() [4/4]

ShowResourceStatisticsResponse& gpudb::GPUdb::showResourceStatistics ( const std::map< std::string, std::string > &  options,
ShowResourceStatisticsResponse response_ 
) const

Requests various statistics for storage/memory tiers and resource groups.

Returns statistics on a per-rank basis.

Parameters
[in]optionsOptional parameters. The default value is an empty map.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ showSchema() [1/4]

ShowSchemaResponse gpudb::GPUdb::showSchema ( const ShowSchemaRequest request_) const

Retrieves information about a schema (or all schemas), as specified in schemaName.

Parameters
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

◆ showSchema() [2/4]

ShowSchemaResponse& gpudb::GPUdb::showSchema ( const ShowSchemaRequest request_,
ShowSchemaResponse response_ 
) const

Retrieves information about a schema (or all schemas), as specified in schemaName.

Parameters
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ showSchema() [3/4]

ShowSchemaResponse gpudb::GPUdb::showSchema ( const std::string &  schemaName,
const std::map< std::string, std::string > &  options 
) const

Retrieves information about a schema (or all schemas), as specified in schemaName.

Parameters
[in]schemaNameName of the schema for which to retrieve the information. If blank, then info for all schemas is returned.
[in]optionsOptional parameters. The default value is an empty map.
Returns
Response object containing the result of the operation.

◆ showSchema() [4/4]

ShowSchemaResponse& gpudb::GPUdb::showSchema ( const std::string &  schemaName,
const std::map< std::string, std::string > &  options,
ShowSchemaResponse response_ 
) const

Retrieves information about a schema (or all schemas), as specified in schemaName.

Parameters
[in]schemaNameName of the schema for which to retrieve the information. If blank, then info for all schemas is returned.
[in]optionsOptional parameters. The default value is an empty map.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ showSecurity() [1/4]

ShowSecurityResponse gpudb::GPUdb::showSecurity ( const ShowSecurityRequest request_) const

Shows security information relating to users and/or roles.

If the caller is not a system administrator, only information relating to the caller and their roles is returned.

Parameters
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

◆ showSecurity() [2/4]

ShowSecurityResponse& gpudb::GPUdb::showSecurity ( const ShowSecurityRequest request_,
ShowSecurityResponse response_ 
) const

Shows security information relating to users and/or roles.

If the caller is not a system administrator, only information relating to the caller and their roles is returned.

Parameters
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ showSecurity() [3/4]

ShowSecurityResponse gpudb::GPUdb::showSecurity ( const std::vector< std::string > &  names,
const std::map< std::string, std::string > &  options 
) const

Shows security information relating to users and/or roles.

If the caller is not a system administrator, only information relating to the caller and their roles is returned.

Parameters
[in]namesA list of names of users and/or roles about which security information is requested. If none are provided, information about all users and roles will be returned.
[in]optionsOptional parameters. The default value is an empty map.
Returns
Response object containing the result of the operation.

◆ showSecurity() [4/4]

ShowSecurityResponse& gpudb::GPUdb::showSecurity ( const std::vector< std::string > &  names,
const std::map< std::string, std::string > &  options,
ShowSecurityResponse response_ 
) const

Shows security information relating to users and/or roles.

If the caller is not a system administrator, only information relating to the caller and their roles is returned.

Parameters
[in]namesA list of names of users and/or roles about which security information is requested. If none are provided, information about all users and roles will be returned.
[in]optionsOptional parameters. The default value is an empty map.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ showSqlProc() [1/4]

ShowSqlProcResponse gpudb::GPUdb::showSqlProc ( const ShowSqlProcRequest request_) const

Shows information about SQL procedures, including the full definition of each requested procedure.

Parameters
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

◆ showSqlProc() [2/4]

ShowSqlProcResponse& gpudb::GPUdb::showSqlProc ( const ShowSqlProcRequest request_,
ShowSqlProcResponse response_ 
) const

Shows information about SQL procedures, including the full definition of each requested procedure.

Parameters
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ showSqlProc() [3/4]

ShowSqlProcResponse gpudb::GPUdb::showSqlProc ( const std::string &  procedureName,
const std::map< std::string, std::string > &  options 
) const

Shows information about SQL procedures, including the full definition of each requested procedure.

Parameters
[in]procedureNameName of the procedure for which to retrieve the information. If blank, then information about all procedures is returned. The default value is ''.
[in]optionsOptional parameters. The default value is an empty map.
Returns
Response object containing the result of the operation.

◆ showSqlProc() [4/4]

ShowSqlProcResponse& gpudb::GPUdb::showSqlProc ( const std::string &  procedureName,
const std::map< std::string, std::string > &  options,
ShowSqlProcResponse response_ 
) const

Shows information about SQL procedures, including the full definition of each requested procedure.

Parameters
[in]procedureNameName of the procedure for which to retrieve the information. If blank, then information about all procedures is returned. The default value is ''.
[in]optionsOptional parameters. The default value is an empty map.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ showStatistics() [1/4]

ShowStatisticsResponse gpudb::GPUdb::showStatistics ( const ShowStatisticsRequest request_) const

Retrieves the collected column statistics for the specified table(s).

Parameters
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

◆ showStatistics() [2/4]

ShowStatisticsResponse& gpudb::GPUdb::showStatistics ( const ShowStatisticsRequest request_,
ShowStatisticsResponse response_ 
) const

Retrieves the collected column statistics for the specified table(s).

Parameters
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ showStatistics() [3/4]

ShowStatisticsResponse gpudb::GPUdb::showStatistics ( const std::vector< std::string > &  tableNames,
const std::map< std::string, std::string > &  options 
) const

Retrieves the collected column statistics for the specified table(s).

Parameters
[in]tableNamesNames of tables whose metadata will be fetched, each in [schema_name.]table_name format, using standard name resolution rules. All provided tables must exist, or an error is returned.
[in]optionsOptional parameters. The default value is an empty map.
Returns
Response object containing the result of the operation.

◆ showStatistics() [4/4]

ShowStatisticsResponse& gpudb::GPUdb::showStatistics ( const std::vector< std::string > &  tableNames,
const std::map< std::string, std::string > &  options,
ShowStatisticsResponse response_ 
) const

Retrieves the collected column statistics for the specified table(s).

Parameters
[in]tableNamesNames of tables whose metadata will be fetched, each in [schema_name.]table_name format, using standard name resolution rules. All provided tables must exist, or an error is returned.
[in]optionsOptional parameters. The default value is an empty map.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ showSystemProperties() [1/4]

ShowSystemPropertiesResponse gpudb::GPUdb::showSystemProperties ( const ShowSystemPropertiesRequest request_) const

Returns server configuration and version related information to the caller.

The admin tool uses it to present server related information to the user.

Parameters
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

◆ showSystemProperties() [2/4]

ShowSystemPropertiesResponse& gpudb::GPUdb::showSystemProperties ( const ShowSystemPropertiesRequest request_,
ShowSystemPropertiesResponse response_ 
) const

Returns server configuration and version related information to the caller.

The admin tool uses it to present server related information to the user.

Parameters
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ showSystemProperties() [3/4]

ShowSystemPropertiesResponse gpudb::GPUdb::showSystemProperties ( const std::map< std::string, std::string > &  options) const

Returns server configuration and version related information to the caller.

The admin tool uses it to present server related information to the user.

Parameters
[in]optionsOptional parameters. The default value is an empty map.
Returns
Response object containing the result of the operation.

◆ showSystemProperties() [4/4]

ShowSystemPropertiesResponse& gpudb::GPUdb::showSystemProperties ( const std::map< std::string, std::string > &  options,
ShowSystemPropertiesResponse response_ 
) const

Returns server configuration and version related information to the caller.

The admin tool uses it to present server related information to the user.

Parameters
[in]optionsOptional parameters. The default value is an empty map.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ showSystemStatus() [1/4]

ShowSystemStatusResponse gpudb::GPUdb::showSystemStatus ( const ShowSystemStatusRequest request_) const

Provides server configuration and health related status to the caller.

The admin tool uses it to present server related information to the user.

Parameters
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

◆ showSystemStatus() [2/4]

ShowSystemStatusResponse& gpudb::GPUdb::showSystemStatus ( const ShowSystemStatusRequest request_,
ShowSystemStatusResponse response_ 
) const

Provides server configuration and health related status to the caller.

The admin tool uses it to present server related information to the user.

Parameters
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ showSystemStatus() [3/4]

ShowSystemStatusResponse gpudb::GPUdb::showSystemStatus ( const std::map< std::string, std::string > &  options) const

Provides server configuration and health related status to the caller.

The admin tool uses it to present server related information to the user.

Parameters
[in]optionsOptional parameters, currently unused. The default value is an empty map.
Returns
Response object containing the result of the operation.

◆ showSystemStatus() [4/4]

ShowSystemStatusResponse& gpudb::GPUdb::showSystemStatus ( const std::map< std::string, std::string > &  options,
ShowSystemStatusResponse response_ 
) const

Provides server configuration and health related status to the caller.

The admin tool uses it to present server related information to the user.

Parameters
[in]optionsOptional parameters, currently unused. The default value is an empty map.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ showSystemTiming() [1/4]

ShowSystemTimingResponse gpudb::GPUdb::showSystemTiming ( const ShowSystemTimingRequest request_) const

Returns the last 100 database requests along with the request timing and internal job id.

The admin tool uses it to present request timing information to the user.

Parameters
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

◆ showSystemTiming() [2/4]

ShowSystemTimingResponse& gpudb::GPUdb::showSystemTiming ( const ShowSystemTimingRequest request_,
ShowSystemTimingResponse response_ 
) const

Returns the last 100 database requests along with the request timing and internal job id.

The admin tool uses it to present request timing information to the user.

Parameters
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ showSystemTiming() [3/4]

ShowSystemTimingResponse gpudb::GPUdb::showSystemTiming ( const std::map< std::string, std::string > &  options) const

Returns the last 100 database requests along with the request timing and internal job id.

The admin tool uses it to present request timing information to the user.

Parameters
[in]optionsOptional parameters, currently unused. The default value is an empty map.
Returns
Response object containing the result of the operation.

◆ showSystemTiming() [4/4]

ShowSystemTimingResponse& gpudb::GPUdb::showSystemTiming ( const std::map< std::string, std::string > &  options,
ShowSystemTimingResponse response_ 
) const

Returns the last 100 database requests along with the request timing and internal job id.

The admin tool uses it to present request timing information to the user.

Parameters
[in]optionsOptional parameters, currently unused. The default value is an empty map.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ showTable() [1/4]

ShowTableResponse gpudb::GPUdb::showTable ( const ShowTableRequest request_) const

Retrieves detailed information about a table, view, or schema, specified in tableName.

If the supplied tableName is a schema the call can return information about either the schema itself or the tables and views it contains. If tableName is empty, information about all schemas will be returned.

If the option get_sizes is set to true, then the number of records in each table is returned (in sizes and fullSizes), along with the total number of objects across all requested tables (in totalSize and totalFullSize).

For a schema, setting the show_children option to false returns only information about the schema itself; setting show_children to true returns a list of tables and views contained in the schema, along with their corresponding detail.

To retrieve a list of every table, view, and schema in the database, set tableName to '*' and show_children to true. When doing this, the returned totalSize and totalFullSize will not include the sizes of non-base tables (e.g., filters, views, joins, etc.).

Parameters
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

◆ showTable() [2/4]

ShowTableResponse& gpudb::GPUdb::showTable ( const ShowTableRequest request_,
ShowTableResponse response_ 
) const

Retrieves detailed information about a table, view, or schema, specified in tableName.

If the supplied tableName is a schema the call can return information about either the schema itself or the tables and views it contains. If tableName is empty, information about all schemas will be returned.

If the option get_sizes is set to true, then the number of records in each table is returned (in sizes and fullSizes), along with the total number of objects across all requested tables (in totalSize and totalFullSize).

For a schema, setting the show_children option to false returns only information about the schema itself; setting show_children to true returns a list of tables and views contained in the schema, along with their corresponding detail.

To retrieve a list of every table, view, and schema in the database, set tableName to '*' and show_children to true. When doing this, the returned totalSize and totalFullSize will not include the sizes of non-base tables (e.g., filters, views, joins, etc.).

Parameters
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ showTable() [3/4]

ShowTableResponse gpudb::GPUdb::showTable ( const std::string &  tableName,
const std::map< std::string, std::string > &  options 
) const

Retrieves detailed information about a table, view, or schema, specified in tableName.

If the supplied tableName is a schema the call can return information about either the schema itself or the tables and views it contains. If tableName is empty, information about all schemas will be returned.

If the option get_sizes is set to true, then the number of records in each table is returned (in sizes and fullSizes), along with the total number of objects across all requested tables (in totalSize and totalFullSize).

For a schema, setting the show_children option to false returns only information about the schema itself; setting show_children to true returns a list of tables and views contained in the schema, along with their corresponding detail.

To retrieve a list of every table, view, and schema in the database, set tableName to '*' and show_children to true. When doing this, the returned totalSize and totalFullSize will not include the sizes of non-base tables (e.g., filters, views, joins, etc.).

Parameters
[in]tableNameName of the table for which to retrieve the information, in [schema_name.]table_name format, using standard name resolution rules. If blank, then returns information about all tables and views.
[in]optionsOptional parameters. The default value is an empty map.
Returns
Response object containing the result of the operation.

◆ showTable() [4/4]

ShowTableResponse& gpudb::GPUdb::showTable ( const std::string &  tableName,
const std::map< std::string, std::string > &  options,
ShowTableResponse response_ 
) const

Retrieves detailed information about a table, view, or schema, specified in tableName.

If the supplied tableName is a schema the call can return information about either the schema itself or the tables and views it contains. If tableName is empty, information about all schemas will be returned.

If the option get_sizes is set to true, then the number of records in each table is returned (in sizes and fullSizes), along with the total number of objects across all requested tables (in totalSize and totalFullSize).

For a schema, setting the show_children option to false returns only information about the schema itself; setting show_children to true returns a list of tables and views contained in the schema, along with their corresponding detail.

To retrieve a list of every table, view, and schema in the database, set tableName to '*' and show_children to true. When doing this, the returned totalSize and totalFullSize will not include the sizes of non-base tables (e.g., filters, views, joins, etc.).

Parameters
[in]tableNameName of the table for which to retrieve the information, in [schema_name.]table_name format, using standard name resolution rules. If blank, then returns information about all tables and views.
[in]optionsOptional parameters. The default value is an empty map.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ showTableMetadata() [1/4]

ShowTableMetadataResponse gpudb::GPUdb::showTableMetadata ( const ShowTableMetadataRequest request_) const

Retrieves the user provided metadata for the specified tables.

Parameters
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

◆ showTableMetadata() [2/4]

ShowTableMetadataResponse& gpudb::GPUdb::showTableMetadata ( const ShowTableMetadataRequest request_,
ShowTableMetadataResponse response_ 
) const

Retrieves the user provided metadata for the specified tables.

Parameters
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ showTableMetadata() [3/4]

ShowTableMetadataResponse gpudb::GPUdb::showTableMetadata ( const std::vector< std::string > &  tableNames,
const std::map< std::string, std::string > &  options 
) const

Retrieves the user provided metadata for the specified tables.

Parameters
[in]tableNamesNames of tables whose metadata will be fetched, in [schema_name.]table_name format, using standard name resolution rules. All provided tables must exist, or an error is returned.
[in]optionsOptional parameters. The default value is an empty map.
Returns
Response object containing the result of the operation.

◆ showTableMetadata() [4/4]

ShowTableMetadataResponse& gpudb::GPUdb::showTableMetadata ( const std::vector< std::string > &  tableNames,
const std::map< std::string, std::string > &  options,
ShowTableMetadataResponse response_ 
) const

Retrieves the user provided metadata for the specified tables.

Parameters
[in]tableNamesNames of tables whose metadata will be fetched, in [schema_name.]table_name format, using standard name resolution rules. All provided tables must exist, or an error is returned.
[in]optionsOptional parameters. The default value is an empty map.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ showTableMonitors() [1/4]

ShowTableMonitorsResponse gpudb::GPUdb::showTableMonitors ( const ShowTableMonitorsRequest request_) const

Show table monitors and their properties.

Table monitors are created using createTableMonitor. Returns detailed information about existing table monitors.

Parameters
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

◆ showTableMonitors() [2/4]

ShowTableMonitorsResponse& gpudb::GPUdb::showTableMonitors ( const ShowTableMonitorsRequest request_,
ShowTableMonitorsResponse response_ 
) const

Show table monitors and their properties.

Table monitors are created using createTableMonitor. Returns detailed information about existing table monitors.

Parameters
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ showTableMonitors() [3/4]

ShowTableMonitorsResponse gpudb::GPUdb::showTableMonitors ( const std::vector< std::string > &  monitorIds,
const std::map< std::string, std::string > &  options 
) const

Show table monitors and their properties.

Table monitors are created using createTableMonitor. Returns detailed information about existing table monitors.

Parameters
[in]monitorIdsList of monitors to be shown. An empty list or a single entry with an empty string returns all table monitors.
[in]optionsOptional parameters. The default value is an empty map.
Returns
Response object containing the result of the operation.

◆ showTableMonitors() [4/4]

ShowTableMonitorsResponse& gpudb::GPUdb::showTableMonitors ( const std::vector< std::string > &  monitorIds,
const std::map< std::string, std::string > &  options,
ShowTableMonitorsResponse response_ 
) const

Show table monitors and their properties.

Table monitors are created using createTableMonitor. Returns detailed information about existing table monitors.

Parameters
[in]monitorIdsList of monitors to be shown. An empty list or a single entry with an empty string returns all table monitors.
[in]optionsOptional parameters. The default value is an empty map.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ showTablesByType() [1/4]

ShowTablesByTypeResponse gpudb::GPUdb::showTablesByType ( const ShowTablesByTypeRequest request_) const

Gets names of the tables whose type matches the given criteria.

Each table has a particular type. This type comprises the schema and properties of the table and sometimes a type label. This function allows a look up of the existing tables based on full or partial type information. The operation is synchronous.

Parameters
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

◆ showTablesByType() [2/4]

ShowTablesByTypeResponse& gpudb::GPUdb::showTablesByType ( const ShowTablesByTypeRequest request_,
ShowTablesByTypeResponse response_ 
) const

Gets names of the tables whose type matches the given criteria.

Each table has a particular type. This type comprises the schema and properties of the table and sometimes a type label. This function allows a look up of the existing tables based on full or partial type information. The operation is synchronous.

Parameters
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ showTablesByType() [3/4]

ShowTablesByTypeResponse gpudb::GPUdb::showTablesByType ( const std::string &  typeId,
const std::string &  label,
const std::map< std::string, std::string > &  options 
) const

Gets names of the tables whose type matches the given criteria.

Each table has a particular type. This type comprises the schema and properties of the table and sometimes a type label. This function allows a look up of the existing tables based on full or partial type information. The operation is synchronous.

Parameters
[in]typeIdType id returned by a call to createType.
[in]labelOptional user supplied label which can be used instead of the type_id to retrieve all tables with the given label.
[in]optionsOptional parameters. The default value is an empty map.
Returns
Response object containing the result of the operation.

◆ showTablesByType() [4/4]

ShowTablesByTypeResponse& gpudb::GPUdb::showTablesByType ( const std::string &  typeId,
const std::string &  label,
const std::map< std::string, std::string > &  options,
ShowTablesByTypeResponse response_ 
) const

Gets names of the tables whose type matches the given criteria.

Each table has a particular type. This type comprises the schema and properties of the table and sometimes a type label. This function allows a look up of the existing tables based on full or partial type information. The operation is synchronous.

Parameters
[in]typeIdType id returned by a call to createType.
[in]labelOptional user supplied label which can be used instead of the type_id to retrieve all tables with the given label.
[in]optionsOptional parameters. The default value is an empty map.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ showTriggers() [1/4]

ShowTriggersResponse gpudb::GPUdb::showTriggers ( const ShowTriggersRequest request_) const

Retrieves information regarding the specified triggers or all existing triggers currently active.

Parameters
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

◆ showTriggers() [2/4]

ShowTriggersResponse& gpudb::GPUdb::showTriggers ( const ShowTriggersRequest request_,
ShowTriggersResponse response_ 
) const

Retrieves information regarding the specified triggers or all existing triggers currently active.

Parameters
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ showTriggers() [3/4]

ShowTriggersResponse gpudb::GPUdb::showTriggers ( const std::vector< std::string > &  triggerIds,
const std::map< std::string, std::string > &  options 
) const

Retrieves information regarding the specified triggers or all existing triggers currently active.

Parameters
[in]triggerIdsList of IDs of the triggers whose information is to be retrieved. An empty list means information will be retrieved on all active triggers.
[in]optionsOptional parameters. The default value is an empty map.
Returns
Response object containing the result of the operation.

◆ showTriggers() [4/4]

ShowTriggersResponse& gpudb::GPUdb::showTriggers ( const std::vector< std::string > &  triggerIds,
const std::map< std::string, std::string > &  options,
ShowTriggersResponse response_ 
) const

Retrieves information regarding the specified triggers or all existing triggers currently active.

Parameters
[in]triggerIdsList of IDs of the triggers whose information is to be retrieved. An empty list means information will be retrieved on all active triggers.
[in]optionsOptional parameters. The default value is an empty map.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ showTypes() [1/4]

ShowTypesResponse gpudb::GPUdb::showTypes ( const ShowTypesRequest request_) const

Retrieves information for the specified data type ID or type label.

For all data types that match the input criteria, the database returns the type ID, the type schema, the label (if available), and the type's column properties.

Parameters
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

◆ showTypes() [2/4]

ShowTypesResponse& gpudb::GPUdb::showTypes ( const ShowTypesRequest request_,
ShowTypesResponse response_ 
) const

Retrieves information for the specified data type ID or type label.

For all data types that match the input criteria, the database returns the type ID, the type schema, the label (if available), and the type's column properties.

Parameters
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ showTypes() [3/4]

ShowTypesResponse gpudb::GPUdb::showTypes ( const std::string &  typeId,
const std::string &  label,
const std::map< std::string, std::string > &  options 
) const

Retrieves information for the specified data type ID or type label.

For all data types that match the input criteria, the database returns the type ID, the type schema, the label (if available), and the type's column properties.

Parameters
[in]typeIdType Id returned in response to a call to createType.
[in]labelOption string that was supplied by user in a call to createType.
[in]optionsOptional parameters. The default value is an empty map.
Returns
Response object containing the result of the operation.

◆ showTypes() [4/4]

ShowTypesResponse& gpudb::GPUdb::showTypes ( const std::string &  typeId,
const std::string &  label,
const std::map< std::string, std::string > &  options,
ShowTypesResponse response_ 
) const

Retrieves information for the specified data type ID or type label.

For all data types that match the input criteria, the database returns the type ID, the type schema, the label (if available), and the type's column properties.

Parameters
[in]typeIdType Id returned in response to a call to createType.
[in]labelOption string that was supplied by user in a call to createType.
[in]optionsOptional parameters. The default value is an empty map.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ showVideo() [1/4]

ShowVideoResponse gpudb::GPUdb::showVideo ( const ShowVideoRequest request_) const

Retrieves information about rendered videos.

Parameters
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

◆ showVideo() [2/4]

ShowVideoResponse& gpudb::GPUdb::showVideo ( const ShowVideoRequest request_,
ShowVideoResponse response_ 
) const

Retrieves information about rendered videos.

Parameters
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ showVideo() [3/4]

ShowVideoResponse gpudb::GPUdb::showVideo ( const std::vector< std::string > &  paths,
const std::map< std::string, std::string > &  options 
) const

Retrieves information about rendered videos.

Parameters
[in]pathsThe fully-qualified KiFS paths for the videos to show. If empty, shows all videos.
[in]optionsOptional parameters. The default value is an empty map.
Returns
Response object containing the result of the operation.

◆ showVideo() [4/4]

ShowVideoResponse& gpudb::GPUdb::showVideo ( const std::vector< std::string > &  paths,
const std::map< std::string, std::string > &  options,
ShowVideoResponse response_ 
) const

Retrieves information about rendered videos.

Parameters
[in]pathsThe fully-qualified KiFS paths for the videos to show. If empty, shows all videos.
[in]optionsOptional parameters. The default value is an empty map.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ showWal() [1/4]

ShowWalResponse gpudb::GPUdb::showWal ( const ShowWalRequest request_) const

Requests table wal properties.

Returns information about the requested table wal entries.

Parameters
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

◆ showWal() [2/4]

ShowWalResponse& gpudb::GPUdb::showWal ( const ShowWalRequest request_,
ShowWalResponse response_ 
) const

Requests table wal properties.

Returns information about the requested table wal entries.

Parameters
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ showWal() [3/4]

ShowWalResponse gpudb::GPUdb::showWal ( const std::vector< std::string > &  tableNames,
const std::map< std::string, std::string > &  options 
) const

Requests table wal properties.

Returns information about the requested table wal entries.

Parameters
[in]tableNamesList of tables to query. An asterisk returns all tables.
[in]optionsOptional parameters. The default value is an empty map.
Returns
Response object containing the result of the operation.

◆ showWal() [4/4]

ShowWalResponse& gpudb::GPUdb::showWal ( const std::vector< std::string > &  tableNames,
const std::map< std::string, std::string > &  options,
ShowWalResponse response_ 
) const

Requests table wal properties.

Returns information about the requested table wal entries.

Parameters
[in]tableNamesList of tables to query. An asterisk returns all tables.
[in]optionsOptional parameters. The default value is an empty map.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ solveGraph() [1/4]

SolveGraphResponse gpudb::GPUdb::solveGraph ( const SolveGraphRequest request_) const

Solves an existing graph for a type of problem (e.g., shortest path, page rank, travelling salesman, etc.) using source nodes, destination nodes, and additional, optional weights and restrictions.

IMPORTANT: It's highly recommended that you review the Graphs & Solvers concepts documentation, the Graph REST Tutorial, and/or some /solve/graph examples before using this endpoint.

Parameters
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

◆ solveGraph() [2/4]

SolveGraphResponse& gpudb::GPUdb::solveGraph ( const SolveGraphRequest request_,
SolveGraphResponse response_ 
) const

Solves an existing graph for a type of problem (e.g., shortest path, page rank, travelling salesman, etc.) using source nodes, destination nodes, and additional, optional weights and restrictions.

IMPORTANT: It's highly recommended that you review the Graphs & Solvers concepts documentation, the Graph REST Tutorial, and/or some /solve/graph examples before using this endpoint.

Parameters
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ solveGraph() [3/4]

SolveGraphResponse gpudb::GPUdb::solveGraph ( const std::string &  graphName,
const std::vector< std::string > &  weightsOnEdges,
const std::vector< std::string > &  restrictions,
const std::string &  solverType,
const std::vector< std::string > &  sourceNodes,
const std::vector< std::string > &  destinationNodes,
const std::string &  solutionTable,
const std::map< std::string, std::string > &  options 
) const

Solves an existing graph for a type of problem (e.g., shortest path, page rank, travelling salesman, etc.) using source nodes, destination nodes, and additional, optional weights and restrictions.

IMPORTANT: It's highly recommended that you review the Graphs & Solvers concepts documentation, the Graph REST Tutorial, and/or some /solve/graph examples before using this endpoint.

Parameters
[in]graphNameName of the graph resource to solve.
[in]weightsOnEdgesAdditional weights to apply to the edges of an existing graph. Weights must be specified using identifiers; identifiers are grouped as combinations. Identifiers can be used with existing column names, e.g., 'table.column AS WEIGHTS_EDGE_ID', expressions, e.g., 'ST_LENGTH(wkt) AS WEIGHTS_VALUESPECIFIED', or constant values, e.g., '{4, 15, 2} AS WEIGHTS_VALUESPECIFIED'. Any provided weights will be added (in the case of 'WEIGHTS_VALUESPECIFIED') to or multiplied with (in the case of 'WEIGHTS_FACTORSPECIFIED') the existing weight(s). If using constant values in an identifier combination, the number of values specified must match across the combination. The default value is an empty vector.
[in]restrictionsAdditional restrictions to apply to the nodes/edges of an existing graph. Restrictions must be specified using identifiers; identifiers are grouped as combinations. Identifiers can be used with existing column names, e.g., 'table.column AS RESTRICTIONS_EDGE_ID', expressions, e.g., 'column/2 AS RESTRICTIONS_VALUECOMPARED', or constant values, e.g., '{0, 0, 0, 1} AS RESTRICTIONS_ONOFFCOMPARED'. If using constant values in an identifier combination, the number of values specified must match across the combination. If remove_previous_restrictions option is set to true, any provided restrictions will replace the existing restrictions. Otherwise, any provided restrictions will be added (in the case of 'RESTRICTIONS_VALUECOMPARED') to or replaced (in the case of 'RESTRICTIONS_ONOFFCOMPARED'). The default value is an empty vector.
[in]solverTypeThe type of solver to use for the graph. Supported values:
  • solve_graph_SHORTEST_PATH: Solves for the optimal (shortest) path based on weights and restrictions from one source to destinations nodes. Also known as the Dijkstra solver.
  • solve_graph_PAGE_RANK: Solves for the probability of each destination node being visited based on the links of the graph topology. Weights are not required to use this solver.
  • solve_graph_PROBABILITY_RANK: Solves for the transitional probability (Hidden Markov) for each node based on the weights (probability assigned over given edges).
  • solve_graph_CENTRALITY: Solves for the degree of a node to depict how many pairs of individuals that would have to go through the node to reach one another in the minimum number of hops. Also known as betweenness.
  • solve_graph_MULTIPLE_ROUTING: Solves for finding the minimum cost cumulative path for a round-trip starting from the given source and visiting each given destination node once then returning to the source. Also known as the travelling salesman problem.
  • solve_graph_INVERSE_SHORTEST_PATH: Solves for finding the optimal path cost for each destination node to route to the source node. Also known as inverse Dijkstra or the service man routing problem.
  • solve_graph_BACKHAUL_ROUTING: Solves for optimal routes that connect remote asset nodes to the fixed (backbone) asset nodes.
  • solve_graph_ALLPATHS: Solves for paths that would give costs between max and min solution radia - Make sure to limit by the 'max_solution_targets' option. Min cost shoudl be >= shortest_path cost.
  • solve_graph_STATS_ALL: Solves for graph statistics such as graph diameter, longest pairs, vertex valences, topology numbers, average and max cluster sizes, etc.
  • solve_graph_CLOSENESS: Solves for the centrality closeness score per node as the sum of the inverse shortest path costs to all nodes in the graph.
The default value is solve_graph_SHORTEST_PATH.
[in]sourceNodesIt can be one of the nodal identifiers - e.g: 'NODE_WKTPOINT' for source nodes. For BACKHAUL_ROUTING, this list depicts the fixed assets. The default value is an empty vector.
[in]destinationNodesIt can be one of the nodal identifiers - e.g: 'NODE_WKTPOINT' for destination (target) nodes. For BACKHAUL_ROUTING, this list depicts the remote assets. The default value is an empty vector.
[in]solutionTableName of the table to store the solution, in [schema_name.]table_name format, using standard name resolution rules. The default value is 'graph_solutions'.
[in]optionsAdditional parameters.
  • solve_graph_max_solution_radius: For ALLPATHS, SHORTEST_PATH and INVERSE_SHORTEST_PATH solvers only. Sets the maximum solution cost radius, which ignores the destinationNodes list and instead outputs the nodes within the radius sorted by ascending cost. If set to '0.0', the setting is ignored. The default value is '0.0'.
  • solve_graph_min_solution_radius: For ALLPATHS, SHORTEST_PATH and INVERSE_SHORTEST_PATH solvers only. Applicable only when max_solution_radius is set. Sets the minimum solution cost radius, which ignores the destinationNodes list and instead outputs the nodes within the radius sorted by ascending cost. If set to '0.0', the setting is ignored. The default value is '0.0'.
  • solve_graph_max_solution_targets: For ALLPATHS, SHORTEST_PATH and INVERSE_SHORTEST_PATH solvers only. Sets the maximum number of solution targets, which ignores the destinationNodes list and instead outputs no more than n number of nodes sorted by ascending cost where n is equal to the setting value. If set to 0, the setting is ignored. The default value is '1000'.
  • solve_graph_uniform_weights: When specified, assigns the given value to all the edges in the graph. Note that weights provided in weightsOnEdges will override this value.
  • solve_graph_left_turn_penalty: This will add an additonal weight over the edges labelled as 'left turn' if the 'add_turn' option parameter of the createGraph was invoked at graph creation. The default value is '0.0'.
  • solve_graph_right_turn_penalty: This will add an additonal weight over the edges labelled as' right turn' if the 'add_turn' option parameter of the createGraph was invoked at graph creation. The default value is '0.0'.
  • solve_graph_intersection_penalty: This will add an additonal weight over the edges labelled as 'intersection' if the 'add_turn' option parameter of the createGraph was invoked at graph creation. The default value is '0.0'.
  • solve_graph_sharp_turn_penalty: This will add an additonal weight over the edges labelled as 'sharp turn' or 'u-turn' if the 'add_turn' option parameter of the createGraph was invoked at graph creation. The default value is '0.0'.
  • solve_graph_num_best_paths: For MULTIPLE_ROUTING solvers only; sets the number of shortest paths computed from each node. This is the heuristic criterion. Default value of zero allows the number to be computed automatically by the solver. The user may want to override this parameter to speed-up the solver. The default value is '0'.
  • solve_graph_max_num_combinations: For MULTIPLE_ROUTING solvers only; sets the cap on the combinatorial sequences generated. If the default value of two millions is overridden to a lesser value, it can potentially speed up the solver. The default value is '2000000'.
  • solve_graph_output_edge_path: If true then concatenated edge ids will be added as the EDGE path column of the solution table for each source and target pair in shortest path solves. Supported values: The default value is solve_graph_false.
  • solve_graph_output_wkt_path: If true then concatenated wkt line segments will be added as the Wktroute column of the solution table for each source and target pair in shortest path solves. Supported values: The default value is solve_graph_true.
  • solve_graph_server_id: Indicates which graph server(s) to send the request to. Default is to send to the server, amongst those containing the corresponding graph, that has the most computational bandwidth. For SHORTEST_PATH solver type, the input is split amongst the server containing the corresponding graph.
  • solve_graph_convergence_limit: For PAGE_RANK solvers only; Maximum percent relative threshold on the pagerank scores of each node between consecutive iterations to satisfy convergence. Default value is 1 (one) percent. The default value is '1.0'.
  • solve_graph_max_iterations: For PAGE_RANK solvers only; Maximum number of pagerank iterations for satisfying convergence. Default value is 100. The default value is '100'.
  • solve_graph_max_runs: For all CENTRALITY solvers only; Sets the maximum number of shortest path runs; maximum possible value is the number of nodes in the graph. Default value of 0 enables this value to be auto computed by the solver. The default value is '0'.
  • solve_graph_output_clusters: For STATS_ALL solvers only; the cluster index for each node will be inserted as an additional column in the output. Supported values: The default value is solve_graph_false.
  • solve_graph_solve_heuristic: Specify heuristic search criterion only for the geo graphs and shortest path solves towards a single target. Supported values: The default value is solve_graph_none.
  • solve_graph_astar_radius: For path solvers only when 'solve_heuristic' option is 'astar'. The shortest path traversal front includes nodes only within this radius (kilometers) as it moves towards the target location. The default value is '70'.
The default value is an empty map.
Returns
Response object containing the result of the operation.

◆ solveGraph() [4/4]

SolveGraphResponse& gpudb::GPUdb::solveGraph ( const std::string &  graphName,
const std::vector< std::string > &  weightsOnEdges,
const std::vector< std::string > &  restrictions,
const std::string &  solverType,
const std::vector< std::string > &  sourceNodes,
const std::vector< std::string > &  destinationNodes,
const std::string &  solutionTable,
const std::map< std::string, std::string > &  options,
SolveGraphResponse response_ 
) const

Solves an existing graph for a type of problem (e.g., shortest path, page rank, travelling salesman, etc.) using source nodes, destination nodes, and additional, optional weights and restrictions.

IMPORTANT: It's highly recommended that you review the Graphs & Solvers concepts documentation, the Graph REST Tutorial, and/or some /solve/graph examples before using this endpoint.

Parameters
[in]graphNameName of the graph resource to solve.
[in]weightsOnEdgesAdditional weights to apply to the edges of an existing graph. Weights must be specified using identifiers; identifiers are grouped as combinations. Identifiers can be used with existing column names, e.g., 'table.column AS WEIGHTS_EDGE_ID', expressions, e.g., 'ST_LENGTH(wkt) AS WEIGHTS_VALUESPECIFIED', or constant values, e.g., '{4, 15, 2} AS WEIGHTS_VALUESPECIFIED'. Any provided weights will be added (in the case of 'WEIGHTS_VALUESPECIFIED') to or multiplied with (in the case of 'WEIGHTS_FACTORSPECIFIED') the existing weight(s). If using constant values in an identifier combination, the number of values specified must match across the combination. The default value is an empty vector.
[in]restrictionsAdditional restrictions to apply to the nodes/edges of an existing graph. Restrictions must be specified using identifiers; identifiers are grouped as combinations. Identifiers can be used with existing column names, e.g., 'table.column AS RESTRICTIONS_EDGE_ID', expressions, e.g., 'column/2 AS RESTRICTIONS_VALUECOMPARED', or constant values, e.g., '{0, 0, 0, 1} AS RESTRICTIONS_ONOFFCOMPARED'. If using constant values in an identifier combination, the number of values specified must match across the combination. If remove_previous_restrictions option is set to true, any provided restrictions will replace the existing restrictions. Otherwise, any provided restrictions will be added (in the case of 'RESTRICTIONS_VALUECOMPARED') to or replaced (in the case of 'RESTRICTIONS_ONOFFCOMPARED'). The default value is an empty vector.
[in]solverTypeThe type of solver to use for the graph. Supported values:
  • solve_graph_SHORTEST_PATH: Solves for the optimal (shortest) path based on weights and restrictions from one source to destinations nodes. Also known as the Dijkstra solver.
  • solve_graph_PAGE_RANK: Solves for the probability of each destination node being visited based on the links of the graph topology. Weights are not required to use this solver.
  • solve_graph_PROBABILITY_RANK: Solves for the transitional probability (Hidden Markov) for each node based on the weights (probability assigned over given edges).
  • solve_graph_CENTRALITY: Solves for the degree of a node to depict how many pairs of individuals that would have to go through the node to reach one another in the minimum number of hops. Also known as betweenness.
  • solve_graph_MULTIPLE_ROUTING: Solves for finding the minimum cost cumulative path for a round-trip starting from the given source and visiting each given destination node once then returning to the source. Also known as the travelling salesman problem.
  • solve_graph_INVERSE_SHORTEST_PATH: Solves for finding the optimal path cost for each destination node to route to the source node. Also known as inverse Dijkstra or the service man routing problem.
  • solve_graph_BACKHAUL_ROUTING: Solves for optimal routes that connect remote asset nodes to the fixed (backbone) asset nodes.
  • solve_graph_ALLPATHS: Solves for paths that would give costs between max and min solution radia - Make sure to limit by the 'max_solution_targets' option. Min cost shoudl be >= shortest_path cost.
  • solve_graph_STATS_ALL: Solves for graph statistics such as graph diameter, longest pairs, vertex valences, topology numbers, average and max cluster sizes, etc.
  • solve_graph_CLOSENESS: Solves for the centrality closeness score per node as the sum of the inverse shortest path costs to all nodes in the graph.
The default value is solve_graph_SHORTEST_PATH.
[in]sourceNodesIt can be one of the nodal identifiers - e.g: 'NODE_WKTPOINT' for source nodes. For BACKHAUL_ROUTING, this list depicts the fixed assets. The default value is an empty vector.
[in]destinationNodesIt can be one of the nodal identifiers - e.g: 'NODE_WKTPOINT' for destination (target) nodes. For BACKHAUL_ROUTING, this list depicts the remote assets. The default value is an empty vector.
[in]solutionTableName of the table to store the solution, in [schema_name.]table_name format, using standard name resolution rules. The default value is 'graph_solutions'.
[in]optionsAdditional parameters.
  • solve_graph_max_solution_radius: For ALLPATHS, SHORTEST_PATH and INVERSE_SHORTEST_PATH solvers only. Sets the maximum solution cost radius, which ignores the destinationNodes list and instead outputs the nodes within the radius sorted by ascending cost. If set to '0.0', the setting is ignored. The default value is '0.0'.
  • solve_graph_min_solution_radius: For ALLPATHS, SHORTEST_PATH and INVERSE_SHORTEST_PATH solvers only. Applicable only when max_solution_radius is set. Sets the minimum solution cost radius, which ignores the destinationNodes list and instead outputs the nodes within the radius sorted by ascending cost. If set to '0.0', the setting is ignored. The default value is '0.0'.
  • solve_graph_max_solution_targets: For ALLPATHS, SHORTEST_PATH and INVERSE_SHORTEST_PATH solvers only. Sets the maximum number of solution targets, which ignores the destinationNodes list and instead outputs no more than n number of nodes sorted by ascending cost where n is equal to the setting value. If set to 0, the setting is ignored. The default value is '1000'.
  • solve_graph_uniform_weights: When specified, assigns the given value to all the edges in the graph. Note that weights provided in weightsOnEdges will override this value.
  • solve_graph_left_turn_penalty: This will add an additonal weight over the edges labelled as 'left turn' if the 'add_turn' option parameter of the createGraph was invoked at graph creation. The default value is '0.0'.
  • solve_graph_right_turn_penalty: This will add an additonal weight over the edges labelled as' right turn' if the 'add_turn' option parameter of the createGraph was invoked at graph creation. The default value is '0.0'.
  • solve_graph_intersection_penalty: This will add an additonal weight over the edges labelled as 'intersection' if the 'add_turn' option parameter of the createGraph was invoked at graph creation. The default value is '0.0'.
  • solve_graph_sharp_turn_penalty: This will add an additonal weight over the edges labelled as 'sharp turn' or 'u-turn' if the 'add_turn' option parameter of the createGraph was invoked at graph creation. The default value is '0.0'.
  • solve_graph_num_best_paths: For MULTIPLE_ROUTING solvers only; sets the number of shortest paths computed from each node. This is the heuristic criterion. Default value of zero allows the number to be computed automatically by the solver. The user may want to override this parameter to speed-up the solver. The default value is '0'.
  • solve_graph_max_num_combinations: For MULTIPLE_ROUTING solvers only; sets the cap on the combinatorial sequences generated. If the default value of two millions is overridden to a lesser value, it can potentially speed up the solver. The default value is '2000000'.
  • solve_graph_output_edge_path: If true then concatenated edge ids will be added as the EDGE path column of the solution table for each source and target pair in shortest path solves. Supported values: The default value is solve_graph_false.
  • solve_graph_output_wkt_path: If true then concatenated wkt line segments will be added as the Wktroute column of the solution table for each source and target pair in shortest path solves. Supported values: The default value is solve_graph_true.
  • solve_graph_server_id: Indicates which graph server(s) to send the request to. Default is to send to the server, amongst those containing the corresponding graph, that has the most computational bandwidth. For SHORTEST_PATH solver type, the input is split amongst the server containing the corresponding graph.
  • solve_graph_convergence_limit: For PAGE_RANK solvers only; Maximum percent relative threshold on the pagerank scores of each node between consecutive iterations to satisfy convergence. Default value is 1 (one) percent. The default value is '1.0'.
  • solve_graph_max_iterations: For PAGE_RANK solvers only; Maximum number of pagerank iterations for satisfying convergence. Default value is 100. The default value is '100'.
  • solve_graph_max_runs: For all CENTRALITY solvers only; Sets the maximum number of shortest path runs; maximum possible value is the number of nodes in the graph. Default value of 0 enables this value to be auto computed by the solver. The default value is '0'.
  • solve_graph_output_clusters: For STATS_ALL solvers only; the cluster index for each node will be inserted as an additional column in the output. Supported values: The default value is solve_graph_false.
  • solve_graph_solve_heuristic: Specify heuristic search criterion only for the geo graphs and shortest path solves towards a single target. Supported values: The default value is solve_graph_none.
  • solve_graph_astar_radius: For path solvers only when 'solve_heuristic' option is 'astar'. The shortest path traversal front includes nodes only within this radius (kilometers) as it moves towards the target location. The default value is '70'.
The default value is an empty map.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ submitRequest() [1/3]

template<typename TRequest , typename TResponse >
TResponse& gpudb::GPUdb::submitRequest ( const HttpUrl url,
const TRequest &  request,
TResponse &  response,
const bool  enableCompression = false 
) const
inline

Definition at line 357 of file GPUdb.hpp.

◆ submitRequest() [2/3]

template<typename TRequest , typename TResponse >
TResponse& gpudb::GPUdb::submitRequest ( const std::string &  endpoint,
const TRequest &  request,
TResponse &  response,
const bool  enableCompression = false 
) const
inline

Definition at line 393 of file GPUdb.hpp.

◆ submitRequest() [3/3]

template<typename TRequest , typename TResponse >
TResponse& gpudb::GPUdb::submitRequest ( const char *  endpoint,
const TRequest &  request,
TResponse &  response,
const bool  enableCompression = false 
) const
inline

Definition at line 430 of file GPUdb.hpp.

◆ submitRequestToHostManager() [1/2]

template<typename TRequest , typename TResponse >
TResponse& gpudb::GPUdb::submitRequestToHostManager ( const std::string &  endpoint,
const TRequest &  request,
TResponse &  response,
const bool  enableCompression = false 
) const
inline

Submit an HTTP request to the host manager.

Parameters
[in]endpointThe endpoint for which the request is made.
[in]requestThe request object containing the parameters for the operation.
[out]responseThe response object in which the return values will be saved.
[in]enableCompressionOptional boolean flag indicating whether any compression should be used. Default is false.
Returns
a reference to the response object.

Definition at line 454 of file GPUdb.hpp.

◆ submitRequestToHostManager() [2/2]

template<typename TRequest , typename TResponse >
TResponse& gpudb::GPUdb::submitRequestToHostManager ( const char *  endpoint,
const TRequest &  request,
TResponse &  response,
const bool  enableCompression = false 
) const
inline

Submit an HTTP request to the host manager.

Parameters
[in]endpointThe endpoint for which the request is made.
[in]requestThe request object containing the parameters for the operation.
[out]responseThe response object in which the return values will be saved.
[in]enableCompressionOptional boolean flag indicating whether any compression should be used. Default is false.
Returns
a reference to the response object.

Definition at line 505 of file GPUdb.hpp.

◆ updateHostManagerPort()

void gpudb::GPUdb::updateHostManagerPort ( )

Update the host manager port by inquiring the server.

◆ updateRecords() [1/4]

template<typename TRequest >
UpdateRecordsResponse gpudb::GPUdb::updateRecords ( const UpdateRecordsRequest< TRequest > &  request_) const
inline

Runs multiple predicate-based updates in a single call.

With the list of given expressions, any matching record's column values will be updated as provided in newValuesMaps. There is also an optional 'upsert' capability where if a particular predicate doesn't match any existing record, then a new record can be inserted.

Note that this operation can only be run on an original table and not on a result view.

This operation can update primary key values. By default only 'pure primary key' predicates are allowed when updating primary key values. If the primary key for a table is the column 'attr1', then the operation will only accept predicates of the form: "attr1 == 'foo'" if the attr1 column is being updated. For a composite primary key (e.g. columns 'attr1' and 'attr2') then this operation will only accept predicates of the form: "(attr1 == 'foo') and (attr2 == 'bar')". Meaning, all primary key columns must appear in an equality predicate in the expressions. Furthermore each 'pure primary key' predicate must be unique within a given request. These restrictions can be removed by utilizing some available options through options.

The update_on_existing_pk option specifies the record primary key collision policy for tables with a primary key, while ignore_existing_pk specifies the record primary key collision error-suppression policy when those collisions result in the update being rejected. Both are ignored on tables with no primary key.

Template Parameters
TRequestThe type of object being added.
Parameters
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

Definition at line 47878 of file GPUdb.hpp.

◆ updateRecords() [2/4]

template<typename TRequest >
UpdateRecordsResponse& gpudb::GPUdb::updateRecords ( const UpdateRecordsRequest< TRequest > &  request_,
UpdateRecordsResponse response_ 
) const
inline

Runs multiple predicate-based updates in a single call.

With the list of given expressions, any matching record's column values will be updated as provided in newValuesMaps. There is also an optional 'upsert' capability where if a particular predicate doesn't match any existing record, then a new record can be inserted.

Note that this operation can only be run on an original table and not on a result view.

This operation can update primary key values. By default only 'pure primary key' predicates are allowed when updating primary key values. If the primary key for a table is the column 'attr1', then the operation will only accept predicates of the form: "attr1 == 'foo'" if the attr1 column is being updated. For a composite primary key (e.g. columns 'attr1' and 'attr2') then this operation will only accept predicates of the form: "(attr1 == 'foo') and (attr2 == 'bar')". Meaning, all primary key columns must appear in an equality predicate in the expressions. Furthermore each 'pure primary key' predicate must be unique within a given request. These restrictions can be removed by utilizing some available options through options.

The update_on_existing_pk option specifies the record primary key collision policy for tables with a primary key, while ignore_existing_pk specifies the record primary key collision error-suppression policy when those collisions result in the update being rejected. Both are ignored on tables with no primary key.

Template Parameters
TRequestThe type of object being added.
Parameters
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

Definition at line 47933 of file GPUdb.hpp.

◆ updateRecords() [3/4]

template<typename TRequest >
UpdateRecordsResponse gpudb::GPUdb::updateRecords ( const std::string &  tableName,
const std::vector< std::string > &  expressions,
const std::vector< std::map< std::string, boost::optional< std::string > > > &  newValuesMaps,
const std::vector< TRequest > &  data,
const std::map< std::string, std::string > &  options 
) const
inline

Runs multiple predicate-based updates in a single call.

With the list of given expressions, any matching record's column values will be updated as provided in newValuesMaps. There is also an optional 'upsert' capability where if a particular predicate doesn't match any existing record, then a new record can be inserted.

Note that this operation can only be run on an original table and not on a result view.

This operation can update primary key values. By default only 'pure primary key' predicates are allowed when updating primary key values. If the primary key for a table is the column 'attr1', then the operation will only accept predicates of the form: "attr1 == 'foo'" if the attr1 column is being updated. For a composite primary key (e.g. columns 'attr1' and 'attr2') then this operation will only accept predicates of the form: "(attr1 == 'foo') and (attr2 == 'bar')". Meaning, all primary key columns must appear in an equality predicate in the expressions. Furthermore each 'pure primary key' predicate must be unique within a given request. These restrictions can be removed by utilizing some available options through options.

The update_on_existing_pk option specifies the record primary key collision policy for tables with a primary key, while ignore_existing_pk specifies the record primary key collision error-suppression policy when those collisions result in the update being rejected. Both are ignored on tables with no primary key.

Template Parameters
TRequestThe type of object being added.
Parameters
[in]tableNameName of table to be updated, in [schema_name.]table_name format, using standard name resolution rules. Must be a currently existing table and not a view.
[in]expressionsA list of the actual predicates, one for each update; format should follow the guidelines here.
[in]newValuesMapsList of new values for the matching records. Each element is a map with (key, value) pairs where the keys are the names of the columns whose values are to be updated; the values are the new values. The number of elements in the list should match the length of expressions.
[in]dataAn optional list of new binary-avro encoded records to insert, one for each update. If one of expressions does not yield a matching record to be updated, then the corresponding element from this list will be added to the table. The default value is an empty vector.
[in]optionsOptional parameters.
  • update_records_global_expression: An optional global expression to reduce the search space of the predicates listed in expressions. The default value is ''.
  • update_records_bypass_safety_checks: When set to true, all predicates are available for primary key updates. Keep in mind that it is possible to destroy data in this case, since a single predicate may match multiple objects (potentially all of records of a table), and then updating all of those records to have the same primary key will, due to the primary key uniqueness constraints, effectively delete all but one of those updated records. Supported values: The default value is update_records_false.
  • update_records_update_on_existing_pk: Specifies the record collision policy for updating a table with a primary key. There are two ways that a record collision can occur. The first is an "update collision", which happens when the update changes the value of the updated record's primary key, and that new primary key already exists as the primary key of another record in the table. The second is an "insert collision", which occurs when a given filter in expressions finds no records to update, and the alternate insert record given in data (or recordsToInsertStr) contains a primary key matching that of an existing record in the table. If update_on_existing_pk is set to true, "update collisions" will result in the existing record collided into being removed and the record updated with values specified in newValuesMaps taking its place; "insert collisions" will result in the collided-into record being updated with the values in data/recordsToInsertStr (if given). If set to false, the existing collided-into record will remain unchanged, while the update will be rejected and the error handled as determined by ignore_existing_pk. If the specified table does not have a primary key, then this option has no effect. Supported values:
    • update_records_true: Overwrite the collided-into record when updating a record's primary key or inserting an alternate record causes a primary key collision between the record being updated/inserted and another existing record in the table
    • update_records_false: Reject updates which cause primary key collisions between the record being updated/inserted and an existing record in the table
    The default value is update_records_false.
  • update_records_ignore_existing_pk: Specifies the record collision error-suppression policy for updating a table with a primary key, only used when primary key record collisions are rejected (update_on_existing_pk is false). If set to true, any record update that is rejected for resulting in a primary key collision with an existing table record will be ignored with no error generated. If false, the rejection of any update for resulting in a primary key collision will cause an error to be reported. If the specified table does not have a primary key or if update_on_existing_pk is true, then this option has no effect. Supported values:
    • update_records_true: Ignore updates that result in primary key collisions with existing records
    • update_records_false: Treat as errors any updates that result in primary key collisions with existing records
    The default value is update_records_false.
  • update_records_update_partition: Force qualifying records to be deleted and reinserted so their partition membership will be reevaluated. Supported values: The default value is update_records_false.
  • update_records_truncate_strings: If set to true, any strings which are too long for their charN string fields will be truncated to fit. Supported values: The default value is update_records_false.
  • update_records_use_expressions_in_new_values_maps: When set to true, all new values in newValuesMaps are considered as expression values. When set to false, all new values in newValuesMaps are considered as constants. NOTE: When true, string constants will need to be quoted to avoid being evaluated as expressions. Supported values: The default value is update_records_false.
  • update_records_record_id: ID of a single record to be updated (returned in the call to insertRecords or getRecordsFromCollection).
The default value is an empty map.
Returns
Response object containing the result of the operation.

Definition at line 48186 of file GPUdb.hpp.

◆ updateRecords() [4/4]

template<typename TRequest >
UpdateRecordsResponse& gpudb::GPUdb::updateRecords ( const std::string &  tableName,
const std::vector< std::string > &  expressions,
const std::vector< std::map< std::string, boost::optional< std::string > > > &  newValuesMaps,
const std::vector< TRequest > &  data,
const std::map< std::string, std::string > &  options,
UpdateRecordsResponse response_ 
) const
inline

Runs multiple predicate-based updates in a single call.

With the list of given expressions, any matching record's column values will be updated as provided in newValuesMaps. There is also an optional 'upsert' capability where if a particular predicate doesn't match any existing record, then a new record can be inserted.

Note that this operation can only be run on an original table and not on a result view.

This operation can update primary key values. By default only 'pure primary key' predicates are allowed when updating primary key values. If the primary key for a table is the column 'attr1', then the operation will only accept predicates of the form: "attr1 == 'foo'" if the attr1 column is being updated. For a composite primary key (e.g. columns 'attr1' and 'attr2') then this operation will only accept predicates of the form: "(attr1 == 'foo') and (attr2 == 'bar')". Meaning, all primary key columns must appear in an equality predicate in the expressions. Furthermore each 'pure primary key' predicate must be unique within a given request. These restrictions can be removed by utilizing some available options through options.

The update_on_existing_pk option specifies the record primary key collision policy for tables with a primary key, while ignore_existing_pk specifies the record primary key collision error-suppression policy when those collisions result in the update being rejected. Both are ignored on tables with no primary key.

Template Parameters
TRequestThe type of object being added.
Parameters
[in]tableNameName of table to be updated, in [schema_name.]table_name format, using standard name resolution rules. Must be a currently existing table and not a view.
[in]expressionsA list of the actual predicates, one for each update; format should follow the guidelines here.
[in]newValuesMapsList of new values for the matching records. Each element is a map with (key, value) pairs where the keys are the names of the columns whose values are to be updated; the values are the new values. The number of elements in the list should match the length of expressions.
[in]dataAn optional list of new binary-avro encoded records to insert, one for each update. If one of expressions does not yield a matching record to be updated, then the corresponding element from this list will be added to the table. The default value is an empty vector.
[in]optionsOptional parameters.
  • update_records_global_expression: An optional global expression to reduce the search space of the predicates listed in expressions. The default value is ''.
  • update_records_bypass_safety_checks: When set to true, all predicates are available for primary key updates. Keep in mind that it is possible to destroy data in this case, since a single predicate may match multiple objects (potentially all of records of a table), and then updating all of those records to have the same primary key will, due to the primary key uniqueness constraints, effectively delete all but one of those updated records. Supported values: The default value is update_records_false.
  • update_records_update_on_existing_pk: Specifies the record collision policy for updating a table with a primary key. There are two ways that a record collision can occur. The first is an "update collision", which happens when the update changes the value of the updated record's primary key, and that new primary key already exists as the primary key of another record in the table. The second is an "insert collision", which occurs when a given filter in expressions finds no records to update, and the alternate insert record given in data (or recordsToInsertStr) contains a primary key matching that of an existing record in the table. If update_on_existing_pk is set to true, "update collisions" will result in the existing record collided into being removed and the record updated with values specified in newValuesMaps taking its place; "insert collisions" will result in the collided-into record being updated with the values in data/recordsToInsertStr (if given). If set to false, the existing collided-into record will remain unchanged, while the update will be rejected and the error handled as determined by ignore_existing_pk. If the specified table does not have a primary key, then this option has no effect. Supported values:
    • update_records_true: Overwrite the collided-into record when updating a record's primary key or inserting an alternate record causes a primary key collision between the record being updated/inserted and another existing record in the table
    • update_records_false: Reject updates which cause primary key collisions between the record being updated/inserted and an existing record in the table
    The default value is update_records_false.
  • update_records_ignore_existing_pk: Specifies the record collision error-suppression policy for updating a table with a primary key, only used when primary key record collisions are rejected (update_on_existing_pk is false). If set to true, any record update that is rejected for resulting in a primary key collision with an existing table record will be ignored with no error generated. If false, the rejection of any update for resulting in a primary key collision will cause an error to be reported. If the specified table does not have a primary key or if update_on_existing_pk is true, then this option has no effect. Supported values:
    • update_records_true: Ignore updates that result in primary key collisions with existing records
    • update_records_false: Treat as errors any updates that result in primary key collisions with existing records
    The default value is update_records_false.
  • update_records_update_partition: Force qualifying records to be deleted and reinserted so their partition membership will be reevaluated. Supported values: The default value is update_records_false.
  • update_records_truncate_strings: If set to true, any strings which are too long for their charN string fields will be truncated to fit. Supported values: The default value is update_records_false.
  • update_records_use_expressions_in_new_values_maps: When set to true, all new values in newValuesMaps are considered as expression values. When set to false, all new values in newValuesMaps are considered as constants. NOTE: When true, string constants will need to be quoted to avoid being evaluated as expressions. Supported values: The default value is update_records_false.
  • update_records_record_id: ID of a single record to be updated (returned in the call to insertRecords or getRecordsFromCollection).
The default value is an empty map.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

Definition at line 48445 of file GPUdb.hpp.

◆ updateRecordsBySeries() [1/4]

UpdateRecordsBySeriesResponse gpudb::GPUdb::updateRecordsBySeries ( const UpdateRecordsBySeriesRequest request_) const

Updates the view specified by tableName to include full series (track) information from the worldTableName for the series (tracks) present in the viewName.

Parameters
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

◆ updateRecordsBySeries() [2/4]

UpdateRecordsBySeriesResponse& gpudb::GPUdb::updateRecordsBySeries ( const UpdateRecordsBySeriesRequest request_,
UpdateRecordsBySeriesResponse response_ 
) const

Updates the view specified by tableName to include full series (track) information from the worldTableName for the series (tracks) present in the viewName.

Parameters
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ updateRecordsBySeries() [3/4]

UpdateRecordsBySeriesResponse gpudb::GPUdb::updateRecordsBySeries ( const std::string &  tableName,
const std::string &  worldTableName,
const std::string &  viewName,
const std::vector< std::string > &  reserved,
const std::map< std::string, std::string > &  options 
) const

Updates the view specified by tableName to include full series (track) information from the worldTableName for the series (tracks) present in the viewName.

Parameters
[in]tableNameName of the view on which the update operation will be performed, in [schema_name.]view_name format, using standard name resolution rules. Must be an existing view.
[in]worldTableNameName of the table containing the complete series (track) information, in [schema_name.]table_name format, using standard name resolution rules.
[in]viewNameName of the view containing the series (tracks) which have to be updated, in [schema_name.]view_name format, using standard name resolution rules. The default value is ''.
[in]reservedThe default value is an empty vector.
[in]optionsOptional parameters. The default value is an empty map.
Returns
Response object containing the result of the operation.

◆ updateRecordsBySeries() [4/4]

UpdateRecordsBySeriesResponse& gpudb::GPUdb::updateRecordsBySeries ( const std::string &  tableName,
const std::string &  worldTableName,
const std::string &  viewName,
const std::vector< std::string > &  reserved,
const std::map< std::string, std::string > &  options,
UpdateRecordsBySeriesResponse response_ 
) const

Updates the view specified by tableName to include full series (track) information from the worldTableName for the series (tracks) present in the viewName.

Parameters
[in]tableNameName of the view on which the update operation will be performed, in [schema_name.]view_name format, using standard name resolution rules. Must be an existing view.
[in]worldTableNameName of the table containing the complete series (track) information, in [schema_name.]table_name format, using standard name resolution rules.
[in]viewNameName of the view containing the series (tracks) which have to be updated, in [schema_name.]view_name format, using standard name resolution rules. The default value is ''.
[in]reservedThe default value is an empty vector.
[in]optionsOptional parameters. The default value is an empty map.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ updateRecordsRaw() [1/2]

UpdateRecordsResponse gpudb::GPUdb::updateRecordsRaw ( const RawUpdateRecordsRequest request_) const

Runs multiple predicate-based updates in a single call.

With the list of given expressions, any matching record's column values will be updated as provided in newValuesMaps. There is also an optional 'upsert' capability where if a particular predicate doesn't match any existing record, then a new record can be inserted.

Note that this operation can only be run on an original table and not on a result view.

This operation can update primary key values. By default only 'pure primary key' predicates are allowed when updating primary key values. If the primary key for a table is the column 'attr1', then the operation will only accept predicates of the form: "attr1 == 'foo'" if the attr1 column is being updated. For a composite primary key (e.g. columns 'attr1' and 'attr2') then this operation will only accept predicates of the form: "(attr1 == 'foo') and (attr2 == 'bar')". Meaning, all primary key columns must appear in an equality predicate in the expressions. Furthermore each 'pure primary key' predicate must be unique within a given request. These restrictions can be removed by utilizing some available options through options.

The update_on_existing_pk option specifies the record primary key collision policy for tables with a primary key, while ignore_existing_pk specifies the record primary key collision error-suppression policy when those collisions result in the update being rejected. Both are ignored on tables with no primary key.

Parameters
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

◆ updateRecordsRaw() [2/2]

UpdateRecordsResponse& gpudb::GPUdb::updateRecordsRaw ( const RawUpdateRecordsRequest request_,
UpdateRecordsResponse response_ 
) const

Runs multiple predicate-based updates in a single call.

With the list of given expressions, any matching record's column values will be updated as provided in newValuesMaps. There is also an optional 'upsert' capability where if a particular predicate doesn't match any existing record, then a new record can be inserted.

Note that this operation can only be run on an original table and not on a result view.

This operation can update primary key values. By default only 'pure primary key' predicates are allowed when updating primary key values. If the primary key for a table is the column 'attr1', then the operation will only accept predicates of the form: "attr1 == 'foo'" if the attr1 column is being updated. For a composite primary key (e.g. columns 'attr1' and 'attr2') then this operation will only accept predicates of the form: "(attr1 == 'foo') and (attr2 == 'bar')". Meaning, all primary key columns must appear in an equality predicate in the expressions. Furthermore each 'pure primary key' predicate must be unique within a given request. These restrictions can be removed by utilizing some available options through options.

The update_on_existing_pk option specifies the record primary key collision policy for tables with a primary key, while ignore_existing_pk specifies the record primary key collision error-suppression policy when those collisions result in the update being rejected. Both are ignored on tables with no primary key.

Parameters
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ uploadFiles() [1/4]

UploadFilesResponse gpudb::GPUdb::uploadFiles ( const UploadFilesRequest request_) const

Uploads one or more files to KiFS.

There are two methods for uploading files: load files in their entirety, or load files in parts. The latter is recommeded for files of approximately 60 MB or larger.

To upload files in their entirety, populate fileNames with the file names to upload into on KiFS, and their respective byte content in fileData.

Multiple steps are involved when uploading in multiple parts. Only one file at a time can be uploaded in this manner. A user-provided UUID is utilized to tie all the upload steps together for a given file. To upload a file in multiple parts:

  1. Provide the file name in fileNames, the UUID in the multipart_upload_uuid key in options, and a multipart_operation value of init.
  2. Upload one or more parts by providing the file name, the part data in fileData, the UUID, a multipart_operation value of upload_part, and the part number in the multipart_upload_part_number. The part numbers must start at 1 and increase incrementally. Parts may not be uploaded out of order.
  3. Complete the upload by providing the file name, the UUID, and a multipart_operation value of complete.

Multipart uploads in progress may be canceled by providing the file name, the UUID, and a multipart_operation value of cancel. If an new upload is initialized with a different UUID for an existing upload in progress, the pre-existing upload is automatically canceled in favor of the new upload.

The multipart upload must be completed for the file to be usable in KiFS. Information about multipart uploads in progress is available in showFiles.

File data may be pre-encoded using base64 encoding. This should be indicated using the file_encoding option, and is recommended when using JSON serialization.

Each file path must reside in a top-level KiFS directory, i.e. one of the directories listed in showDirectories. The user must have write permission on the directory. Nested directories are permitted in file name paths. Directories are deliniated with the directory separator of '/'. For example, given the file path '/a/b/c/d.txt', 'a' must be a KiFS directory.

These characters are allowed in file name paths: letters, numbers, spaces, the path delimiter of '/', and the characters: '.' '-' ':' '[' ']' '(' ')' '#' '='.

Parameters
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

◆ uploadFiles() [2/4]

UploadFilesResponse& gpudb::GPUdb::uploadFiles ( const UploadFilesRequest request_,
UploadFilesResponse response_ 
) const

Uploads one or more files to KiFS.

There are two methods for uploading files: load files in their entirety, or load files in parts. The latter is recommeded for files of approximately 60 MB or larger.

To upload files in their entirety, populate fileNames with the file names to upload into on KiFS, and their respective byte content in fileData.

Multiple steps are involved when uploading in multiple parts. Only one file at a time can be uploaded in this manner. A user-provided UUID is utilized to tie all the upload steps together for a given file. To upload a file in multiple parts:

  1. Provide the file name in fileNames, the UUID in the multipart_upload_uuid key in options, and a multipart_operation value of init.
  2. Upload one or more parts by providing the file name, the part data in fileData, the UUID, a multipart_operation value of upload_part, and the part number in the multipart_upload_part_number. The part numbers must start at 1 and increase incrementally. Parts may not be uploaded out of order.
  3. Complete the upload by providing the file name, the UUID, and a multipart_operation value of complete.

Multipart uploads in progress may be canceled by providing the file name, the UUID, and a multipart_operation value of cancel. If an new upload is initialized with a different UUID for an existing upload in progress, the pre-existing upload is automatically canceled in favor of the new upload.

The multipart upload must be completed for the file to be usable in KiFS. Information about multipart uploads in progress is available in showFiles.

File data may be pre-encoded using base64 encoding. This should be indicated using the file_encoding option, and is recommended when using JSON serialization.

Each file path must reside in a top-level KiFS directory, i.e. one of the directories listed in showDirectories. The user must have write permission on the directory. Nested directories are permitted in file name paths. Directories are deliniated with the directory separator of '/'. For example, given the file path '/a/b/c/d.txt', 'a' must be a KiFS directory.

These characters are allowed in file name paths: letters, numbers, spaces, the path delimiter of '/', and the characters: '.' '-' ':' '[' ']' '(' ')' '#' '='.

Parameters
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ uploadFiles() [3/4]

UploadFilesResponse gpudb::GPUdb::uploadFiles ( const std::vector< std::string > &  fileNames,
const std::vector< std::vector< uint8_t > > &  fileData,
const std::map< std::string, std::string > &  options 
) const

Uploads one or more files to KiFS.

There are two methods for uploading files: load files in their entirety, or load files in parts. The latter is recommeded for files of approximately 60 MB or larger.

To upload files in their entirety, populate fileNames with the file names to upload into on KiFS, and their respective byte content in fileData.

Multiple steps are involved when uploading in multiple parts. Only one file at a time can be uploaded in this manner. A user-provided UUID is utilized to tie all the upload steps together for a given file. To upload a file in multiple parts:

  1. Provide the file name in fileNames, the UUID in the multipart_upload_uuid key in options, and a multipart_operation value of init.
  2. Upload one or more parts by providing the file name, the part data in fileData, the UUID, a multipart_operation value of upload_part, and the part number in the multipart_upload_part_number. The part numbers must start at 1 and increase incrementally. Parts may not be uploaded out of order.
  3. Complete the upload by providing the file name, the UUID, and a multipart_operation value of complete.

Multipart uploads in progress may be canceled by providing the file name, the UUID, and a multipart_operation value of cancel. If an new upload is initialized with a different UUID for an existing upload in progress, the pre-existing upload is automatically canceled in favor of the new upload.

The multipart upload must be completed for the file to be usable in KiFS. Information about multipart uploads in progress is available in showFiles.

File data may be pre-encoded using base64 encoding. This should be indicated using the file_encoding option, and is recommended when using JSON serialization.

Each file path must reside in a top-level KiFS directory, i.e. one of the directories listed in showDirectories. The user must have write permission on the directory. Nested directories are permitted in file name paths. Directories are deliniated with the directory separator of '/'. For example, given the file path '/a/b/c/d.txt', 'a' must be a KiFS directory.

These characters are allowed in file name paths: letters, numbers, spaces, the path delimiter of '/', and the characters: '.' '-' ':' '[' ']' '(' ')' '#' '='.

Parameters
[in]fileNamesAn array of full file name paths to be used for the files uploaded to KiFS. File names may have any number of nested directories in their paths, but the top-level directory must be an existing KiFS directory. Each file must reside in or under a top-level directory. A full file name path cannot be larger than 1024 characters.
[in]fileDataFile data for the files being uploaded, for the respective files in fileNames.
[in]optionsOptional parameters. The default value is an empty map.
Returns
Response object containing the result of the operation.

◆ uploadFiles() [4/4]

UploadFilesResponse& gpudb::GPUdb::uploadFiles ( const std::vector< std::string > &  fileNames,
const std::vector< std::vector< uint8_t > > &  fileData,
const std::map< std::string, std::string > &  options,
UploadFilesResponse response_ 
) const

Uploads one or more files to KiFS.

There are two methods for uploading files: load files in their entirety, or load files in parts. The latter is recommeded for files of approximately 60 MB or larger.

To upload files in their entirety, populate fileNames with the file names to upload into on KiFS, and their respective byte content in fileData.

Multiple steps are involved when uploading in multiple parts. Only one file at a time can be uploaded in this manner. A user-provided UUID is utilized to tie all the upload steps together for a given file. To upload a file in multiple parts:

  1. Provide the file name in fileNames, the UUID in the multipart_upload_uuid key in options, and a multipart_operation value of init.
  2. Upload one or more parts by providing the file name, the part data in fileData, the UUID, a multipart_operation value of upload_part, and the part number in the multipart_upload_part_number. The part numbers must start at 1 and increase incrementally. Parts may not be uploaded out of order.
  3. Complete the upload by providing the file name, the UUID, and a multipart_operation value of complete.

Multipart uploads in progress may be canceled by providing the file name, the UUID, and a multipart_operation value of cancel. If an new upload is initialized with a different UUID for an existing upload in progress, the pre-existing upload is automatically canceled in favor of the new upload.

The multipart upload must be completed for the file to be usable in KiFS. Information about multipart uploads in progress is available in showFiles.

File data may be pre-encoded using base64 encoding. This should be indicated using the file_encoding option, and is recommended when using JSON serialization.

Each file path must reside in a top-level KiFS directory, i.e. one of the directories listed in showDirectories. The user must have write permission on the directory. Nested directories are permitted in file name paths. Directories are deliniated with the directory separator of '/'. For example, given the file path '/a/b/c/d.txt', 'a' must be a KiFS directory.

These characters are allowed in file name paths: letters, numbers, spaces, the path delimiter of '/', and the characters: '.' '-' ':' '[' ']' '(' ')' '#' '='.

Parameters
[in]fileNamesAn array of full file name paths to be used for the files uploaded to KiFS. File names may have any number of nested directories in their paths, but the top-level directory must be an existing KiFS directory. Each file must reside in or under a top-level directory. A full file name path cannot be larger than 1024 characters.
[in]fileDataFile data for the files being uploaded, for the respective files in fileNames.
[in]optionsOptional parameters. The default value is an empty map.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ uploadFilesFromurl() [1/4]

UploadFilesFromurlResponse gpudb::GPUdb::uploadFilesFromurl ( const UploadFilesFromurlRequest request_) const

Uploads one or more files to KiFS.

Each file path must reside in a top-level KiFS directory, i.e. one of the directories listed in showDirectories. The user must have write permission on the directory. Nested directories are permitted in file name paths. Directories are deliniated with the directory separator of '/'. For example, given the file path '/a/b/c/d.txt', 'a' must be a KiFS directory.

These characters are allowed in file name paths: letters, numbers, spaces, the path delimiter of '/', and the characters: '.' '-' ':' '[' ']' '(' ')' '#' '='.

Parameters
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

◆ uploadFilesFromurl() [2/4]

UploadFilesFromurlResponse& gpudb::GPUdb::uploadFilesFromurl ( const UploadFilesFromurlRequest request_,
UploadFilesFromurlResponse response_ 
) const

Uploads one or more files to KiFS.

Each file path must reside in a top-level KiFS directory, i.e. one of the directories listed in showDirectories. The user must have write permission on the directory. Nested directories are permitted in file name paths. Directories are deliniated with the directory separator of '/'. For example, given the file path '/a/b/c/d.txt', 'a' must be a KiFS directory.

These characters are allowed in file name paths: letters, numbers, spaces, the path delimiter of '/', and the characters: '.' '-' ':' '[' ']' '(' ')' '#' '='.

Parameters
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ uploadFilesFromurl() [3/4]

UploadFilesFromurlResponse gpudb::GPUdb::uploadFilesFromurl ( const std::vector< std::string > &  fileNames,
const std::vector< std::string > &  urls,
const std::map< std::string, std::string > &  options 
) const

Uploads one or more files to KiFS.

Each file path must reside in a top-level KiFS directory, i.e. one of the directories listed in showDirectories. The user must have write permission on the directory. Nested directories are permitted in file name paths. Directories are deliniated with the directory separator of '/'. For example, given the file path '/a/b/c/d.txt', 'a' must be a KiFS directory.

These characters are allowed in file name paths: letters, numbers, spaces, the path delimiter of '/', and the characters: '.' '-' ':' '[' ']' '(' ')' '#' '='.

Parameters
[in]fileNamesAn array of full file name paths to be used for the files uploaded to KiFS. File names may have any number of nested directories in their paths, but the top-level directory must be an existing KiFS directory. Each file must reside in or under a top-level directory. A full file name path cannot be larger than 1024 characters.
[in]urlsList of URLs to upload, for each respective file in fileNames.
[in]optionsOptional parameters. The default value is an empty map.
Returns
Response object containing the result of the operation.

◆ uploadFilesFromurl() [4/4]

UploadFilesFromurlResponse& gpudb::GPUdb::uploadFilesFromurl ( const std::vector< std::string > &  fileNames,
const std::vector< std::string > &  urls,
const std::map< std::string, std::string > &  options,
UploadFilesFromurlResponse response_ 
) const

Uploads one or more files to KiFS.

Each file path must reside in a top-level KiFS directory, i.e. one of the directories listed in showDirectories. The user must have write permission on the directory. Nested directories are permitted in file name paths. Directories are deliniated with the directory separator of '/'. For example, given the file path '/a/b/c/d.txt', 'a' must be a KiFS directory.

These characters are allowed in file name paths: letters, numbers, spaces, the path delimiter of '/', and the characters: '.' '-' ':' '[' ']' '(' ')' '#' '='.

Parameters
[in]fileNamesAn array of full file name paths to be used for the files uploaded to KiFS. File names may have any number of nested directories in their paths, but the top-level directory must be an existing KiFS directory. Each file must reside in or under a top-level directory. A full file name path cannot be larger than 1024 characters.
[in]urlsList of URLs to upload, for each respective file in fileNames.
[in]optionsOptional parameters. The default value is an empty map.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ visualizeImageChart() [1/4]

VisualizeImageChartResponse gpudb::GPUdb::visualizeImageChart ( const VisualizeImageChartRequest request_) const

Scatter plot is the only plot type currently supported.

A non-numeric column can be specified as x or y column and jitters can be added to them to avoid excessive overlapping. All color values must be in the format RRGGBB or AARRGGBB (to specify the alpha value). The image is contained in the imageData field.

Parameters
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

◆ visualizeImageChart() [2/4]

VisualizeImageChartResponse& gpudb::GPUdb::visualizeImageChart ( const VisualizeImageChartRequest request_,
VisualizeImageChartResponse response_ 
) const

Scatter plot is the only plot type currently supported.

A non-numeric column can be specified as x or y column and jitters can be added to them to avoid excessive overlapping. All color values must be in the format RRGGBB or AARRGGBB (to specify the alpha value). The image is contained in the imageData field.

Parameters
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ visualizeImageChart() [3/4]

VisualizeImageChartResponse gpudb::GPUdb::visualizeImageChart ( const std::string &  tableName,
const std::vector< std::string > &  xColumnNames,
const std::vector< std::string > &  yColumnNames,
const double  minX,
const double  maxX,
const double  minY,
const double  maxY,
const int32_t  width,
const int32_t  height,
const std::string &  bgColor,
const std::map< std::string, std::vector< std::string > > &  styleOptions,
const std::map< std::string, std::string > &  options 
) const

Scatter plot is the only plot type currently supported.

A non-numeric column can be specified as x or y column and jitters can be added to them to avoid excessive overlapping. All color values must be in the format RRGGBB or AARRGGBB (to specify the alpha value). The image is contained in the imageData field.

Parameters
[in]tableNameName of the table containing the data to be drawn as a chart, in [schema_name.]table_name format, using standard name resolution rules.
[in]xColumnNamesNames of the columns containing the data mapped to the x axis of a chart.
[in]yColumnNamesNames of the columns containing the data mapped to the y axis of a chart.
[in]minXLower bound for the x column values. For non-numeric x column, each x column item is mapped to an integral value starting from 0.
[in]maxXUpper bound for the x column values. For non-numeric x column, each x column item is mapped to an integral value starting from 0.
[in]minYLower bound for the y column values. For non-numeric y column, each y column item is mapped to an integral value starting from 0.
[in]maxYUpper bound for the y column values. For non-numeric y column, each y column item is mapped to an integral value starting from 0.
[in]widthWidth of the generated image in pixels.
[in]heightHeight of the generated image in pixels.
[in]bgColorBackground color of the generated image.
[in]styleOptionsRendering style options for a chart.
[in]optionsOptional parameters. The default value is an empty map.
Returns
Response object containing the result of the operation.

◆ visualizeImageChart() [4/4]

VisualizeImageChartResponse& gpudb::GPUdb::visualizeImageChart ( const std::string &  tableName,
const std::vector< std::string > &  xColumnNames,
const std::vector< std::string > &  yColumnNames,
const double  minX,
const double  maxX,
const double  minY,
const double  maxY,
const int32_t  width,
const int32_t  height,
const std::string &  bgColor,
const std::map< std::string, std::vector< std::string > > &  styleOptions,
const std::map< std::string, std::string > &  options,
VisualizeImageChartResponse response_ 
) const

Scatter plot is the only plot type currently supported.

A non-numeric column can be specified as x or y column and jitters can be added to them to avoid excessive overlapping. All color values must be in the format RRGGBB or AARRGGBB (to specify the alpha value). The image is contained in the imageData field.

Parameters
[in]tableNameName of the table containing the data to be drawn as a chart, in [schema_name.]table_name format, using standard name resolution rules.
[in]xColumnNamesNames of the columns containing the data mapped to the x axis of a chart.
[in]yColumnNamesNames of the columns containing the data mapped to the y axis of a chart.
[in]minXLower bound for the x column values. For non-numeric x column, each x column item is mapped to an integral value starting from 0.
[in]maxXUpper bound for the x column values. For non-numeric x column, each x column item is mapped to an integral value starting from 0.
[in]minYLower bound for the y column values. For non-numeric y column, each y column item is mapped to an integral value starting from 0.
[in]maxYUpper bound for the y column values. For non-numeric y column, each y column item is mapped to an integral value starting from 0.
[in]widthWidth of the generated image in pixels.
[in]heightHeight of the generated image in pixels.
[in]bgColorBackground color of the generated image.
[in]styleOptionsRendering style options for a chart.
[in]optionsOptional parameters. The default value is an empty map.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ visualizeIsochrone() [1/4]

VisualizeIsochroneResponse gpudb::GPUdb::visualizeIsochrone ( const VisualizeIsochroneRequest request_) const

Generate an image containing isolines for travel results using an existing graph.

Isolines represent curves of equal cost, with cost typically referring to the time or distance assigned as the weights of the underlying graph. See Graphs & Solvers for more information on graphs.

Parameters
[in]request_Request object containing the parameters for the operation.
Returns
Response object containing the result of the operation.

◆ visualizeIsochrone() [2/4]

VisualizeIsochroneResponse& gpudb::GPUdb::visualizeIsochrone ( const VisualizeIsochroneRequest request_,
VisualizeIsochroneResponse response_ 
) const

Generate an image containing isolines for travel results using an existing graph.

Isolines represent curves of equal cost, with cost typically referring to the time or distance assigned as the weights of the underlying graph. See Graphs & Solvers for more information on graphs.

Parameters
[in]request_Request object containing the parameters for the operation.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

◆ visualizeIsochrone() [3/4]

VisualizeIsochroneResponse gpudb::GPUdb::visualizeIsochrone ( const std::string &  graphName,
const std::string &  sourceNode,
const double  maxSolutionRadius,
const std::vector< std::string > &  weightsOnEdges,
const std::vector< std::string > &  restrictions,
const int32_t  numLevels,
const bool  generateImage,
const std::string &  levelsTable,
const std::map< std::string, std::string > &  styleOptions,
const std::map< std::string, std::string > &  solveOptions,
const std::map< std::string, std::string > &  contourOptions,
const std::map< std::string, std::string > &  options 
) const

Generate an image containing isolines for travel results using an existing graph.

Isolines represent curves of equal cost, with cost typically referring to the time or distance assigned as the weights of the underlying graph. See Graphs & Solvers for more information on graphs.

Parameters
[in]graphNameName of the graph on which the isochrone is to be computed.
[in]sourceNodeStarting vertex on the underlying graph from/to which the isochrones are created.
[in]maxSolutionRadiusExtent of the search radius around sourceNode. Set to '-1.0' for unrestricted search radius. The default value is -1.0.
[in]weightsOnEdgesAdditional weights to apply to the edges of an existing graph. Weights must be specified using identifiers; identifiers are grouped as combinations. Identifiers can be used with existing column names, e.g., 'table.column AS WEIGHTS_EDGE_ID', or expressions, e.g., 'ST_LENGTH(wkt) AS WEIGHTS_VALUESPECIFIED'. Any provided weights will be added (in the case of 'WEIGHTS_VALUESPECIFIED') to or multiplied with (in the case of 'WEIGHTS_FACTORSPECIFIED') the existing weight(s). The default value is an empty vector.
[in]restrictionsAdditional restrictions to apply to the nodes/edges of an existing graph. Restrictions must be specified using identifiers; identifiers are grouped as combinations. Identifiers can be used with existing column names, e.g., 'table.column AS RESTRICTIONS_EDGE_ID', or expressions, e.g., 'column/2 AS RESTRICTIONS_VALUECOMPARED'. If remove_previous_restrictions is set to true, any provided restrictions will replace the existing restrictions. If remove_previous_restrictions is set to false, any provided restrictions will be added (in the case of 'RESTRICTIONS_VALUECOMPARED') to or replaced (in the case of 'RESTRICTIONS_ONOFFCOMPARED'). The default value is an empty vector.
[in]numLevelsNumber of equally-separated isochrones to compute. The default value is 1.
[in]generateImageIf set to true, generates a PNG image of the isochrones in the response. Supported values:
  • true
  • false
The default value is true.
[in]levelsTableName of the table to output the isochrones to, in [schema_name.]table_name format, using standard name resolution rules and meeting table naming criteria. The table will contain levels and their corresponding WKT geometry. If no value is provided, the table is not generated. The default value is ''.
[in]styleOptionsVarious style related options of the isochrone image.
[in]solveOptionsSolver specific parameters. The default value is an empty map.
[in]contourOptionsSolver specific parameters. The default value is an empty map.
[in]optionsAdditional parameters. The default value is an empty map.
Returns
Response object containing the result of the operation.

◆ visualizeIsochrone() [4/4]

VisualizeIsochroneResponse& gpudb::GPUdb::visualizeIsochrone ( const std::string &  graphName,
const std::string &  sourceNode,
const double  maxSolutionRadius,
const std::vector< std::string > &  weightsOnEdges,
const std::vector< std::string > &  restrictions,
const int32_t  numLevels,
const bool  generateImage,
const std::string &  levelsTable,
const std::map< std::string, std::string > &  styleOptions,
const std::map< std::string, std::string > &  solveOptions,
const std::map< std::string, std::string > &  contourOptions,
const std::map< std::string, std::string > &  options,
VisualizeIsochroneResponse response_ 
) const

Generate an image containing isolines for travel results using an existing graph.

Isolines represent curves of equal cost, with cost typically referring to the time or distance assigned as the weights of the underlying graph. See Graphs & Solvers for more information on graphs.

Parameters
[in]graphNameName of the graph on which the isochrone is to be computed.
[in]sourceNodeStarting vertex on the underlying graph from/to which the isochrones are created.
[in]maxSolutionRadiusExtent of the search radius around sourceNode. Set to '-1.0' for unrestricted search radius. The default value is -1.0.
[in]weightsOnEdgesAdditional weights to apply to the edges of an existing graph. Weights must be specified using identifiers; identifiers are grouped as combinations. Identifiers can be used with existing column names, e.g., 'table.column AS WEIGHTS_EDGE_ID', or expressions, e.g., 'ST_LENGTH(wkt) AS WEIGHTS_VALUESPECIFIED'. Any provided weights will be added (in the case of 'WEIGHTS_VALUESPECIFIED') to or multiplied with (in the case of 'WEIGHTS_FACTORSPECIFIED') the existing weight(s). The default value is an empty vector.
[in]restrictionsAdditional restrictions to apply to the nodes/edges of an existing graph. Restrictions must be specified using identifiers; identifiers are grouped as combinations. Identifiers can be used with existing column names, e.g., 'table.column AS RESTRICTIONS_EDGE_ID', or expressions, e.g., 'column/2 AS RESTRICTIONS_VALUECOMPARED'. If remove_previous_restrictions is set to true, any provided restrictions will replace the existing restrictions. If remove_previous_restrictions is set to false, any provided restrictions will be added (in the case of 'RESTRICTIONS_VALUECOMPARED') to or replaced (in the case of 'RESTRICTIONS_ONOFFCOMPARED'). The default value is an empty vector.
[in]numLevelsNumber of equally-separated isochrones to compute. The default value is 1.
[in]generateImageIf set to true, generates a PNG image of the isochrones in the response. Supported values:
  • true
  • false
The default value is true.
[in]levelsTableName of the table to output the isochrones to, in [schema_name.]table_name format, using standard name resolution rules and meeting table naming criteria. The table will contain levels and their corresponding WKT geometry. If no value is provided, the table is not generated. The default value is ''.
[in]styleOptionsVarious style related options of the isochrone image.
[in]solveOptionsSolver specific parameters. The default value is an empty map.
[in]contourOptionsSolver specific parameters. The default value is an empty map.
[in]optionsAdditional parameters. The default value is an empty map.
[out]response_Response object containing the results of the operation.
Returns
Response object containing the result of the operation (initially passed in by reference).

Member Data Documentation

◆ DB_CONNECTION_REFUSED_ERROR_MESSAGE

const std::string gpudb::GPUdb::DB_CONNECTION_REFUSED_ERROR_MESSAGE
static

Definition at line 163 of file GPUdb.hpp.

◆ DB_CONNECTION_RESET_ERROR_MESSAGE

const std::string gpudb::GPUdb::DB_CONNECTION_RESET_ERROR_MESSAGE
static

Special error messages indicating that a connection failure happened (generally should trigger a high-availability failover if applicable)

Definition at line 162 of file GPUdb.hpp.

◆ DB_EXITING_ERROR_MESSAGE

const std::string gpudb::GPUdb::DB_EXITING_ERROR_MESSAGE
static

Definition at line 164 of file GPUdb.hpp.

◆ DB_HM_OFFLINE_ERROR_MESSAGE

const std::string gpudb::GPUdb::DB_HM_OFFLINE_ERROR_MESSAGE
static

Definition at line 167 of file GPUdb.hpp.

◆ DB_OFFLINE_ERROR_MESSAGE

const std::string gpudb::GPUdb::DB_OFFLINE_ERROR_MESSAGE
static

Definition at line 165 of file GPUdb.hpp.

◆ DB_SYSTEM_LIMITED_ERROR_MESSAGE

const std::string gpudb::GPUdb::DB_SYSTEM_LIMITED_ERROR_MESSAGE
static

Definition at line 166 of file GPUdb.hpp.

◆ END_OF_SET

const int64_t gpudb::GPUdb::END_OF_SET = -9999
static

Definition at line 158 of file GPUdb.hpp.

◆ HEADER_AUTHORIZATION

const std::string gpudb::GPUdb::HEADER_AUTHORIZATION
static

Headers used internally; MUST add each of them to PROTECTED_HEADERS in the .cpp file.

Definition at line 171 of file GPUdb.hpp.

◆ HEADER_CONTENT_LENGTH

const std::string gpudb::GPUdb::HEADER_CONTENT_LENGTH
static

Definition at line 173 of file GPUdb.hpp.

◆ HEADER_CONTENT_TYPE

const std::string gpudb::GPUdb::HEADER_CONTENT_TYPE
static

Definition at line 172 of file GPUdb.hpp.

◆ HEADER_HA_SYNC_MODE

const std::string gpudb::GPUdb::HEADER_HA_SYNC_MODE
static

Definition at line 174 of file GPUdb.hpp.


The documentation for this class was generated from the following files: