Java 时间迁移指南
编辑Java 时间迁移指南
编辑从 7.0 版本开始，Elasticsearch 将日期相关的解析、格式化和计算从 joda time 切换到了 java time。本指南旨在帮助您确定您的集群是否受到影响，以及如果受到影响，如何准备升级。
转换日期格式
编辑要升级到 Elasticsearch 8，您需要将所有 joda-time 日期格式转换为其 java-time 等价格式。
受影响的功能
编辑切换到 java time 仅会影响自定义的 date 和 date_nanos 格式。
这些格式通常用于
如果您不使用自定义日期格式，则可以跳过本指南的其余部分。大多数自定义日期格式都是兼容的。但是，一些需要更新。
要查看您的日期格式是否受到影响，请使用 弃用信息 API 或 Kibana 升级助手。
不兼容的日期格式
编辑包含以下 joda-time 字面量的自定义日期格式应进行迁移。
-
Y（时代年） -
替换为
y。示例：
YYYY-MM-dd应变为yyyy-MM-dd。在 java time 中，
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 time 中，
y用于时代年。u可以包含非正值，而y则不能。y也可以与时代字段相关联。 -
C（时代世纪） -
时代世纪在 java time 中不受支持。没有替换项。我们建议您预处理您的输入。
-
x（周年份） -
替换为
Y。在 java time 中，
x表示 时区偏移量。未能正确将
x（周年份）转换为Y可能会导致数据丢失。 -
Z（时区偏移量/ID） -
替换为多个
X。Z在 java time 中具有类似的含义。但是，java time 期望不同的字面量数量来解析不同的形式。考虑迁移到
X，它可以让您更好地控制如何解析时间。例如，joda-time 格式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 time 中，您无法使用单个格式解析所有这些日期。相反，您必须指定 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 time 中接受所有这些形式，您必须使用
||分隔符yyyy-MM-dd'T'hh:mm:ssX||yyyy-MM-dd'T'hh:mm:ssXX||yyyy-MM-dd'T'hh:mm:ssXXXX
-
d（日期） -
在 java time 中，
d仍然解释为“日期”，但灵活性较差。例如，joda-time 日期格式
YYYY-MM-dd接受2010-01-01或2010-01-1。在 java time 中，您必须使用
||分隔符来指定每个格式yyyy-MM-dd||yyyy-MM-d
在 java time 中，
d也不接受超过两位数字。要接受超过两位数字的日期，您必须在 java-time 日期格式中包含文本字面量。例如，要解析2010-01-00001，您必须使用以下 java-time 日期格式yyyy-MM-'000'dd
-
e（日期名称） -
在 java time 中，
e仍然解释为“日期名称”，但不解析简写或完整文本形式。例如，joda-time 日期格式
EEE YYYY-MM同时接受Wed 2020-01和Wednesday 2020-01。要在 java time 中接受这两个日期，您必须使用
||分隔符指定每个格式cccc yyyy-MM||ccc yyyy-MM
joda-time 字面量
E解释为“星期几”。java-time 字面量c解释为“本地化星期几”。E不接受完整文本日期格式，例如Wednesday。 -
EEEE和类似文本形式 -
对完整文本形式的支持取决于随您的 Java 开发工具包 (JDK) 提供的区域设置数据和其他实现细节。我们建议您在升级之前仔细测试包含这些模式的格式。
-
z（时区文本） -
在 java time 中，
z在给定 UTC 时区时输出 *Z* 表示 Zulu。
使用您的数据进行测试
编辑我们强烈建议您在生产环境中部署之前，使用实际数据测试任何日期格式更改。
更新索引映射
编辑要更新索引映射中的 joda-time 日期格式，您必须使用更新的映射创建一个新的索引，并将您的数据重新索引到其中。
以下 my-index-000001 索引包含 datetime 字段的映射，这是一个带有自定义 joda-time 日期格式的 date 字段。
resp = client.indices.get_mapping(
index="my-index-000001",
)
print(resp)
response = client.indices.get_mapping( index: 'my-index-000001' ) puts response
const response = await client.indices.getMapping({
index: "my-index-000001",
});
console.log(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" } }
]
}