Skip to content

Clarify TTL document restore behavior in backup documentation#343

Closed
HansWieser-MS wants to merge 1 commit intoMicrosoftDocs:mainfrom
HansWieser-MS:clarify-restore-behavior
Closed

Clarify TTL document restore behavior in backup documentation#343
HansWieser-MS wants to merge 1 commit intoMicrosoftDocs:mainfrom
HansWieser-MS:clarify-restore-behavior

Conversation

@HansWieser-MS
Copy link
Contributor

This PR clarifies the documentation about TTL-expired document restoration behavior in both periodic and continuous backup modes.

Changes Made:

  • Periodic backup documentation: Updated language to clarify that TTL-expired documents are not restored by default, however the behavior can be enforced explicitly
  • Continuous backup documentation: Updated with consistent language for TTL restore behavior
  • Ensures both backup modes have aligned and clear documentation about TTL restoration options

This provides clearer guidance to users about TTL restoration behavior and helps users understand they can explicitly request TTL-expired document restoration when needed.

- 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
@HansWieser-MS
Copy link
Contributor Author

@microsoft-github-policy-service agree company="Microsoft"

@prmerger-automator
Copy link
Contributor

@HansWieser-MS : Thanks for your contribution! The author(s) and reviewer(s) have been notified to review your proposed change.

@learn-build-service-prod
Copy link
Contributor

Learn Build status updates of commit 95d2047:

✅ Validation status: passed

File Status Preview URL Details
articles/cosmos-db/continuous-backup-restore-introduction.md ✅Succeeded
articles/cosmos-db/periodic-backup-restore-introduction.md ✅Succeeded

For more details, please refer to the build report.

@Court72 Court72 requested a review from Copilot January 14, 2026 16:29
@Court72
Copy link
Contributor

Court72 commented Jan 14, 2026

@kanshiG

Can you review the proposed changes?

Important: When the changes are ready for publication, adding a #sign-off comment is the best way to signal that the PR is ready for the review team to merge.

#label:"aq-pr-triaged"
@MicrosoftDocs/public-repo-pr-review-team

@prmerger-automator prmerger-automator bot added the aq-pr-triaged C+L Pull Request Review Team label label Jan 14, 2026
Copy link
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

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.
Copy link

Copilot AI Jan 14, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

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.

Copilot uses AI. Check for mistakes.
Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

pinged my reviewer colleagues :)

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@HansWieser-MS I have the same question as Copilot :) This should link to the doc and header that shows this.

@seesharprun
Copy link
Contributor

@kanshiG, this is a pull request from a customer to update TTL details for backup/restore.

@github-actions
Copy link

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!
SQL Docs Team: Contact Us
Contributor Guide

@github-actions github-actions bot added the inactive This PR is inactive for more than 14 days label Jan 30, 2026
Copy link
Contributor

@markjbrown markjbrown left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Add links to show users how to do restore TTL'd data

@github-actions
Copy link

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
Contributor Guide

@github-actions github-actions bot added the auto-close This PR is auto-closed by Stale Bot due to inactivity. Reopen if needed. label Feb 13, 2026
@github-actions github-actions bot closed this Feb 13, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

aq-pr-triaged C+L Pull Request Review Team label auto-close This PR is auto-closed by Stale Bot due to inactivity. Reopen if needed. azure-cosmos-db/svc Change sent to author do-not-merge inactive This PR is inactive for more than 14 days nosql/subsvc

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants