Skip to content

Conversation

@lambrospetrou
Copy link
Contributor

Summary

Rewording the D1 documentation about how much work can be done since this is a very common question by D1 users.

Screenshots (optional)

Screenshot 2025-11-07 at 11 41 46

Documentation checklist

  • Is there a changelog entry (guidelines)? If you don't add one for something awesome and new (however small) — how will our customers find out? Changelogs are automatically posted to RSS feeds, the Discord, and X.
  • The change adheres to the documentation style guide.
  • If a larger change - such as adding a new page- an issue has been opened in relation to any incorrect or out of date information that this PR fixes.
  • Files which have changed name or location have been allocated redirects.

Oxyjun and others added 2 commits November 7, 2025 12:32
Co-authored-by: Jun Lee <junlee@cloudflare.com>

A database that receives too many concurrent requests will first attempt to queue them. If the queue becomes full, the database will return an ["overloaded" error](/d1/observability/debug-d1/#error-list).

Each individual D1 database is backed by a single [Durable Object](/durable-objects/concepts/what-are-durable-objects/).
Copy link
Contributor

Choose a reason for hiding this comment

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

  • should mention how replication alters this
  • could raise reader question of durability

Copy link
Contributor Author

@lambrospetrou lambrospetrou Nov 7, 2025

Choose a reason for hiding this comment

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

This doesn't really change though if we take each replica separately.

I can add a sub-section at the end for read replication to add some clarification.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Suggested change
Each individual D1 database is backed by a single [Durable Object](/durable-objects/concepts/what-are-durable-objects/).
Each individual D1 database is backed by a single [Durable Object](/durable-objects/concepts/what-are-durable-objects/). When using [D1 read replication](https://developers.cloudflare.com/d1/best-practices/read-replication/#primary-database-instance-vs-read-replicas) each replica instance is a different Durable Object and the guidelines apply to each replica instance independently.

@vy-ton what do you think?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

8 participants