Java 时间迁移指南
编辑Java 时间迁移指南编辑
从 7.0 版本开始，Elasticsearch 将日期相关的解析、格式化和计算从 joda 时间切换到 java 时间。本指南旨在帮助您确定您的集群是否受到影响，以及如何为升级做好准备。
转换日期格式编辑
要升级到 Elasticsearch 8，您需要将所有 joda 时间日期格式转换为其 java 时间等效格式。
受影响的功能编辑
切换到 java 时间只影响自定义的 date 和 date_nanos 格式。
这些格式通常用于
如果您不使用自定义日期格式，则可以跳过本指南的其余部分。大多数自定义日期格式都是兼容的。但是，一些格式需要更新。
要查看您的日期格式是否受到影响，请使用 弃用信息 API 或 Kibana 升级助手。
不兼容的日期格式编辑
包含以下 joda 时间字面量的自定义日期格式应该进行迁移。
-
Y(纪元年) -
替换为
y。示例：
YYYY-MM-dd应该变为yyyy-MM-dd。在 java 时间中，
Y用于 基于周的年份。使用Y代替y可能会导致年份计算出现偏差。对于模式
YYYY-ww和日期2019-01-01T00:00:00.000Z将给出2019-01。对于模式YYYY-ww和日期2018-12-31T00:00:00.000Z将给出2019-01（不直观），因为 2019 年有超过 4 天属于这一周。 -
y(年份) -
替换为
u。示例：
yyyy-MM-dd应该变为uuuu-MM-dd。在 java 时间中，
y用于纪元年。u可以包含非正值，而y则不能。y也可以与纪元字段相关联。 -
C(纪元世纪) -
java 时间不支持纪元世纪。没有替代方案。建议您预处理输入。
-
x(周年份) -
替换为
Y。在 java 时间中，
x表示 时区偏移量。未能正确将
x(周年份) 转换为Y可能会导致数据丢失。 -
Z(时区偏移量/ID) -
替换为多个
X。Z在 java 时间中具有类似的含义。但是，java 时间期望不同的字面量数量来解析不同的形式。考虑迁移到
X，它可以让您更好地控制时间解析方式。例如，joda 时间格式YYYY-MM-dd'T'hh:mm:ssZZ接受以下日期2010-01-01T01:02:03Z 2010-01-01T01:02:03+01 2010-01-01T01:02:03+01:02 2010-01-01T01:02:03+01:02:03
在 java 时间中，您无法使用单个格式解析所有这些日期。相反，您必须指定 3 个单独的格式
2010-01-01T01:02:03Z 2010-01-01T01:02:03+01 both parsed with yyyy-MM-dd'T'hh:mm:ssX 2010-01-01T01:02:03+01:02 yyyy-MM-dd'T'hh:mm:ssXXX 2010-01-01T01:02:03+01:02:03 yyyy-MM-dd'T'hh:mm:ssXXXXX
然后，必须使用
||分隔这些格式yyyy-MM-dd'T'hh:mm:ssX||yyyy-MM-dd'T'hh:mm:ssXXX||yyyy-MM-dd'T'hh:mm:ssXXXXX
如果您期望模式不包含冒号 (
:)，则同样适用：例如，YYYY-MM-dd'T'hh:mm:ssZ格式接受以下日期形式2010-01-01T01:02:03Z 2010-01-01T01:02:03+01 2010-01-01T01:02:03+0102 2010-01-01T01:02:03+010203
要在 java 时间中接受所有这些形式，您必须使用
||分隔符yyyy-MM-dd'T'hh:mm:ssX||yyyy-MM-dd'T'hh:mm:ssXX||yyyy-MM-dd'T'hh:mm:ssXXXX
-
d(日期) -
在 java 时间中，
d仍然被解释为“日期”，但灵活性较低。例如，joda 时间日期格式
YYYY-MM-dd接受2010-01-01或2010-01-1。在 java 时间中，您必须使用
||分隔符来指定每个格式yyyy-MM-dd||yyyy-MM-d
在 java 时间中，
d也不接受超过 2 位数字。要接受超过两位数字的日期，您必须在 java 时间日期格式中包含文本字面量。例如，要解析2010-01-00001，您必须使用以下 java 时间日期格式yyyy-MM-'000'dd
-
e(星期几名称) -
在 java 时间中，
e仍然被解释为“星期几名称”，但不会解析简短或完整文本形式。例如，joda 时间日期格式
EEE YYYY-MM接受Wed 2020-01和Wednesday 2020-01。要在 java 时间中接受这两个日期，您必须使用
||分隔符指定每个格式cccc yyyy-MM||ccc yyyy-MM
joda 时间字面量
E被解释为“星期几”。java 时间字面量c被解释为“本地化星期几”。E不会接受完整文本日期格式，例如Wednesday。 -
EEEE和类似的文本形式 -
对完整文本形式的支持取决于与您的 Java 开发工具包 (JDK) 一起提供的区域设置数据和其他实现细节。建议您在升级之前仔细测试包含这些模式的格式。
-
z(时区文本) -
在 java 时间中，
z在给定 UTC 时区时输出 Z 表示 Zulu。
使用您的数据进行测试编辑
强烈建议您在生产环境中部署之前，使用真实数据测试任何日期格式更改。
更新索引映射编辑
要更新索引映射中的 joda 时间日期格式，您必须创建一个包含更新映射的新索引，并将您的数据重新索引到该索引中。
以下 my-index-000001 索引包含 datetime 字段的映射，这是一个使用自定义 joda 时间日期格式的 date 字段。
response = client.indices.get_mapping( index: 'my-index-000001' ) puts response
GET my-index-000001/_mapping
{
"my-index-000001" : {
"mappings" : {
"properties" : {
"datetime": {
"type": "date",
"format": "yyyy/MM/dd HH:mm:ss||yyyy/MM/dd||epoch_millis"
}
}
}
}
}
要更改 datetime 字段的日期格式，请创建一个包含更新映射和日期格式的单独索引。
例如，以下 my-index-000002 索引将 datetime 字段的日期格式更改为 uuuu/MM/dd HH:mm:ss||uuuu/MM/dd||epoch_millis。
response = client.indices.create(
index: 'my-index-000002',
body: {
mappings: {
properties: {
datetime: {
type: 'date',
format: 'uuuu/MM/dd HH:mm:ss||uuuu/MM/dd||epoch_millis'
}
}
}
}
)
puts response
PUT my-index-000002
{
"mappings": {
"properties": {
"datetime": {
"type": "date",
"format": "uuuu/MM/dd HH:mm:ss||uuuu/MM/dd||epoch_millis"
}
}
}
}
接下来，将数据从旧索引重新索引到新索引。
以下 重新索引 API 请求将数据从 my-index-000001 重新索引到 my-index-000002。
response = client.reindex(
body: {
source: {
index: 'my-index-000001'
},
dest: {
index: 'my-index-000002'
}
}
)
puts response
POST _reindex
{
"source": {
"index": "my-index-000001"
},
"dest": {
"index": "my-index-000002"
}
}
如果您使用索引别名，请将它们更新为指向新索引。
POST /_aliases
{
"actions" : [
{ "remove" : { "index" : "my-index-000001", "alias" : "my-index" } },
{ "add" : { "index" : "my-index-000002", "alias" : "my-index" } }
]
}