Skip to content

docs(ai): document snapshot per-hour scheduling limit (blocked on neon-cloud#9065) #5559

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

Open
bgrenon wants to merge 6 commits into
base: main
Choose a base branch
from
Open

docs(ai): document snapshot per-hour scheduling limit (blocked on neon-cloud#9065) #5559

Changes from all commits
Commits
Show all changes
6 commits
Select commit Hold shift + click to select a range
e693b20
docs(ai): document snapshot per-hour scheduling limit
Aug 17, 2026
d78cf4e
docs(ai): tighten snapshot per-hour scheduling section
Aug 17, 2026
61b8991
docs(ai): finalize snapshot per-hour scheduling wording
Aug 17, 2026
3929dfd
docs(ai): format snapshot scheduling strategies as bullets
Aug 17, 2026
5e1a607
docs(ai): drop numeric limit, keep bare good-practice guidance
Aug 18, 2026
f30e8c5
docs(ai): split scheduling intro into two sentences
Aug 18, 2026
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
12 changes: 11 additions & 1 deletion content/docs/ai/ai-database-versioning.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,7 @@ summary: >-
connection string stable, or when you need temporary preview branches from any
saved version. Snapshot limits and storage pricing vary by plan.
enableTableOfContents: true
updatedOn: '2026-08-07T17:19:40.308Z'
updatedOn: '2026-08-18T13:12:58.000Z'
---

<Admonition type="note">
Expand Down Expand Up @@ -378,6 +378,16 @@ Proper cleanup reduces costs and keeps your project manageable:
- **Cleanup strategy**: Set `expires_at` on temporary snapshots and preview branches. Delete orphaned branches (for example, `production (old)`) created during restores.
- **Version metadata**: Keep version metadata separate to preserve audit trail across restores.

## Scheduling snapshots at scale

If you create scheduled snapshots programmatically at high volume (for example, an agent platform that schedules across many branches), it's good practice to distribute snapshot creation across different hours of the day rather than concentrating it in one. For example, avoid scheduling every branch at midnight.

A scheduled snapshot's `hour` (`0`–`23`) sets when it's created. Spread the `hour` across branches:

- **Hash the branch ID**: map each branch to a fixed hour (`0`–`23`) so it always schedules to the same hour.
- **Cycle through hours**: assign each new schedule the next hour in sequence.
- **Pick a random hour**: choose one per branch and keep it.

## FAQ

<DefinitionList>
Expand Down
Loading