迁移到 8.13

编辑

本节讨论将应用程序迁移到 Elasticsearch 8.13 时需要注意的更改。

另请参阅 8.17 中的新功能发行说明

即将在 8.13.0 中推出。

重大更改

编辑

8.13 中没有重大更改。

值得注意的更改

编辑

以下是需要注意的重要的非破坏性更新

  • 技术预览版功能的变化。
  • 日志格式的更改。
  • 非公共 API 的更改。
  • 修复严重错误的的行为更改。

索引设置更改

编辑
index.look_ahead_time 索引设置的默认值从 2 小时更改为 30 分钟。

详细信息
index.look_ahead_time 索引设置的最大值从 2 小时降低到 30 分钟。

影响
@timestamp 在未来 30 分钟或更长时间的文档将被拒绝。之前,@timestamp 在未来 2 小时或更长时间的文档将被拒绝。如果应保留先前的行为,则在执行升级之前将 index.look_ahead_time 设置更新为两个小时。

降低 look_ahead_time 索引设置的最大值

详细信息
look_ahead_time 索引设置的最大值从 7 天降低到 2 小时。

影响
任何介于 2 小时和 7 天之间的值都将按定义的 2 小时提前时间计算

REST API 更改

编辑
ESQL:语法 - FROM METADATA 不再需要 []

详细信息
删除 FROM 命令语句中 METADATA 选项的 [ ]

影响
以前,要返回元数据字段,必须使用方括号:(例如,FROM index [METADATA _index])。现在不再需要了:[ ] 被删除,无需指定,从而将上面的命令简化为:'FROM index METADATA _index'。

ES|QL:从语法中删除 PROJECT 关键字

详细信息
从 ES|QL 语法中删除 PROJECT 关键字(KEEP 的别名)

影响
在此更改之前,用户可以在 ESQL 查询中使用 PROJECT 作为 KEEP 的别名,(例如,FROM idx | PROJECT name, surname),解析器将 PROJECT 替换为 KEEP,发出警告:不再支持 PROJECT 命令,请改用 KEEP,并且查询正常执行。进行此更改后,查询解析器不再识别 PROJECT 命令;现在使用 PROJECT 命令的查询会返回解析异常。

[ESQL] 删除 is_nan、is_finite 和 is_infinite

详细信息
删除函数 is_nanis_finiteis_infinite

影响
尝试使用上述函数现在会产生计划器时间错误。不再支持这些功能。

弃用

编辑

以下功能在 Elasticsearch 8.13 中已弃用,并将在未来的版本中删除。虽然这不会对您的应用程序产生直接影响,但我们强烈建议您在升级到 8.13 后采取所述步骤来更新您的代码。

要查找您是否正在使用任何已弃用的功能,请启用 弃用日志记录

集群和节点设置弃用

编辑
弃用 client.type

详细信息
自 8.0 版本中删除了节点客户端以来,节点设置 client.type 一直被忽略。该设置现在已被弃用,并将在未来的版本中删除。

影响
elasticsearch.yml 中删除 client.type 设置

REST API 弃用

编辑
DesiredNode: 弃用 node_version 字段并使其对于当前版本是可选的

详细信息
desired_node API 包括一个 node_version 字段,用于对所需的新节点版本执行验证。这种类型的检查过于宽泛,最好由外部逻辑完成,因此已将其删除,使得 node_version 字段不再必要。该字段将在以后的版本中删除。

影响
用户应更新其 desired_node 的用法,不再包括 node_version 字段。