Skip to content

Commit 8e07796

Browse files
authored
[DO] Note on nominal metadata when writing to SQLite DO (#20217)
* Adding note on storing metadata when writing to SQLite-backed DO. * Wording clarification * Implementing PCX review feedback. * Turning the caution note into FAQ section. * Clarifying language on empty database and nominal metadata. * Splitting question into 2 for clearer framing.
1 parent 98c18bc commit 8e07796

File tree

2 files changed

+16
-2
lines changed

2 files changed

+16
-2
lines changed

src/content/docs/durable-objects/platform/limits.mdx

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -44,7 +44,9 @@ For Durable Object classes with [SQLite storage backend](/durable-objects/best-p
4444

4545
<Render file="limits_increase" product="workers" />
4646

47-
## How much work can a single Durable Object do?
47+
## Frequently Asked Questions
48+
49+
### How much work can a single Durable Object do?
4850

4951
Durable Objects can scale horizontally across many Durable Objects. Each individual Object is inherently single-threaded.
5052

@@ -54,7 +56,7 @@ Durable Objects can scale horizontally across many Durable Objects. Each individ
5456

5557
A Durable Object that receives too many requests will, after attempting to queue them, return an [overloaded](/durable-objects/observability/troubleshooting/#durable-object-is-overloaded) error to the caller.
5658

57-
## How many Durable Objects can I create?
59+
### How many Durable Objects can I create?
5860

5961
Durable Objects are designed such that the number of individual objects in the system do not need to be limited, and can scale horizontally.
6062

src/content/docs/durable-objects/platform/pricing.mdx

Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -118,3 +118,15 @@ In this scenario, the estimated monthly cost would be calculated as:
118118
## Storage API billing
119119

120120
<Render file="storage_api_pricing" product="workers" />
121+
122+
## Frequently Asked Questions
123+
124+
### Does an empty table / SQLite database contribute to my storage?
125+
126+
Yes, although minimal. Empty tables can consume at least a few kilobytes, based on the number of columns (table width) in the table. An empty SQLite database consumes approximately 12 KB of storage.
127+
128+
### Does metadata stored in Durable Objects count towards my storage?
129+
130+
All writes to a SQLite-backed Durable Object stores nominal amounts of metadata in internal tables in the Durable Object, which counts towards your billable storage.
131+
132+
The metadata remains in the Durable Object until you call [`deleteAll()`](/durable-objects/api/storage-api/#deleteall).

0 commit comments

Comments
 (0)