Documentation > System Stored Procedures > @SetConfiguration
@SetConfiguration
Change the value of a list of HStoreConf parameters in the entire H-Store cluster. The changes will be sent to each HStoreSite and then validate that the current value is the same at all of them.
Please note that this operation is primarily used for benchmarking experiments and is not guaranteed to be consistent. That is, if the system procedure transaction fails at one HStoreSite, the HStoreConf changes made will not be rolled back at each site. Furthermore, the changes made by this procedure are not durable. When the system is restarted, the HStoreConf parameters will revert back to their default values and the values defined in the H-Store configuration file.
Not all parameters support being changed dynamically at run time, as this could put the database in an invalid state. Any class that implements the internal Configurable interface will be changed by this system procedure but not all of their parameters will updated.
Input Parameters
Name | Type | Description |
---|---|---|
CONF_NAMES | String[] | The list of the HStoreConf parameter to modify at each node in the cluster. |
CONF_VALUES | String[] | The list of the HStoreConf parameter values to assign to the confNames. |
Return Values
Name | Type | Description |
---|---|---|
CONF_NAME | String | The name of the HStoreConf parameter in this record. |
CONF_VALUE | String | A string representation of the value for this HStoreConf parameter. |
UPDATED | Timestamp | The timestamp of when this HStoreConf parameter was updated. |
Java Example
Client client = ClientFactory.createClient(); client = client.createConnection(hostname, port); String confNames[] = { "site.exec_validate_work", "site.specexec_enable" }; String confValues[] = { "true", "true" }; ClientResponse cresponse = client.callProcedure("@SetConfiguration", confNames, confValues); |
Command-Line Example
Not supported at this time