简介
官网地址:https://www.elastic.co/guide/en/elasticsearch/reference/current/coerce.html#coerce
在实际的使用中,数据并不总是正确的。 根据产生方式的不同,数字可能会在 JSON 主体中呈现为真实的 JSON 数字,例如 5,但也可能呈现为字符串,例如 “5”。 或者将整数的数字呈现为浮点数,例如 5.0,甚至是 “5.0”。
coerce 尝试清除不匹配的数值以适配字段的数据类型。 例如:
- 字符串将被强制转换为数字,比如 "5" 转换为整型数值5
- 浮点将被截断为整数值,比如 5.0 转换为整型值5
PUT my_index
{
"mappings": {
"properties": {
"number_one": {
"type": "integer"
},
"number_two": {
"type": "integer",
"coerce": false
}
}
}
}
PUT my_index/_doc/1
{
"number_one": "10"
}
PUT my_index/_doc/2
{
"number_two": "10"
}
在上面的例子中,我们定义 number_one 为 integer 数据类型,但是它没有属性 coerce 为 false,那么当我们把 number_one 赋值为"10",也就是一个字符串,那么它自动将"10"转换为整型值10。针对第二字段 number_two,它同样被定义为证型值,但是它同时也设置 coerce 为 false,也就是说当字段的值不匹配的时候,就会出现错误。
运行上面的结果是:
- number_one 字段将包含整数10。
- 由于禁用了强制,因此该文档将被拒绝
Index 级默认设置
代码语言:javascript复制PUT my_index
{
"settings": {
"index.mapping.coerce": false
},
"mappings": {
"properties": {
"number_one": {
"type": "integer",
"coerce": true
},
"number_two": {
"type": "integer"
}
}
}
}
PUT my_index/_doc/1
{
"number_one": "10"
}
PUT my_index/_doc/2
{
"number_two": "10"
}