
# ALTER GLOBAL CONFIGURATION
#### 功能描述
新增、修改系统表gs_global_config的key-value值。如果修改的参数已经存在，则修改；如果不存在则新增。
#### 注意事项
- 仅支持数据库初始用户运行此命令。
- 参数名称不能为weak_password、undostoragetype。
- 参数名称为扩容重分布预留参数时，需设置GUC参数enable_cluster_resize为on，或者使用扩容工具进行修改。涉及的参数名称包括：lockwait_timeout、lockwait_interval、trylock_threshold、enable_cancel、last_catchup_threshold、catchup_times、write_error_mode、catchup_query_dop、parallel_catchup_threshold、parallel_reindex_jobs、redis_retry_times、redis_retry_interval、redis_bucket_expansion、redis_bucket_batchsize、redis_bucket_log_level、redis_bucket_lockhold_timeout、redis_bucket_timeout_penalty、redis_bucket_max_lockwait_timeout_retry、redis_bucket_max_lockhold_timeout_retry、redis_bucket_strategy_history_capacity、redis_bucket_strategy_recent_threshold、redis_bucket_workload_rule、redis_bucket_lsn_rule、redis_bucket_tx_bucket_min、redis_bucket_tx_bucket_max、redis_max_expected_tps、redis_bucket_sender_concurrency、redis_bucket_receiver_concurrency、redis_bucket_parse_redo_num、redis_bucket_workers_per_paser以及redis_bucket_keep_bucketxlogs。
 
#### 语法格式
```
ALTER GLOBAL CONFIGURATION with(name=value, name=value...);
```
#### 参数说明
- **name**
  参数名称，text类型，不能为weak_password、undostoragetype，除此之外没有限制。
  ![](https://support.huaweicloud.com/distributed-devg-v8-gaussdb/public_sys-resources/note_3.0-zh-cn.png)
  当参数名称为扩容重分布预留参数时，需设置GUC参数enable_cluster_resize为on，或者使用扩容工具进行修改。
  

- **value**
  参数值，text类型。
  
 
#### 示例
```
--插入内容。
gaussdb=# ALTER GLOBAL CONFIGURATION with(redis_is_ok = true);
--查询。
gaussdb=# SELECT * FROM gs_global_config;
      name       | value
-----------------+-------
 buckets_len     | 16384
 undostoragetype | page
 redis_is_ok     | true
(3 rows)
--修改内容。
gaussdb=# ALTER GLOBAL CONFIGURATION with(redis_is_ok = false);
--查询。
gaussdb=# SELECT * FROM gs_global_config;
      name       | value
-----------------+-------
 buckets_len     | 16384
 undostoragetype | page
 redis_is_ok     | false
(3 rows)
--删除内容。
gaussdb=# DROP GLOBAL CONFIGURATION redis_is_ok;
--查询。
gaussdb=# SELECT * FROM gs_global_config;
      name       | value
-----------------+-------
 buckets_len     | 16384
 undostoragetype | page
(2 rows)
```
#### 相关链接
[DROP GLOBAL CONFIGURATION](https://support.huaweicloud.com/distributed-devg-v8-gaussdb/gaussdb-12-0596.html#ZH-CN_TOPIC_0000002559105929)
