* Minor improvement to the nested aggregation docs * The attributes name and resellers.name were rather confusing, especially since the first one was dynamically mapped and not shown in the documentation (you had to read the test to see it). This change introduces a unique name for the nested attribute and adds the example document to the documentation. * Change the index name from "index" to something more speaking. * Update docs/reference/aggregations/bucket/nested-aggregation.asciidoc Co-Authored-By: James Rodewig <james.rodewig@elastic.co> * Update docs/reference/aggregations/bucket/nested-aggregation.asciidoc Co-Authored-By: James Rodewig <james.rodewig@elastic.co> * Update docs/reference/aggregations/bucket/nested-aggregation.asciidoc Co-Authored-By: James Rodewig <james.rodewig@elastic.co>
This commit is contained in:
parent
dcdfc382c7
commit
043471c643
|
@ -8,14 +8,14 @@ price for the product. The mapping could look like:
|
||||||
|
|
||||||
[source,console]
|
[source,console]
|
||||||
--------------------------------------------------
|
--------------------------------------------------
|
||||||
PUT /index
|
PUT /products
|
||||||
{
|
{
|
||||||
"mappings": {
|
"mappings": {
|
||||||
"properties" : {
|
"properties" : {
|
||||||
"resellers" : { <1>
|
"resellers" : { <1>
|
||||||
"type" : "nested",
|
"type" : "nested",
|
||||||
"properties" : {
|
"properties" : {
|
||||||
"name" : { "type" : "text" },
|
"reseller" : { "type" : "text" },
|
||||||
"price" : { "type" : "double" }
|
"price" : { "type" : "double" }
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
@ -23,14 +23,37 @@ PUT /index
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
--------------------------------------------------
|
--------------------------------------------------
|
||||||
// TESTSETUP
|
<1> `resellers` is an array that holds nested documents.
|
||||||
<1> The `resellers` is an array that holds nested documents under the `product` object.
|
|
||||||
|
|
||||||
The following aggregations will return the minimum price products can be purchased in:
|
The following request adds a product with two resellers:
|
||||||
|
|
||||||
[source,console]
|
[source,console]
|
||||||
--------------------------------------------------
|
--------------------------------------------------
|
||||||
GET /_search
|
PUT /products/_doc/0
|
||||||
|
{
|
||||||
|
"name": "LED TV", <1>
|
||||||
|
"resellers": [
|
||||||
|
{
|
||||||
|
"reseller": "companyA",
|
||||||
|
"price": 350
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"reseller": "companyB",
|
||||||
|
"price": 500
|
||||||
|
}
|
||||||
|
]
|
||||||
|
}
|
||||||
|
--------------------------------------------------
|
||||||
|
// TEST[s/PUT \/products\/_doc\/0/PUT \/products\/_doc\/0\?refresh/]
|
||||||
|
// TEST[continued]
|
||||||
|
<1> We are using a dynamic mapping for the `name` attribute.
|
||||||
|
|
||||||
|
|
||||||
|
The following request returns the minimum price a product can be purchased for:
|
||||||
|
|
||||||
|
[source,console]
|
||||||
|
--------------------------------------------------
|
||||||
|
GET /products/_search
|
||||||
{
|
{
|
||||||
"query" : {
|
"query" : {
|
||||||
"match" : { "name" : "led tv" }
|
"match" : { "name" : "led tv" }
|
||||||
|
@ -47,8 +70,8 @@ GET /_search
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
--------------------------------------------------
|
--------------------------------------------------
|
||||||
// TEST[s/GET \/_search/GET \/_search\?filter_path=aggregations/]
|
// TEST[s/GET \/products\/_search/GET \/products\/_search\?filter_path=aggregations/]
|
||||||
// TEST[s/^/PUT index\/_doc\/0\?refresh\n{"name":"led", "resellers": [{"name": "foo", "price": 350.00}, {"name": "bar", "price": 500.00}]}\n/]
|
// TEST[continued]
|
||||||
|
|
||||||
As you can see above, the nested aggregation requires the `path` of the nested documents within the top level documents.
|
As you can see above, the nested aggregation requires the `path` of the nested documents within the top level documents.
|
||||||
Then one can define any type of aggregation over these nested documents.
|
Then one can define any type of aggregation over these nested documents.
|
||||||
|
@ -61,7 +84,7 @@ Response:
|
||||||
...
|
...
|
||||||
"aggregations": {
|
"aggregations": {
|
||||||
"resellers": {
|
"resellers": {
|
||||||
"doc_count": 0,
|
"doc_count": 2,
|
||||||
"min_price": {
|
"min_price": {
|
||||||
"value": 350
|
"value": 350
|
||||||
}
|
}
|
||||||
|
|
Loading…
Reference in New Issue