# 内存
介绍与内存相关的参数设置。
![](https://support.huaweicloud.com/centralized-ref-v10-gaussdb/public_sys-resources/note_3.0-zh-cn.png)
这些参数只能在数据库服务重新启动后生效，local_syscache_threshold除外。
#### memorypool_enable
**参数说明** **：**设置是否允许使用内存池。
**参数类型：**布尔型
**参数单位：**无
**取值范围** **：**
- on：表示允许使用内存池。
- off：表示不允许使用内存池。
**默认值** **：**off
**设置方式：** 该参数属于POSTMASTER类型参数，请参见[表1](https://support.huaweicloud.com/centralized-ref-v10-gaussdb/gaussdb-38-0993.html#ZH-CN_TOPIC_0000002793699379__zh-cn_topic_0283137176_zh-cn_topic_0237121562_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中对应设置方法进行设置。
**设置建议：**推荐使用默认值。
**设置不当的风险与影响：**请在充分理解参数含义，并经过测试验证后进行修改。
#### memorypool_size
**参数说明** **：**设置内存池大小。
**参数类型：**整型
**参数单位：**kB
**取值范围** **：**131072 \~ 1073741823
**默认值** **：**524288（即512MB）
**设置方式：** 该参数属于POSTMASTER类型参数，请参见[表1](https://support.huaweicloud.com/centralized-ref-v10-gaussdb/gaussdb-38-0993.html#ZH-CN_TOPIC_0000002793699379__zh-cn_topic_0283137176_zh-cn_topic_0237121562_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中对应设置方法进行设置。例如，不带单位取值131072，表示memorypool_size为131072kB；带单位取值128MB，表示memorypool_size为128MB。取值如果要带单位，必须为kB、MB、GB。
**设置建议：**推荐使用默认值。
**设置不当的风险与影响：**请在充分理解参数含义，并经过测试验证后进行修改。
 #### enable_memory_limit
**参数说明：**设置是否启用逻辑内存管理模块。多租数据库特性（enable_mtd）需要开启该参数。
![](https://support.huaweicloud.com/centralized-ref-v10-gaussdb/public_sys-resources/note_3.0-zh-cn.png)
由于存在固定开销，即[shared_buffers]和元数据（大约200MB），若[max_process_memory]减去固定开销小于2GB，GaussDB会强制把enable_memory_limit设置为off。其中元数据是GaussDB内部使用的内存，和部分并发参数，如[max_connections](https://support.huaweicloud.com/centralized-ref-v10-gaussdb/gaussdb-38-0998.html#ZH-CN_TOPIC_0000002793699389__zh-cn_topic_0283136886_zh-cn_topic_0237124695_zh-cn_topic_0059777636_sa723b719fa70453bb7ec27f323d41c79)、[thread_pool_attr](https://support.huaweicloud.com/centralized-ref-v10-gaussdb/gaussdb-38-1065.html#ZH-CN_TOPIC_0000002764460146__zh-cn_topic_0283137548_zh-cn_topic_0237124743_section787511112134)、[max_prepared_transactions]等参数相关。
**参数类型：**布尔型
**参数单位：**无
**取值范围** **：**
- on：表示启用逻辑内存管理模块。
- off：表示不启用逻辑内存管理模块。
**默认值：**on
**设置方式：** 该参数属于POSTMASTER类型参数，请参见[表1](https://support.huaweicloud.com/centralized-ref-v10-gaussdb/gaussdb-38-0993.html#ZH-CN_TOPIC_0000002793699379__zh-cn_topic_0283137176_zh-cn_topic_0237121562_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中对应设置方法进行设置。
**设置建议：**推荐使用默认值。
**设置不当的风险与影响：**当该值为off时，不对数据库使用的内存做限制，在大并发或者复杂查询时，使用内存过多，可能导致操作系统OOM问题。
 #### enable_threads_memory_reserve
**参数说明：**设置是否启用后台线程内存隔离模块。开启后为后台线程按照后台线程优先级预留内存资源。当开启逻辑内存管理模块（即enable_memory_limit为on）时，设置该参数为on才能启动生效。
**参数类型：**布尔型
**参数单位：**无
**取值范围** **：**
- on：表示启用后台线程内存隔离模块。
- off：表示不启用后台线程内存隔离模块。
**默认值：**on
**设置方式：** 该参数属于SIGHUP类型参数，请参见[表1](https://support.huaweicloud.com/centralized-ref-v10-gaussdb/gaussdb-38-0993.html#ZH-CN_TOPIC_0000002793699379__zh-cn_topic_0283137176_zh-cn_topic_0237121562_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中对应设置方法进行设置。
**设置建议：**推荐使用默认值。开启之后不同优先级后台线程预留内存和内存使用上限如下。
| 内存情况                        | 高优先级       | 中优先级             | 低优先级     |
|:---|:---|:---|:---|
| 预留内存情况1（最大可用动态内存 \< 10G）  | 最大可用动态内存/10 | 最大可用动态内存/10      | 最大可用动态内存/20 |
| 预留内存情况1（最大可用动态内存 \< 20G）  | 0.75GB      | 1.5GB             | 0.75GB   |
| 预留内存情况1（最大可用动态内存 \< 40G） | 0.9GB        | 3.0GB             | 1.5GB   |
| 预留内存情况1（最大可用动态内存 \>= 40G） | 1.0GB         | 4.0GB            | 2.0GB   |
| 内存使用上限                    | 无           | 最大可用动态内存 \* 30% | 等于预留内存     |
   
**设置不当的风险与影响：**当该参数设置为off时，后台线程内存使用数据会被持续统计，但不对后台线程使用的内存做隔离，在大并发或者复杂查询时，使用内存过多，可能导致后台线程申请不到内存。
![](https://support.huaweicloud.com/centralized-ref-v10-gaussdb/public_sys-resources/notice_3.0-zh-cn.png)
当[enable_serverless](https://support.huaweicloud.com/centralized-ref-v10-gaussdb/gaussdb-38-1034.html#ZH-CN_TOPIC_0000002764300298__section19907445133016)设置为on或[resource_expansion_strategy](https://support.huaweicloud.com/centralized-ref-v10-gaussdb/gaussdb-38-1034.html#ZH-CN_TOPIC_0000002764300298__section78279381915)开启"memory"开关时，会在启动阶段检查最大动态内存大小，如果小于4GB，会关闭enable_threads_memory_reserve。
 #### max_process_memory
**参数说明：**设置一个数据库节点可用的最大物理内存。
**参数类型：**整型
**参数单位：**kB
**取值范围** **：**2097152 \~ 2147483647
**默认值：**请参见"集中式（单节点1D）场景设置"。
**设置方式：** 该参数属于SIGHUP类型参数，请参见[表1](https://support.huaweicloud.com/centralized-ref-v10-gaussdb/gaussdb-38-0993.html#ZH-CN_TOPIC_0000002793699379__zh-cn_topic_0283137176_zh-cn_topic_0237121562_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中对应设置方法进行设置。（可通过[表2](https://support.huaweicloud.com/centralized-ref-v10-gaussdb/gaussdb-38-0993.html#ZH-CN_TOPIC_0000002793699379__zh-cn_topic_0283137176_zh-cn_topic_0237121562_zh-cn_topic_0059777490_t290c8f15953843db8d8e53d867cd893d)的方法一对参数值进行增大和缩小，仅在[enable_memory_limit]=on时支持通过[表2](https://support.huaweicloud.com/centralized-ref-v10-gaussdb/gaussdb-38-0993.html#ZH-CN_TOPIC_0000002793699379__zh-cn_topic_0283137176_zh-cn_topic_0237121562_zh-cn_topic_0059777490_t290c8f15953843db8d8e53d867cd893d)的方法二增大，在[enable_serverless](https://support.huaweicloud.com/centralized-ref-v10-gaussdb/gaussdb-38-1034.html#ZH-CN_TOPIC_0000002764300298__section19907445133016)=on或[resource_expansion_strategy](https://support.huaweicloud.com/centralized-ref-v10-gaussdb/gaussdb-38-1034.html#ZH-CN_TOPIC_0000002764300298__section78279381915)打开memory开关时支持通过方法二增大或缩小，增大部分仅用于动态内存，GPC可用最大动态内存及后台线程预留内存跟随最大动态内存更新。）
**设置建议：**该参数的目的是尽可能保证系统的可靠性，不会因数据库内存膨胀导致节点OOM。数据库节点上该参数值需要根据系统物理内存及单节点部署主数据库节点个数决定，建议计算公式如下：(物理内存大小 - vm.min_free_kbytes) \* 0.7 / 节点个数。这个公式中提到vm.min_free_kbytes，其含义是预留操作系统内存供内核使用，通常用作操作系统内核中通信收发内存分配，至少为5%内存，即max_process_memory = 物理内存 \* 0.665 / 节点个数。
**设置不当的风险与影响：**若该值设置不合理，比如大于服务器物理内存时，可能导致操作系统OOM问题。
**集中式（单节点1D）场景设置：**
此典型场景设置是针对主推的规格经过专门的测试调优之后，给出的最优出口值配置，具体配置信息如[表1]所示。
 表1集中式设置 
| 资源配置         | 推荐值       |
|:---|:---|
| 256C/2048G    | 1800GB  |
| 192C/1536G | 1400GB     |
| 128C/1024G | 900GB     |
| 104C/1024G  | 900GB  |
| 96C/1024G      | 900GB     |
| 96C/768G     | 680GB   |
| 80C/640G      | 560GB‬ |
| 64C/512G      | 450GB     |
| 60C/480G     | 420GB    |
| 32C/256G      | 200GB   |
| 16C/128G    | 90GB      |
| 8C/64G      | 40GB     |
| 4C/32G      | 20GB       |
| 4C/16G        | 10GB   |
   
#### local_syscache_threshold
**参数说明：** 单个session的系统缓存占用内存的最大值，当实际系统缓存大小超过该阈值时，会触发内存淘汰。如果参数[enable_global_syscache](https://support.huaweicloud.com/centralized-ref-v10-gaussdb/gaussdb-38-1073.html#ZH-CN_TOPIC_0000002793698779__section97160555612)和[enable_thread_pool](https://support.huaweicloud.com/centralized-ref-v10-gaussdb/gaussdb-38-1065.html#ZH-CN_TOPIC_0000002764460146__zh-cn_topic_0283137548_zh-cn_topic_0237124743_section97160555612)已打开，则该参数描述的是当前线程和绑定到当前线程上的session缓存的总大小。该参数可在PDB级别设置。
**参数类型：**整型
**参数单位：**kB
**取值范围** **：**1024 \~ 524288
**默认值：**
32MB（256核CPU/2048G内存，192核CPU/1536G内存）；16MB（128核CPU/1024G内存，104核CPU/1024G内存，96核CPU/1024G内存，96核CPU/768G内存，80核CPU/640G内存，64核CPU/512G内存，60核CPU/480G内存，32核CPU/256G内存，16核CPU/128G内存，8核CPU/64G内存，4核CPU/32G内存，4核CPU/16G内存）。在PDB场景内，若未设置该参数，则默认值为16MB。
**设置方式：** 该参数属于SIGHUP类型参数，请参见[表1](https://support.huaweicloud.com/centralized-ref-v10-gaussdb/gaussdb-38-0993.html#ZH-CN_TOPIC_0000002793699379__zh-cn_topic_0283137176_zh-cn_topic_0237121562_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中对应设置方法进行设置。例如，不带单位取值1024，表示local_syscache_threshold为1024kB；带单位取值1MB，表示local_syscache_threshold为1MB。取值如果要带单位，必须为kB、MB、GB。
**设置建议：**建议设置为1024的整数倍。底噪内存是2MB，平均每增加一个表或者索引，增加11kB内存。
**设置不当的风险与影响：**如果设置的值过小，会导致内存频繁淘汰，影响性能。
#### enable_memory_context_control
**参数说明：**设置是否启用检查内存上下文是否超过给定限制的功能。仅适用于DEBUG版本。
**参数类型：**布尔型
**参数单位：**无
**取值范围** **：**
- on：表示启用最大内存上下文限制检查功能。
- off：表示关闭最大内存上下文限制检查功能。
**默认值：**off
**设置方式：** 该参数属于SIGHUP类型参数，请参见[表1](https://support.huaweicloud.com/centralized-ref-v10-gaussdb/gaussdb-38-0993.html#ZH-CN_TOPIC_0000002793699379__zh-cn_topic_0283137176_zh-cn_topic_0237121562_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中对应设置方法进行设置。
**设置建议：**推荐使用默认值。
**设置不当的风险与影响：**请在充分理解参数含义，并经过测试验证后进行修改。
#### uncontrolled_memory_context
**参数说明：**启用检查内存上下文是否超过给定限制的功能时，设置不受此功能约束的内存上下文。仅适用于DEBUG版本。该参数可在PDB级别设置。
![](https://support.huaweicloud.com/centralized-ref-v10-gaussdb/public_sys-resources/note_3.0-zh-cn.png)
查询该参数时，会在参数值的最前面添加标题含义字符串"MmgrMemoryController white list:"。
**参数类型：**字符串
**参数单位：**无
**取值范围** **：**字符串
**默认值：**""。在PDB场景内，若未设置该参数，则继承来自全局的设置。
**设置方式：** 该参数属于USERSET类型参数，请参见[表1](https://support.huaweicloud.com/centralized-ref-v10-gaussdb/gaussdb-38-0993.html#ZH-CN_TOPIC_0000002793699379__zh-cn_topic_0283137176_zh-cn_topic_0237121562_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中对应设置方法进行设置。
**设置建议：**推荐使用默认值。
**设置不当的风险与影响：**请在充分理解参数含义，并经过测试验证后进行修改。
#### huge_pages
**参数说明：**数据库共享内存的申请启用静态内存大页设置。
![](https://support.huaweicloud.com/centralized-ref-v10-gaussdb/public_sys-resources/note_3.0-zh-cn.png)
要启用静态内存大页功能，需要提前在操作系统内核中设置足够数量的静态内存大页资源以供申请，相关参数为vm.nr_hugepages和vm.nr_overcommit_hugepages，会被设置在/etc/sysctl.conf文件中。
**参数类型：**字符串
**参数单位：**无
**取值范围** **：**
- on：表示启用静态大页内存申请，如果申请不到内存大页资源，则数据库启动失败。
- off：表示不启用静态大页内存申请，申请普通共享内存。
- try：尝试申请内存静态大页资源，如果申请失败，就申请普通共享内存。
**默认值：**try
**设置方式：** 该参数属于POSTMASTER类型参数，请参见[表1](https://support.huaweicloud.com/centralized-ref-v10-gaussdb/gaussdb-38-0993.html#ZH-CN_TOPIC_0000002793699379__zh-cn_topic_0283137176_zh-cn_topic_0237121562_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中对应设置方法进行设置。
**设置建议：**推荐使用默认值。
**设置不当的风险与影响：**请在充分理解参数含义，并经过测试验证后进行修改。
 #### shared_buffers
**参数说明：**设置GaussDB使用的共享内存大小。增加此参数的值会使GaussDB比系统默认设置需要更多的System V共享内存。
**参数类型：**整型
**参数单位：**页面（8kB）
**取值范围：**16 \~ 1073741823
**默认值：**请参见"集中式（单节点1D）场景设置"。
**设置方式：** 该参数属于SIGHUP类型参数，请参见[表1](https://support.huaweicloud.com/centralized-ref-v10-gaussdb/gaussdb-38-0993.html#ZH-CN_TOPIC_0000002793699379__zh-cn_topic_0283137176_zh-cn_topic_0237121562_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中对应设置方法进行设置。（在[enable_serverless](https://support.huaweicloud.com/centralized-ref-v10-gaussdb/gaussdb-38-1034.html#ZH-CN_TOPIC_0000002764300298__section19907445133016)=on或[resource_expansion_strategy](https://support.huaweicloud.com/centralized-ref-v10-gaussdb/gaussdb-38-1034.html#ZH-CN_TOPIC_0000002764300298__section78279381915)打开memory开关时支持[表2](https://support.huaweicloud.com/centralized-ref-v10-gaussdb/gaussdb-38-0993.html#ZH-CN_TOPIC_0000002793699379__zh-cn_topic_0283137176_zh-cn_topic_0237121562_zh-cn_topic_0059777490_t290c8f15953843db8d8e53d867cd893d)中的方式二进行设置，否则只支持方式一。）例如：不带单位取值1024，表示shared_buffers为1024\*8kB，即8192kB；带单位取值8MB，表示shared_buffers为8MB。若取值需带单位，必须为kB、MB或GB，且取值必须为8kB的整数倍。
**设置建议：**
- 建议设置shared_buffers值为[max_process_memory]的40%以内。
- 如果设置较大的shared_buffers，需要同时增加[checkpoint_segments](https://support.huaweicloud.com/centralized-ref-v10-gaussdb/gaussdb-38-1011.html#ZH-CN_TOPIC_0000002793779575__zh-cn_topic_0283137153_zh-cn_topic_0237124708_zh-cn_topic_0059778936_sbadc77895e6643b882a5e7557e405373)的值，因为写入大量新增数据、修改数据需要消耗更多的时间周期。
- 如果调整shared_buffers参数之后，导致进程重启失败，请参见启动失败的报错信息，采用以下解决方案之一：
  - 对应调整操作系统kernel.shmall、kernel.shmmax、kernel.shmmin参数。
  
  - 执行free -g观察操作系统可用内存和swap空间是否足够，如果内存明显不足，请手动停止其他比较占用内存的用户程序。
  
  - 对应不同规格，请按照对应建议的默认值设置，不建议修改，避免设置明显不合理（过大或过小）的shared_buffers值。注意应满足条件：[data_replicate_buffer_size](https://support.huaweicloud.com/centralized-ref-v10-gaussdb/gaussdb-38-1016.html#ZH-CN_TOPIC_0000002793699245__zh-cn_topic_0283137370_zh-cn_topic_0237124713_zh-cn_topic_0059777578_sc3dd3b16705f4fbfb54c665ce00ef966) + [segment_buffers] + shared_buffers + [wal_buffers](https://support.huaweicloud.com/centralized-ref-v10-gaussdb/gaussdb-38-1010.html#ZH-CN_TOPIC_0000002764460124__zh-cn_topic_0283137354_zh-cn_topic_0237124707_zh-cn_topic_0059778393_sce544e842a94430abad77f1ae64406af) + [temp_buffers] + [maintenance_work_mem] + [work_mem] + [query_mem] + （备机）[wal_receiver_buffer_size](https://support.huaweicloud.com/centralized-ref-v10-gaussdb/gaussdb-38-1017.html#ZH-CN_TOPIC_0000002764300592__zh-cn_topic_0283136835_zh-cn_topic_0237124714_zh-cn_topic_0059778071_s1152f5dcb7744fa5ace65b997f92ed03) \< [max_process_memory] \< 物理机内存大小。
   
**设置不当的风险与影响：**如果设置的内存参数数值过大，超过物理内存上限，将会出现数据库由于无法申请到足够的内存而无法成功启动的情况。
**集中式（单节点1D）场景设置：**
此典型场景设置是针对主推的规格经过专门的测试调优之后，给出的最优出口值配置，具体配置信息如[表2]所示。
 表2集中式shared_buffers设置 
| 资源配置        | 推荐值      |
|:---|:---|
| 256C/2048G   | 720GB   |
| 192C/1536G | 560GB |
| 128C/1024G  | 360GB   |
| 104C/1024G | 360GB   |
| 96C/1024G    | 360GB   |
| 96C/768G     | 270GB   |
| 80C/640G   | 220GB‬   |
| 64C/512G      | 180GB    |
| 60C/480G     | 160GB |
| 32C/256G   | 80GB    |
| 16C/128G   | 36GB    |
| 8C/64G       | 16GB    |
| 4C/32G      | 8GB      |
| 4C/16G      | 2GB     |
   
#### enable_scale_cache
**参数说明：**ScaleCache通过提高缓冲区页面pin和unpin的本地性和SIMD加速哈希检索，以及copy on write的无锁索引扫描技术来实现缓冲区管理的优化，进而提升整体缓冲区的性能。该参数仅支持在ARM 8及以上平台环境设置。
**参数类型：**布尔型
**参数单位：**无
**取值范围：**
- on：表示开启ScaleCache缓冲区管理模式。
- off：表示关闭ScaleCache缓冲区管理模式。
**默认值：**off
**设置方式：** 该参数属于POSTMASTER类型参数，请参见[表1](https://support.huaweicloud.com/centralized-ref-v10-gaussdb/gaussdb-38-0993.html#ZH-CN_TOPIC_0000002793699379__zh-cn_topic_0283137176_zh-cn_topic_0237121562_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中对应设置方法进行设置。
**设置建议：**推荐使用默认值。
**设置不当的风险与影响：**请在充分理解参数含义，并经过测试验证后进行修改。
#### pin_buffer_group_cores
**参数说明：**ScaleCache功能，在pin和unpin优化时会对CPU核进行分组，该参数表示分组时每组CPU的核数。当enable_scale_cache参数为on时，该参数才允许被设置和修改。该参数仅支持在ARM 8及以上平台环境设置。
**参数类型：**整型
**参数单位：**个
**取值范围：**1 \~ 1073741823
**默认值：**4
**设置方式：** 该参数属于POSTMASTER类型参数，请参见[表1](https://support.huaweicloud.com/centralized-ref-v10-gaussdb/gaussdb-38-0993.html#ZH-CN_TOPIC_0000002793699379__zh-cn_topic_0283137176_zh-cn_topic_0237121562_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中对应设置方法进行设置。
**设置建议：**推荐使用2的幂次方，如果CPU核数或者设置的值非2的幂次方，那么该参数就会被设置为1。
**设置不当的风险与影响：**修改前请确认enable_scale_cache参数已开启。请在充分理解参数含义，并经过测试验证后进行修改。
#### enable_shared_storage_aio
**参数说明：**该功能用来控制打开或关闭Dorado共享存储模式并行异步写日志优化功能。
**参数类型：**布尔型
**参数单位：**无
**取值范围：**
- on：表示开启Dorado共享存储异步写功能。
- off：表示关闭Dorado共享内存异步写功能。
**默认值：**off
**设置方式：** 该参数属于SIGHUP类型参数，请参见[表1](https://support.huaweicloud.com/centralized-ref-v10-gaussdb/gaussdb-38-0993.html#ZH-CN_TOPIC_0000002793699379__zh-cn_topic_0283137176_zh-cn_topic_0237121562_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中对应设置方法进行设置。
**设置建议：**推荐使用默认值。
**设置不当的风险与影响：**请在充分理解参数含义，并经过测试验证后进行修改。
 #### page_version_check
**参数说明：** 基于页面版本信息，进行底层存储故障校验和页面漏置脏校验的功能总开关，page_version_check是一个三级开关。其中，底层存储故障校验功能是检测从底层存储读取的页面是否为正确版本，防止磁盘掉电等故障情况导致的页面版本信息丢失；页面漏置脏校验功能是检测被修改页面是否忘记置脏，它有一个单独开关[page_missing_dirty_check]进行控制。
**参数类型：**枚举类型
**参数单位：**无
**取值范围：**
- off：表示完全关闭底层存储故障校验和页面漏置脏校验的功能开关。
- memory：表示打开纯内存态的页面版本校验功能（即底层存储故障校验和页面漏置脏校验），页面版本信息只缓存在内存当中，重启丢失。
- persistence：表示打开持久态的页面版本校验功能（即底层存储故障校验和页面漏置脏校验），页面版本信息会持久化到文件中，重启不丢失。
**默认值：**persistence（256核CPU/2048GB内存，192核CPU/1536GB内存，128核CPU/1024GB内存，104核CPU/1024GB内存，96核CPU/1024GB内存，96核CPU/768GB内存，80核CPU/640GB内存，64核CPU/512GB内存，60核CPU/480GB内存，32核CPU/256GB内存，16核CPU/128GB内存）；off（8核CPU/64GB内存，4核CPU/16GB内存，4核CPU/32GB内存）
**设置方式：** 该参数属于POSTMASTER类型参数，请参见[表1](https://support.huaweicloud.com/centralized-ref-v10-gaussdb/gaussdb-38-0993.html#ZH-CN_TOPIC_0000002793699379__zh-cn_topic_0283137176_zh-cn_topic_0237121562_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中对应设置方法进行设置。
**设置建议：**根据不同机器规格，建议如下设置：persistence（256核CPU/2048GB内存，192核CPU/1536GB内存，128核CPU/1024GB内存，104核CPU/1024GB内存，96核CPU/1024GB内存，96核CPU/768GB内存，80核CPU/640GB内存，64核CPU/512GB内存，60核CPU/480GB内存，32核CPU/256GB内存，16核CPU/128GB内存）；off（8核CPU/64GB内存，4核CPU/16GB内存，4核CPU/32GB内存）。
**设置不当的风险与影响：**开关设置为memory及persistence时，对性能有一定影响，机器规格越小，影响越大（参考：16核CPU/128GB内存，TPCC模型影响7%左右）。在系统需要频繁重启的场景下，建议设置为persistence，能够确保页面版本信息不丢失，但会进一步影响性能。
#### page_version_full_validation
**参数说明：**在AntiCache持久态下，页面版本在buffer刷脏时即插入AntiCache，这相比在buffer淘汰时才插入的内存态更为频繁，容易因占满AntiCache内存而导致漏校验。为降低漏校验概率、实现100%校验覆盖，需优化持久态的插入方式与Vlog文件回收机制。page_version_full_validation控制是否开启AntiCache全校验模式。开启此参数后，在插入AntiCache时若内存已满，系统将先对一个已有页面执行原地校验以释放空间，再插入新版本。
**参数类型：**布尔型
**参数单位：**无
**取值范围：**
- on：表示开启AntiCache全校验模式。
- off：表示关闭AntiCache全校验模式。
**默认值：**on
**设置方式：** 该参数属于SIGHUP类型参数，请参见[表1](https://support.huaweicloud.com/centralized-ref-v10-gaussdb/gaussdb-38-0993.html#ZH-CN_TOPIC_0000002793699379__zh-cn_topic_0283137176_zh-cn_topic_0237121562_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中对应设置方法进行设置。
**设置建议：**推荐使用默认值。
**设置不当的风险与影响：**请在充分理解参数含义，并经过测试验证后进行修改。
 #### page_missing_dirty_check
**参数说明：** 页面漏置脏校验的功能开关，检测被修改页面是否忘记置脏。page_missing_dirty_check受控于[page_version_check]，如果page_version_check设置为off，则page_missing_dirty_check设置为on时也不生效。
**参数类型：**布尔型
**参数单位：**无
**取值范围：**
- on：表示进行页面漏置脏校验。
- off：表示不进行页面漏置脏校验。
**默认值：**off
**设置方式：** 该参数属于POSTMASTER类型参数，请参见[表1](https://support.huaweicloud.com/centralized-ref-v10-gaussdb/gaussdb-38-0993.html#ZH-CN_TOPIC_0000002793699379__zh-cn_topic_0283137176_zh-cn_topic_0237121562_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中对应设置方法进行设置。
**设置建议：**建议在测试场景中开启此开关，能够最大限度在非生产环境中排查出漏置脏代码BUG；在现网时默认关闭页面漏置脏，避免带来额外开销，进而影响性能。
**设置不当的风险与影响：**请在充分理解参数含义，并经过测试验证后进行修改。
 #### page_version_max_num
**参数说明：** 内存中所能缓存的页面版本信息的最大数量，在[page_version_check]取值不为OFF的情况下生效。每个page_version内存占用36字节，请注意内存使用量。
**参数类型：**整型
**参数单位：**个
**取值范围：**0 \~ 2147483647
- 0：根据[shared_buffers]大小自动计算，page_version_max_num=shared_buffers\*2。例如，32M shared_buffers对应4096个buffer，所以页面版本信息数量设置为8192个。
- 非0：将强制使用手动配置的数值。不允许小于[page_version_partitions]的16倍，如果小于，则会被强制设置为page_version_partitions\*16。
**默认值：**0
**设置方式：** 该参数属于POSTMASTER类型参数，请参见[表1](https://support.huaweicloud.com/centralized-ref-v10-gaussdb/gaussdb-38-0993.html#ZH-CN_TOPIC_0000002793699379__zh-cn_topic_0283137176_zh-cn_topic_0237121562_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中对应设置方法进行设置。
**设置建议：** 内存有限的情况下，合理的数量应该是[shared_buffers]数量的2倍到4倍。对性能有较高要求且内存足够的情况下，建议手动设置为[shared_buffers]数量的4倍以上，且与[page_version_partitions]的比值范围为\[256, 1024\]。
**设置不当的风险与影响：**如果设置的内存参数数值过大，超过物理内存上限，将会出现数据库由于无法申请到足够的内存而无法成功启动的情况。
 #### page_version_partitions
**参数说明：** 内存中缓存页面版本信息的哈希表分区数量，分区数量直接影响哈希查询效率和哈希冲突概率。只在[page_version_check]取值不为OFF的情况下生效。
**参数类型：**整型
**参数单位：**个
**取值范围：**0 \~ 2097152
- 0：根据[page_version_max_num]自动计算，page_version_partitions=page_version_max_num/512。若自动计算结果小于4，则强制设置为4。
- 非0：将强制使用手动配置的数值。最小值为4，如果取值小于4，则会被强制设置为4。
**默认值：**0
**设置方式：** 该参数属于POSTMASTER类型参数，请参见[表1](https://support.huaweicloud.com/centralized-ref-v10-gaussdb/gaussdb-38-0993.html#ZH-CN_TOPIC_0000002793699379__zh-cn_topic_0283137176_zh-cn_topic_0237121562_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中对应设置方法进行设置。
**设置建议：** 对性能有较高要求的情况下，建议手动设置为[page_version_max_num]的256分之一到1024分之一左右。
**设置不当的风险与影响：**如果设置的分区数量太大，会降低哈希查询效率；设置的分区数量太小，会增加哈希冲突的概率。
#### page_version_recycler_thread_num
**参数说明：** 控制回收和校验页面版本信息的线程数量，只在[page_version_check]取值不为OFF的情况下生效。
**参数类型：**整型
**参数单位：**个
**取值范围：**0 \~ 16
- [page_version_check]参数值为memory时：
  - 0：根据[page_version_partitions]自动计算，page_version_recycler_thread_num=page_version_partitions/16384。若自动计算结果大于4，则强制设置为4。
  
  - 非0：将强制使用手动配置的数值。
  
  - 不允许大于[page_version_partitions]，如果大于，则会被强制设置为page_version_partitions的值。
   
- [page_version_check]参数值为persistence时：
  小于2时将设置为2，大于等于2时强制使用手动配置的参数。
  
**默认值：**0
**设置方式：** 该参数属于POSTMASTER类型参数，请参见[表1](https://support.huaweicloud.com/centralized-ref-v10-gaussdb/gaussdb-38-0993.html#ZH-CN_TOPIC_0000002793699379__zh-cn_topic_0283137176_zh-cn_topic_0237121562_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中对应设置方法进行设置。
**设置建议：**推荐使用默认值。
**设置不当的风险与影响：**请在充分理解参数含义，并经过测试验证后进行修改。
#### enable_cached_context
**参数说明：**控制缓存内存上下文的个数。多租场景下，该参数可在PDB级别设置。
**参数类型：**整型
**参数单位：**个
**取值范围：**0 \~ 1024
- 设置为0时内存上下文优化框架不生效。
- 设置为非0值时，内存上下文优化框架生效，设置的值为缓存内存上下文的个数。
**默认值：**128。在PDB场景内，若未设置该参数，则继承来自全局的设置。
**设置方式：** 该参数属于USERSET类型参数，请参见[表1](https://support.huaweicloud.com/centralized-ref-v10-gaussdb/gaussdb-38-0993.html#ZH-CN_TOPIC_0000002793699379__zh-cn_topic_0283137176_zh-cn_topic_0237121562_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中对应设置方法进行设置。
**设置建议：**推荐使用默认值。
**设置不当的风险与影响：**请在充分理解参数含义，并经过测试验证后进行修改。
#### verify_log_buffers
**参数说明：** 控制verifyLog buffer大小，只在[page_version_check]取值为persistence的情况下生效。verifyLog buffer内存按页面管理，每页8kB。
**参数类型：**整型
**参数单位：**页（8kB）
**取值范围：**4 \~ 262144
**默认值：**1GB（256核CPU/2048G内存，192核CPU/1536G内存，128核CPU/1024G内存，104核CPU/1024G内存，96核CPU/1024G内存，96核CPU/768G内存，80核CPU/640G内存，64核CPU/512G内存，60核CPU/480G内存，32核CPU/256G内存）；512MB（16核CPU/128G内存）；256MB（8核CPU/64G内存）；128MB（4核CPU/32G内存）；16MB（4核CPU/16G内存）
**设置方式：** 该参数属于POSTMASTER类型参数，请参见[表1](https://support.huaweicloud.com/centralized-ref-v10-gaussdb/gaussdb-38-0993.html#ZH-CN_TOPIC_0000002793699379__zh-cn_topic_0283137176_zh-cn_topic_0237121562_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中对应设置方法进行设置。例如，取值131072表示verify_log_buffers为131072 \* 8 kB = 1GB；取值131072kB表示verify_log_buffers为131072kB。取值如果带单位，必须为kB、MB、GB，且必须为8kB整数倍。
**设置建议：**根据系统硬件规格，进行相应的设置。
1GB（256核CPU/2048G内存，192核CPU/1536G内存，128核CPU/1024G内存，104核CPU/1024G内存，96核CPU/1024G内存，96核CPU/768G内存，80核CPU/640G内存，64核CPU/512G内存，60核CPU/480G内存，32核CPU/256G内存）；512MB（16核CPU/128G内存）；256MB（8核CPU/64G内存）；128MB（4核CPU/32G内存）；16MB（4核CPU/16G内存）。
**设置不当的风险与影响：**如果设置的内存参数数值过大，超过物理内存上限，将会出现数据库由于无法申请到足够的内存而无法成功启动的情况。
 #### segment_buffers
**参数说明：**设置GaussDB段页式元数据页的内存大小。
**参数类型：**整型
**参数单位：**页（8kB）
**取值范围：**16 \~ 1073741823
**默认值：**
8MB（256核CPU/2048G内存，192核CPU/1536G内存，128核CPU/1024G内存，104核CPU/1024G内存，96核CPU/1024G内存，96核CPU/768G内存，80核CPU/640G内存，64核CPU/512G内存，60核CPU/480G内存，32核CPU/256G内存，16核CPU/128G内存，8核CPU/64G内存，4核CPU/32G内存）；128kB（4核CPU/16G内存）
**设置方式：** 该参数属于POSTMASTER类型参数，请参见[表1](https://support.huaweicloud.com/centralized-ref-v10-gaussdb/gaussdb-38-0993.html#ZH-CN_TOPIC_0000002793699379__zh-cn_topic_0283137176_zh-cn_topic_0237121562_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中对应设置方法进行设置。例如，不带单位取值1024，表示segment_buffers为1024\*8kB，即8192kB；带单位取值8MB，表示segment_buffers为8MB。取值如果要带单位，必须为kB、MB、GB，且取值必须为8kB的整数倍。
**设置建议：** segment_buffers 用来缓存段页式段头的内容，属于关键元数据信息，为了提高性能建议常用的表的段头都能缓存在buffer中，不被置换出去。建议按照表的个数（包括索引和toast表）\* 分区数 \* 3 + 128 来设置。乘以3是因为每个表（分区）会有一些额外的元数据段，一般一个表有3个段。最后+128因为段页式表空间管理需要一定数量的buffer。该参数设置过小会导致首次创建段页式表时耗时较久，因此请按照默认值进行设置，不建议修改，避免设置明显不合理（过大或过小）的segment_buffers值。注意应满足条件：[data_replicate_buffer_size](https://support.huaweicloud.com/centralized-ref-v10-gaussdb/gaussdb-38-1016.html#ZH-CN_TOPIC_0000002793699245__zh-cn_topic_0283137370_zh-cn_topic_0237124713_zh-cn_topic_0059777578_sc3dd3b16705f4fbfb54c665ce00ef966) + segment_buffers + [shared_buffers] + [wal_buffers](https://support.huaweicloud.com/centralized-ref-v10-gaussdb/gaussdb-38-1010.html#ZH-CN_TOPIC_0000002764460124__zh-cn_topic_0283137354_zh-cn_topic_0237124707_zh-cn_topic_0059778393_sce544e842a94430abad77f1ae64406af) + [temp_buffers] + [maintenance_work_mem] + [work_mem] + [query_mem] + (备机)[wal_receiver_buffer_size](https://support.huaweicloud.com/centralized-ref-v10-gaussdb/gaussdb-38-1017.html#ZH-CN_TOPIC_0000002764300592__zh-cn_topic_0283136835_zh-cn_topic_0237124714_zh-cn_topic_0059778071_s1152f5dcb7744fa5ace65b997f92ed03) \< [max_process_memory] \< 物理机内存大小。
**设置不当的风险与影响：**如果设置的内存参数数值过大，超过物理内存上限，将会出现数据库由于无法申请到足够的内存而无法成功启动的情况。
#### bulk_read_ring_size
**参数说明：**执行大批量数据查询操作时（例如大表扫描），该操作使用的环形缓冲区的大小。该参数可在PDB级别设置。
**参数类型：**整型
**参数单位：**kB
**取值范围：**256 \~ 2147483647
**默认值：**16384（即16MB）。在PDB场景内，若未设置该参数，则继承来自全局的设置。
**设置方式：** 该参数属于USERSET类型参数，请参见[表1](https://support.huaweicloud.com/centralized-ref-v10-gaussdb/gaussdb-38-0993.html#ZH-CN_TOPIC_0000002793699379__zh-cn_topic_0283137176_zh-cn_topic_0237121562_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中对应设置方法进行设置。例如，不带单位取值1024，表示bulk_read_ring_size为1024kB；带单位取值1MB，表示bulk_read_ring_size为1MB。取值如果要带单位，必须为kB、MB、GB。
**设置建议** **：**推荐使用默认值。
**设置不当的风险与影响：**请在充分理解参数含义，并经过测试验证后进行修改。
#### bulk_write_ring_size
**参数说明：**执行大批量数据写入操作时（例如copy动作），该操作使用的环形缓冲区的大小。该参数可在PDB级别设置。
**参数类型：**整型
**参数单位：**kB
**取值范围：**16384 \~ 2147483647
**默认值：**2097152（即2GB）。在PDB场景内，若未设置该参数，则继承来自全局的设置。
**设置方式：** 该参数属于USERSET类型参数，请参见[表1](https://support.huaweicloud.com/centralized-ref-v10-gaussdb/gaussdb-38-0993.html#ZH-CN_TOPIC_0000002793699379__zh-cn_topic_0283137176_zh-cn_topic_0237121562_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中对应设置方法进行设置。例如，不带单位取值16384，表示bulk_write_ring_size为16384kB；带单位取值16MB，表示bulk_write_ring_size为16MB。取值如果要带单位，必须为kB、MB、GB。
**设置建议：**建议导入压力大的场景中增加数据库节点中此参数取值。
**设置不当的风险与影响：**请在充分理解参数含义，并经过测试验证后进行修改。
 #### standby_shared_buffers_fraction
**参数说明：** 备实例所在服务器使用[shared_buffers]内存缓冲区大小的比例。
**参数类型：**浮点型
**参数单位：**无
**取值范围：**0.1 \~ 1.0
**默认值：**1
**设置方式：** 该参数属于SIGHUP类型参数，请参见[表1](https://support.huaweicloud.com/centralized-ref-v10-gaussdb/gaussdb-38-0993.html#ZH-CN_TOPIC_0000002793699379__zh-cn_topic_0283137176_zh-cn_topic_0237121562_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中对应设置方法进行设置。
**设置建议：**推荐使用默认值。
**设置不当的风险与影响：**请在充分理解参数含义，并经过测试验证后进行修改。
 #### temp_buffers
**参数说明：**设置每个数据库会话使用的LOCAL临时缓冲区的大小。该参数可在PDB级别设置。
![](https://support.huaweicloud.com/centralized-ref-v10-gaussdb/public_sys-resources/note_3.0-zh-cn.png)
- 在每个会话第一次使用临时表之前可以改变temp_buffers的值，之后的设置将是无效的。
- 一个会话将按照temp_buffers给出的限制，根据需要分配临时缓冲区。如果在一个并不需要大量临时缓冲区的会话里设置一个大的数值，其开销只是一个缓冲区描述符的大小。当缓冲区被使用，就会额外消耗8192字节。
 
**参数类型：**整型
**参数单位：**页（8kB）
**取值范围：**100 \~ 1073741823
**默认值：**128（即1MB）。在PDB场景内，若未设置该参数，则继承来自全局的设置。
**设置方式：** 该参数属于USERSET类型参数，请参见[表1](https://support.huaweicloud.com/centralized-ref-v10-gaussdb/gaussdb-38-0993.html#ZH-CN_TOPIC_0000002793699379__zh-cn_topic_0283137176_zh-cn_topic_0237121562_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中对应设置方法进行设置。例如，不带单位取值100，表示temp_buffers为100\*8kB，即800kB；带单位取值16MB，表示temp_buffers为16MB。取值如果要带单位，必须为kB、MB、GB，且取值必须为8kB的整数倍。
**设置建议：**推荐使用默认值。
**设置不当的风险与影响：**请在充分理解参数含义，并经过测试验证后进行修改。
 #### max_prepared_transactions
**参数说明：**设置可以同时处于"预备"状态的事务的最大数目。增加此参数的值会使GaussDB比系统默认设置需要更多的System V共享内存。
**参数类型：**整型
**参数单位：**无
**取值范围：**0 \~ 262143
**默认值：**
200（256核CPU/2048G内存，192核CPU/1536G内存，128核CPU/1024G内存，104核CPU/1024G内存，96核CPU/1024G内存，96核CPU/768G内存，80核CPU/640G内存，64核CPU/512G内存，60核CPU/480G内存，32核CPU/256G内存，16核CPU/128G内存，8核CPU/64G内存，4核CPU/32G内存）；0（4核CPU/16G内存）
**设置方式：** 该参数属于POSTMASTER类型参数，请参见[表1](https://support.huaweicloud.com/centralized-ref-v10-gaussdb/gaussdb-38-0993.html#ZH-CN_TOPIC_0000002793699379__zh-cn_topic_0283137176_zh-cn_topic_0237121562_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中对应设置方法进行设置。
**设置建议：**一般不需要对事务显式进行PREPARE操作，如果业务有对事务进行显式PREPARE操作，为避免在准备步骤失败，需调大该值，大于需要进行PREPARE业务的并发数。
**设置不当的风险与影响：**当GaussDB部署为主备双机时，在备机上此参数的设置必须要高于或等于主机上的，否则无法在备机上进行查询操作。
 #### work_mem
**参数说明：**设置内部排序操作和Hash表在开始写入临时磁盘文件之前使用的内存大小。ORDER BY，DISTINCT和MERGE JOINS都要用到排序操作。Hash表在散列连接、散列为基础的聚集、散列为基础的IN子查询处理中都要用到。
对于复杂的查询，可能会同时并发运行好几个排序或者散列操作，每个都可以使用此参数所声明的内存量，不足时会使用临时文件。同样的，多个正在运行的会话可能会同时进行排序操作。因此使用的总内存可能是work_mem的好几倍。该参数可在PDB级别设置。
**参数类型：**整型
**参数单位：**kB
**取值范围：**64 \~ 2147483647
**默认值：**
280MB（256核CPU/2048G内存，192核CPU/1536G内存）；256MB（128核CPU/1024G内存，104核CPU/1024G内存，96核CPU/1024G内存，96核CPU/768G内存）；128MB（80核CPU/640G内存，64核CPU/512G内存，60核CPU/480G内存，32核CPU/256G内存，16核CPU/128G内存）；64MB（8核CPU/64G内存）；32MB（4核CPU/32G内存）；16MB（4核CPU/16G内存）
在PDB场景内，若未设置该参数，则继承来自全局的设置。
**设置方式：** 该参数属于USERSET类型参数，请参见[表1](https://support.huaweicloud.com/centralized-ref-v10-gaussdb/gaussdb-38-0993.html#ZH-CN_TOPIC_0000002793699379__zh-cn_topic_0283137176_zh-cn_topic_0237121562_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中对应设置方法进行设置。例如，不带单位取值1024，表示work_mem为1024kB；带单位取值1MB，表示work_mem为1MB。取值如果要带单位，必须为kB、MB、GB。
**设置建议：**
依据查询特点和并发来确定，一旦work_mem限定的物理内存不够，算子运算数据将写入临时表空间，带来5-10倍的性能下降，查询响应时间从秒级下降到分钟级。
- 对于串行无并发的复杂查询场景，平均每个查询有5-10关联操作，建议work_mem=50%内存/10。
- 对于串行无并发的简单查询场景，平均每个查询有2-5个关联操作，建议work_mem=50%内存/5。
- 对于并发场景，建议work_mem=串行下的work_mem/物理并发数。
- 对于BitmapScan的哈希表也会受到work_mem的限制，但不会被严格管控下盘。完全Lossify的情况下，哈希表每占用1MB的内存，对应一次BitmapHeapScan的16GB的页面（Ustore为32GB），达到work_mem上限后，会按此比例随数据访问量线性增长。
**设置不当的风险与影响：**默认值即推荐值，不建议修改。修改必须详细确认参数的规格限制，并考虑硬件资源是否足够，否则可能导致数据库异常。
 #### query_mem
**参数说明：**设置执行作业所使用的内存。该参数可在PDB级别设置。
**参数类型：**整型
**参数单位：**kB
**取值范围：**0 \~ 2147483647
- 如果设置的query_mem值大于32768（即32MB），在生成执行计划时，优化器会将作业的估算内存调整为该值。
- 如果设置值小于32768（即32MB），将强制设置为默认值0，此时优化器不会根据该值调整作业的估算内存。
**默认值：**0。在PDB场景内，若未设置该参数，则继承来自全局的设置。
**设置方式：** 该参数属于USERSET类型参数，请参见[表1](https://support.huaweicloud.com/centralized-ref-v10-gaussdb/gaussdb-38-0993.html#ZH-CN_TOPIC_0000002793699379__zh-cn_topic_0283137176_zh-cn_topic_0237121562_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中对应设置方法进行设置。例如，不带单位取值32768，表示query_mem为32768kB；带单位取值32MB，表示query_mem为32MB。取值如果要带单位，必须为kB、MB、GB。
**设置建议：**推荐使用默认值。
**设置不当的风险与影响：**请在充分理解参数含义，并经过测试验证后进行修改。
#### query_max_mem
**参数说明：**设置执行作业所能够使用的最大内存。该参数可在PDB级别设置。
**参数类型：**整型
**参数单位：**kB
**取值范围：**0 \~ 2147483647
- 如果设置的query_max_mem值大于32768（即32MB），当作业执行时所使用内存超过该值时，将报错退出。
- 如果设置值小于32768（即32M），将设置为默认值0，此时不会根据该值限制作业的内存使用。
**默认值：**0。在PDB场景内，若未设置该参数，则继承来自全局的设置。
**设置方式：** 该参数属于USERSET类型参数，请参见[表1](https://support.huaweicloud.com/centralized-ref-v10-gaussdb/gaussdb-38-0993.html#ZH-CN_TOPIC_0000002793699379__zh-cn_topic_0283137176_zh-cn_topic_0237121562_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中对应设置方法进行设置。例如，不带单位取值32768，表示query_max_mem为32768kB；带单位取值32MB，表示query_max_mem为32MB。取值如果要带单位，必须为kB、MB、GB。
**设置建议：**推荐使用默认值。
**设置不当的风险与影响：**请在充分理解参数含义，并经过测试验证后进行修改。
 #### maintenance_work_mem
**参数说明：**设置在维护性操作（比如VACUUM、CREATE INDEX、ALTER TABLE ADD FOREIGN KEY等）中可使用的最大的内存。该参数的设置会影响VACUUM、VACUUM FULL、CLUSTER、CREATE INDEX的执行效率。
**参数类型：**整型
**参数单位：**kB
**取值范围：**1024 \~ 2147483647
**默认值：**
2GB（256核CPU/2048G内存，192核CPU/1536G内存，128核CPU/1024G内存，104核CPU/1024G内存，96核CPU/1024G内存，96核CPU/768G内存，80核CPU/640G内存，64核CPU/512G内存，60核CPU/480G内存）；1GB（32核CPU/256G内存）；512MB（16核CPU/128G内存）；256MB（8核CPU/64G内存）；128MB（4核CPU/32G内存）；64MB（4核CPU/16G内存）
**设置方式：** 该参数属于USERSET类型参数，请参见[表1](https://support.huaweicloud.com/centralized-ref-v10-gaussdb/gaussdb-38-0993.html#ZH-CN_TOPIC_0000002793699379__zh-cn_topic_0283137176_zh-cn_topic_0237121562_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中对应设置方法进行设置。例如，不带单位取值1024，表示maintenance_work_mem为1024kB；带单位取值1MB，表示maintenance_work_mem为1MB。取值如果要带单位，必须为kB、MB、GB。
**设置建议：**
- 建议设置此参数的值大于[work_mem]，可以改进清理和恢复数据库转储的速度。因为在一个数据库会话里，任意时刻只有一个维护性操作可以执行，并且在执行维护性操作时不会有太多的会话。
- 当[自动清理](https://support.huaweicloud.com/centralized-ref-v10-gaussdb/gaussdb-38-1035.html)线程运行时，[autovacuum_max_workers](https://support.huaweicloud.com/centralized-ref-v10-gaussdb/gaussdb-38-1035.html#ZH-CN_TOPIC_0000002793699351__zh-cn_topic_0283137694_zh-cn_topic_0237124730_zh-cn_topic_0059778244_s76932f79410248ba8923017d19982673)倍数的内存将会被分配，所以此时设置maintenance_work_mem的值应该不小于[work_mem]。
- 如果进行大数据量的cluster等，可以在session中调大该值。
- 请按照默认值进行设置，不建议修改，避免设置明显不合理（过大或过小）的maintenance_work_mem值。注意应满足条件：[data_replicate_buffer_size](https://support.huaweicloud.com/centralized-ref-v10-gaussdb/gaussdb-38-1016.html#ZH-CN_TOPIC_0000002793699245__zh-cn_topic_0283137370_zh-cn_topic_0237124713_zh-cn_topic_0059777578_sc3dd3b16705f4fbfb54c665ce00ef966) + [segment_buffers] + [shared_buffers] + [wal_buffers](https://support.huaweicloud.com/centralized-ref-v10-gaussdb/gaussdb-38-1010.html#ZH-CN_TOPIC_0000002764460124__zh-cn_topic_0283137354_zh-cn_topic_0237124707_zh-cn_topic_0059778393_sce544e842a94430abad77f1ae64406af) + [temp_buffers] + [maintenance_work_mem] + [work_mem] + [query_mem] + （备机）[wal_receiver_buffer_size](https://support.huaweicloud.com/centralized-ref-v10-gaussdb/gaussdb-38-1017.html#ZH-CN_TOPIC_0000002764300592__zh-cn_topic_0283136835_zh-cn_topic_0237124714_zh-cn_topic_0059778071_s1152f5dcb7744fa5ace65b997f92ed03) \< [max_process_memory] \< 物理机内存大小。
- 在创建向量数据库索引时，maintenance_work_mem的取值一定要大于向量索引构建时对数据进行采样所需的内存。对于GsIVFFlat索引，采样所需内存估算为Max(ivf_nlist, ivf_nlist2）\* dim \* 0.2kB。对于GsDiskanANN索引，开启PQ时，采样所需内存为dim \* 80kB。如果该参数设置过小，会导致索引无法正常创建。
**设置不当的风险与影响：**默认值即推荐值，不建议修改。修改必须详细确认参数的规格限制，并考虑硬件资源是否足够，否则可能导致数据库异常。
#### max_stack_depth
**参数说明：**设置GaussDB执行堆栈的最大安全深度。之所以需要这个安全界限，是因为在服务器里，并非所有程序都检查了堆栈深度，而是只在可能递归的过程，比如表达式计算之类的过程中才进行检查。该参数可在PDB级别设置。
**参数类型：**整型
**参数单位：**kB
**取值范围：**100 \~ 2147483647
**默认值：**
- 系统线程栈大小 - 640kB的值大于等于2MB时，此参数的默认值为2MB。
- 系统线程栈大小 - 640kB的值小于2MB时，此参数的默认值为系统线程栈大小 - 640kB。
- 在PDB场景内，若未设置该参数，则继承来自全局的设置。
![](https://support.huaweicloud.com/centralized-ref-v10-gaussdb/public_sys-resources/notice_3.0-zh-cn.png)
- 系统线程栈大小可通过"ulimit -s"命令查看。
- 修改系统线程栈大小后，需重启数据库，数据库进程才会采用新的系统线程栈大小。数据库进程在启动时从父进程继承该限制，运行期间不会重新读取。
 
**设置方式：** 该参数属于SUSET类型参数，请参见[表1](https://support.huaweicloud.com/centralized-ref-v10-gaussdb/gaussdb-38-0993.html#ZH-CN_TOPIC_0000002793699379__zh-cn_topic_0283137176_zh-cn_topic_0237121562_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中对应设置方法进行设置。例如，不带单位取值1024，表示max_stack_depth为1024kB；带单位取值1MB，表示max_stack_depth为1MB。取值如果要带单位，必须为kB、MB、GB。
**设置建议：**
- 数据库需要预留640KB堆栈深度，因此，此参数的最佳设置是等于系统线程栈大小 - 640kB。
- 不支持设置该参数值大于系统线程栈大小 - 640kB，通过gs_guc工具设置该参数值大于系统线程栈大小 - 640kB时，会设置失败。
- 因为并非所有的操作都能够被检测到，所以建议用户在此设置一个明确的值。
- 默认值最大为2MB，这个值相对比较小，不容易导致系统崩溃。
**设置不当的风险与影响：**
- 系统线程栈大小 -640kB小于此参数取值范围的最小值时，会导致数据库启动失败。
- 如果设置此参数的值大于实际的内核限制，则一个正在运行的递归函数可能会导致一个独立的服务器进程崩溃。
 
#### enable_early_free
**参数说明** **：**控制是否可以进行算子内存的提前释放。该参数可在PDB级别设置。
**参数类型：**布尔型
**参数单位：**无
**取值范围** **：**
- on：表示支持算子内存提前释放。
- off：表示不支持算子内存提前释放。
**默认值** **：**on。在PDB场景内，若未设置该参数，则继承来自全局的设置。
**设置方式：** 该参数属于USERSET类型参数，请参见[表1](https://support.huaweicloud.com/centralized-ref-v10-gaussdb/gaussdb-38-0993.html#ZH-CN_TOPIC_0000002793699379__zh-cn_topic_0283137176_zh-cn_topic_0237121562_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中对应设置方法进行设置。
**设置建议：**推荐使用默认值。
**设置不当的风险与影响：**请在充分理解参数含义，并经过测试验证后进行修改。
 #### memory_trace_level
**参数说明** **：** 动态内存使用超过最大动态内存的指定百分比阈值（默认是90%，可在[memory_log_config]参数中更改）后，记录内存申请信息的管控等级。该参数仅在GUC参数[use_workload_manager](https://support.huaweicloud.com/centralized-ref-v10-gaussdb/gaussdb-38-1034.html#ZH-CN_TOPIC_0000002764300298__zh-cn_topic_0283137479_zh-cn_topic_0237124729_zh-cn_topic_0059777791_s9608d330c6a14d2cbd6ae75493437820)和[enable_memory_limit]打开时生效。
**参数类型：**枚举类型
**参数单位：**无
**取值范围** **：**
- none：表示不记录内存申请信息。
- level1：动态内存使用超过最大动态内存的指定百分比阈值后，会记录以下信息，并将记录的内存信息保存在$GAUSSLOG/mem_log目录下。
  - 全局内存概况。
  
  - instance，session，thread三种类型的所有内存上下文中内存占用前20的内存上下文的内存使用情况。
  
  - 每个内存上下文的totalsize、freesize字段。
   
- level2：动态内存使用超过最大动态内存的指定百分比阈值后，会记录以下信息，并将记录的内存信息保存在$GAUSSLOG/mem_log目录下。
  - 全局内存概况。
  
  - instance，session，thread三种类型的所有内存上下文中内存占用前20的内存上下文的内存使用情况。
  
  - 每个内存上下文的totalsize，freesize字段。
  
  - 每个内存上下文上所有内存申请的详细信息，包含申请内存所在的文件，行号和大小。
   
**默认值** **：**level1
**设置方式：** 该参数属于SIGHUP类型参数，请参见[表1](https://support.huaweicloud.com/centralized-ref-v10-gaussdb/gaussdb-38-0993.html#ZH-CN_TOPIC_0000002793699379__zh-cn_topic_0283137176_zh-cn_topic_0237121562_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中对应设置方法进行设置。
**设置建议：**该参数设置为level2后，会记录每个内存上下文的内存申请详情（file，line，size字段），会对性能影响较大，需慎重设置。
**设置不当的风险与影响：**请在充分理解参数含义，并经过测试验证后进行修改。
![](https://support.huaweicloud.com/centralized-ref-v10-gaussdb/public_sys-resources/note_3.0-zh-cn.png)
- 记录的内存快照信息可以通过系统函数gs_get_history_memory_detail(cstring)查询，函数详情请参见[gs_get_history_memory_detail(cstring)](https://support.huaweicloud.com/centralized-ref-v10-gaussdb/gaussdb-38-0085.html#ZH-CN_TOPIC_0000002793698871__li560091174214)。
- 记录的内存上下文是经过将同一类型所有重名的内存上下文进行汇总之后得到的。
 
 #### memory_log_config
**参数说明** **：** 在动态内存使用百分比超过阈值，或动态内存波动百分比超过阈值，或达到统计周期时，记录每个类型的top n个内存上下文内存信息、内存使用top n个SQL语句的内存信息，并生成内存日志。该参数仅在GUC参数[use_workload_manager](https://support.huaweicloud.com/centralized-ref-v10-gaussdb/gaussdb-38-1034.html#ZH-CN_TOPIC_0000002764300298__zh-cn_topic_0283137479_zh-cn_topic_0237124729_zh-cn_topic_0059777791_s9608d330c6a14d2cbd6ae75493437820)和[enable_memory_limit]打开、[memory_trace_level]非none时生效。
**参数类型：**字符串
**参数单位：**无
**取值范围** **：**
该参数分为5个部分：'memory_log_threshold, memory_rush_percent, memory_log_period, topn_memory_contexts, topn_queries'，这5个部分的具体含义如下：
- memory_log_threshold：动态内存使用量百分比阈值，取值范围为\[0,100\]（含0含100）内的整数，取值为0表示关闭此场景触发功能，单位：%。
- memory_rush_percent：动态内存波动百分比阈值，取值范围为\[0,100\]内的整数，取值为0表示关闭此场景触发功能，单位：%。
- memory_log_period：统计周期，取值范围为\[0,INT_MAX)（含0不含INT_MAX；INT_MAX为数据类型INT的最大值2147483647，下同）的整数，取值为0表示关闭此场景触发功能，单位：分钟。

- topn_memory_contexts：每个类型的内存上下文记录前topn_memory_contexts个内存上下文的信息，取值范围为\[0,INT_MAX)（含0不含INT_MAX）的整数，取值为0表示关闭此场景触发功能。
- topn_queries：记录内存使用前topn_queries个SQL语句的内存信息，取值范围为\[0,INT_MAX)的整数，取值为0表示关闭此场景触发功能。
**默认值** **：'**90,0,0,20,10'，这表示内存使用量百分比阈值为90%，关闭内存波动百分比场景触发功能，关闭达到统计周期场景触发功能，每个类型的内存上下文记录top 20个，SQL语句记录top 10个。
**设置方式：** 该参数属于SIGHUP类型参数，请参见[表1](https://support.huaweicloud.com/centralized-ref-v10-gaussdb/gaussdb-38-0993.html#ZH-CN_TOPIC_0000002793699379__zh-cn_topic_0283137176_zh-cn_topic_0237121562_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中对应设置方法进行设置。
**设置建议：**根据参数含义合理设置。
**设置不当的风险与影响：**参数的每个部分需要用英文逗号","分隔，因此参数中必须仅有4个英文逗号，将参数分为5个部分，每个部分需要按照上述取值范围中各部分的要求填写，任何不符合要求的情况都会导致此次设置操作失败，所有参数部分均无法生效。请在充分理解参数含义，并经过测试验证后进行修改。
#### resilience_memory_reject_percent
**参数说明** **：** 用于控制内存过载逃生功能的动态内存占用百分比。该参数仅在GUC参数[use_workload_manager](https://support.huaweicloud.com/centralized-ref-v10-gaussdb/gaussdb-38-1034.html#ZH-CN_TOPIC_0000002764300298__zh-cn_topic_0283137479_zh-cn_topic_0237124729_zh-cn_topic_0059777791_s9608d330c6a14d2cbd6ae75493437820)和[enable_memory_limit]打开时生效。
**参数类型：**字符串
**参数单位：**无
**取值范围** **：**长度大于0的字符串。
该参数分为recover_memory_percent、overload_memory_percent两部分，这2个部分的具体含义如下：
- recover_memory_percent：内存从过载状态恢复到正常状态的动态内存使用占最大动态内存的百分比，当动态内存使用小于最大动态内存乘以该值对应的百分比后，停止过载逃生并放开新连接接入，取值为0 \~ 100，设置为多少表示百分之多少。
- overload_memory_percent：内存过载时动态内存使用占最大动态内存的百分比，当动态内存使用大于最大动态内存乘以该值对应的百分比后，表示当前内存已经过载，触发过载逃生kill会话并禁止新连接接入，取值为0 \~ 100，设置为多少表示百分之多少。
**默认值** **：**"0,0"，表示关闭内存过载逃生功能。
**设置方式：** 该参数属于SIGHUP类型参数，请参见[表1](https://support.huaweicloud.com/centralized-ref-v10-gaussdb/gaussdb-38-0993.html#ZH-CN_TOPIC_0000002793699379__zh-cn_topic_0283137176_zh-cn_topic_0237121562_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中对应设置方法进行设置。
例如，如下命令表示内存使用超过最大内存上限的90%后禁止新连接接入并kill堆积的会话，kill会话过程中内存恢复到最大内存的70%以下时停止kill会话并允许新连接接入。
kill策略为：优先kill空闲会话；按照会话占用的内存从大到小进行排序，依次kill正在执行的会话。
```
gs_guc reload -Z datanode -N all -I all -c "resilience_memory_reject_percent='70,90'"
```
**设置建议：**建议根据实际业务需要进行调整。
**设置不当的风险与影响：**如果该参数设置的百分比过小，则会频繁触发内存过载逃生流程，会使正在执行的会话被强制退出，新连接短时间接入失败，需要根据实际内存使用情况慎重设置。
![](https://support.huaweicloud.com/centralized-ref-v10-gaussdb/public_sys-resources/note_3.0-zh-cn.png)
- 最大动态内存和已使用的动态内存可以通过gs_total_memory_detail视图查询获得，最大动态内存：max_dynamic_memory，已使用的动态内存：dynamic_used_memory。
- recover_memory_percent和overload_memory_percent的值可以同时为0，除此之外，recover_memory_percent的值必须要小于overload_memory_percent，否则设置不会生效。
- 将参数从其它值动态设为"0,0"后，若此时已启动会话查杀，不会终止查杀动作，可等待10s以上再连接数据库防止新连接被查杀。
 
#### resilience_escape_user_permissions
**参数说明** **：**设置用户权限，以逗号分隔，可以设置多个，设置多个则表示多个特殊权限的用户都支持逃生能力，只设置一个则只针对一个特权用户进行逃生。sysadmin控制sysadmin用户的作业是否会被该逃生功能进行cancel处理；monadmin控制monadmin用户的作业是否会被该逃生功能进行cancel处理；默认为空，表示关闭sysadmin和monadmin用户的逃生能力。当前取值仅支持sysadmin，monadmin或者空字符串。
**参数类型：**字符串
**参数单位：**无
**取值范围** **：**长度大于0的字符串。
该参数目前只支持三个取值：sysadmin，monadmin或""，这几个值的具体含义如下：
- sysadmin：控制sysadmin用户的作业是否会被该逃生功能进行cancel处理。
- monadmin：控制monadmin用户的作业是否会被该逃生功能进行cancel处理。
- ""：关闭sysadmin和monadmin用户的逃生能力。
 
**默认值** **：**""，表示关闭sysadmin和monadmin用户的逃生能力。
**设置方式：** 该参数属于SIGHUP类型参数，请参见[表1](https://support.huaweicloud.com/centralized-ref-v10-gaussdb/gaussdb-38-0993.html#ZH-CN_TOPIC_0000002793699379__zh-cn_topic_0283137176_zh-cn_topic_0237121562_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中对应设置方法进行设置。该参数可以同时设置多个值，以逗号分隔，例如resilience_escape_user_permissions = 'sysadmin,monadmin'，也可以只设置一个值，例如resilience_escape_user_permissions = 'monadmin'。
例如，如下命令表示同时开启sysadmin和monadmin用户的逃生功能。
```
gs_guc reload -Z datanode -N all -I all -c "resilience_escape_user_permissions='sysadmin,monadmin'"
```
**设置建议：**推荐使用默认值。
**设置不当的风险与影响：**请在充分理解参数含义，并经过测试验证后进行修改。
![](https://support.huaweicloud.com/centralized-ref-v10-gaussdb/public_sys-resources/note_3.0-zh-cn.png)
- 若该参数多次设置，以最新的设置生效。
- 该参数设置为取值范围中的任意值，普通用户都支持该逃生功能。
- 当用户同时具有sysadmin和monadmin时，resilience_escape_user_permissions必须设置为"sysadmin,monadmin"才能触发该用户的逃生功能。
 
#### local_plsqlcache_threshold
**参数说明：** 单个session中存储过程及存储过程内plancache的占用内存的最大值。当实际系统缓存大小超过该阈值时，会触发内存释放，参数值为0时表示功能不生效。如果[max_execute_functions](https://support.huaweicloud.com/centralized-ref-v10-gaussdb/gaussdb-38-1076.html#ZH-CN_TOPIC_0000002793698803__section56551625301)参数生效，即使占用缓存未达到参数local_plsqlcache_threshold设置的值，存储过程内存仍旧会因为[max_execute_functions](https://support.huaweicloud.com/centralized-ref-v10-gaussdb/gaussdb-38-1076.html#ZH-CN_TOPIC_0000002793698803__section56551625301)参数而释放。在local_plsqlcache_threshold参数开启时，建议将[max_execute_functions](https://support.huaweicloud.com/centralized-ref-v10-gaussdb/gaussdb-38-1076.html#ZH-CN_TOPIC_0000002793698803__section56551625301)参数设置为一个较大值，避免相互干扰。如果local_plsqlcache_threshold和[max_execute_functions](https://support.huaweicloud.com/centralized-ref-v10-gaussdb/gaussdb-38-1076.html#ZH-CN_TOPIC_0000002793698803__section56551625301)都设置为较小值，同时控制内存大小和执行产物个数，可能两者都无法达到限制的上限值。该参数仅在[enable_global_plsqlcache](https://support.huaweicloud.com/centralized-ref-v10-gaussdb/gaussdb-38-1076.html#ZH-CN_TOPIC_0000002793698803__section20725111412350)开启时生效。
**参数类型：**整型
**参数单位：**Byte
**取值范围** **：**0 \~ 9223372036854775807
**默认值：**0
**设置方式：** 该参数属于USERSET类型参数，请参见[表1](https://support.huaweicloud.com/centralized-ref-v10-gaussdb/gaussdb-38-0993.html#ZH-CN_TOPIC_0000002793699379__zh-cn_topic_0283137176_zh-cn_topic_0237121562_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中对应设置方法进行设置。
**设置建议：**推荐设置值为max_process_memory \* sess_plsql_mem_percent / count_peak_conn。其中max_process_memory为gaussdb实例占用最大内存，sess_plsql_mem_percent为预留给会话存储过程的内存占比，count_peak_conn为峰值连接数。
**设置不当的风险与影响：** 如果设置的值过小，会导致内存频繁释放，影响性能。开启[enable_global_plancache](https://support.huaweicloud.com/centralized-ref-v10-gaussdb/gaussdb-38-1024.html#ZH-CN_TOPIC_0000002764460646__zh-cn_topic_0283137548_section1062361853620)时不建议使用。
#### start_with_max_mem
**参数说明：**对于数据量较大的start with查询语句，可能会由于递归深度过大导致占用内存过大，该参数用于控制start with算子占用的最大内存大小。该参数可在PDB级别设置。
**参数类型：**整型
**参数单位：**kB
**取值范围：**-1 \~ 2147483647
**默认值：**-1，表示start with算子占用内存无限制。
**设置方式：** 该参数属于USERSET类型参数，请参见[表1](https://support.huaweicloud.com/centralized-ref-v10-gaussdb/gaussdb-38-0993.html#ZH-CN_TOPIC_0000002793699379__zh-cn_topic_0283137176_zh-cn_topic_0237121562_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中对应设置方法进行设置。例如，不带单位取值1024，表示start_with_max_mem为1024kB；带单位取值1MB，表示start_with_max_mem为1MB。取值如果要带单位，必须为kB、MB、GB。
**设置建议：** 依据查询数据量来确定，默认-1，如果查询数据量较大，可能导致出现内存占用过大的问题。可按需调整该参数，避免单个查询占用内存过大，具体可参考[work_mem]设置。
**设置不当的风险与影响：**如果start_with_max_mem设置非默认值，或设置的值过小，会导致查询语句执行失败。
