Skip to content

[DOCS] Updated wording for clarity for new users #120257

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.

Sign up for GitHub

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

Merged
merged 4 commits into from
Jan 21, 2025
Merged

[DOCS] Updated wording for clarity for new users #120257

Changes from 2 commits
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
ecd8a03
Updated wording for clarity for new users
thekofimensah Jan 16, 2025
be9b727
Added a detail on updating arrays
thekofimensah Jan 18, 2025
8d5d98a
Update docs/reference/mapping/types/array.asciidoc
thekofimensah Jan 20, 2025
90d2b0d
Reworded note for clarity
thekofimensah Jan 21, 2025
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
9 changes: 6 additions & 3 deletions docs/reference/mapping/types/array.asciidoc
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -14,9 +14,7 @@ same data type. For instance:
[NOTE]
====================================================

Arrays of objects do not work as you would expect: you cannot query each
object independently of the other objects in the array. If you need to be
able to do this then you should use the <<nested,`nested`>> data type instead
Arrays of objects in Elasticsearch do not behave as you would expect: queries may match fields across different objects in the array, leading to unexpected results. To ensure queries match fields within the same object, use the <<nested,`nested`>> data type instead
of the <<object,`object`>> data type.

This is explained in more detail in <<nested>>.
Expand Down Expand Up @@ -81,3 +79,8 @@ GET my-index-000001/_search
<3> The second document contains no arrays, but can be indexed into the same fields.
<4> The query looks for `elasticsearch` in the `tags` field, and matches both documents.


Updating or appending an array is best done with a script using the <<update-api-example,update API>>.