Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

[DOCS][101] Update first quick start with mappings examples #113558

Merged
merged 27 commits into from
Oct 2, 2024
Merged
Show file tree
Hide file tree
Changes from 25 commits
Commits
Show all changes
27 commits
Select commit Hold shift + click to select a range
5c41916
[DOCS] Update first quick start with mappings examples
leemthompo Sep 25, 2024
8a6515f
Fix test?
leemthompo Sep 26, 2024
5ee1ec9
Fix tests, update verbiage
leemthompo Sep 26, 2024
119c32e
Fix heading level
leemthompo Sep 26, 2024
ce595bf
Use verbs for heading consistency
leemthompo Sep 26, 2024
6a5a17a
Remove superfluous list item
leemthompo Sep 26, 2024
f534690
I guess need some context right
leemthompo Sep 26, 2024
a2e5aeb
Fix typo
leemthompo Sep 26, 2024
31d8006
Expand intro, add prerequisites, add hints for Console usage
leemthompo Sep 27, 2024
c0eba9f
Update mappings page with combo info
leemthompo Sep 30, 2024
3a3a9a4
Updates per feedback
leemthompo Sep 30, 2024
6ca87ff
Update link text
leemthompo Sep 30, 2024
f6b77d1
Minor touchups, mainly to rerun CI
leemthompo Oct 1, 2024
8966aa2
Merge branch 'main' into qs-basics
elasticmachine Oct 1, 2024
39f8ebc
Apply suggestions from code review
leemthompo Oct 2, 2024
dbae123
Further edits per review
leemthompo Oct 2, 2024
0f09807
Reword mappings update, add clarity
leemthompo Oct 2, 2024
2d0626d
Tweak mapping updates wording
leemthompo Oct 2, 2024
43895ae
Really clarify this time
leemthompo Oct 2, 2024
536fe60
Edit update verbiage
leemthompo Oct 2, 2024
5971c2b
Typo
leemthompo Oct 2, 2024
e679e74
Apply Kathleen's suggestions
leemthompo Oct 2, 2024
11a38d0
Clarify multi-field mapping updates
leemthompo Oct 2, 2024
b20e506
Link to update mapping API
leemthompo Oct 2, 2024
88b71be
Mention some mapping params can be updated
leemthompo Oct 2, 2024
33a5619
Further clarifications
leemthompo Oct 2, 2024
015a345
Add tweaks and links
leemthompo Oct 2, 2024
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
22 changes: 21 additions & 1 deletion docs/reference/mapping.asciidoc
Original file line number Diff line number Diff line change
Expand Up @@ -75,9 +75,29 @@ reindexing. You can use runtime fields in conjunction with indexed fields to
balance resource usage and performance. Your index will be smaller, but with
slower search performance.

[discrete]
[[mapping-combine-explicit-dynamic]]
== Managing and updating mappings

Explicit mappings should be defined at index creation for fields you know in advance.
You can still add _new fields_ to mappings at any time, as your data evolves.

Use the <<indices-put-mapping,Update mapping API>> to update an existing mapping.

In most cases, you can't change mappings for fields that are already mapped.
These changes require <<docs-reindex,reindexing>>.

However, you can _update_ mappings under certain conditions:

* You can add new fields to an existing mapping at any time, explicitly or dynamically.
* You can add new <<multi-fields,multi-fields>> for existing fields.
leemthompo marked this conversation as resolved.
Show resolved Hide resolved
** Documents indexed before the mapping update will not have values for the new multi-fields until they are updated or reindexed. Documents indexed after the mapping change will automatically have values for the new multi-fields.
* Some <<mapping-params,mapping parameters>> can be updated for existing fields of certain <<mapping-types,data types>>.

[discrete]
[[mapping-limit-settings]]
== Settings to prevent mapping explosion
== Prevent mapping explosions

Defining too many fields in an index can lead to a mapping explosion, which can
cause out of memory errors and difficult situations to recover from.

Expand Down
Loading