Skip to content
Merged
Changes from all commits
Commits
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
9 changes: 9 additions & 0 deletions src/how-to/garbage-collection.md
Original file line number Diff line number Diff line change
Expand Up @@ -16,6 +16,15 @@ remain. This is by design:

Run garbage collection periodically to reclaim storage space.

!!! note "Concurrency semantics"
Garbage collection is single-pass and best-effort: it scans references,
then deletes objects the scan did not see referenced. If a row is inserted
between the scan and the delete, the object it references can be deleted
even though it is now in use — leaving the new row with a dangling
reference. A future release will add quarantine-based serialization to
close this window. Until then, prefer running GC during quiet periods, and
treat any single GC pass as best-effort rather than transactionally safe.

## Basic Usage

```python
Expand Down
Loading