OpenSearch/docs/reference/search/request/fielddata-fields.asciidoc

[[search-request-fielddata-fields]]
=== Field Data Fields

Allows to return the <<fielddata,field data>> representation of a field for each hit, for
example:

[source,js]
--------------------------------------------------
GET /_search
{
    "query" : {
        "match_all": {}
    },
    "fielddata_fields" : ["test1", "test2"]
}
--------------------------------------------------
// CONSOLE

Field data fields can work on fields that are not stored.

It's important to understand that using the `fielddata_fields` parameter will
cause the terms for that field to be loaded to memory (cached), which will
result in more memory consumption.
Add the ability to retrieve fields from field data Adds a new FetchSubPhase, FieldDataFieldsFetchSubPhase, which loads the field data cache for a field and returns an array of values for the field. Also removes `doc['<field>']` and `_source.<field>` workaround no longer needed in field name resolving. Closes #4492 2014-01-09 17:20:06 -05:00			`[[search-request-fielddata-fields]]`
			`=== Field Data Fields`

Add link to field data docs from field data fields This commit adds a link to the field data docs from the field data fields docs for completeness. Closes #17672 2016-05-07 11:06:06 -04:00			`Allows to return the <<fielddata,field data>> representation of a field for each hit, for`
Add the ability to retrieve fields from field data Adds a new FetchSubPhase, FieldDataFieldsFetchSubPhase, which loads the field data cache for a field and returns an array of values for the field. Also removes `doc['<field>']` and `_source.<field>` workaround no longer needed in field name resolving. Closes #4492 2014-01-09 17:20:06 -05:00			`example:`

			`[source,js]`
			`--------------------------------------------------`
Add CONSOLE to several trivial search request docs. Relates to #18160 Touches explain, fielddata-fields, fields, index-boost, min-score, named-queries-and-filters, query 2016-05-18 07:15:19 -04:00			`GET /_search`
Add the ability to retrieve fields from field data Adds a new FetchSubPhase, FieldDataFieldsFetchSubPhase, which loads the field data cache for a field and returns an array of values for the field. Also removes `doc['<field>']` and `_source.<field>` workaround no longer needed in field name resolving. Closes #4492 2014-01-09 17:20:06 -05:00			`{`
			`"query" : {`
Add CONSOLE to several trivial search request docs. Relates to #18160 Touches explain, fielddata-fields, fields, index-boost, min-score, named-queries-and-filters, query 2016-05-18 07:15:19 -04:00			`"match_all": {}`
Add the ability to retrieve fields from field data Adds a new FetchSubPhase, FieldDataFieldsFetchSubPhase, which loads the field data cache for a field and returns an array of values for the field. Also removes `doc['<field>']` and `_source.<field>` workaround no longer needed in field name resolving. Closes #4492 2014-01-09 17:20:06 -05:00			`},`
			`"fielddata_fields" : ["test1", "test2"]`
			`}`
			`--------------------------------------------------`
Add CONSOLE to several trivial search request docs. Relates to #18160 Touches explain, fielddata-fields, fields, index-boost, min-score, named-queries-and-filters, query 2016-05-18 07:15:19 -04:00			`// CONSOLE`
Add the ability to retrieve fields from field data Adds a new FetchSubPhase, FieldDataFieldsFetchSubPhase, which loads the field data cache for a field and returns an array of values for the field. Also removes `doc['<field>']` and `_source.<field>` workaround no longer needed in field name resolving. Closes #4492 2014-01-09 17:20:06 -05:00
			`Field data fields can work on fields that are not stored.`

			It's important to understand that using the `fielddata_fields` parameter will
			`cause the terms for that field to be loaded to memory (cached), which will`
			`result in more memory consumption.`