alter_system_properties
GPUdb.alter_system_properties( property_updates_map = None, options = {} )
The alter_system_properties 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 input parameter property_updates_map whose keys are commands and values are strings representing integer values (for example '8000') or boolean values ('true' or 'false').
| Name |
Type |
Description |
| property_updates_map |
dict
of
str |
Map containing the properties of the system to be updated. Error if empty.
| Supported Parameters (keys) |
Parameter Description |
| sm_omp_threads |
Set the number of OpenMP threads that will be used to service filter & aggregation requests against collections to the specified integer value. |
| kernel_omp_threads |
Set the number of kernel OpenMP threads to the specified integer value. |
| concurrent_kernel_execution |
Enables concurrent kernel execution if the value is true and disables it if the value is false. The allowed values are:
|
| chunk_size |
Sets the chunk size of all new sets to the specified integer value. |
| flush_to_disk |
Flushes any changes to any tables to the persistent store. These changes include updates to the vector store, object store, and text search store, Value string is ignored |
| clear_cache |
Clears cached results. Useful to allow repeated timing of endpoints. Value string is ignored |
| communicator_test |
Invoke the communicator test and report timing results. Value string is is a comma separated list of <key>=<value> expressions. Expressions are: num_transactions=<num> where num is the number of request reply transactions to invoke per test; message_size=<bytes> where bytes is the size of the messages to send in bytes; check_values=<enabled> where if enabled is true the value of the messages received are verified. |
| set_message_timers_enabled |
Enables the communicator test to collect additional timing statistics when the value string is true. Disables the collection when the value string is false The allowed values are:
|
| bulk_add_test |
Invoke the bulk add test and report timing results. Value string is ignored. |
| network_speed |
Invoke the network speed test and report timing results. Value string is a semicolon-separated list of <key>=<value> expressions. Valid expressions are: seconds=<time> where time is the time in seconds to run the test; data_size=<size> where size is the size in bytes of the block to be transferred; threads=<number of threads>; to_ranks=<space-separated list of ranks> where the list of ranks is the ranks that rank 0 will send data to and get data from. If to_ranks is unspecified then all worker ranks are used. |
| request_timeout |
Number of minutes after which filtering (e.g., filter) and aggregating (e.g., aggregate_group_by) queries will timeout. Default value is 20. The minimum allowed value is 0. The maximum allowed value is 200. |
| max_get_records_size |
The maximum number of records the database will serve for a given data retrieval call Default value is 20000. The minimum allowed value is 0. The maximum allowed value is 1000000. |
|
| options |
dict
of
str |
Optional parameters. Default value is an empty dict ( {} ). |
| Name |
Type |
Description |
| updated_properties_map |
dict
of
str |
map of values updated, For speed
tests a map of values measured to
the measurement |