Clarify TTL document restore behavior in backup documentation#343
Clarify TTL document restore behavior in backup documentation#343HansWieser-MS wants to merge 1 commit intoMicrosoftDocs:mainfrom
Conversation
- Updated periodic backup documentation to clarify that TTL-expired documents are not restored by default but behavior can be enforced explicitly - Updated continuous backup documentation with consistent language for restore behavior - Ensures both backup modes have aligned documentation about restoration options
|
@microsoft-github-policy-service agree company="Microsoft" |
|
@HansWieser-MS : Thanks for your contribution! The author(s) and reviewer(s) have been notified to review your proposed change. |
|
Learn Build status updates of commit 95d2047: ✅ Validation status: passed
For more details, please refer to the build report. |
|
Can you review the proposed changes? Important: When the changes are ready for publication, adding a #label:"aq-pr-triaged" |
There was a problem hiding this comment.
Pull request overview
This PR clarifies the documentation about TTL-expired document restoration behavior in both periodic and continuous backup modes for Azure Cosmos DB.
Changes:
- Updated periodic backup documentation to clarify that TTL-expired documents are not restored by default, but the behavior can be enforced explicitly
- Updated continuous backup documentation with consistent TTL restore behavior language and reformatted the "What isn't restored?" list
- Ensured both backup modes have aligned documentation about TTL restoration options
Reviewed changes
Copilot reviewed 2 out of 2 changed files in this pull request and generated 1 comment.
| File | Description |
|---|---|
| articles/cosmos-db/periodic-backup-restore-introduction.md | Updated TTL restoration behavior statement to clarify default behavior and explicit enforcement option |
| articles/cosmos-db/continuous-backup-restore-introduction.md | Added TTL restoration statement and reformatted list items with proper markdown syntax |
Comments suppressed due to low confidence (1)
articles/cosmos-db/continuous-backup-restore-introduction.md:65
- The statement claims 'the behavior can be enforced explicitly' but there is no documentation in the codebase explaining how to explicitly enforce TTL-expired document restoration. This could confuse users who want to restore TTL-expired documents. Either add documentation explaining how to enforce this behavior, link to relevant documentation, or remove the claim if this feature doesn't exist or isn't documented.
- Documents that were deleted because of expired TTL are not restored by default, however the behavior can be enforced explicitly.
| - Stored procedures, triggers, user-defined functions (UDF). | ||
| - Role-based access control assignments. These need to be reassigned. | ||
| - Documents that were deleted because of expired TTL. | ||
| - Documents that were deleted because of expired TTL are not restored by default, however the behavior can be enforced explicitly. |
There was a problem hiding this comment.
The statement claims 'the behavior can be enforced explicitly' but there is no documentation in the codebase explaining how to explicitly enforce TTL-expired document restoration. This could confuse users who want to restore TTL-expired documents. Either add documentation explaining how to enforce this behavior, link to relevant documentation, or remove the claim if this feature doesn't exist or isn't documented.
There was a problem hiding this comment.
pinged my reviewer colleagues :)
There was a problem hiding this comment.
@HansWieser-MS I have the same question as Copilot :) This should link to the doc and header that shows this.
|
@kanshiG, this is a pull request from a customer to update TTL details for backup/restore. |
|
This pull request has been inactive for 14 days. If you are finished with your changes, don't forget to sign off. See the contributor guide for instructions. If this PR is inactive for 14 more days, it will be closed automatically. Thank you! |
markjbrown
left a comment
There was a problem hiding this comment.
Add links to show users how to do restore TTL'd data
|
This pull request has been inactive for 28 days. At this time, we are closing the PR. If you decide to continue working on your change, you can reopen the PR and continue working. Thank you! SQL Docs Team: Contact Us |
This PR clarifies the documentation about TTL-expired document restoration behavior in both periodic and continuous backup modes.
Changes Made:
This provides clearer guidance to users about TTL restoration behavior and helps users understand they can explicitly request TTL-expired document restoration when needed.