Skip to main content

​
◆ alterTier() [1/4]

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

Alters properties of an existing 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 existing 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 existing 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: vram, ram, disk[n], persist, cold[n].
[in]optionsOptional parameters.
  • alter_tier_capacity: Maximum size in bytes this tier may hold at once, per rank.
  • 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 existing 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: vram, ram, disk[n], persist, cold[n].
[in]optionsOptional parameters.
  • alter_tier_capacity: Maximum size in bytes this tier may hold at once, per rank.
  • 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).