# NVMe
#### nvme_cache_seg_num
**参数说明：**该参数用于控制NVMe缓存是否开启，若开启，缓存的大小是多少。
**参数类型** **：**整型
**参数单位** **：**GB
**取值范围** **：**0 \~ 2048
- 0：表示NVMe缓存关闭。
- 1 \~ 2048：表示NVMe缓存开启并设置其大小为对应的数值。
**默认值** **：**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)中对应设置方法进行设置。
**设置建议：**若不需要开启NVMe缓存，推荐使用默认值，关闭NVMe缓存；若需要开启NVMe缓存，则根据实际NVMe磁盘的大小设置合适的值。
**设置不当的风险与影响：**请按需选择是否需要开启NVMe缓存，并按需设置其大小。
![](https://support.huaweicloud.com/centralized-ref-v10-gaussdb/public_sys-resources/note_3.0-zh-cn.png)
NVMe缓存不支持段页式。由于NVMe缓存和段页式特性存在冲突，不能同时开启，否则数据库将无法正常使用。
#### local_storage_directory
**参数说明：**该参数用来控制NVMe缓存的存储位置。
**参数类型** **：**字符串
**参数单位** **：**无
**取值范围** **：**合理的存储路径，需要有读写权限，否则会报错。
**默认值** **：**"."（即会在当前数据库实例数据目录根路径下创建gs_nvme_cache文件夹）
**设置方式** **：** 该参数属于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)中对应设置方法进行设置。
**设置建议：**推荐使用默认值。
**设置不当的风险与影响：**请避免使用包含特殊字符的路径，否则会导致数据库无法启动。
#### nvme_cache_sub_heat_range
**参数说明：**该参数用来控制NVMe缓存页面淘汰的时间间隔。
**参数类型** **：**整型
**参数单位** **：**s（秒）
**取值范围** **：**1 \~ 2147483647
**默认值** **：**30
**设置方式** **：** 该参数属于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_nvme_cache_immediately_after_read
**参数说明：**该参数用来控制是否需要在evs读取后立即缓存到NVMe上。
**参数类型** **：**布尔型
**参数单位** **：**无
**取值范围** **：**
- on：表示在读取后立即启用NVMe缓存。
- off：表示在读取后不立即启用NVMe缓存。
**默认值** **：**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)中对应设置方法进行设置。
**设置建议：**推荐使用默认值。
**设置不当的风险与影响：**请在充分理解参数含义，并经过测试验证后进行修改，避免出现意料之外的结果。
#### nvme_io_capacity
**参数说明：**该参数用来控制使用NVMe缓存时每秒批量刷新脏页的I/O上限。
**参数类型** **：**整型
**参数单位** **：**kB
**取值范围** **：**512000（500MB） \~ 10485760（10GB）
**默认值** **：**2097152（2GB）
**设置方式** **：** 该参数属于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)中对应设置方法进行设置。
**设置建议：**推荐使用默认值。
**设置不当的风险与影响：**请在充分理解参数含义，并经过测试验证后进行修改，避免出现意料之外的结果。
#### nvme_victim_strategy
**参数说明：**该参数用来控制使用NVMe缓存时启用哪种页面淘汰策略。
**参数类型** **：**枚举类型
**参数单位** **：**无
**取值范围** **：**
- dirty：当页面在共享内存中并且是脏页时淘汰页面。
- memory：当页面在共享内存中时淘汰页面。
- flushed：当页面刷新到硬盘时淘汰页面。
**默认值** **：**dirty
**设置方式** **：** 该参数属于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)中对应设置方法进行设置。
**设置建议：**推荐使用默认值。
**设置不当的风险与影响：**请在充分理解参数含义，并经过测试验证后进行修改，避免出现意料之外的结果。
#### nvme_cache_thread_num
**参数说明：**该参数用来控制NVMe缓存刷脏线程的个数。
**参数类型** **：**整型
**参数单位** **：**无
**取值范围** **：**1 \~ 16
**默认值** **：**5
**设置方式** **：** 该参数属于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_vldb_flow_control
**参数说明：**该参数用于控制是否开启智能刷脏算法。
**参数类型** **：**布尔型
**参数单位** **：**无
**取值范围** **：**
- 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)中对应设置方法进行设置。
**设置建议：**推荐使用默认值。
**设置不当的风险与影响：**请在充分理解参数含义，并经过测试验证后进行修改，避免出现意料之外的结果。
#### adapt_period
**参数说明：**该参数用来控制智能刷脏算法的调整间隔。
**参数类型** **：**整型
**参数单位** **：**us（微秒）
**取值范围** **：**1 \~ 2147483647
**默认值** **：**1000000（即1s）
**设置方式** **：** 该参数属于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)中对应设置方法进行设置。
**设置建议：**推荐使用默认值。
**设置不当的风险与影响：**请在充分理解参数含义，并经过测试验证后进行修改，避免出现意料之外的结果。
#### max_iops_speed
**参数说明：**该参数用来控制当前每秒最大I/O访问次数，用于反压算法中休眠时长的计算。
**参数类型** **：**整型
**参数单位** **：**无
**取值范围** **：**1 \~ 2147483647
**默认值** **：**100000
**设置方式** **：** 该参数属于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)中对应设置方法进行设置。
**设置建议：**推荐使用默认值。
**设置不当的风险与影响：**请在充分理解参数含义，并经过测试验证后进行修改，避免出现意料之外的结果。
#### nvme_cache_pagetype
**参数说明：**该参数用来控制哪些页面会经过磁盘缓存。
**参数类型** **：**枚举类型
**参数单位** **：**无
**取值范围** **：**
- all：所有类型页面都可以走磁盘缓存。
- turbo_compress：仅turbo压缩页面可以走磁盘缓存。
**默认值** **：**all
**设置方式** **：** 该参数属于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)中对应设置方法进行设置。
**设置建议：**没有nvme磁盘，且使用了跨页压缩的场景建议设置为turbo_compress，其他场景使用默认值。
**设置不当的风险与影响：**请在充分理解参数含义，并经过测试验证后进行修改，避免出现意料之外的结果。
#### enable_spdk_function
**参数说明：**该参数控制是否通过SPDK逻辑对NVMe缓存进行读写。
**参数类型** **：**布尔型
**参数单位** **：**无
**取值范围** **：**
- on：表示启动SPDK读写NVMe缓存。
- off：表示关闭SPDK读写NVMe缓存。
**默认值** **：**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)中对应设置方法进行设置。
**设置建议：**在大容量场景且配置NVMe缓存盘作为缓存时，建议开启该参数，并结合spdk_nvme_pcie_addr参数的设备号一起使用。
**设置不当的风险与影响：**请在充分理解参数含义，并经过测试验证后进行修改，避免出现意料之外的结果。
#### spdk_poller_thread_num
**参数说明：**该参数控制NVMe缓存SPDK执行回调处理的线程个数。
**参数类型** **：**整型
**参数单位** **：**无
**取值范围** **：**1 \~ 8
**默认值** **：**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)中对应设置方法进行设置。
**设置建议：**推荐使用默认值。
**设置不当的风险与影响：**请在充分理解参数含义，并经过测试验证后进行修改，避免出现意料之外的结果。
#### spdk_nvme_pcie_addr
**参数说明：**该参数指定SPDK绑定的NVMe存储盘的设备号。
**参数类型** **：**字符串
**参数单位** **：**无
**取值范围** **：**合法的设备号，否则绑定会失败，例如：0000:84:00.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)中对应设置方法进行设置。
**设置建议：**通过命令查询NVMe盘的PCI设备号。
**设置不当的风险与影响：**必须确保目标设备存在且NVMe盘未挂载任何文件系统，并确保文件系统被破坏掉，否则将导致数据库启动失败。
