迁移到 8.13
编辑迁移到 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_nan
、is_finite
和 is_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
字段。