Skip to content

Commit aa8ebeb

Browse files
committed
Clarify snapshot incrementality (#65587)
Today we describe snapshots as "incremental" but their incrementality is rather different beast from e.g. incremental filesystem backups. With traditional backups you take a large and relatively infrequent "full" backup and then a sequence of smaller "incremental" ones, and this whole sequence of backups is required for a restore so it must be kept around until at least the next full backup. In contrast, Elasticsearch snapshots are logically independent and each can be deleted without affecting the integrity of the others. This distinction frequently causes confusion amongst newer users, so this commit clarifies what we mean by "incremental" in the docs.
1 parent a122f10 commit aa8ebeb

File tree

1 file changed

+6
-3
lines changed

1 file changed

+6
-3
lines changed

docs/reference/snapshot-restore/index.asciidoc

Lines changed: 6 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -19,9 +19,12 @@ Remote repositories can reside on Amazon S3, HDFS, Microsoft Azure,
1919
Google Cloud Storage,
2020
and other platforms supported by a {plugins}/repository.html[repository plugin].
2121

22-
Snapshots are incremental: each snapshot only stores data that
23-
is not part of an earlier snapshot.
24-
This enables you to take frequent snapshots with minimal overhead.
22+
{es} takes snapshots incrementally: the snapshotting process only copies data
23+
to the repository that was not already copied there by an earlier snapshot,
24+
avoiding unnecessary duplication of work or storage space. This means you can
25+
safely take snapshots very frequently with minimal overhead. However, snapshots
26+
are also logically independent: deleting a snapshot does not affect the
27+
integrity of any other snapshot.
2528
// end::snapshot-intro[]
2629

2730
// tag::restore-intro[]

0 commit comments

Comments
 (0)