You need to enable JavaScript to run this app.
导航
云搜索服务
  • 文档首页
    • /云搜索服务/用户指南/实例管理/参数管理/查看系统参数
查看系统参数
最近更新时间：2025.07.17 20:50:58首次发布时间：2024.07.08 15:08:45
复制全文
我的收藏
有用
有用
无用
无用

本文介绍不同版本实例支持的系统参数。

功能入口

  1. 登录云搜索服务控制台。
  2. 在顶部导航栏，选择目标项目和地域。
  3. 在实例列表 v2页面，单击目标实例名称，进入实例详情页。
  4. 在左侧导航栏选择实例管理 > 参数管理，然后查看系统参数。

Opensearch 2.9.0 参数

类别

参数名

说明

索引管理

ActionAutoCreateIndex

是否自动创建索引。默认值为 true，取值说明如下：

  • true：自动创建索引。
  • false：不自动创建索引。

ActionDestructiveRequiresName

删除索引是否需要声明完整索引名。默认值为 false，取值说明如下：

  • true：需要声明完整索引名。
  • false：不需要声明完整索引名。

ActionIndicesCloseEnable

是否支持关闭索引。默认值为 true，取值说明如下：

  • true：支持关闭索引。
  • false：不支持关闭索引。

集群管理

ClusterPublishTimeout

集群发布状态超时时间，取值是正整数，单位秒，默认值为 30s。
这是专家级配置，请谨慎设置。

FollowerFaultDetectionTimeout

数据节点心跳超时时间，取值是正整数，单位秒，默认值为 30s。
这是专家级配置，请谨慎设置。

FollowerLagTimeout

节点接受元数据时，可容忍不被剔除的最大时间，取值是正整数，单位秒，默认值为 90s。
这是专家级配置，请谨慎设置。

LeaderFaultDetectionTimeout

主节点心跳超时时间，取值为正整数，单位秒，默认值为 30s。
这是专家级配置，请谨慎设置。

跨域访问

HttpCorsAllowCredentials

跨域访问是否返回头部的 Access-Control-Allow-Credentials。默认值为 false，取值说明如下：

  • true：返回头部的 Access-Control-Allow-Credentials。
  • false：不返回头部的 Access-Control-Allow-Credentials。

HttpCorsAllowHeaders

跨域访问允许的 Headers，用英文逗号分开。默认值：X-Requested-With, Content-Type, Content-Length。

HttpCorsAllowMethods

跨域访问允许的 http 方法，用英文逗号分开。默认值：OPTIONS, HEAD, GET, POST, PUT, DELETE。

HttpCorsAllowOrigin

跨域访问允许的源地址，配置格式为 http://host:port。支持正则表达式。

HttpCorsEnabled

是否允许跨域访问。默认值为 false，取值说明如下：

  • true：允许跨域访问。
  • false：不允许跨域访问。

HttpCorsMaxAge

浏览器 preflight 请求的返回结果的默认缓存时间，可配置的范围为 [1, 1728000]，单位为秒。
默认值为 1728000（20 天）。

HTTP

HttpMaxContentLength

HTTP 请求体最大限制，取值为正整数，单位为 mb。
默认值为 100mb。

HttpMaxHeaderSize

HTTP 请求头最大限制，取值为正整数，单位为 kb。
默认值为 8kb。

HttpMaxInitialLineLength

HTTP 请求行最大限制，取值为正整数，单位为 kb。
默认值为 4kb。

缓存

IndicesFielddataCacheSize

字段数据在 Java 堆空间的缓存占比，取值范围为 [1%, 100%]，默认值为 100%。

IndicesQueriesCacheSize

查询阶段的缓存大小。取值可以是百分比，也可以是具体值，取值范围为
[512mb, 2048mb] 或 [5%, 20%]。
默认值为 10%。

IndicesRequestsCacheSize

请求响应结果在 Java 堆空间的缓存占比，取值范围为 [1%, 100%]，默认值为 1%。

查询

IndicesQueryBoolMaxClauseCount

Lucene BooleanQuery 可以包含的最大子句数，取值范围为 [16, 100000]，默认值为 1024。

SearchAllowExpensiveQueries

是否允许高资源消耗类的查询，包括脚本查询、Join 查询、正则查询、通配查询、模糊查询等。默认值为 true，取值说明如下：

  • true：允许
  • false：不允许

线程池

ThreadPoolForceMergeQueueSize

force-merge 操作的请求等待队列大小，取值范围为 -1~10000。当设置为 0 或 -1 时，表示不使用该队列。
默认值为 -1。

ThreadPoolWriteQueueSize

对单个 document 的 index/delete/update 和 bulk 操作的请求等待队列大小。取值范围为 -1~10000。当设置为 0 或 -1 时，表示不使用该队列。
默认值为 1000。

Reindex

ReindexRemoteWhitelist

添加远程集群的访问地址白名单，支持 host 和 port 组合，逗号隔开多个主机配置，例如 node1:9200,127.0.0.1:9200。

分片分配

ClusterRoutingAllocationNodeConcurrentIncomingRecoveries

允许在一个节点上同时发生的传入分片恢复的数量。传入恢复是指目标分片（通常是副本分片，除非分片正在迁移）分配到该节点上的恢复操作。默认值为 2。

ClusterRoutingAllocationNodeConcurrentOutgoingRecoveries

允许在一个节点上同时发生的传出分片恢复的数量。传出恢复是指源分片（通常是主分片，除非分片正在迁移）分配到该节点上的恢复操作。默认值为 2。

ClusterRoutingAllocationNodeConcurrentRecoveries

同时设置 ClusterRoutingAllocationNodeConcurrentIncomingRecoveries 和 ClusterRoutingAllocationNodeConcurrentOutgoingRecoveries 参数。仅当上述参数未配置时，此参数才生效。默认值为 2。

ClusterRoutingAllocationNodeInitialPrimariesRecoveries

副本分片的恢复通过网络进行，而节点重启后未分配主分片的恢复则使用本地磁盘上的数据。这种恢复通常很快，因此可以在每个节点上并行执行更多的初始主分片恢复。默认值为 4。

索引恢复

IndicesRecoveryMaxBytesPerSec

限制每个节点的总入向和出向恢复流量。此限制同时适用于节点间恢复和快照恢复 。默认值为 40 MB。

ES 7.10.2 参数

类别

参数名

说明

索引管理

ActionAutoCreateIndex

是否自动创建索引。默认值为 true，取值说明如下：

  • true：自动创建索引。
  • false：不自动创建索引。

ActionDestructiveRequiresName

删除索引是否需要声明完整索引名。默认值为 false，取值说明如下：

  • true：需要声明完整索引名。
  • false：不需要声明完整索引名。

ActionIndicesCloseEnable

是否支持关闭索引。默认值为 true，取值说明如下：

  • true：支持关闭索引。
  • false：不支持关闭索引。

集群管理

ClusterPublishTimeout

集群发布状态超时时间，取值是正整数，单位秒，默认值为 30s。
这是专家级配置，请谨慎设置。

FollowerFaultDetectionTimeout

数据节点心跳超时时间，取值是正整数，单位秒，默认值为 30s。
这是专家级配置，请谨慎设置。

FollowerLagTimeout

节点接受元数据时，可容忍不被剔除的最大时间，取值是正整数，单位秒，默认值为 90s。
这是专家级配置，请谨慎设置。

LeaderFaultDetectionTimeout

主节点心跳超时时间，取值为正整数，单位秒，默认值为 30s。
这是专家级配置，请谨慎设置。

跨域访问

HttpCorsAllowCredentials

跨域访问是否返回头部的 Access-Control-Allow-Credentials。默认值为 false，取值说明如下：

  • true：返回头部的 Access-Control-Allow-Credentials。
  • false：不返回头部的 Access-Control-Allow-Credentials。

HttpCorsAllowHeaders

跨域访问允许的 Headers，用英文逗号分开。默认值：X-Requested-With, Content-Type, Content-Length。

HttpCorsAllowMethods

跨域访问允许的 http 方法，用英文逗号分开。默认值：OPTIONS, HEAD, GET, POST, PUT, DELETE。

HttpCorsAllowOrigin

跨域访问允许的源地址，配置格式为 http://host:port。支持正则表达式。

HttpCorsEnabled

是否允许跨域访问。默认值为 false，取值说明如下：

  • true：允许跨域访问。
  • false：不允许跨域访问。

HttpCorsMaxAge

浏览器 preflight 请求的返回结果的默认缓存时间，可配置的范围为 [1, 1728000]，单位为秒。
默认值为 1728000（20 天）。

HTTP

HttpMaxContentLength

HTTP 请求体最大限制，取值为正整数，单位为 mb。
默认值为 100mb。

HttpMaxHeaderSize

HTTP 请求头最大限制，取值为正整数，单位为 kb。
默认值为 8kb。

HttpMaxInitialLineLength

HTTP 请求行最大限制，取值为正整数，单位为 kb。
默认值为 4kb。

缓存

IndicesFielddataCacheSize

字段数据在 Java 堆空间的缓存占比，取值范围为 [1%, 100%]，默认值为 100%。

IndicesQueriesCacheSize

查询阶段的缓存大小。取值可以是百分比，也可以是具体值，取值范围为
[512mb, 2048mb] 或 [5%, 20%]。
默认值为 10%。

IndicesRequestsCacheSize

请求响应结果在 Java 堆空间的缓存占比，取值范围为 [1%, 100%]，默认值为 1%。

查询

IndicesQueryBoolMaxClauseCount

Lucene BooleanQuery 可以包含的最大子句数，取值范围为 [16, 100000]，默认值为 1024。

SearchAllowExpensiveQueries

是否允许高资源消耗类的查询，包括脚本查询、Join 查询、正则查询、通配查询、模糊查询等。默认值为 true，取值说明如下：

  • true：允许
  • false：不允许

线程池

ThreadPoolForceMergeQueueSize

force-merge 操作的请求等待队列大小，取值范围为 -1~10000。当设置为 0 或 -1 时，表示不使用该队列。
默认值为 -1。

ThreadPoolSearchSize

查询请求使用的线程池大小。默认值为自动计算，一般约为 CPU 核数的 1.5 倍。

ThreadPoolWriteQueueSize

对单个 document 的 index/delete/update 和 bulk 操作的请求等待队列大小。取值范围为 -1~10000。当设置为 0 或 -1 时，表示不使用该队列。
默认值为 1000。

Reindex

ReindexRemoteWhitelist

添加远程集群的访问地址白名单，支持 host 和 port 组合，逗号隔开多个主机配置，例如 node1:9200,127.0.0.1:9200。

分片分配

ClusterRoutingAllocationNodeConcurrentIncomingRecoveries

允许在一个节点上同时发生的传入分片恢复的数量。传入恢复是指目标分片（通常是副本分片，除非分片正在迁移）分配到该节点上的恢复操作。默认值为 2。

ClusterRoutingAllocationNodeConcurrentOutgoingRecoveries

允许在一个节点上同时发生的传出分片恢复的数量。传出恢复是指源分片（通常是主分片，除非分片正在迁移）分配到该节点上的恢复操作。默认值为 2。

ClusterRoutingAllocationNodeConcurrentRecoveries

同时设置 ClusterRoutingAllocationNodeConcurrentIncomingRecoveries 和 ClusterRoutingAllocationNodeConcurrentOutgoingRecoveries 参数。仅当上述参数未配置时，此参数才生效。默认值为 2。

ClusterRoutingAllocationNodeInitialPrimariesRecoveries

副本分片的恢复通过网络进行，而节点重启后未分配主分片的恢复则使用本地磁盘上的数据。这种恢复通常很快，因此可以在每个节点上并行执行更多的初始主分片恢复。默认值为 4。

索引恢复

IndicesRecoveryMaxBytesPerSec

限制每个节点的总入向和出向恢复流量。此限制同时适用于节点间恢复和快照恢复 。默认值为 40 MB。

说明

增大分片分配类别下参数的值可能会使分片移动对集群中的其他活动产生性能影响，但未必能显著加快分片移动的完成速度。不建议更改默认值。

ES 6.7.1 和 ES 6.8.23 参数

类别

参数名

说明

索引管理

ActionAutoCreateIndex

是否自动创建索引。默认值为 true，取值说明如下：

  • true：自动创建索引。
  • false：不自动创建索引。

ActionDestructiveRequiresName

删除索引是否需要声明完整索引名。默认值为 false，取值说明如下：

  • true：需要声明完整索引名。
  • false：不需要声明完整索引名。

ActionIndicesCloseEnable

是否支持关闭索引。默认值为 true，取值说明如下：

  • true：支持关闭索引。
  • false：不支持关闭索引。

跨域访问

HttpCorsAllowCredentials

跨域访问是否返回头部的 Access-Control-Allow-Credentials。默认值为 false，取值说明如下：

  • true：返回头部的 Access-Control-Allow-Credentials。
  • false：不返回头部的 Access-Control-Allow-Credentials。

HttpCorsAllowHeaders

跨域访问允许的 Headers，用英文逗号分开。默认值：X-Requested-With, Content-Type, Content-Length。

HttpCorsAllowMethods

跨域访问允许的 http 方法，用英文逗号分开。默认值：OPTIONS, HEAD, GET, POST, PUT, DELETE。

HttpCorsAllowOrigin

跨域访问允许的源地址，配置格式为 http://host:port。支持正则表达式。

HttpCorsEnabled

是否允许跨域访问。默认值为 false，取值说明如下：

  • true：允许跨域访问。
  • false：不允许跨域访问。

HttpCorsMaxAge

浏览器 preflight 请求的返回结果的默认缓存时间，可配置的范围为 [1, 1728000]，单位为秒。
默认值为 1728000（20 天）。

HTTP

HttpMaxContentLength

HTTP 请求体最大限制，取值为正整数，单位为 mb。
默认值为 100mb。

HttpMaxHeaderSize

HTTP 请求头最大限制，取值为正整数，单位为 kb。
默认值为 8kb。

HttpMaxInitialLineLength

HTTP 请求行最大限制，取值为正整数，单位为 kb。
默认值为 4kb。

缓存

IndicesFielddataCacheSize

字段数据在 Java 堆空间的缓存占比，取值范围为 [1%, 100%]，默认值为 100%。

IndicesQueriesCacheSize

查询阶段的缓存大小。取值可以是百分比，也可以是具体值，取值范围为
[512mb, 2048mb] 或 [5%, 20%]。
默认值为 10%。

IndicesRequestsCacheSize

请求响应结果在 Java 堆空间的缓存占比，取值范围为 [1%, 100%]，默认值为 1%。

查询

IndicesQueryBoolMaxClauseCount

Lucene BooleanQuery 可以包含的最大子句数，取值范围为 [16, 100000]，默认值为 1024。

线程池

ThreadPoolWriteQueueSize

对单个 document 的 index/delete/update 和 bulk 操作的请求等待队列大小。取值范围为 -1~10000。当设置为 0 或 -1 时，表示不使用该队列。
默认值为 1000。

ThreadPoolBulkQueueSize

对单个 document 的 bulk 操作的请求等待队列大小。取值范围为 -1~10000。当设置为 0 或 -1 时，表示不使用该队列。
默认值为 1000。

Reindex

ReindexRemoteWhitelist

添加远程集群的访问地址白名单，支持 host 和 port 组合，逗号隔开多个主机配置，例如 node1:9200,127.0.0.1:9200。