Elasticsearch Service ES 版本升级检查

升级检查操作入口，在 Elasticsearch Service 控制台 详情页，单击右上角升级，操作步骤详见 升级 ES 集群。

注意：警告

注意：需特别留意这篇中需要人工检查的部分（无法自动检查），并在升级前完成代码兼容性改造，避免升级后造成集群无法正常访问，例如，6.8版本升级到7.5版本后默认无法创建包含 type 的索引，详情见下文 需人工自查的不兼容配置。

一、检查的配置项列表

二、集群级别

·集群快照设置（Snapshot settings）
通过 ES 集群设置更新接口PUT _cluster/settings取消此设置（包括 persistent 和 transient）：

PUT _cluster/settings{ "persistent": { "cluster.routing.allocation.snapshot.relocation_enabled": null }, "transient": { "cluster.routing.allocation.snapshot.relocation_enabled": null }}

·集群存储限流设置（Store throttling settings）
通过 ES 集群设置更新接口PUT _cluster/settings取消此设置（包括 persistent 和 transient）：

PUT _cluster/settings{ "persistent": { "indices.store.throttle.type": null, "indices.store.throttle.max_bytes_per_sec": null }, "transient": { "indices.store.throttle.type": null, "indices.store.throttle.max_bytes_per_sec": null }}

三、索引级别

·索引相似性设置（Similarity settings）
此设置在升级 6.x 后被忽略，但不会影响升级。如需取消设置，可按照如下步骤操作：

·此设置需要关闭索引后修改，关闭后的索引无法被读写。关闭索引：

POST my_index/_close

·使用 ES 索引设置更新接口取消此设置：

PUT my_index/_settings{ "index.similarity.base.*": null}

·最后打开索引：

POST my_index/_open

·索引影子副本设置（Shadow Replicas settings）

·此设置需要关闭索引后修改，关闭后的索引无法被读写。关闭索引：

POST my_index/_close

·使用 ES 索引设置更新接口取消此设置：

PUT my_index/_settings{ "index.shared_filesystem": null, "index.shadow_replicas": null}

·最后打开索引：

POST my_index/_open

·索引存储设置（Index Store settings）

·此设置需要关闭索引后修改，关闭后的索引无法被读写。关闭索引：

POST my_index/_close

·使用 ES 索引设置更新接口取消此设置：

PUT my_index/_settings{ "index.store.type": null}

·最后打开索引：

POST my_index/_open

·索引存储限流设置（Index Store throttling settings）
使用 ES 索引设置更新接口取消此设置：

PUT my_index/_settings{ "settings": { "index.store.throttle.type": null, "index.store.throttle.max_bytes_per_sec": null }}

·索引 Mapping 参数 include_in_all
对已创建的包含此参数的索引，升级后可以兼容，无需修复。

四、索引模板级别

1. 使用 API GET _template/my_template 获取不兼容模板my_template。存在以下三个不兼容设置：索引模板存储设置（Index Store settings）、索引模板 Mapping 参数 include_in_all、索引模板 Mapping 元字段_all。

{ "my_template": { "order": 0, "template": "my_*", "settings": { "index": { "store": { "throttle": { "max_bytes_per_sec": "10m" } } } }, "mappings": { "my_type": { "_all": { "enabled": true }, "properties": { "my_field": { "type": "text", "include_in_all": true } } } }, "aliases": {} } }

2. 拷贝并去除模板中不兼容配置后，使用 API PUT _template/my_template 更新模板。

PUT _template/my_template { "order": 0, "template": "my_*", "settings": { }, "mappings": { "my_type": { "properties": { "my_field": { "type": "text" } } } }, "aliases": {} }

五、需人工自查的不兼容配置

·对于超过1024个字段数的索引，查询时如果不指定字段会非常消耗性能。建议设置默认查询字段 index.query.default_field。如果仍要查询所有字段，那么可以通过提高“布尔查询最大子句数”设置 indices.query.bool.max_clause_count 来实现。

·include_type_name 默认为 false，升级后默认将无法创建包含 type 的索引，需要显式指定参数 include_type_name：

注意：警告

注意：需重点关注集群是否有此项不兼容配置，避免升级后造成集群无法正常访问。

PUT my_index?include_type_name { "mappings": { "type1": { "properties": { "name": { "type": "text" } } } } }

六、可自动检查的配置项列表

七、集群级别

·用户代理预处理器（User agent processor）设置
使用非ecs格式的 user agent 将被废弃，应调整为：

PUT _ingest/pipeline/my_pipeline1{"processors" : [ { "user_agent" : { "field" : "agent", "ecs": true } }]}

·集群分片数
对于超过分片数限制的集群，有两种调整方法：

·降低集群分片数（通过清理过期索引、shrink 索引 等）。

·修改集群设置提高分片数限制。

PUT _cluster/settings{ "persistent": { "cluster.max_shards_per_node": 5000 }}

·集群设置（discovery.zen.no_master_block）
对于使用了集群设置 discovery.zen.no_master_block 的集群，在升级完成后调整为 cluster.no_master_block，例如：

PUT _cluster/settings{"persistent": { "cluster.no_master_block": "write"}}

·预处理器管道（Ingest pipeline）日期格式
可参考 Joda based date formatters are replaced with java ones 进行调整。

八、索引级别

·索引创建版本
不允许6.0版本之前创建的索引升级到7.x版本，对于需要保留的索引，需要在升级前执行 reindex ， 例如：

POST _reindex{"source": { "index": "my_index"},"dest": { "index": "new_my_index"}}

·Delimited payload 语汇单元过滤器（Token filter）索引模板设置
将索引设置中的 delimited_payload_filter 改为 delimited_payload，例如原始索引如下：

PUT my_index{"settings": { "analysis": { "analyzer": { "whitespace_plus_delimited": { "tokenizer": "whitespace", "filter": [ "plus_delimited" ] } }, "filter": { "plus_delimited": { "type": "delimited_payload_filter", "delimiter": "+", "encoding": "int" } } }}}

修改后的索引：

PUT my_index{"settings": { "analysis": { "analyzer": { "whitespace_plus_delimited": { "tokenizer": "whitespace", "filter": [ "plus_delimited" ] } }, "filter": { "plus_delimited": { "type": "delimited_payload", "delimiter": "+", "encoding": "int" } } }}}

·索引设置（index.percolator.map_unmapped_fields_as_string）
将索引设置 index.percolator.map_unmapped_fields_as_string 调整为 index.percolator.map_unmapped_fields_as_text（此设置调整前需要 close 索引）。

PUT my_index/_settings{"index.percolator.map_unmapped_fields_as_text": true}

·索引名
对于包含“:”的索引，需执行 reindex，例如：

POST _reindex{"source": { "index": "my_index"},"dest": { "index": "new_my_index"}}

·索引设置（index.unassigned.node_left.delayed_timeout）
将索引设置 index.unassigned.node_left.delayed_timeout 调整为正整数：

PUT my_index/_settings{"index.unassigned.node_left.delayed_timeout": 0}

·索引设置（index.shard.check_on_startup）
将索引设置 index.shard.check_on_startup 值为 fix 调整为其它值，例如：

PUT my_index/_settings{"index.shard.check_on_startup": true}

·经典相似性（classic similarity）索引 Mapping 参数、经典相似性（classic similarity）索引设置
对于包含经典相似性（classic similarity）的索引设置或 Mapping，调整为其他类型，例如原始索引如下：

PUT my_index{"mappings": { "doc": { "properties": { "field1": { "properties": { "field4": { "type": "text", "similarity": "classic" } } } } }}}

修改后的索引为：

PUT my_index{"mappings": { "doc": { "properties": { "field1": { "properties": { "field4": { "type": "text", "similarity": "BM25" } } } } }}}

·索引字段数
对于超过1024个字段的索引，有两种调整方法：

·设置默认查询字段设置 index.query.default_field。

PUT my_index/_settings{ "index.query.default_field": "field1"}

·通过修改 ES YML 配置文件提升最大字段数设置 indices.query.bool.max_clause_count（后续支持）。

·索引 Mapping 日期格式
可参考 Joda based date formatters are replaced with java ones 进行调整。

九、索引模板级别

索引模板级别的不兼容设置调整请参考 索引级别。