• 检索多个文档

    检索多个文档

    像Elasticsearch一样，检索多个文档依旧非常快。合并多个请求可以避免每个请求单独的网络开销。如果你需要从Elasticsearch中检索多个文档，相对于一个一个的检索，更快的方式是在一个请求中使用multi-get或者mget API。

    mget API参数是一个docs数组，数组的每个节点定义一个文档的_index、_type、_id元数据。如果你只想检索一个或几个确定的字段，也可以定义一个_source参数：

    1. POST /_mget
    2. {
    3.    "docs" : [
    4.       {
    5.          "_index" : "website",
    6.          "_type" :  "blog",
    7.          "_id" :    2
    8.       },
    9.       {
    10.          "_index" : "website",
    11.          "_type" :  "pageviews",
    12.          "_id" :    1,
    13.          "_source": "views"
    14.       }
    15.    ]
    16. }

    响应体也包含一个docs数组，每个文档还包含一个响应，它们按照请求定义的顺序排列。每个这样的响应与单独使用get request响应体相同：

    1. {
    2.    "docs" : [
    3.       {
    4.          "_index" :   "website",
    5.          "_id" :      "2",
    6.          "_type" :    "blog",
    7.          "found" :    true,
    8.          "_source" : {
    9.             "text" :  "This is a piece of cake...",
    10.             "title" : "My first external blog entry"
    11.          },
    12.          "_version" : 10
    13.       },
    14.       {
    15.          "_index" :   "website",
    16.          "_id" :      "1",
    17.          "_type" :    "pageviews",
    18.          "found" :    true,
    19.          "_version" : 2,
    20.          "_source" : {
    21.             "views" : 2
    22.          }
    23.       }
    24.    ]
    25. }

    如果你想检索的文档在同一个_index中（甚至在同一个_type中），你就可以在URL中定义一个默认的/_index或者/_index/_type。

    你依旧可以在单独的请求中使用这些值：

    1. POST /website/blog/_mget
    2. {
    3.    "docs" : [
    4.       { "_id" : 2 },
    5.       { "_type" : "pageviews", "_id" :   1 }
    6.    ]
    7. }

    事实上，如果所有文档具有相同_index和_type，你可以通过简单的ids数组来代替完整的docs数组：

    1. POST /website/blog/_mget
    2. {
    3.    "ids" : [ "2", "1" ]
    4. }

    注意到我们请求的第二个文档并不存在。我们定义了类型为blog，但是ID为1的文档类型为pageviews。这个不存在的文档会在响应体中被告知。

    1. {
    2.   "docs" : [
    3.     {
    4.       "_index" :   "website",
    5.       "_type" :    "blog",
    6.       "_id" :      "2",
    7.       "_version" : 10,
    8.       "found" :    true,
    9.       "_source" : {
    10.         "title":   "My first external blog entry",
    11.         "text":    "This is a piece of cake..."
    12.       }
    13.     },
    14.     {
    15.       "_index" :   "website",
    16.       "_type" :    "blog",
    17.       "_id" :      "1",
    18.       "found" :    false  <1>
    19.     }
    20.   ]
    21. }
    • <1> 这个文档不存在

    事实上第二个文档不存在并不影响第一个文档的检索。每个文档的检索和报告都是独立的。

    注意：

    尽管前面提到有一个文档没有被找到，但HTTP请求状态码还是200。事实上，就算所有文档都找不到，请求也还是返回200，原因是mget请求本身成功了。如果想知道每个文档是否都成功了，你需要检查found标志。