Skip to content

PBM-1561 Revise known limitations for backups and restores #302

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
nastena1606 merged 3 commits into from
Sep 16, 2025
Merged

PBM-1561 Revise known limitations for backups and restores #302

Changes from 1 commit
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
636e518
PBM-1561 Revise known limitations for backups and restores
radoslawszulgo Sep 16, 2025
daf47a7
Update docs/features/known-limitations.md
radoslawszulgo Sep 16, 2025
83421f8
Update docs/features/known-limitations.md
radoslawszulgo Sep 16, 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
11 changes: 5 additions & 6 deletions docs/features/known-limitations.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -5,15 +5,14 @@
## Selective backups and restores

1. Only **logical** backups and restores are supported.
2. Selective backups and restores are supported in sharded clusters for non-sharded collections starting with version 2.0.3. Sharded collections are supported starting with version 2.1.0.
3. Sharded time series collections are not supported.
4. Multi-collection transactions are not yet supported for selective restore. However, if you use them and attempt a selective restore, it may break [ACID](../reference/glossary.md#acid) because not all operations with this transaction are restored. PBM applies oplog events that relate only to the specified namespaces(s). Thus, from the transaction's point of view, the data consistency may be broken.
2. Selective backups and restores are supported in sharded clusters for non-sharded collections starting with version 2.0.3. Sharded collections are supported starting with version 2.1.0. 3. Selective restore of sharded collections from either a full logical backup or a selective logical backup is not supported if the distribution of chunks in the backup differs from the distribution of chunks in the existing collection. The supported way to restore in this scenario is to drop the target collection before performing the selective restore, ensuring shard metadata is recreated consistently.

Check notice on line 8 in docs/features/known-limitations.md

View workflow job for this annotation

GitHub Actions / vale

[vale] docs/features/known-limitations.md#L8 

[Google.Passive] In general, use active voice instead of passive voice ('are supported').
Raw output 
{"message": "[Google.Passive] In general, use active voice instead of passive voice ('are supported').", "location": {"path": "docs/features/known-limitations.md", "range": {"start": {"line": 8, "column": 35}}}, "severity": "INFO"}

Check failure on line 8 in docs/features/known-limitations.md

View workflow job for this annotation

GitHub Actions / vale

[vale] docs/features/known-limitations.md#L8 

[Vale.Spelling] Did you really mean 'sharded'?
Raw output 
{"message": "[Vale.Spelling] Did you really mean 'sharded'?", "location": {"path": "docs/features/known-limitations.md", "range": {"start": {"line": 8, "column": 52}}}, "severity": "ERROR"}

Check notice on line 8 in docs/features/known-limitations.md

View workflow job for this annotation

GitHub Actions / vale

[vale] docs/features/known-limitations.md#L8 

[Google.Passive] In general, use active voice instead of passive voice ('are supported').
Raw output 
{"message": "[Google.Passive] In general, use active voice instead of passive voice ('are supported').", "location": {"path": "docs/features/known-limitations.md", "range": {"start": {"line": 8, "column": 146}}}, "severity": "INFO"}

Check failure on line 8 in docs/features/known-limitations.md

View workflow job for this annotation

GitHub Actions / vale

[vale] docs/features/known-limitations.md#L8 

[Vale.Spelling] Did you really mean 'sharded'?
Raw output 
{"message": "[Vale.Spelling] Did you really mean 'sharded'?", "location": {"path": "docs/features/known-limitations.md", "range": {"start": {"line": 8, "column": 213}}}, "severity": "ERROR"}

Check notice on line 8 in docs/features/known-limitations.md

View workflow job for this annotation

GitHub Actions / vale

[vale] docs/features/known-limitations.md#L8 

[Google.Contractions] Use 'isn't' instead of 'is not'.
Raw output 
{"message": "[Google.Contractions] Use 'isn't' instead of 'is not'.", "location": {"path": "docs/features/known-limitations.md", "range": {"start": {"line": 8, "column": 297}}}, "severity": "INFO"}

Check notice on line 8 in docs/features/known-limitations.md

View workflow job for this annotation

GitHub Actions / vale

[vale] docs/features/known-limitations.md#L8 

[Google.Passive] In general, use active voice instead of passive voice ('is recreated').
Raw output 
{"message": "[Google.Passive] In general, use active voice instead of passive voice ('is recreated').", "location": {"path": "docs/features/known-limitations.md", "range": {"start": {"line": 8, "column": 570}}}, "severity": "INFO"}
4.. Sharded time series collections are not supported.

Check failure on line 9 in docs/features/known-limitations.md

View workflow job for this annotation

GitHub Actions / vale

[vale] docs/features/known-limitations.md#L9 

[Vale.Spelling] Did you really mean 'Sharded'?
Raw output 
{"message": "[Vale.Spelling] Did you really mean 'Sharded'?", "location": {"path": "docs/features/known-limitations.md", "range": {"start": {"line": 9, "column": 5}}}, "severity": "ERROR"}

Check notice on line 9 in docs/features/known-limitations.md

View workflow job for this annotation

GitHub Actions / vale

[vale] docs/features/known-limitations.md#L9 

[Google.Contractions] Use 'aren't' instead of 'are not'.
Raw output 
{"message": "[Google.Contractions] Use 'aren't' instead of 'are not'.", "location": {"path": "docs/features/known-limitations.md", "range": {"start": {"line": 9, "column": 37}}}, "severity": "INFO"}
5. Multi-collection transactions are not yet supported for selective restore. However, if you use them and attempt a selective restore, it may break [ACID](../reference/glossary.md#acid) because not all operations with this transaction are restored. PBM applies oplog events that relate only to the specified namespaces(s). Thus, from the transaction's point of view, the data consistency may be broken.

Check notice on line 10 in docs/features/known-limitations.md

View workflow job for this annotation

GitHub Actions / vale

[vale] docs/features/known-limitations.md#L10 

[Google.Contractions] Use 'aren't' instead of 'are not'.
Raw output 
{"message": "[Google.Contractions] Use 'aren't' instead of 'are not'.", "location": {"path": "docs/features/known-limitations.md", "range": {"start": {"line": 10, "column": 34}}}, "severity": "INFO"}

Check notice on line 10 in docs/features/known-limitations.md

View workflow job for this annotation

GitHub Actions / vale

[vale] docs/features/known-limitations.md#L10 

[Google.Acronyms] Spell out 'ACID', if it's unfamiliar to the audience.
Raw output 
{"message": "[Google.Acronyms] Spell out 'ACID', if it's unfamiliar to the audience.", "location": {"path": "docs/features/known-limitations.md", "range": {"start": {"line": 10, "column": 151}}}, "severity": "INFO"}

Check notice on line 10 in docs/features/known-limitations.md

View workflow job for this annotation

GitHub Actions / vale

[vale] docs/features/known-limitations.md#L10 

[Google.Passive] In general, use active voice instead of passive voice ('are restored').
Raw output 
{"message": "[Google.Passive] In general, use active voice instead of passive voice ('are restored').", "location": {"path": "docs/features/known-limitations.md", "range": {"start": {"line": 10, "column": 237}}}, "severity": "INFO"}

Check failure on line 10 in docs/features/known-limitations.md

View workflow job for this annotation

GitHub Actions / vale

[vale] docs/features/known-limitations.md#L10 

[Google.OptionalPlurals] Don't use plurals in parentheses such as in 'namespaces(s)'.
Raw output 
{"message": "[Google.OptionalPlurals] Don't use plurals in parentheses such as in 'namespaces(s)'.", "location": {"path": "docs/features/known-limitations.md", "range": {"start": {"line": 10, "column": 310}}}, "severity": "ERROR"}

Check notice on line 10 in docs/features/known-limitations.md

View workflow job for this annotation

GitHub Actions / vale

[vale] docs/features/known-limitations.md#L10 

[Google.Parens] Use parentheses judiciously.
Raw output 
{"message": "[Google.Parens] Use parentheses judiciously.", "location": {"path": "docs/features/known-limitations.md", "range": {"start": {"line": 10, "column": 320}}}, "severity": "INFO"}

Check notice on line 10 in docs/features/known-limitations.md

View workflow job for this annotation

GitHub Actions / vale

[vale] docs/features/known-limitations.md#L10 

[Google.Passive] In general, use active voice instead of passive voice ('be broken').
Raw output 
{"message": "[Google.Passive] In general, use active voice instead of passive voice ('be broken').", "location": {"path": "docs/features/known-limitations.md", "range": {"start": {"line": 10, "column": 394}}}, "severity": "INFO"}

For example, you have a transaction that involves collections A and B. When you restore collection A, PBM replays oplog events only for collection A and ignores those related to collection B. As a result, the state of collection B remains unchanged and is no longer consistent with collection A.

5. System collections in ``admin``, ``config``, and ``local`` databases cannot be backed up and restored selectively. You must make a full backup and restore to include them.
6. Selective point-in-time recovery is not supported for sharded clusters.

6. System collections in ``admin``, ``config``, and ``local`` databases cannot be backed up and restored selectively. You must make a full backup and restore to include them.

Check notice on line 14 in docs/features/known-limitations.md

View workflow job for this annotation

GitHub Actions / vale

[vale] docs/features/known-limitations.md#L14 

[Google.Contractions] Use 'can't' instead of 'cannot'.
Raw output 
{"message": "[Google.Contractions] Use 'can't' instead of 'cannot'.", "location": {"path": "docs/features/known-limitations.md", "range": {"start": {"line": 14, "column": 73}}}, "severity": "INFO"}

Check notice on line 14 in docs/features/known-limitations.md

View workflow job for this annotation

GitHub Actions / vale

[vale] docs/features/known-limitations.md#L14 

[Google.Passive] In general, use active voice instead of passive voice ('be backed').
Raw output 
{"message": "[Google.Passive] In general, use active voice instead of passive voice ('be backed').", "location": {"path": "docs/features/known-limitations.md", "range": {"start": {"line": 14, "column": 80}}}, "severity": "INFO"}
7. Selective point-in-time recovery is not supported for sharded clusters.

Check notice on line 15 in docs/features/known-limitations.md

View workflow job for this annotation

GitHub Actions / vale

[vale] docs/features/known-limitations.md#L15 

[Google.Contractions] Use 'isn't' instead of 'is not'.
Raw output 
{"message": "[Google.Contractions] Use 'isn't' instead of 'is not'.", "location": {"path": "docs/features/known-limitations.md", "range": {"start": {"line": 15, "column": 37}}}, "severity": "INFO"}

Check failure on line 15 in docs/features/known-limitations.md

View workflow job for this annotation

GitHub Actions / vale

[vale] docs/features/known-limitations.md#L15 

[Vale.Spelling] Did you really mean 'sharded'?
Raw output 
{"message": "[Vale.Spelling] Did you really mean 'sharded'?", "location": {"path": "docs/features/known-limitations.md", "range": {"start": {"line": 15, "column": 58}}}, "severity": "ERROR"}

## Oplog slicing for point-in-time recovery

Expand Down