diff --git a/docs/source/backup/index.rst b/docs/source/backup/index.rst index 9b3c5270c..8f0e976e7 100644 --- a/docs/source/backup/index.rst +++ b/docs/source/backup/index.rst @@ -31,13 +31,26 @@ The following backup storage engines are supported: Features ======== -* Glob patterns to select keyspaces or tables to backup +* Glob patterns to select keyspaces or tables to back up * Deduplication of SSTables * Retention of old data * Throttling of upload speed * Configurable upload destination per datacenter * Pause and resume +Selecting tables and nodes to back up +===================================== + +| The ``--keyspace``/``--dc`` flags allow for specifying glob patter for selecting tables/data centers to back up. +| Even when table should be backed up according to ``--keyspace`` flag, but it is not replicated in specified data centers (``--dc`` flag), the table won't be backed up. + +| All currently down nodes are ignored for the backup procedure. +| In case table should be backed up, but some of its token ranges are not replicated on any currently live node in the cluster, the backup will fail. + +| Moreover, `Materialized Views `_ and `Secondary Indexes `_ + won't be backed up, as they should be restored by recreating them on the restored base table (see `ScyllaDB docs `_). +| In order to ensure that data residing in View table is preserved, make sure to backup its base table. + Process =======