迁移到 8.0

详情
在Elasticsearch 8.0.0中，action.destructive_requires_name设置的默认值从false更改为true。

之前，默认设置为false允许用户使用通配符模式删除、关闭或更改索引上的块。 为了防止意外删除恰好匹配通配符模式的索引，我们现在默认要求破坏性操作明确指定要修改的索引。

影响
要使用通配符模式进行破坏性操作，请将 action.destructive_requires_name 设置为 false，使用 https://www.elastic.co/guide/en/elasticsearch/reference/master/cluster-update-settings.html 集群设置 API。

详情
您不能再在未分配data_frozen节点角色的节点上设置 xpack.searchable.snapshot.shared_cache.size。此设置为部分挂载索引的共享缓存预留磁盘空间。Elasticsearch仅将部分挂载的索引分配给具有data_frozen角色的节点。

影响
从没有data_frozen角色的节点的elasticsearch.yml中移除xpack.searchable.snapshot.shared_cache.size。在非冻结节点上指定此设置将导致启动时出错。

详情
Elasticsearch 现在将根据搜索线程池的大小和分配给 JVM 的堆大小，使用一种启发式方法动态设置查询中允许的最大子句数。此限制的最小值为 1024，在大多数情况下会更大（例如，具有 30GB RAM 和 48 个 CPU 的节点将具有大约 27,000 的最大子句计数）。较大的堆会导致更高的值，而较大的线程池会导致更低的值。

影响
应尽可能避免使用包含许多子句的查询。 如果您之前为了适应繁重的查询而调整了这个设置， 您可能需要增加分配给Elasticsearch的内存， 或者减少搜索线程池的大小，以便为每个并发搜索提供更多内存。

在Lucene的早期版本中，您可以通过相互嵌套布尔查询来绕过此限制，但现在的限制是基于整个查询中的叶查询总数，这种解决方法将不再有效。

指定 indices.query.bool.max_clause_count 将不会有任何效果，但会生成弃用警告。为了避免这些警告，请在升级或节点重启期间从 elasticsearch.yml 中移除该设置。

详情
设置 indices.lifecycle.poll_interval 过低可能会导致集群负载过高。轮询间隔现在必须至少为 1s（一秒）。

影响
在 elasticsearch.yml 中或通过 集群更新设置 API 将 indices.lifecycle.poll_interval 设置为 1s 或更大。

在 elasticsearch.yml 中将 indices.lifecycle.poll_interval 设置为小于 1s 会导致启动时出现错误。 Cluster update settings API 请求将 indices.lifecycle.poll_interval 设置为小于 1s 将返回错误。

详情
除非明确禁用，文件和本地领域现在已启用。如果明确禁用，文件和本地领域将始终保持禁用状态。

之前，文件和本地域具有以下隐含行为：

影响
要显式禁用文件或本地领域，请在elasticsearch.yml中的xpack.security.authc.realms命名空间下，将相应的file..enabled或native..enabled设置为false。

以下配置示例禁用了本地领域和文件领域。

xpack.security.authc.realms:

  native.realm1.enabled: false
  file.realm2.enabled: false

  ...

详情
xpack.security.authc.realms.{type}.{name}.order 设置现在是必需的，并且必须为每个显式配置的领域指定。每个值必须是唯一的。

影响
如果不满足要求，集群将无法启动。

例如，以下配置是无效的：

xpack.security.authc.realms.kerberos.kerb1:
  keytab.path: es.keytab
  remove_realm_name: false

并且必须配置为：

xpack.security.authc.realms.kerberos.kerb1:
  order: 0
  keytab.path: es.keytab
  remove_realm_name: false

详情
Elasticsearch 现在在基于集群中节点的磁盘使用情况进行分配决策时，总是会考虑重新定位分片的大小。在早期版本中，您可以通过将 cluster.routing.allocation.disk.include_relocations 设置为 false 来禁用此功能。这可能会导致分配决策不佳，可能会超出水位线并需要大量额外工作来纠正。cluster.routing.allocation.disk.include_relocations 设置已被移除。

影响
移除 cluster.routing.allocation.disk.include_relocations 设置。在 elasticsearch.yml 中指定此设置将在启动时导致错误。

详情
cluster.join.timeout 设置已被移除。加入尝试不再超时。

影响
从 elasticsearch.yml 中移除 cluster.join.timeout。

详情
所有在 discovery.zen 命名空间下的设置不再被支持。它们仅在7.x版本中出于向后兼容性原因存在。这包括：

影响
从elasticsearch.yml中移除discovery.zen设置。指定这些设置将在启动时导致错误。

详情
http.content_type.required 设置在 Elasticsearch 6.0 中已被弃用，并在 Elasticsearch 8.0 中被移除。该设置是在 Elasticsearch 5.3 中引入的，目的是为 Elasticsearch 6.0 做准备，因为在 Elasticsearch 6.0 中，HTTP 请求的内容类型自动检测已被移除。

影响
从elasticsearch.yml中移除http.content_type.required设置。指定此设置将在启动时导致错误。

详情
http.tcp_no_delay 设置在7.x版本中已被弃用，并在8.0版本中被移除。请改用 http.tcp.no_delay。

影响
将 http.tcp_no_delay 设置替换为 http.tcp.no_delay。 在 elasticsearch.yml 中指定 http.tcp_no_delay 将 导致启动时出现错误。

详情
network.tcp.connect_timeout 设置在7.x中已被弃用，并在8.0中被移除。此设置是transport.connect_timeout的备用设置。

影响
移除 network.tcp.connect_timeout 设置。 使用 transport.connect_timeout 设置来更改客户端连接的默认连接超时。在 elasticsearch.yml 中指定 network.tcp.connect_timeout 将导致启动时出现错误。

详情
node.max_local_storage_nodes 设置在 7.x 中已被弃用，并在 8.0 中被移除。节点应在不同的数据路径上运行，以确保每个节点始终分配到相同的数据路径。

影响
移除 node.max_local_storage_nodes 设置。在 elasticsearch.yml 中指定此设置将在启动时导致错误。

详情
自Elasticsearch 6.0版本发布以来，xpack.security.authc.accept_default_password设置没有任何影响，并且不再允许使用。

影响
从elasticsearch.yml中移除xpack.security.authc.accept_default_password设置。 指定此设置将在启动时导致错误。

详情
xpack.security.authz.store.roles.index.cache.max_size 和 xpack.security.authz.store.roles.index.cache.ttl 设置已被移除。这些设置自 Elasticsearch 5.2 版本以来一直是多余的并已被弃用。

影响
从 elasticsearch.yml 中移除 xpack.security.authz.store.roles.index.cache.max_size 和 xpack.security.authz.store.roles.index.cache.ttl 设置。 指定这些设置将在启动时导致错误。

详情
transport.profiles.*.xpack.security.type 设置不再受支持。 Transport Client 已被移除，所有客户端流量现在都使用 HTTP 传输。使用此设置的传输配置文件应被删除。

影响
从elasticsearch.yml中移除transport.profiles.*.xpack.security.type设置。 在传输配置文件中指定此设置将在启动时导致错误。

详情
在SAML中，身份提供者（IdP）可以显式配置为以特定格式发布NameID，或者配置为尝试符合服务提供者（SP）的要求。SP在其SAML认证请求的NameIDPolicy元素中声明其要求。在Elasticsearch中，nameid_format SAML领域设置控制NameIDPolicy值。

之前，nameid_format 的默认值是 urn:oasis:names:tc:SAML:2.0:nameid-format:transient。此设置创建了 需要 IdP 以 transient 格式发布 NameID 的认证请求。

默认值已被移除，这意味着Elasticsearch将默认创建不对此要求IdP的SAML身份验证请求。如果您想保留之前的行为，请将nameid_format设置为urn:oasis:names:tc:SAML:2.0:nameid-format:transient。

影响
如果您当前没有显式配置nameid_format，您的身份提供者（IdP）可能会拒绝来自Elasticsearch的身份验证请求，因为这些请求没有指定NameID格式（并且您的IdP配置为期望一个格式）。这种不匹配可能导致SAML配置失效。如果您不确定您的IdP是否显式配置为使用特定的NameID格式，并且您希望保留当前行为，请尝试将nameid_format显式设置为urn:oasis:names:tc:SAML:2.0:nameid-format:transient。

详情
现在，如果不同时配置xpack.security.transport.ssl.enabled，则为xpack.security.transport.ssl配置任何SSL设置都会出错。

影响
如果使用其他xpack.security.transport.ssl设置，您必须显式指定xpack.security.transport.ssl.enabled设置。

如果您不想启用SSL并且当前正在使用其他 xpack.security.transport.ssl 设置，请执行以下操作之一：

如果您想启用SSL，请按照加密集群中节点之间的通信中的说明进行操作。作为此配置的一部分，明确指定xpack.security.transport.ssl.enabled为true。

例如，以下配置是无效的：

xpack.security.transport.ssl.keystore.path: elastic-certificates.p12
xpack.security.transport.ssl.truststore.path: elastic-certificates.p12

并且必须配置为：

xpack.security.transport.ssl.enabled: true 
xpack.security.transport.ssl.keystore.path: elastic-certificates.p12
xpack.security.transport.ssl.truststore.path: elastic-certificates.p12

详情
现在，如果不同时配置xpack.security.http.ssl.enabled，则为xpack.security.http.ssl配置任何SSL设置都会出错。

影响
如果使用其他xpack.security.http.ssl设置，您必须显式指定xpack.security.http.ssl.enabled设置。

如果您不想启用SSL，并且当前正在使用其他 xpack.security.http.ssl 设置，请执行以下操作之一：

如果您想启用SSL，请按照加密HTTP客户端通信中的说明进行操作。作为此配置的一部分，明确指定xpack.security.http.ssl.enabled为true。

例如，以下配置是无效的：

xpack.security.http.ssl.certificate: elasticsearch.crt
xpack.security.http.ssl.key: elasticsearch.key
xpack.security.http.ssl.certificate_authorities: [ "corporate-ca.crt" ]

并且必须配置为以下任一方式：

xpack.security.http.ssl.enabled: true 
xpack.security.http.ssl.certificate: elasticsearch.crt
xpack.security.http.ssl.key: elasticsearch.key
xpack.security.http.ssl.certificate_authorities: [ "corporate-ca.crt" ]

详情
现在，如果在未通过使用xpack.security.transport.ssl.keystore.path设置或xpack.security.transport.ssl.certificate和xpack.security.transport.ssl.key设置配置证书和密钥的情况下，为传输接口启用SSL，将会报错。

影响
如果 xpack.security.transport.ssl.enabled 设置为 true，请使用 xpack.security.transport.ssl.keystore.path 设置或 xpack.security.transport.ssl.certificate 和 xpack.security.transport.ssl.key 设置提供证书和密钥。如果没有提供证书和密钥，Elasticsearch 将在启动时返回错误。

详情
现在，如果在未通过使用xpack.security.http.ssl.keystore.path设置或xpack.security.http.ssl.certificate和xpack.security.http.ssl.key设置配置证书和密钥的情况下为HTTP（Rest）服务器启用SSL，将会报错。

影响
如果 xpack.security.http.ssl.enabled 设置为 true，请使用 xpack.security.http.ssl.keystore.path 设置或 xpack.security.http.ssl.certificate 和 xpack.security.http.ssl.key 设置提供证书和密钥。如果未提供证书和密钥，Elasticsearch 将在启动时返回错误。

详情
设置 *.ssl.keystore.type 和 *.ssl.truststore.type 不再接受 "PKCS11" 作为有效类型。 这适用于 Elasticsearch 中的所有 SSL 设置，包括

除了安全域的SSL设置外，还有观察者和监控。

使用PKCS#11密钥库或信任库作为JRE的默认存储不受影响。

影响
如果您在 elasticsearch.yml 文件中配置了 PKCS#11 密钥库，您必须删除该配置并切换到受支持的密钥库类型，或者将您的 PKCS#11 密钥库配置为 JRE 默认存储。

详情
kibana 用户历史上用于验证 Kibana 到 Elasticsearch 的身份。 这个用户的名称容易引起混淆，并且经常被误用来登录 Kibana。 为了减少混淆并更好地与其他内置系统账户保持一致，该用户已被重命名为 kibana_system。

影响
将任何使用kibana用户的部分替换为kibana_system用户。在kibana.yml中指定kibana用户将导致启动时出现错误。

如果你的 kibana.yml 文件曾经包含：

elasticsearch.username: kibana

然后你应该更新以使用新的 kibana_system 用户：

elasticsearch.username: kibana_system

详情
在6.5中，这些设置已被弃用，取而代之的是cluster.remote。在7.x中，我们提供了将这些设置自动升级到cluster.remote对应设置的功能。在8.0.0中，这些设置已被移除。如果您的配置或集群状态中包含这些设置，Elasticsearch将拒绝启动。

影响
使用替换的 cluster.remote 设置。停止使用 search.remote.* 设置。在 elasticsearch.yml 中指定这些设置将导致启动时出错。

详情
为了确保所有设置都在适当的命名空间中，pidfile 设置在 Elasticsearch 7.4.0 版本中已被弃用，并在 8.0.0 版本中被移除。请改用 node.pidfile。

影响
使用 node.pidfile 设置。停止使用 pidfile 设置。 在 elasticsearch.yml 中指定 pidfile 设置将导致启动时出错。

详情
为了确保所有设置都在适当的命名空间中，processors 设置在 Elasticsearch 7.4.0 版本中已被弃用，并在 8.0.0 版本中被移除。请改用 node.processors。

影响
使用 node.processors 设置。停止使用 processors 设置。 在 elasticsearch.yml 中指定 processors 设置将导致启动时出现错误。

详情
之前可以设置用于设置线程池默认大小的处理器数量超过可用处理器的数量。由于这会导致更多的上下文切换和更多的线程，但没有增加可以调度这些额外线程的物理CPU数量，因此node.processors设置现在受限于可用处理器的数量。

影响
如果指定，确保node.processors设置的值不超过可用处理器的数量。在elasticsearch.yml中将node.processors的值设置为大于可用处理器的数量，将会导致启动时出现错误。

详情
在 Elasticsearch 7.7.0 中，设置 cluster.remote.connect 已被弃用，取而代之的是设置 node.remote_cluster_client。在 Elasticsearch 8.0.0 中，设置 cluster.remote.connect 已被移除。

影响
使用 node.remote_cluster_client 设置。停止使用 cluster.remote.connect 设置。在 elasticsearch.yml 中指定 cluster.remote.connect 设置将在启动时导致错误。

详情
在 Elasticsearch 7.8.0 中，设置 node.local_storage 已被弃用，并且从 Elasticsearch 8.0.0 开始，所有节点都需要本地存储。因此，node.local_storage 设置已被移除。

影响
停止使用node.local_storage设置。在elasticsearch.yml中指定此设置将导致启动时出错。

详情
在 Elasticsearch 7.7.0 中，设置 xpack.monitoring.exporters..auth.password 已被弃用，取而代之的是设置 xpack.monitoring.exporters..auth.secure_password。 在 Elasticsearch 8.0.0 中，设置 xpack.monitoring.exporters..auth.password 已被移除。

影响
使用 xpack.monitoring.exporters..auth.secure_password 设置。停止使用 xpack.monitoring.exporters..auth.password 设置。在 elasticsearch.yml 中指定 xpack.monitoring.exporters..auth.password 设置将导致启动时出现错误。

详情
以下设置在Elasticsearch 7.8.0中已被弃用，并在Elasticsearch 8.0.0中已被移除：

这些基本许可证功能现在始终启用。

如果你已经禁用了ILM，以便可以使用另一个工具来管理Watcher索引，那么新引入的xpack.watcher.use_ilm_index_management设置可能需要设置为false。

影响
停止使用已移除的设置。在elasticsearch.yml中指定这些设置将导致启动时出现错误。

详情
以下集群设置已被移除：

一旦大多数符合主节点资格的节点加入集群，就可以安全地恢复集群，因此等待任何额外的主节点资格节点启动并没有任何好处。

影响
停止使用已移除的设置。如果需要，可以使用 gateway.expected_data_nodes 或 gateway.recover_after_data_nodes 来延迟 集群恢复，直到满足一定数量的数据节点。

详情
遗留角色设置：

已被移除。请改用 node.roles 设置。如果您之前在 7.13 或更高版本的集群上使用过旧版角色设置，您将在每个节点上收到一条弃用日志消息，指示 node.roles 的确切替代值。

影响
停止使用已移除的设置。在elasticsearch.yml中指定这些设置将在启动时导致错误。

详情
Elasticsearch 使用系统调用过滤器来移除其分叉另一个进程的能力。这对于缓解远程代码执行漏洞非常有用。这些系统调用过滤器默认启用，并且之前通过设置 bootstrap.system_call_filter 进行控制。从 Elasticsearch 8.0 开始，系统调用过滤器将成为必需。因此，设置 bootstrap.system_call_filter 在 Elasticsearch 7.13.0 中已被弃用，并在 Elasticsearch 8.0.0 中被移除。

影响
停止使用已移除的设置。在Elasticsearch配置中指定此设置将导致启动时出现错误。

详情
用于过滤将分片分配到特定节点集的以 ._tier 结尾的集群和索引级别设置已被移除。取而代之的是，应使用层级偏好设置，即 index.routing.allocation.include._tier_preference。被移除的设置包括：

集群级别设置：

索引设置：

影响
停止使用已移除的设置。在Elasticsearch配置中指定这些集群设置中的任何一个都会导致启动时出现错误。使用这些设置的任何索引在加载索引元数据时，这些设置将被归档（并且它们将无效）。

详情
Elasticsearch 使用共享数据路径作为每个索引数据路径的基路径。此功能之前与共享副本一起使用。从 7.13.0 开始，这些设置已被弃用。从 8.0 开始，只有 7.x 中创建的现有索引才能使用共享数据路径和每个索引数据路径设置。

影响
停止使用已弃用的设置。

详情
在7.14中，将cluster.routing.allocation.disk.watermark.enable_for_single_data_node 设置为false已被弃用。从8.0开始，唯一合法的值将是 true。在未来的版本中，该设置将被完全移除，其行为将与设置为true时相同。

如果希望单个数据节点集群使用旧的行为，可以通过设置 cluster.routing.allocation.disk.threshold_enabled: false来禁用基于磁盘的分配

影响
停止使用已弃用的设置。

详情
gateway.auto_import_dangling_indices 集群设置已被移除。 以前，您可以使用此设置来自动导入 悬空索引。然而， 自动导入悬空索引是不安全的。请改用 悬空索引API 来管理和导入悬空索引。

影响
停止使用已移除的设置。在elasticsearch.yml中指定该设置将导致启动时出现错误。

详情
之前，传输客户端使用线程池来确保监听器不会在网络线程上调用。传输客户端已在8.0中被移除，线程池也不再需要。

影响
从任何节点的elasticsearch.yml中移除listener线程池设置。 在elasticsearch.yml中指定listener线程池设置将导致启动时出现错误。

详情
fixed_auto_queue_size 线程池类型，之前被标记为实验性功能，在7.x中已被弃用，并在8.0中被移除。 search 和 search_throttled 线程池现在具有 fixed 类型。

影响
无需采取行动。

详情
以下设置在7.x版本中已被弃用，并在8.0版本中被移除。每个设置都有一个在6.7版本中引入的替代设置。

影响
使用替换设置。停止使用已移除的设置。 在elasticsearch.yml中指定已移除的设置将导致启动时出错。

详情
在8.0之前，传输压缩默认是禁用的。从8.0开始，transport.compress 默认设置为 indexing_data。此配置意味着节点之间的原始索引数据传播将会被压缩。

影响
节点间传输将在索引路径上减少。在某些情况下，CPU使用率可能会增加。

详情
在8.0之前，transport.compression_scheme 设置默认值为 deflate。从8.0开始，transport.compress_scheme 默认值为 lz4。

在8.0之前，当cluster.remote..transport.compress被显式配置时，cluster.remote..transport.compression_scheme设置默认值为deflate。从8.0开始，cluster.remote..transport.compression_scheme将默认回退到transport.compression_scheme。

影响
此配置意味着传输压缩将产生略低的压缩比，以换取较低的CPU负载。

详情
对于共享文件系统仓库（"type": "fs"），节点级别的设置 repositories.fs.compress 以前可以用于为所有未指定 compress 的共享文件系统仓库启用压缩。repositories.fs.compress 设置已被移除。

影响
停止使用节点级别的repositories.fs.compress设置。请改用特定于存储库的compress设置来启用压缩。参考共享文件系统存储库设置。

详情
如果 xpack.security.fips_mode.enabled 为 true（参见 FIPS 140-2）， xpack.security.authc.password_hashing.algorithm 的值现在默认为 pbkdf2_stretch。

在早期版本中，此设置总是默认为bcrypt，并且运行时检查会阻止节点启动，除非该值被显式设置为"pbkdf2"变体。

对于未启用FIPS 140模式的集群，没有变化。

影响
此更改不应对升级的节点产生任何影响。 任何已明确配置密码哈希算法的节点将继续使用该配置值。 在Elasticsearch 6.x或Elasticsearch 7.x中未明确配置密码哈希算法的任何节点将无法启动。

详情

在8.0之前，Elasticsearch会根据xpack.monitoring.history.duration设置内部处理所有监控索引的删除。

当使用 metricbeat 或 elastic agent >= 8.0 收集监控数据时，索引通过 ILM 策略进行管理。如果设置了该选项，策略将使用 xpack.monitoring.history.duration 作为初始保留期创建。

如果您需要为使用metricbeat收集的监控数据自定义保留设置，请直接更新.monitoring-8-ilm-policy ILM策略。

设置 xpack.monitoring.history.duration 仅适用于使用（遗留）内部收集编写的监控索引，不适用于由 metricbeat 或 agent 创建的索引。

影响
升级后，确保 .monitoring-8-ilm-policy ILM 策略与您期望的保留设置一致。

如果你仅使用metricbeat或agent来收集监控数据，你也可以移除任何自定义的xpack.monitoring.history.duration设置。

详情
elasticsearch-migrate 工具提供了一种将文件领域用户和角色转换为本地领域的方法。自 Elasticsearch 7.2.0 起，该工具已被弃用。现在应在本地领域中直接创建用户和角色。

影响
停止使用 elasticsearch-migrate 工具。尝试使用 elasticsearch-migrate 工具将导致错误。

详情
直接访问系统索引已被弃用，并且在未来的版本中可能会被禁止。如果您必须访问系统索引，请创建一个具有针对特定索引的索引权限的安全角色，并将allow_restricted_indices权限设置为true。有关如何将此权限添加到索引权限的信息，请参阅索引权限。

影响
直接访问系统索引会导致API响应头中出现警告。如果可用，请使用Kibana或相关功能的Elasticsearch API来管理您想要访问的数据。

详情
index.merge.policy.max_merge_at_once_explicit 索引设置已被弃用，并且无效。

之前，您可以指定 index.merge.policy.max_merge_at_once_explicit 来设置在强制合并或清除已删除文档时同时合并的最大段数。在 8.0 中，无论设置如何，此数量都是无限的。

影响
指定 index.merge.policy.max_merge_at_once_explicit 将不会有效果，但会生成弃用警告。

为了避免这些弃用警告，请停止使用该设置。在创建新索引时不要指定该设置，并从索引和组件模板中移除该设置。

要从现有的数据流或索引中移除设置，请使用更新索引设置 API 将设置的值指定为 null。

PUT my-index-000001/_settings
{
  "index.merge.policy.max_merge_at_once_explicit": null
}

详情
index.max_adjacency_matrix_filters 索引设置已被移除。 以前，您可以使用此设置来配置 邻接矩阵聚合的最大过滤器数量。现在，indices.query.bool.max_clause_count 索引设置决定了该聚合的最大过滤器数量。

影响
停止使用index.max_adjacency_matrix_filters索引设置。

包含索引设置的请求将返回错误。如果您升级一个已经包含该设置的7.x索引的集群，Elasticsearch将归档该设置。

从索引和组件模板中移除索引设置。尝试使用包含该设置的模板将会失败并返回错误。这包括自动化操作，例如ILM滚动更新操作。

详情
index.force_memory_term_dictionary 设置在7.0中作为临时措施引入，允许用户选择退出在适当情况下将术语字典保留在磁盘上的优化。此优化现在是强制性的，该设置已被移除。

影响
停止使用index.force_memory_term_dictionary索引设置。 包含此设置的请求将返回错误。

详情
在7.6版本中，创建禁用软删除的索引已被弃用，并且在8.0版本中不再支持。index.soft_deletes.enabled设置不能再设置为false。

影响
停止使用index.soft_deletes.enabled索引设置。将index.soft_deletes.enabled设置为false的请求将返回错误。

详情
Translog 保留设置 index.translog.retention.age 和 index.translog.retention.size 在 7.4 中实际上被忽略，在 7.7 中被弃用，并在 8.0 中被移除，以支持 软删除。

影响
停止使用 index.translog.retention.age 和 index.translog.retention.size 索引设置。包含这些设置的请求将返回错误。

详情
在高级别的REST客户端中，indexlifecycle 包已被重命名为 ilm，以匹配Elasticsearch代码中的包重命名。

影响
更新您的工作流程和应用程序，以使用ilm包代替indexlifecycle。

详情
要创建 Fuzziness 实例，请使用 fromString 和 fromEdits 方法，而不是接受字符串和数值的 build 方法。查询构建器上的多个模糊性设置器（例如 MatchQueryBuilder#fuzziness）现在只接受一个 Fuzziness 实例，而不是一个对象。

模糊性在解析任意数值时曾经是宽松的，会静默地将它们截断为三个允许的编辑距离之一：0、1 或 2。现在这种宽松性已被移除，当尝试使用其他值（例如，像 1.3 这样的浮点数曾经被接受但被截断为 1）构造实例时，类将抛出错误。

影响
使用可用的常量（例如 Fuzziness.ONE，Fuzziness.AUTO）或使用上述提到的工厂方法构建您自己的实例。仅使用允许的 Fuzziness 值。

详情
仓库不再依赖于IndexShard。为了提高可测试性，restoreShard和snapshotShard的契约已简化为Store和MappingService。

影响
无需采取行动。

详情
如果一个节点超过了洪水阶段磁盘水位线，那么我们会向其所有索引添加一个块，以防止进一步写入，作为防止节点完全耗尽磁盘空间的最后手段。默认情况下，从7.4版本开始，当节点再次低于高水位线时，该块会自动移除，但可以通过将系统属性es.disk.auto_release_flood_stage_block设置为false来禁用此行为。此行为不再可选，并且现在不得设置此系统属性。

影响
停止使用es.disk.auto_release_flood_stage_block系统属性。 设置此系统属性将导致启动时出现错误。

详情
从版本7.4开始，URL中的+将被所有REST API功能编码为%2B。在此之前的版本中，+被视为单个空格。 在这些早期版本中，如果您的应用程序需要将+作为单个空格处理，您可以通过将系统属性es.rest.url_plus_as_space设置为true来恢复旧的行为。请注意，此行为已被弃用，并且在版本8中将不再支持将此系统属性设置为true。

影响
更新您的应用程序或工作流程，以假设URL中的+被编码为%2B。

详情
Elasticsearch 有一个检查，验证通信的对节点是否运行在相同的版本，并且因此使用相同的构建，从而使用相同的网络格式。在之前的版本中，可以通过设置系统属性 es.unsafely_permit_handshake_from_incompatible_builds 为 true 来绕过此检查。现在，使用此系统属性已被禁止。

影响
停止使用es.unsafely_permit_handshake_from_incompatible_builds系统属性，并确保同一版本的所有节点运行完全相同的构建。设置此系统属性将在启动时导致错误。

详情
Elasticsearch的JSON日志现在符合Elastic通用模式（ECS）。以前，Elasticsearch的JSON日志使用自定义模式。

影响
如果您的应用程序解析 Elasticsearch 的 JSON 日志，请更新它以支持新的 ECS 格式。

详情
Elasticsearch 不再输出以下日志的纯文本版本：

这些日志现在仅在 JSON 中可用。

服务器日志仍然可以以JSON和纯文本格式提供。

影响
如果您的应用程序解析 Elasticsearch 的纯文本日志，请更新它以使用新的 ECS JSON 日志。

详情
除了现有的每日滚动外，安全审计日志现在还会根据磁盘大小限制进行滚动。此外，滚动后的日志也会被gzip压缩。

影响
滚动审计日志文件的名称（但不包括当前日志的名称）已更改。 如果您已设置自动化工具来使用这些文件，您必须配置它们以使用新名称，并可能需要处理gzip存档而不是纯文本。Elasticsearch的Docker构建不受影响，因为它记录在stdout上，滚动操作不会执行。

详情
Elasticsearch 8.0 可以读取在版本 7.0 或更高版本中创建的索引。在存在由 7.0 之前版本的 Elasticsearch 创建的索引的情况下，Elasticsearch 8.0 节点将无法启动。

影响
如果需要将Elasticsearch 6.x或之前创建的索引迁移到Elasticsearch 8.x，请在Elasticsearch 7.x中重新索引这些索引。

详情
在早期版本中，即使节点包含来自比前一个主要版本更早的版本创建的索引数据，只要这些索引是关闭的，节点也会启动。现在，Elasticsearch 确保在启动时与每个索引（无论是打开还是关闭）兼容。

影响
如果需要将Elasticsearch 6.x或之前创建的已关闭索引迁移到Elasticsearch 8.x，请使用Elasticsearch 7.x重新索引这些索引。

详情
单个完成字段内的完成上下文数量已限制为10个。

影响
在一个完成字段中最多使用10个完成上下文。指定超过10个完成上下文将返回一个错误。

详情
之前，可以在一个多字段内定义一个多字段。 在7.3版本中，定义链式多字段已被弃用，现在不再支持。

影响
要迁移映射，所有出现在fields块中的fields实例都应该被移除，可以通过将链式的fields块扁平化为单一层级，或者在适当的情况下切换到copy_to。

详情
该设置在7.5版本中已被弃用，并且在新索引上不再受支持。 旧索引的映射将继续工作，但会发出弃用警告。

影响
_field_names 的 enabled 设置应从模板和映射中移除。 禁用 _field_names 不再必要，因为它不再带来大的索引开销。

详情
索引时间提升自5x系列以来已被弃用，但仍然可以在映射中声明特定字段的提升。现在这已完全移除。在7x中构建的包含映射提升的索引将发出警告，并且在8.0中提升将无效。新的索引将完全不允许在其映射中设置提升。

影响
应从模板和映射中移除boost设置。请直接在查询中使用boost。

详情
在7.0版本中，Elasticsearch从joda时间切换到java时间进行与日期相关的解析、格式化和计算。在7.0及更高版本中创建的索引已经需要使用带有java时间日期格式的映射。然而，使用joda时间格式的早期索引必须重新索引以使用带有java时间格式的映射。

影响
有关详细的迁移指南，请参阅Java时间迁移指南。

详情
以下 geo_shape 映射参数在6.6版本中已被弃用：

这些参数已在8.0.0中移除。

影响
在8.0中，您不能再创建包含这些参数的映射。 然而，使用这些映射参数的7.x索引将继续正常工作。

详情
sparse_vector 字段类型在7.6版本中已被弃用，并在8.0版本中被移除。我们没有看到对此实验性字段类型的广泛兴趣，并且目前的设计中没有明确的用例。如果您对稀疏向量功能有反馈或建议，请通过GitHub或讨论论坛告知我们。

影响
停止使用sparse_vector字段数据类型。包含此字段数据类型映射的请求将返回错误。

详情
每个节点的数据现在直接存储在由path.data设置的数据目录中，而不是存储在${path.data}/nodes/0中，因为移除了node.max_local_storage_nodes设置，这意味着节点可能不再共享数据路径。

影响
在启动时，Elasticsearch 会自动将数据路径迁移到新的布局。 如果数据路径包含多个节点的数据，此自动迁移将不会进行。 您应在升级前迁移到每个节点都有自己数据路径的配置。

如果您尝试升级一个在数据路径中包含多个节点数据的配置，那么自动迁移将会失败，Elasticsearch 将拒绝启动。要解决这个问题，您需要手动执行迁移。多余节点的数据存储在名为 ${path.data}/nodes/1、${path.data}/nodes/2 等的文件夹中，您应该将这些文件夹移动到适当的位置，然后配置相应的节点以使用此位置作为其数据路径。如果您的节点在 path.data 设置中每个都有多个数据路径，那么您应该同时移动所有相应的子文件夹。每个节点在其所有数据路径中使用相同的子文件夹（例如 nodes/2）。

详情
Elasticsearch 默认附带的 Maxmind geoip 数据库已被移除。这些数据库已过时且陈旧，使用这些数据库可能会导致 geoip 查找不准确。

自7.13版本起，默认情况下，如果在配置目录中未指定数据库或在geoip下载器下载geoip数据库之前，将使用这些预打包的geoip数据库。当geoip数据库下载器完成下载新数据库后，这些预打包的数据库将不再使用。

影响
如果禁用了geoip下载器，并且在每个摄取节点的配置目录中没有提供geoip数据库，那么geoip处理器将不再执行geoip查找，并将这些文档标记为请求的数据库不再可用。

在集群启动后且geoip下载器完成最新数据库下载之前，geoip处理器将不会执行任何geoip查找，并标记请求的数据库不可用。geoip下载器完成最新数据库下载后，geoip处理器将正常工作。集群启动后geoip处理器无法进行geoip查找的时间窗口应该非常小。

详情
作为从Joda日期时间到Java日期时间的过渡，脚本使用了一个称为JodaCompatibleZonedDateTime的中间类。该类已被移除，并被ZonedDateTime所取代。任何在脚本中使用强制转换到JodaCompatibleZonedDateTime或仅在JodaCompatibleZonedDateTime中可用的方法调用，都将导致编译错误，并且可能不允许升级后的节点启动。

影响
在升级之前，请在任何脚本中将 getDayOfWeek 替换为 getDayOfWeekEnum().value。任何期望返回值为 int 的 getDayOfWeek 使用都将导致编译错误或运行时错误，并且可能不允许升级后的节点启动。

以下 JodaCompatibleZonedDateTime 方法必须在升级前使用 ZonedDateTime 方法进行替换：

详情
在Elasticsearch的早期版本中，为了注册一个由Amazon S3、Google Cloud Storage (GCS)或Microsoft Azure Blob Storage支持的快照仓库，您首先需要安装相应的Elasticsearch插件，例如repository-s3。这些插件现在默认包含在Elasticsearch中。

影响
您不再需要安装以下插件，也不应尝试安装它们。

Elasticsearch 和 elasticsearch-plugin CLI 工具已更改，以容忍尝试安装和删除这些插件，以避免破坏任何现有的自动化。将来，尝试安装这些插件将会是一个错误。

具体来说，如果您尝试安装上述任何插件，elasticsearch-plugin CLI 工具不会失败，而是会打印一条警告并跳过这些插件。如果这些插件中的任何一个已经安装，例如因为您在运行旧版本的 Elasticsearch 时安装了它们，那么您仍然可以使用 elasticsearch-plugin 删除它们。如果尝试删除未安装的插件，操作将成功但会打印警告。

如果您使用 Docker 运行 Elasticsearch 并且使用配置文件管理插件，那么在升级后首次启动 Elasticsearch 时，如果这些插件已经安装，它将移除上述插件。如果这些插件中的任何一个在您的配置文件中被指定，Elasticsearch 将忽略它们并发出一条警告日志消息。

详情
在Elasticsearch的早期版本中，第三方插件可以通过实现getRestHandlerWrapper方法来拦截所有发送到节点的REST请求。这个功能的一个常见用途是实现自定义的安全插件来替代内置的安全功能。这个扩展点不再对第三方插件可用。

影响
一些为早期版本的 Elasticsearch 设计的第三方插件可能与 Elasticsearch 8.0 或更高版本不兼容。

如果你依赖于任何不是由Elastic生产和维护的插件，请与插件作者确认，并确保该插件适用于你的目标Elasticsearch版本，然后再进行升级。

详情
在7.0版本中，我们弃用了路径中包含_xpack的REST端点。这些端点在8.0版本中已被移除。每个被弃用并移除的端点都被一个新的端点所取代，新端点不包含_xpack。例如，/{index}/_xpack/graph/_explore被替换为/{index}/_graph/explore。

影响
使用替换的REST API端点。提交到_xpack API端点的请求将返回错误。

兼容性
当请求rest-api-compatibility时，任何包含`_xpack`前缀的请求都会被重定向到不带_xpack前缀的相应URL。

详情
映射类型已被移除。包含映射类型的API端点也已被移除。请改用无类型的端点。

影响
更新您的应用程序以使用无类型的REST API端点。请求包含映射类型的端点将返回错误。

兼容性
当请求rest-api-compatibility时，如果请求包含自定义映射类型，它将被忽略。请求将被重新路由到相应的无类型URL。请求体中的自定义映射类型和与类型相关的HTTP参数将被忽略，并且在适当的情况下，响应中将包含_type : _doc。

详情
在8.0+版本中，Elastic支持从本地集群到远程集群的搜索，运行：

Elastic 还支持从运行主要版本最后一个次版本的本地集群搜索到运行下一个主要版本任何次版本的远程集群。例如，本地 7.17 集群可以搜索任何远程 8.x 集群。

例如，本地 8.0 集群可以搜索远程 7.17 或任何远程 8.x 集群。然而，从本地 8.0 集群到远程 7.16 或 6.8 集群的搜索是不支持的。

之前，我们还支持在运行以下内容的远程集群上进行搜索：

然而，此类搜索可能会导致未定义的行为。

影响
如果您仅在使用相同或更新版本的远程集群上运行跨集群搜索，则无需进行任何更改。

如果您之前搜索过运行早期版本的 Elasticsearch 的远程集群，请参阅 确保跨集群搜索支持 以获取推荐的解决方案。

使用不支持配置的跨集群搜索可能仍然有效。然而，此类搜索未经过Elastic的测试，其行为不保证。

详情
terms 聚合不再支持在 order 值中使用 _term 键。要按术语对桶进行排序，请改用 _key。

影响
停止使用 _term 排序键。包含 _term 排序键的请求将返回错误。

兼容性
当请求rest-api-compatibility时，_term顺序被忽略，改为使用key。

详情
date_histogram 聚合不再支持在 order 值中使用 _time 键。要按桶的键排序，请改用 _key。

影响
停止使用 _time 排序键。包含 _time 排序键的请求将返回错误。

兼容性
当请求rest-api-compatibility时，_time顺序被忽略，改为使用_key。

详情
moving_avg 聚合在6.4版本中已被弃用并已被移除。要计算移动平均值，请使用 moving_fn 聚合。

影响
停止使用 moving_avg 聚合。包含 moving_avg 聚合的请求将返回错误。

详情
如果你在百分位数聚合中指定了百分比参数，其值必须是唯一的。否则，会发生异常。

影响
在 percentiles 聚合的 percents 参数中使用唯一值。 包含重复值的请求将在 percents 参数中返回错误。

详情
现在指定interval参数给 date_histogram 聚合或 https://www.elastic.co/guide/en/elasticsearch/reference/master/search-aggregations-bucket-composite-aggregation.html#_date_histogram[composite date_histogram源。 请改用calendar_interval或 fixed_interval。

影响
在date_histogram聚合或date_histogram复合源中使用interval参数将生成错误。请改用更具体的fixed_interval或calendar_interval参数。

兼容性
当请求rest-api-compatibility时，interval参数会被调整为固定或日历间隔。

详情
自版本6.4以来已弃用的nGram和edgeNGram分词过滤器名称已被移除。自版本7.0以来，这两个分词过滤器只能通过它们的替代名称ngram和edge_ngram使用。

影响
使用等效的 ngram 和 edge_ngram 分词过滤器。包含 nGram 和 edgeNGram 分词过滤器名称的请求将返回错误。

详情
nGram 和 edgeNGram 分词器名称在7.6版本中已被弃用，并且在新索引上不再支持。7.6版本之后创建的索引的映射将继续工作，但会发出弃用警告。对于新索引和索引模板，分词器名称应更改为完全等效的 ngram 或 edge_ngram 名称。

影响
使用 ngram 和 edge_ngram 分词器。请求创建新索引时使用 nGram 和 edgeNGram 分词器名称将会返回错误。

详情
日志输出和诊断API（如节点状态API）中正在进行的请求断路器的名称从in_flight_requests更改为inflight_requests，以与相应设置的名称保持一致。

影响
更新您的工作流程和应用程序以使用 inflight_requests 统计信息代替 in_flight_requests。

详情
POST /_cluster/voting_config_exclusions/{node_filter} API 已被移除，取而代之的是 POST /_cluster/voting_config_exclusions?node_names=... 和 POST /_cluster/voting_config_exclusions?node_ids=...，它们允许您指定要排除的节点的名称或ID。

影响
使用 POST /_cluster/voting_config_exclusions?node_ids=... 并指定要排除的节点，而不是使用节点过滤器。提交到 /_cluster/voting_config_exclusions/{node_filter} 端点的请求将返回错误。

详情
与自动跟随模式匹配的远程系统索引不会自动配置为跟随者索引。

影响
如果这是所需的行为，请显式创建一个跟随索引以跟随远程系统索引。

详情
wildcard 函数在 Elasticsearch 7.13.0 中已被弃用并已被移除。

影响
使用 like 或 regex 关键词 代替。

详情
ILM冻结操作现在是一个无操作，不会对索引执行任何操作，因为在8.0中已移除冻结API端点。

影响
更新您的ILM策略以从冷阶段中移除冻结操作。

详情
创建或更新ILM策略现在要求任何引用的快照存储库和SLM策略都必须存在。

影响
更新您的代码或配置管理，以确保在引用它们的任何策略之前创建存储库和SLM策略。

详情
以前，_upgrade API 用于将索引从上一个主要版本升级到当前版本。现在应该使用 _reindex API 来实现这一目的。

影响
对旧的 _upgrade API 的请求将返回错误。

详情
冻结索引 API (POST //_freeze) 已被移除。 堆内存使用的改进 已经消除了冻结索引的原因。 您仍然可以使用 解冻索引 API 解冻现有的冻结索引。对于某些用例，冻结层可能是冻结索引的合适替代品。有关更多信息，请参阅 数据层。

影响
对旧的冻结索引 API 的请求将返回错误。

详情
之前，force merge API允许参数only_expunge_deletes和max_num_segments同时设置为非默认值。但是当only_expunge_deletes设置为true时，max_num_segments会被静默忽略，给人留下已经应用的错误印象。

影响
在使用强制合并 API时，不要同时为max_num_segments和only_expunge_deletes参数指定值。 包含这两个参数值的请求将返回错误。

详情
在6.0版本中，我们弃用了在创建或更新索引模板请求中使用的template参数，转而使用index_patterns。现在，在8.0版本中，template参数的支持已被移除。

影响
使用创建或更新索引模板 API的 index_patterns参数。包含template参数的请求将返回错误。

兼容性
当请求rest-api-compatibility时，template参数被映射到index_patterns。

详情
同步刷新在7.6版本中已被弃用，并在8.0版本中被移除。请改用常规刷新，因为它在7.6及以后的版本中具有与同步刷新相同的效果。

影响
使用 flush API。对 //flush/synced 或 /flush/synced 端点的请求将返回错误。

兼容性
当请求rest-api-compatibility时，同步刷新请求会被路由到等效的非同步刷新URL。

详情
在早期版本中，关闭索引时，Elasticsearch 默认不会等待关闭索引的分片被正确分配后再返回。从 8.0 版本开始，默认行为是根据 index.write.wait_for_active_shards 索引设置等待分片被分配。

影响
接受新的行为，或者指定 ?wait_for_active_shards=0 以在需要时保留旧的行为。

详情
索引统计API的types查询参数已被移除。以前，您可以结合types与indexing查询参数来返回特定映射类型的索引统计信息。映射类型已在8.0中被移除。

影响
停止使用types查询参数。包含该参数的请求将返回错误。

兼容性
当请求rest-api-compatibility时，types查询参数将被忽略，并且会返回整个索引的统计信息。

详情
在7.2版本中，我们弃用了user_agent摄取处理器中的ecs参数。 在8.x版本中，user_agent摄取处理器将仅返回Elastic Common Schema (ECS)字段，无论ecs值如何。

影响
为避免弃用警告，请从您的摄取管道中移除该参数。 如果管道指定了ecs值，该值将被忽略。

详情
include_type_name 查询参数已从索引创建、索引模板和映射API中移除。以前，您可以将 include_type_name 设置为 true，以指示请求和响应应包含映射类型名称。映射类型已在8.x中移除。

影响
停止使用include_type_name查询参数。包含该参数的请求将返回错误。

兼容性
当请求rest-api-compatibility时，include_type_name查询参数被忽略，并且请求中的任何自定义映射类型都会被移除。

详情
从远程重新索引之前允许使用URL编码的索引名称，并且在生成远程主机的搜索请求时不重新编码它们。这种宽松性已被移除，因此在重新索引生成远程搜索请求时，所有索引名称都会被正确编码。

影响
为远程请求的重索引指定未编码的索引名称。

详情
之前，一个 _reindex 请求在请求体中有两个不同的尺寸规格：

外层级别的 size 参数现在已重命名为 max_docs，以避免混淆并明确其语义。

同样地，size 参数已重命名为 max_docs，以保持 _delete_by_query 和 _update_by_query 这三个接口的一致性。

影响
使用替换参数。包含size参数的请求将返回错误。

兼容性
当请求rest-api-compatibility时，size参数被映射到max_docs参数。

详情
一个包含不支持字段的更新查询API请求现在会返回错误。以前，API会默默忽略这些不支持的字段。

影响
为了避免错误，请从script对象中移除不支持的字段。

详情
?local 参数在 7.x 版本中已被弃用，并在 8.0 版本中被拒绝。此参数导致 API 使用本地集群状态来确定由 API 返回的节点，而不是从主节点获取的集群状态，但此 API 请求信息来自每个选定的节点，无论 ?local 参数如何，这意味着此 API 不能完全以节点本地方式运行。

影响
停止使用?local查询参数。包含此参数的cat node API请求将返回错误。

详情
?local 参数在 7.x 版本中已被弃用，并在 8.0 版本中被拒绝使用。该参数导致 API 使用本地集群状态来确定由 API 返回的节点，而不是从主节点获取集群状态，但此 API 请求信息来自每个选定的节点，无论是否使用 ?local 参数，这意味着此 API 不能完全以节点本地方式运行。

影响
停止使用?local查询参数。包含此参数的cat shards API请求将返回错误。

详情
?local 参数在 7.x 版本中已被弃用，并在 8.0 版本中被拒绝使用。该参数导致 API 使用本地集群状态来确定由 API 返回的节点，而不是从主节点获取的集群状态，但此 API 请求信息来自每个选定的节点，无论是否使用 ?local 参数，这意味着此 API 并未完全以节点本地方式运行。

影响
停止使用?local查询参数。包含此参数的cat indices API请求将返回错误。

详情
get field mapping API 的 local 参数在 7.8 版本中已被弃用，并在 8.0 版本中被移除。此参数已无操作，字段映射始终在本地检索。

影响
停止使用local查询参数。 获取字段映射API请求中包含此参数将返回错误。

详情
机器学习 向作业发送数据 API 从 7.11.0 开始已弃用，并将在未来的主要版本中移除。

影响
使用 datafeeds 替代。

详情
在7.3.0中，更新数据馈送中的job_id的功能已被弃用，并在8.0中被移除。

影响
无法在异常检测作业之间移动数据馈送。

详情
创建或更新快照仓库 API 和 删除快照仓库 API 在请求尝试修改现有仓库时返回 409 状态码，而不是状态码 500。

影响
更新处理仓库创建和删除的客户端代码以反映此更改。

详情
allow_no_datafeeds 属性在 7.10.0 版本的 cat datafeeds、 get datafeeds、 get datafeed statistics 和 stop datafeeds API 中已被弃用。

影响
使用 allow_no_match 代替。

详情
allow_no_jobs 属性在 7.10.0 中已被弃用，涉及的 API 包括： cat 异常检测器、 关闭异常检测作业、 获取异常检测作业、 获取异常检测作业统计信息 和 获取整体桶。

影响
使用 allow_no_match 代替。

详情
之前，尝试启动一个已经启动的汇总作业会导致500 InternalServerError: 无法启动汇总作业[job]，因为状态为[STARTED]异常。

现在，尝试启动一个已经启动的任务将只会返回一个成功的200 OK: 已启动响应。

影响
更新您的流程和应用程序，以假设在尝试启动汇总作业时，响应中的200状态码表示作业处于活动启动状态。请求本身可能已经启动了作业，或者作业之前已经在运行，因此请求没有产生效果。

详情
创建或更新存储脚本 API的 source参数不能为空。

影响
在升级之前，使用删除存储脚本API删除任何空的存储脚本或搜索模板。 在8.0中，Elasticsearch将从集群状态中删除任何空的存储脚本或空的搜索模板。 创建存储脚本或搜索模板的请求如果带有空的source将返回错误。

详情
创建或更新存储脚本 API的 code 参数已被移除。请改用 source 参数。

影响
停止使用code参数。包含该参数的请求将返回错误。

详情
在8.x版本中，_type元数据字段已被移除。Elasticsearch现在将_type字段上的搜索视为对不存在的字段的搜索。对不存在的字段的搜索不会匹配任何文档，无论查询字符串是什么。

在7.x版本中，在_type字段中搜索_doc将与match_all查询匹配相同的文档。

影响
从您的搜索请求和搜索模板中移除对_type字段的查询。包含这些查询的搜索可能会返回无结果。

详情
当您提供一个文本文件作为请求体时，例如在使用curl的--data-binary标志时，多搜索API现在会将空的第一行解析为空的行动元数据。

该API不再支持包含以下内容的文本文件：

影响
不要向多搜索API提供不支持的文本文件。包含不支持文件的请求将返回错误。

详情
搜索请求不再支持 unmapped_type: string 排序选项。 相反，使用 unmapped_type: keyword 将未映射的字段视为具有 keyword 字段类型，但在排序时忽略其值。

影响
停止使用 unmapped_type: string。包含 unmapped_type: string 排序选项的搜索请求将返回分片失败。

详情
以前，可以通过加载称为fielddata的昂贵数据结构来对内置的_id字段进行聚合和排序。这在7.6中已被弃用，现在在8.0中默认被禁止。

影响
应避免对_id进行聚合和排序。作为替代方案，可以将_id字段的内容复制到另一个启用了docvalues的字段中（注意，这不适用于自动生成的ID）。

详情
在7.x中已弃用的common查询，在8.0中已被移除。 如果不需要跟踪总命中数，可以通过match查询实现相同的功能。

影响
停止使用common查询。包含common查询的搜索请求将返回错误。

详情
在7.x中已弃用的cutoff_frequency参数，已在8.0中从match和multi_match查询中移除。 如果不需要跟踪总命中数，则无需任何配置即可实现相同的功能。

影响
停止使用cutoff_frequency参数。在match或multi_match查询中包含此参数的搜索请求将返回错误。

详情
nested_filter 和 nested_path 选项在 6.x 中已被弃用，现已被移除，取而代之的是 nested 上下文。

影响
停止使用 sort 请求体参数中的 nested_filter 和 nested_path 属性。包含这些属性的请求将返回错误。

详情
Elasticsearch 将不再优先使用位于同一位置（具有相同感知属性值）的分片来处理 _search 和 _get 请求。自适应副本选择（在此版本中默认激活）将使用先前节点间通信的服务时间更高效地路由请求。

影响
无需采取行动。

详情
形式为 function(query, doc['field']) 的向量函数在 7.6 版本中已被弃用，并在 8.x 版本中被移除。应使用形式 function(query, 'field') 代替。例如，cosineSimilarity(query, doc['field']) 被替换为 cosineSimilarity(query, 'field')。

影响
使用 function(query, 'field') 形式。停止使用 function(query, doc['field']) 形式。包含 function(query, doc['field']) 形式的请求将返回错误。

详情
搜索请求中的indices_boost选项过去既可以接受对象格式，也可以接受数组格式。对象格式自5.2版本起已被弃用，现在在8.0版本中已被移除。

影响
仅在 indices_boost 参数中使用数组值。包含对象值的请求将返回错误。

详情
在7.0版本中，我们开始使用每个字段的映射定义来默认格式化docvalue_fields。为了简化从6.x版本的过渡，我们添加了格式选项use_field_mapping。此参数在7.0版本中已被弃用，并在8.0版本中被移除。

影响
停止使用 use_field_mapping 请求体参数。包含此参数的请求将返回错误。

兼容性
当请求rest-api-compatibility时，use_field_mapping参数将被忽略。

详情
搜索请求过去接受 -1 作为搜索体和URL中的 from 值，并将其视为默认值0。其他负值已经被拒绝并返回错误。我们现在也拒绝 -1 作为无效值。

影响
将请求体或URL参数中任何使用-1作为from参数的情况更改为0或完全省略它。包含负值的请求将返回错误。

详情
日期字段上的范围查询过去会错误地将小数字（例如像1000这样的四位数）解释为年份，当没有设置额外的格式时，但会将其他数值解释为自纪元以来的毫秒数。我们现在在没有特定format参数的情况下，将所有数值视为自纪元以来的毫秒数。如果你想查询年份，在没有format的情况下，现在需要将输入值加上引号（例如 "1984"）。

影响
如果你查询日期字段时没有指定format，检查你的查询值是否实际上是自纪元以来的毫秒数，并在这种情况下使用数值。如果不是，请使用字符串值，该值将由映射中字段设置的日期格式或默认情况下由strict_date_optional_time解析。

详情
geo_bounding_box 查询的 type 参数在 7.14.0 版本中已被弃用，并在 8.0.0 版本中被移除。此参数为无操作，对查询没有影响。

影响
停止使用type参数。包含此参数的geo_bounding_box查询将返回错误。

详情
type 查询已被移除。映射类型已在8.0中移除。

影响
停止使用type查询。包含type查询的请求将返回错误。

详情
之前被分配了kibana_user角色的用户应改为分配kibana_admin角色。此角色授予与kibana_user相同的权限集，但已重命名以更好地反映其预期用途。

影响
将具有kibana_user角色的用户分配到kibana_admin角色。 停止使用kibana_user角色。

详情
对于快照和SLM API，indices参数不再解析为系统索引或系统数据流。 功能状态现在是唯一的方式 从快照备份和恢复系统索引或系统数据流。

您不能再使用 indices 参数来为 创建 SLM 策略 API 或 创建快照 API 包含系统索引。 要备份系统索引，请使用 include_global_state 和 feature_states 参数来包含相应的功能状态。 默认情况下，include_global_state 和 feature_states 参数包含所有系统索引。

同样地，您不能再使用恢复快照API的indices参数从快照中恢复系统索引。要恢复系统索引，请使用include_global_state和feature_states参数来恢复相应的功能状态。默认情况下，include_global_state和feature_states参数不会恢复任何系统索引。

影响
如果您之前使用 indices 参数来备份或恢复系统索引，请更新您的 SLM 策略和应用程序，改为使用 include_global_state 和 feature_states 参数。

在indices参数中明确指定系统索引的SLM策略将无法创建快照。同样，在indices参数中明确指定系统索引的创建快照API或恢复快照API请求将失败并返回错误。如果indices值包含通配符(*)模式，该模式将不再匹配系统索引。

详情
之前，compress 的默认值是 false。现在默认值已更改为 true。

此更改将影响新创建的仓库和未明确指定 compress=false 的现有仓库。

影响
更新你的工作流程和应用程序，假设compress参数的默认值为true。

详情
从版本7.4开始，s3快照仓库不再默认使用现已弃用的路径样式访问模式。在版本7.0、7.1、7.2和7.3中，s3快照仓库始终使用路径样式访问模式。对于仅支持路径样式访问但被AWS SDK识别为支持DNS样式访问的部署，这是一个重大更改。这一重大更改是必要的，因为AWS宣布路径样式访问模式已被弃用，并且在2020年9月30日之后创建的存储桶将不再支持该模式。

影响
如果你的部署仅支持路径样式访问并且受到此更改的影响，那么你必须将S3客户端设置path_style_access配置为true。

详情
在早期版本中，您可以在恢复快照请求的正文中传递settings和index_settings，但settings值被忽略了。现在，恢复快照API会拒绝包含settings值的请求。

影响
停止在恢复快照请求中使用settings参数。包含这些参数的请求将返回错误。

详情
仓库统计 API 已被移除。我们在 7.10.0 版本中弃用了这个实验性 API。

影响
使用 repositories metering APIs 代替。

详情
在8.x版本中，Elasticsearch将Watcher历史记录写入到一个隐藏的 .watcher-history- 数据流中。之前，Elasticsearch将Watcher历史记录写入到隐藏的 .watcher-history-- 索引中。

影响
更新您的请求以针对 Watcher 历史数据流。例如，使用 .watcher-history-* 通配符表达式。专门针对不存在的 Watcher 历史索引的请求可能会返回错误。

详情
集群健康 API 包括等待某些健康条件满足的选项。如果在超时时间内未满足请求的条件，Elasticsearch 将返回一个包含字段 "timed_out": true 的正常响应。在早期版本中，如果请求超时，它还会使用 HTTP 响应代码 408 Request timeout，否则使用 200 OK。408 Request timeout 响应代码不适用于这种情况，因此从版本 8.0.0 开始，Elasticsearch 将在两种情况下都使用响应代码 200 OK。

影响
要检测服务器超时，请检查JSON响应中的timed_out字段。

详情
为了减少JDBC驱动程序对Elasticsearch类的依赖，JDBC驱动程序返回几何数据时使用WKT（熟知文本）格式作为字符串，而不是使用org.elasticsearch.geometry中的类。用户可以选择所需的几何库将字符串表示转换为完整的对象，例如elasticsearch-geo库（以前返回org.elasticsearch.geo对象）、jts或spatial4j。

影响
在升级之前，请将 ResultSet#getObject 或 ResultSet#setObject 中的任何 org.elasticsearch.geo 类替换为其WKT表示形式，只需调用 toString 或 org.elasticsearch.geometry.utils.WellKnownText#toWKT/fromWKT 方法。

此更改不会影响不使用几何类的用户。

详情
以下操作系统已达到其生命周期终点，不再受Elasticsearch支持：

我们也移除了对 SysV init 的支持。没有支持的操作系统使用 SysV init 进程。

详情
确保您的节点使用 受支持的操作系统。 在不受支持的操作系统上运行Elasticsearch可能会导致意外错误或故障。

详情
运行Elasticsearch及其任何命令行工具现在需要Java 17或更高版本。

影响
使用 Java 17 或更高版本。尝试使用较早的 Java 版本运行 Elasticsearch 8.0 将会失败。

目前还没有适用于 Java 17 的 FIPS 认证安全模块， 当您在 FIPS 140-2 模式下运行 Elasticsearch 8.0 时可以使用。 如果您在 FIPS 140-2 模式下运行，您将需要向您的安全组织申请例外 以升级到 Elasticsearch 8.0， 或者在 Java 17 获得认证之前继续使用 Elasticsearch 7.x。

详情
JAVA_HOME 不再支持用于设置JDK路径。请改用捆绑的JDK（推荐），或者设置 ES_JAVA_HOME。

影响
使用捆绑的JDK（首选），或者设置ES_JAVA_HOME。JAVA_HOME将被忽略。

详情
早期测试版本的转换工具使用了不再支持的配置信息格式。

影响
使用 升级转换 API 来修复您的转换。此升级不会影响源索引或目标索引。

详情
我们不再推荐使用瞬态集群设置。请改用持久集群设置。如果集群变得不稳定，瞬态设置可能会意外清除，导致不希望的集群配置。

影响
瞬态集群设置尚未被弃用，但我们计划在未来的版本中弃用它们。有关迁移步骤，请参阅瞬态设置迁移指南。

详情
elasticsearch-setup-passwords 工具在 8.0 中已被弃用。要手动重置内置用户（包括 elastic 用户）的密码，请使用 elasticsearch-reset-password 工具、Elasticsearch 更改密码 API 或 Kibana 中的用户管理功能。 elasticsearch-setup-passwords 将在未来的版本中被移除。

影响
当你第一次启动Elasticsearch时，会自动为elastic用户生成密码。如果你在启动Elasticsearch后运行elasticsearch-setup-passwords，它将会失败，因为elastic用户的密码已经配置好了。