Multi Get API

Multi Get API允许基于索引、类型（可选）和id（可能还有路由）获得多个文档，响应包括一个docs数组，其中包含所有获取的文档，以便与原始的multi-get请求相对应（如果特定get失败，则在响应中包括包含此错误的对象），成功get的结构在结构上类似于get API提供的文档。

这里有一个例子：

GET /_mget{    "docs" : [        {            "_index" : "test",            "_type" : "_doc",            "_id" : "1"        },        {            "_index" : "test",            "_type" : "_doc",            "_id" : "2"        }    ]}

mget端点还可以用于索引（在这种情况下，body中不需要索引）：

GET /test/_mget{    "docs" : [        {            "_type" : "_doc",            "_id" : "1"        },        {            "_type" : "_doc",            "_id" : "2"        }    ]}

和类型：

GET /test/_doc/_mget{    "docs" : [        {            "_id" : "1"        },        {            "_id" : "2"        }    ]}

在这种情况下，可以直接使用ids元素来简化请求：

GET /test/_doc/_mget{    "ids" : ["1", "2"]}

源过滤

默认情况下，每个文档将返回_source字段（如果存储了的话），与get API类似，通过使用_source参数，你可以只检索_source的一部分（或者完全没有），你还可以使用url参数_source、_source_include和_source_exclude来指定默认值，当没有针对每个文档指令时将使用默认值。

例如：

GET /_mget{    "docs" : [        {            "_index" : "test",            "_type" : "_doc",            "_id" : "1",            "_source" : false        },        {            "_index" : "test",            "_type" : "_doc",            "_id" : "2",            "_source" : ["field3", "field4"]        },        {            "_index" : "test",            "_type" : "_doc",            "_id" : "3",            "_source" : {                "include": ["user"],                "exclude": ["user.location"]            }        }    ]}

字段

可以指定特定的存储字段，以便对每个要获取的文档进行检索，类似于get API的stored_fields参数，例如：

GET /_mget{    "docs" : [        {            "_index" : "test",            "_type" : "_doc",            "_id" : "1",            "stored_fields" : ["field1", "field2"]        },        {            "_index" : "test",            "_type" : "_doc",            "_id" : "2",            "stored_fields" : ["field3", "field4"]        }    ]}

或者，你可以将查询字符串中的stored_fields参数指定为应用于所有文档的默认参数。

GET /test/_doc/_mget?stored_fields=field1,field2{    "docs" : [        {            "_id" : "1"         },        {            "_id" : "2",            "stored_fields" : ["field3", "field4"]         }    ]}

• "_id" : "1" => 返回field1、field2。
• "stored_fields" : ["field3", "field4"] => 返回field3、field4。

路由

还可以将路由值指定为参数：

GET /_mget?routing=key1{    "docs" : [        {            "_index" : "test",            "_type" : "_doc",            "_id" : "1",            "routing" : "key2"        },        {            "_index" : "test",            "_type" : "_doc",            "_id" : "2"        }    ]}

在本例中，文档test/_doc/2将从与路由键key1对应的碎片中获取，但是，文档test/_doc/1将从与路由键key2对应的碎片中获取。