范围（Range）字段类型 #

以下表格列出了 Easysearch 支持的所有范围字段类型。

参考代码 #

创建一个有双精度浮点数范围字段和日期范围字段的映射

PUT testindex
{
  "mappings" : {
    "properties" :  {
      "gpa" : {
        "type" : "double_range"
      },
      "graduation_date" : {
        "type" : "date_range",
        "format" : "strict_year_month||strict_year_month_day"
      }
    }
  }
}

索引一个包含这两个字段的文档

PUT testindex/_doc/1
{
  "gpa" : {
    "gte" : 1.0,
    "lte" : 4.0
  },
  "graduation_date" : {
    "gte" : "2019-05-01",
    "lte" : "2019-05-15"
  }
}

IP 地址范围字段 #

您可以使用两种格式指定 IP 地址范围字段：范围表示法和 CIDR 表示法。 CIDR notation

创建一个有 IP 地址范围字段两个格式的映射

PUT testindex
{
  "mappings" : {
    "properties" :  {
      "ip_address_range" : {
        "type" : "ip_range"
      },
      "ip_address_cidr" : {
        "type" : "ip_range"
      }
    }
  }
}

索引一个包含这两个 IP 地址范围字段格式的文档

PUT testindex/_doc/2
{
  "ip_address_range" : {
    "gte" : "10.24.34.0",
    "lte" : "10.24.35.255"
  },
  "ip_address_cidr" : "10.24.34.0/24"
}

查询范围字段 #

您可以使用 Term 查询 或 Range 查询对范围字段进行搜索。

Term 查询 #

Term 查询可以使用一个具体值匹配到所有符合条件的范围字段。

例如，以下查询将返回文档 1，因为 3.5 位于文档 1 的范围 [1.0, 4.0] 之内。

GET testindex/_search
{
  "query" : {
    "term" : {
      "gpa" : {
        "value" : 3.5
      }
    }
  }
}

范围查询 #

对范围字段的范围查询会返回位于指定范围内的文档。

例如，可以查询 2019 年的所有毕业日期，并以“MM/dd/yyyy”格式提供日期范围。

GET testindex/_search
{
  "query": {
    "range": {
      "graduation_date": {
        "gte": "01/01/2019",
        "lte": "12/31/2019",
        "format": "MM/dd/yyyy",
        "relation" : "within"
      }
    }
  }
}

上面的查询在“within”和“intersects”关系中会返回文档 1，但在“contains”关系中不会返回它。

参数详解 #

下面列出了范围字段的设置参数，所有参数都是可选的