Document D1 errors and expected error rates

[Cherry]

Proposed changes

As per the D1 team and what folks have observed since the product hit GA, errors are "not unexpected".

Errors like:

• D1 DB storage operation exceeded timeout which caused object to be reset
• D1_ERROR: Network connection lost
• Internal error while starting up D1 DB storage caused object to be reset
• D1 DB's isolate exceeded its memory limit and was reset

occur somewhat regularly, and you'll find regular reports in the #d1-database channel in Discord.

The team has said:

retry their query and unless there is an underlying issue with the database, it should eventually work

as well as that a handful of errors every several hours is not unexpected.

An example of the number of errors one can expect with D1 over ~9 months:

While these errors occurring might be expected, I don't think this is well documented currently, and should be made clearer that people should develop with these in mind, focusing on building idempotency into their apps if they scale with D1.

Subject Matter

D1

Content Location

https://developers.cloudflare.com/d1/

Additional information

No response