Improved Terms Aggregation documentation (#38892)

srensamblador · polyfractal · commit 4615e72578d6 · 2019-03-05T10:45:52.000-05:00
Added a note after the first query example talking about fielddata.
diff --git a/docs/reference/aggregations/bucket/terms-aggregation.asciidoc b/docs/reference/aggregations/bucket/terms-aggregation.asciidoc
@@ -61,13 +61,15 @@ GET /_search
 {
     "aggs" : {
         "genres" : {
-            "terms" : { "field" : "genre" }
+            "terms" : { "field" : "genre" } <1>
         }
     }
 }
 --------------------------------------------------
 // CONSOLE
 // TEST[s/_search/_search\?filter_path=aggregations/]
+<1> `terms` aggregation should be a field of type `keyword` or any other data type suitable for bucket aggregations. In order to use it with `text` you will need to enable 
+<<fielddata, fielddata>>.
 
 Response:
 

Original file line number	Diff line number	Diff line change
`@@ -61,13 +61,15 @@ GET /_search`
`61`	`61`	`{`
`62`	`62`	`"aggs" : {`
`63`	`63`	`"genres" : {`
`64`		`- "terms" : { "field" : "genre" }`
	`64`	`+ "terms" : { "field" : "genre" } <1>`
`65`	`65`	`}`
`66`	`66`	`}`
`67`	`67`	`}`
`68`	`68`	`--------------------------------------------------`
`69`	`69`	`// CONSOLE`
`70`	`70`	`// TEST[s/_search/_search\?filter_path=aggregations/]`
	`71`	+<1> `terms` aggregation should be a field of type `keyword` or any other data type suitable for bucket aggregations. In order to use it with `text` you will need to enable
	`72`	`+<<fielddata, fielddata>>.`
`71`	`73`
`72`	`74`	`Response:`
`73`	`75`