A set of parameters for GPUdb::alterResourceGroup. More...

#include <gpudb/protocol/alter_resource_group.h>

Public Member Functions
	AlterResourceGroupRequest ()
	Constructs an AlterResourceGroupRequest object with default parameters. More...

	AlterResourceGroupRequest (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_)
	Constructs an AlterResourceGroupRequest object with the specified parameters. More...

Public Attributes
std::string	name
	Name of the group to be altered. More...

std::map< std::string, std::map< std::string, std::string > >	tierAttributes
	Optional map containing tier names and their respective attribute group limits. More...

std::string	ranking
	If 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. More...

std::string	adjoiningResourceGroup
	If ranking is before or after, this field indicates the resource group before or after which the current group will be placed; otherwise, leave blank. More...

std::map< std::string, std::string >	options
	Optional parameters. More...

Detailed Description

A set of parameters for GPUdb::alterResourceGroup.

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

Definition at line 19 of file alter_resource_group.h.

Constructor & Destructor Documentation

◆ AlterResourceGroupRequest() [1/2]

gpudb::AlterResourceGroupRequest::AlterResourceGroupRequest ( )

inline

Constructs an AlterResourceGroupRequest object with default parameters.

Definition at line 25 of file alter_resource_group.h.

◆ AlterResourceGroupRequest() [2/2]

gpudb::AlterResourceGroupRequest::AlterResourceGroupRequest	(	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_
	)

inline

Constructs an AlterResourceGroupRequest object with the specified parameters.

Parameters

[in]	name_	Name 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]	tierAttributes_	Optional 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'}}. alter_resource_group_max_memory: Maximum amount of memory usable in the given tier at one time for this group. The default value is an empty map.
[in]	ranking_	If 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: alter_resource_group_empty_string alter_resource_group_first alter_resource_group_last alter_resource_group_before alter_resource_group_after The default value is alter_resource_group_empty_string.
[in]	adjoiningResourceGroup_	If 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]	options_	Optional parameters. alter_resource_group_max_cpu_concurrency: Maximum number of simultaneous threads that will be used to execute a request for this group. The minimum allowed value is '4'. alter_resource_group_max_data: Maximum amount of cumulative ram usage regardless of tier status for this group. The minimum allowed value is '-1'. alter_resource_group_max_scheduling_priority: Maximum priority of a scheduled task for this group. The minimum allowed value is '1'. The maximum allowed value is '100'. alter_resource_group_max_tier_priority: Maximum priority of a tiered object for this group. The minimum allowed value is '1'. The maximum allowed value is '10'. alter_resource_group_is_default_group: If true, this request applies to the global default resource group. It is an error for this field to be true when the name_ field is also populated. Supported values: alter_resource_group_true alter_resource_group_false The default value is alter_resource_group_false. alter_resource_group_persist: If true and a system-level change was requested, 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: alter_resource_group_true alter_resource_group_false The default value is alter_resource_group_true. The default value is an empty map.

Definition at line 175 of file alter_resource_group.h.

Member Data Documentation

◆ adjoiningResourceGroup

std::string gpudb::AlterResourceGroupRequest::adjoiningResourceGroup

If 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 ''.

Definition at line 240 of file alter_resource_group.h.

◆ name

std::string gpudb::AlterResourceGroupRequest::name

Name 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.

Definition at line 189 of file alter_resource_group.h.

◆ options

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

Optional parameters.

alter_resource_group_max_cpu_concurrency: Maximum number of simultaneous threads that will be used to execute a request for this group. The minimum allowed value is '4'.
alter_resource_group_max_data: Maximum amount of cumulative ram usage regardless of tier status for this group. The minimum allowed value is '-1'.
alter_resource_group_max_scheduling_priority: Maximum priority of a scheduled task for this group. The minimum allowed value is '1'. The maximum allowed value is '100'.
alter_resource_group_max_tier_priority: Maximum priority of a tiered object for this group. The minimum allowed value is '1'. The maximum allowed value is '10'.
alter_resource_group_is_default_group: If true, this request applies to the global default resource group. It is an error for this field to be true when the name field is also populated. Supported values:
- alter_resource_group_true
- alter_resource_group_false
The default value is alter_resource_group_false.
alter_resource_group_persist: If true and a system-level change was requested, 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:
- alter_resource_group_true
- alter_resource_group_false
The default value is alter_resource_group_true.

The default value is an empty map.

Definition at line 295 of file alter_resource_group.h.

◆ ranking

std::string gpudb::AlterResourceGroupRequest::ranking

If 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.

Definition at line 232 of file alter_resource_group.h.

◆ tierAttributes

std::map<std::string, std::map<std::string, std::string> > gpudb::AlterResourceGroupRequest::tierAttributes

Optional 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'}}.

alter_resource_group_max_memory: Maximum amount of memory usable in the given tier at one time for this group.