OpenSearch/docs/reference
Adrien Grand cb868d2f5e
Introduce a `constant_keyword` field. (#49713) (#53024)
This field is a specialization of the `keyword` field for the case when all
documents have the same value. It typically performs more efficiently than
keywords at query time by figuring out whether all or none of the documents
match at rewrite time, like `term` queries on `_index`.

The name is up for discussion. I liked including `keyword` in it, so that we
still have room for a `singleton_numeric` in the future. However I'm unsure
whether to call it `singleton`, `constant` or something else, any opinions?

For this field there is a choice between
 1. accepting values in `_source` when they are equal to the value configured
    in mappings, but rejecting mapping updates
 2. rejecting values in `_source` but then allowing updates to the value that
    is configured in the mapping
This commit implements option 1, so that it is possible to reindex from/to an
index that has the field mapped as a keyword with no changes to the source.

Backport of #49713
2020-03-03 16:01:47 +01:00
..
aggregations Add size support to `top_metrics` (backport of #52662) (#52914) 2020-02-27 16:12:52 -05:00
analysis [DOCS] Reformat trim token filter docs (#51649) 2020-03-02 07:48:23 -05:00
autoscaling Add autoscaling API skelton (#51564) 2020-02-06 21:55:01 -05:00
cat [DOCS] Adds cat anomaly detectors API (#52866) (#52970) 2020-03-02 07:28:55 -08:00
ccr Remove outdated requirement of CCR (#50859) 2020-01-13 20:00:23 -05:00
cluster [DOCS] Fix typo in task management API docs (#52881) 2020-02-27 11:31:11 -05:00
commands [Docs] Fix typo in node-tool.asciidoc (#51667) 2020-01-31 10:36:21 +01:00
docs [DOCS] Update term vectors snippet to prevent CI failure (#52819) 2020-02-26 12:41:40 -05:00
eql [DOCS] Reorganize EQL requirements page 2020-03-03 07:02:30 -05:00
graph [DOCS] [2 of 5] Change // CONSOLE comments to [source,console] (#46353) (#46502) 2019-09-09 13:38:14 -04:00
high-availability [DOCS] Move snapshot-restore out of modules. (#49618) (#50829) 2020-01-09 16:55:46 -08:00
how-to Introduce a `constant_keyword` field. (#49713) (#53024) 2020-03-03 16:01:47 +01:00
ilm [DOCS] Correct policy name in ILM docs example (#52354) 2020-02-25 09:36:22 -05:00
images SQL: update ODBC docs, cover Cloud ID, latest params (#52291) 2020-02-19 17:42:28 +01:00
index-modules Discourage from opting in for the `niofs` store. (#52638) 2020-02-25 08:54:11 +01:00
indices [Docs] Clarify default value for `allow_no_indices` (#52635) (#52697) 2020-02-24 11:57:32 +01:00
ingest [DOCS] Fix formatting of simulate ingest pipeline API docs (#52754) 2020-03-02 11:46:27 -05:00
licensing [DOCS] Augments update license API (#51903) 2020-02-05 11:08:11 -08:00
mapping Introduce a `constant_keyword` field. (#49713) (#53024) 2020-03-03 16:01:47 +01:00
migration Clarified http.max_content_length description (#52329) 2020-02-24 21:01:14 -05:00
ml [DOCS] Adds cat anomaly detectors API (#52866) (#52970) 2020-03-02 07:28:55 -08:00
modules "Adding nodes" instructions only work on localhost (#52677) 2020-02-27 09:18:37 +00:00
monitoring [DOCS] Fixes monitoring links (#52790) 2020-02-25 18:08:23 -08:00
query-dsl Correct boost calculation in script_score query (#52478) (#52724) 2020-02-24 13:48:21 -05:00
release-notes Add validation for dynamic templates (#52890) 2020-02-28 10:35:04 +01:00
rest-api Correct the name of the search timeout parameter. (#52733) 2020-02-24 14:59:06 -08:00
rollup [DOCS] Merge rollup config details into API (#49412) 2019-11-22 08:39:49 -08:00
scripting Scripting: Add char position of script errors (#51069) (#51266) 2020-01-21 13:45:59 -07:00
search Adds recall@k metric to rank eval API (#52889) 2020-02-27 16:04:24 +01:00
settings [7.x][Transform] implement node.transform to control where to… (#52998) 2020-03-02 16:10:57 +01:00
setup Document how to change GC logging behaviour (#52879) 2020-02-28 21:27:45 +00:00
slm Correct SLM retention timezone documentation (#52533) 2020-02-19 13:46:43 -07:00
snapshot-restore Backporting updates to ILM org, overview, & GS (#51898) 2020-02-04 16:45:18 -08:00
sql remove references to the SQL API from ODBC config (#52765) 2020-02-26 13:39:54 +01:00
testing Uppercasing some docs section title (#37781) 2019-01-24 22:54:55 +01:00
transform [DOCS] Correct important note for xpack.transform.enabled (#52194) 2020-02-11 13:02:10 +00:00
upgrade Deprecate synced flush (#50835) 2020-01-13 19:54:38 -05:00
vectors Remove the 'experimental' marking from vector fields. (#49120) 2019-11-18 12:42:46 -08:00
aggregations.asciidoc
analysis.asciidoc [DOCS] Add attribute for Lucene analysis links (#51687) 2020-01-30 11:24:01 -05:00
api-conventions.asciidoc [DOCS] [2 of 5] Change // CONSOLE comments to [source,console] (#46353) (#46502) 2019-09-09 13:38:14 -04:00
cat.asciidoc [DOCS] Adds cat anomaly detectors API (#52866) (#52970) 2020-03-02 07:28:55 -08:00
cluster.asciidoc Password-protected Keystore Feature Branch PR (#51123) (#51510) 2020-01-28 05:32:32 -05:00
data-rollup-transform.asciidoc [DOCS] Adds transforms to Elasticsearch book (#46846) (#47055) 2019-09-25 08:11:37 -07:00
docs.asciidoc [DOCS] Remove heading offsets for REST APIs (#44568) 2019-07-19 14:36:06 -04:00
frozen-indices.asciidoc [DOCS] [2 of 5] Change // CONSOLE comments to [source,console] (#46353) (#46502) 2019-09-09 13:38:14 -04:00
getting-started.asciidoc [DOCS] Switch to standard ESS trial links (#52552) 2020-02-21 12:07:10 -05:00
glossary.asciidoc Backporting updates to ILM org, overview, & GS (#51898) 2020-02-04 16:45:18 -08:00
gs-index.asciidoc
high-availability.asciidoc [DOCS] Remove leveloffset for CCR docs (#46818) 2019-09-18 09:44:43 -04:00
how-to.asciidoc
index-modules.asciidoc Deprecate creation of dot-prefixed index names except for hidden and system indices (#49959) 2020-01-28 10:01:16 -07:00
index.asciidoc [DOCS] Include docs on permanently unreleased branches only (#51743) 2020-02-11 11:24:13 -05:00
index.x.asciidoc [DOCS] Removes redundant index.asciidoc files (#30707) 2018-05-18 11:05:40 -07:00
indices.asciidoc [DOCS] Reorder index APIs alphabetically (#46981) (#47402) 2019-10-01 17:07:28 -04:00
ingest.asciidoc Replace required pipeline with final pipeline (#49470) 2019-11-22 14:37:36 -05:00
intro.asciidoc [7.x][DOCS] Updates ML links (#50387) (#50409) 2019-12-20 10:01:19 -08:00
mapping.asciidoc [DOCS] Note clause limit in `index.mapping.total_fields.limit` docs (#48153) 2019-10-18 10:20:49 -04:00
modules.asciidoc Backporting updates to ILM org, overview, & GS (#51898) 2020-02-04 16:45:18 -08:00
query-dsl.asciidoc Add a cluster setting to disallow expensive queries (#51385) (#52279) 2020-02-12 22:56:14 +01:00
redirects.asciidoc [DOCS] Adds transform-settings page and its subpage to redirects (#52944) 2020-03-02 16:36:40 +01:00
release-notes.asciidoc [DOCS] Adds placeholder for 7.5.2 release notes (#51124) 2020-01-16 14:42:24 -05:00
scripting.asciidoc [DOCS] Move 'Scripting' section to top-level navigation. (#42939) 2019-06-06 10:46:02 -04:00
search.asciidoc Use snake casing for document field (#45432) 2019-09-19 14:27:00 +02:00
setup.asciidoc [DOCS] Adds transform-settings page and its subpage to redirects (#52944) 2020-03-02 16:36:40 +01:00
testing.asciidoc
upgrade.asciidoc [DOCS] Change prev version to 7.5 in upgrade docs (#48415) 2019-10-23 12:09:26 -05:00