范围查询
编辑范围查询
编辑返回指定范围内的词项的文档。
示例请求
编辑以下搜索返回 age 字段包含介于 10 和 20 之间的词项的文档。
resp = client.search(
query={
"range": {
"age": {
"gte": 10,
"lte": 20,
"boost": 2
}
}
},
)
print(resp)
response = client.search(
body: {
query: {
range: {
age: {
gte: 10,
lte: 20,
boost: 2
}
}
}
}
)
puts response
res, err := es.Search(
es.Search.WithBody(strings.NewReader(`{
"query": {
"range": {
"age": {
"gte": 10,
"lte": 20,
"boost": 2.0
}
}
}
}`)),
es.Search.WithPretty(),
)
fmt.Println(res, err)
const response = await client.search({
query: {
range: {
age: {
gte: 10,
lte: 20,
boost: 2,
},
},
},
});
console.log(response);
GET /_search
{
"query": {
"range": {
"age": {
"gte": 10,
"lte": 20,
"boost": 2.0
}
}
}
}
range 的顶层参数
编辑-
<字段> -
（必需，对象）您要搜索的字段。
<字段> 的参数
编辑-
relation -
（可选，字符串）指示范围查询如何匹配
range字段的值。有效值包括-
INTERSECTS（默认） - 匹配范围字段值与查询范围相交的文档。
-
CONTAINS - 匹配范围字段值完全包含查询范围的文档。
-
WITHIN - 匹配范围字段值完全在查询范围内的文档。
-
-
time_zone -
（可选，字符串）协调世界时 (UTC) 偏移量 或 IANA 时区，用于将查询中的
date值转换为 UTC。有效值是 ISO 8601 UTC 偏移量（例如
+01:00或 -08:00）和 IANA 时区 ID（例如America/Los_Angeles）。有关使用
time_zone参数的示例查询，请参见 范围查询中的时区。 -
boost -
（可选，浮点数）用于减少或增加查询的相关性分数的浮点数。默认为
1.0。您可以使用
boost参数来调整包含两个或多个查询的搜索的相关性分数。提升值相对于默认值
1.0。介于0和1.0之间的提升值会降低相关性分数。大于1.0的值会增加相关性分数。
注意
编辑在 text 和 keyword 字段中使用 range 查询
编辑如果 search.allow_expensive_queries 设置为 false，则不会执行 text 或 keyword 字段的范围查询。
在 date 字段中使用 range 查询
编辑当 <field> 参数是 date 字段数据类型时，您可以将 日期数学 与以下参数一起使用
-
gt -
gte -
lt -
lte
例如，以下搜索返回 timestamp 字段包含今天和昨天之间日期的文档。
resp = client.search(
query={
"range": {
"timestamp": {
"gte": "now-1d/d",
"lte": "now/d"
}
}
},
)
print(resp)
response = client.search(
body: {
query: {
range: {
timestamp: {
gte: 'now-1d/d',
lte: 'now/d'
}
}
}
}
)
puts response
const response = await client.search({
query: {
range: {
timestamp: {
gte: "now-1d/d",
lte: "now/d",
},
},
},
});
console.log(response);
GET /_search
{
"query": {
"range": {
"timestamp": {
"gte": "now-1d/d",
"lte": "now/d"
}
}
}
}
缺失的日期组件
编辑对于范围查询和 日期范围 聚合，Elasticsearch 会使用以下值替换缺失的日期组件。缺失的年份组件不会被替换。
MONTH_OF_YEAR: 01 DAY_OF_MONTH: 01 HOUR_OF_DAY: 23 MINUTE_OF_HOUR: 59 SECOND_OF_MINUTE: 59 NANO_OF_SECOND: 999_999_999
例如，如果格式为 yyyy-MM，则 Elasticsearch 会将 gt 值 2099-12 转换为 2099-12-01T23:59:59.999_999_999Z。此日期使用提供的年份 (2099) 和月份 (12)，但使用默认的日期 (01)、小时 (23)、分钟 (59)、秒 (59) 和纳秒 (999_999_999)。
数值日期范围值
编辑当未指定日期格式且范围查询的目标是日期字段时，数值会被解释为自纪元以来的毫秒数。如果您希望该值表示年份（例如 2020），则需要将其作为字符串值（例如“2020”）传递，该值将根据默认格式或设置的格式进行解析。
日期数学和舍入
编辑Elasticsearch 按如下方式舍入参数中的 日期数学 值
-
gt -
向上舍入到舍入日期未覆盖的第一个毫秒。
例如，
2014-11-18||/M向上舍入为2014-12-01T00:00:00.000，不包括整个 11 月。 -
gte -
向下舍入到第一个毫秒。
例如，
2014-11-18||/M向下舍入为2014-11-01T00:00:00.000，包括整个 11 月。 -
lt -
向下舍入到舍入值之前的最后一个毫秒。
例如，
2014-11-18||/M向下舍入为2014-10-31T23:59:59.999，不包括整个 11 月。 -
lte -
向上舍入到舍入间隔中的最新毫秒。
例如，
2014-11-18||/M向上舍入为2014-11-30T23:59:59.999，包括整个 11 月。
使用 time_zone 参数的示例查询
编辑您可以使用 time_zone 参数，使用 UTC 偏移量将 date 值转换为 UTC。例如
$params = [
'body' => [
'query' => [
'range' => [
'timestamp' => [
'time_zone' => '+01:00',
'gte' => '2020-01-01T00:00:00',
'lte' => 'now',
],
],
],
],
];
$response = $client->search($params);
resp = client.search(
query={
"range": {
"timestamp": {
"time_zone": "+01:00",
"gte": "2020-01-01T00:00:00",
"lte": "now"
}
}
},
)
print(resp)
response = client.search(
body: {
query: {
range: {
timestamp: {
time_zone: '+01:00',
gte: '2020-01-01T00:00:00',
lte: 'now'
}
}
}
}
)
puts response
res, err := es.Search(
es.Search.WithBody(strings.NewReader(`{
"query": {
"range": {
"timestamp": {
"time_zone": "+01:00",
"gte": "2020-01-01T00:00:00",
"lte": "now"
}
}
}
}`)),
es.Search.WithPretty(),
)
fmt.Println(res, err)
const response = await client.search({
query: {
range: {
timestamp: {
time_zone: "+01:00",
gte: "2020-01-01T00:00:00",
lte: "now",
},
},
},
});
console.log(response);