Improved Terms Aggregation documentation (#38892)

srensamblador · polyfractal · commit ff6ffe8ba1d8 · 2019-03-05T10:17:01.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
@@ -59,13 +59,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
`@@ -59,13 +59,15 @@ GET /_search`
`59`	`59`	`{`
`60`	`60`	`"aggs" : {`
`61`	`61`	`"genres" : {`
`62`		`- "terms" : { "field" : "genre" }`
	`62`	`+ "terms" : { "field" : "genre" } <1>`
`63`	`63`	`}`
`64`	`64`	`}`
`65`	`65`	`}`
`66`	`66`	`--------------------------------------------------`
`67`	`67`	`// CONSOLE`
`68`	`68`	`// TEST[s/_search/_search\?filter_path=aggregations/]`
	`69`	+<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
	`70`	`+<<fielddata, fielddata>>.`
`69`	`71`
`70`	`72`	`Response:`
`71`	`73`