多词项查询 #

使用 terms 多词项查询在同一字段中搜索多个词项。例如，以下查询搜索具有 ID 61809 和 61810 的文档：

GET shakespeare/_search
{
  "query": {
    "terms": {
      "line_id": [
        "61809",
        "61810"
      ]
    }
  }
}

如果文档与数组中的任何词项匹配，则会返回该文档。

默认情况下， terms 查询中允许的最大词项数量为 65,536。要更改最大词项数量，请更新 index.max_terms_count 设置。

为了更好的查询性能，请传递包含已排序词项的长期数组（按 UTF-8 字节值升序排序）。

根据高亮器类型和查询中词项的数量，高亮显示词项查询结果的能力可能无法保证。

参数说明 #

该查询接受以下参数。所有参数都是可选的。

条件查找 #

条件查找功能会检索单个文档的字段值并将其用作搜索词。您可以使用条件查找功能来搜索大量词项。

要使用条件查找功能，您必须启用 _source 映射字段，因为条件查找功能会从文档中获取值。默认情况下， _source 字段处于启用状态。

条件查找会尝试从本地数据节点上的分片获取文档字段值。因此，使用具有单个主分片且在所有适用数据节点上都有完整副本的索引可以减少网络流量。

参考用例 #

例如，创建一个包含学生数据的索引，将 student_id 映射为 keyword ：

PUT students
{
  "mappings": {
    "properties": {
      "student_id": { "type": "keyword" }
    }
  }
}

接下来，索引与学生对应的三个文档：

PUT students/_doc/1
{
  "name": "Jane Doe",
  "student_id" : "111"
}

PUT students/_doc/2
{
  "name": "Mary Major",
  "student_id" : "222"
}

PUT students/_doc/3
{
  "name": "John Doe",
  "student_id" : "333"
}

创建一个单独的索引，其中包含班级信息，包括班级名称和与该班级注册的学生对应的学生 ID 数组：

PUT classes/_doc/101
{
  "name": "CS101",
  "enrolled" : ["111" , "222"]
}

要搜索参加 CS101 课程的学生，请指定与该课程对应的文档的文档 ID、该文档的索引以及词项所在字段的路径：

GET students/_search
{
  "query": {
    "terms": {
      "student_id": {
        "index": "classes",
        "id": "101",
        "path": "enrolled"
      }
    }
  }
}

返回内容包含 students 索引中 ID 与 enrolled 数组中的一个值匹配的每个学生的文档：

{
  "took": 13,
  "timed_out": false,
  "_shards": {
    "total": 1,
    "successful": 1,
    "skipped": 0,
    "failed": 0
  },
  "hits": {
    "total": {
      "value": 2,
      "relation": "eq"
    },
    "max_score": 1,
    "hits": [
      {
        "_index": "students",
        "_id": "1",
        "_score": 1,
        "_source": {
          "name": "Jane Doe",
          "student_id": "111"
        }
      },
      {
        "_index": "students",
        "_id": "2",
        "_score": 1,
        "_source": {
          "name": "Mary Major",
          "student_id": "222"
        }
      }
    ]
  }
}

示例：嵌套字段 #

第二个示例演示了如何查询嵌套字段。考虑以下文档的索引：

PUT classes/_doc/102
{
  "name": "CS102",
  "enrolled_students" : {
    "id_list" : ["111" , "333"]
  }
}

要搜索就读 CS102 的学生，请使用点路径符号指定 path 参数中字段的完整路径：

GET students/_search
{
  "query": {
    "terms": {
      "student_id": {
        "index": "classes",
        "id": "102",
        "path": "enrolled_students.id_list"
      }
    }
  }
}

返回内容包含匹配的文档：

{
  "took": 18,
  "timed_out": false,
  "_shards": {
    "total": 1,
    "successful": 1,
    "skipped": 0,
    "failed": 0
  },
  "hits": {
    "total": {
      "value": 2,
      "relation": "eq"
    },
    "max_score": 1,
    "hits": [
      {
        "_index": "students",
        "_id": "1",
        "_score": 1,
        "_source": {
          "name": "Jane Doe",
          "student_id": "111"
        }
      },
      {
        "_index": "students",
        "_id": "3",
        "_score": 1,
        "_source": {
          "name": "John Doe",
          "student_id": "333"
        }
      }
    ]
  }
}

参数说明 #

下表列出了条件查找参数。