anchor.diff:  [[cat-fielddata]]
   === cat fielddata
   
  -`fielddata` shows how much heap memory is currently being used by fielddata
  -on every data node in the cluster.
  +Returns the amount of heap memory currently used by fielddata on every data node
  +in the cluster.
   
  +
  +[[cat-fielddata-api-request]]
  +==== {api-request-title}
  +
  +`GET /_cat/fielddata/{fields}`
  +
  +
  +[[cat-fielddata-api-path-params]]
  +==== {api-path-parms-title}
  +
  +`{fields}`::
  +(Optional, string) Comma-separated list of fields used to limit returned
  +information.
  +
  +
  +[[cat-fielddata-api-query-params]]
  +==== {api-query-parms-title}
  +
  +include::{docdir}/rest-api/common-parms.asciidoc[tag=bytes]
  +
  +include::{docdir}/rest-api/common-parms.asciidoc[tag=http-format]
  +
  +include::{docdir}/rest-api/common-parms.asciidoc[tag=local]
  +
  +include::{docdir}/rest-api/common-parms.asciidoc[tag=master-timeout]
  +
  +include::{docdir}/rest-api/common-parms.asciidoc[tag=cat-h]
  +
  +include::{docdir}/rest-api/common-parms.asciidoc[tag=help]
  +
  +include::{docdir}/rest-api/common-parms.asciidoc[tag=cat-s]
  +
  +include::{docdir}/rest-api/common-parms.asciidoc[tag=cat-v]
  +
  +
  +[[cat-fielddata-api-example]]
  +==== {api-examples-title}
   
   ////
   Hidden setup snippet to build an index with fielddata so our results are real:
  
positive.code: // TESTRESPONSE[s/544b|480b/\\d+(\\.\\d+)?[tgmk]?b/]
  // TESTRESPONSE[s/Nqk-6in[^ ]*/.+/ s/soul|body/\\w+/ non_json]
  
  Fields can be specified either as a query parameter, or in the URL path:
  
  [source,js]
  --------------------------------------------------
  GET /_cat/fielddata?v&fields=body
  --------------------------------------------------
  // CONSOLE
  // TEST[continued]
  
  Which looks like:
  
  [source,txt]
  --------------------------------------------------
  id                     host      ip        node    field   size
  Nqk-6inXQq-OxUfOUI8jNQ 127.0.0.1 127.0.0.1 Nqk-6in body    544b
  --------------------------------------------------
  // TESTRESPONSE[s/544b|480b/\\d+(\\.\\d+)?[tgmk]?b/]
  // TESTRESPONSE[s/Nqk-6in[^ ]*/.+/ non_json]
  
  And it accepts a comma delimited list:
  
  [source,js]
  --------------------------------------------------
  GET /_cat/fielddata/body,soul?v
  --------------------------------------------------
  // CONSOLE
  // TEST[continued]
  
  Which produces the same output as the first snippet:
  
  [source,txt]
  --------------------------------------------------
  id                     host      ip        node    field   size
  Nqk-6inXQq-OxUfOUI8jNQ 127.0.0.1 127.0.0.1 Nqk-6in body    544b
  Nqk-6inXQq-OxUfOUI8jNQ 127.0.0.1 127.0.0.1 Nqk-6in soul    480b
  --------------------------------------------------
  // TESTRESPONSE[s/544b|480b/\\d+(\\.\\d+)?[tgmk]?b/]
  // TESTRESPONSE[s/Nqk-6in[^ ]*/.+/ s/soul|body/\\w+/ non_json]
  
  The output shows the individual fielddata for the `body` and `soul` fields, one row per field per node.
  
negative.code: POST test/_doc?refresh
  {
    "body": "some words so there is a little field data",
    "soul": "some more words",
    "mind": "even more words"
  }
  
  # Perform a search to load the field data
  POST test/_search?sort=body,soul,mind
  --------------------------------------------------
  // CONSOLE
  ////
  
  [[cat-fielddata-api-example-ind]]
  ===== Example with an individual field
  
  You can specify an individual field in the request body or URL path. The
  following `fieldata` API request retrieves heap memory size information for the
  `body` field.
  
  [source,js]
  --------------------------------------------------
  GET /_cat/fielddata?v&fields=body
  --------------------------------------------------
  // CONSOLE
  // TEST[continued]
  
  The API returns the following response:
  
  [source,txt]
  --------------------------------------------------
  id                     host      ip        node    field   size
  Nqk-6inXQq-OxUfOUI8jNQ 127.0.0.1 127.0.0.1 Nqk-6in body    544b
  --------------------------------------------------
  // TESTRESPONSE[s/544b|480b/\\d+(\\.\\d+)?[tgmk]?b/]
  // TESTRESPONSE[s/Nqk-6in[^ ]*/.+/ non_json]
  
  [[cat-fielddata-api-example-list]]
  ===== Example with a list of fields
  
  You can specify a comma-separated list of fields in the request body or URL
  path. The following `fieldata` API request retrieves heap memory size
  information for the `body` and `soul` fields.
  
  
  [source,js]
  --------------------------------------------------
  GET /_cat/fielddata/body,soul?v
  --------------------------------------------------
  // CONSOLE
  // TEST[continued]
  
  The API returns the following response:
  
  [source,txt]
  --------------------------------------------------
  