Skip to content

Commit c420101

Browse files
authored
Clarify update operations may be performed on a data stream's backing indices (#105408) (#105415)
These statements come off a little too strongly towards "don't use data streams if you *ever* have updates", but they do support updates when necessary, as long as the backing indices are used. (cherry picked from commit d95d6ad)
1 parent 5001128 commit c420101

File tree

2 files changed

+8
-7
lines changed

2 files changed

+8
-7
lines changed

docs/reference/alias.asciidoc

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -240,8 +240,9 @@ POST _aliases
240240
include::{es-repo-dir}/indices/aliases.asciidoc[tag=write-index-defaults]
241241

242242
TIP: We recommend using data streams to store append-only time series data. If
243-
you frequently update or delete existing time series data, use an index alias
244-
with a write index instead. See
243+
you need to update or delete existing time series data, you can perform update or delete operations
244+
directly on the data stream backing index. If you frequently send multiple documents using the same
245+
`_id` expecting last-write-wins, you may want to use an index alias with a write index instead. See
245246
<<manage-time-series-data-without-data-streams>>.
246247

247248
[discrete]

docs/reference/ilm/ilm-tutorial.asciidoc

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -14,11 +14,11 @@ requirements for your newest data, control costs over time, enforce retention po
1414
and still get the most out of your data.
1515

1616
TIP: Data streams are best suited for
17-
<<data-streams-append-only,append-only>> use cases. If you need to frequently
18-
update or delete existing documents across multiple indices, we recommend
19-
using an index alias and index template instead. You can still use ILM to
20-
manage and rollover the alias's indices. Skip to
21-
<<manage-time-series-data-without-data-streams>>.
17+
<<data-streams-append-only,append-only>> use cases. If you need to update or delete existing time
18+
series data, you can perform update or delete operations directly on the data stream backing index.
19+
If you frequently send multiple documents using the same `_id` expecting last-write-wins, you may
20+
want to use an index alias with a write index instead. You can still use ILM to manage and rollover
21+
the alias's indices. Skip to <<manage-time-series-data-without-data-streams>>.
2222

2323
To automate rollover and management of a data stream with {ilm-init}, you:
2424

0 commit comments

Comments
 (0)