docs: document terminal_flush_batch_size (batched deletes)#132
Merged
Conversation
Add the knob to the subscriber-options table and a dedicated 'Batching terminal deletes' section: the 100x round-trip win, the idle-flush no-latency behavior, and the at-least-once redelivery tradeoff on ungraceful crash. Off by default; recommended per-subscriber for high-throughput idempotent handlers. Fills the user-facing gap (the feature shipped in #131 with only internal architecture docs).
lesnik512
added a commit
that referenced
this pull request
Jul 16, 2026
Curated notes for the 0.11.0 minor release: producer NOTIFY dedup (#135), opt-in batched terminal flush (#131/#132), outbox_autovacuum_ddl helper + cost knobs and check_autovacuum probe (#133/#134), benchmark harness (#130). Required by release.yml before the 0.11.0 tag can publish. Co-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Fills the user-facing docs gap for the batched terminal flush shipped in #131. That change promoted only the internal
architecture/docs, sodocs/usage/subscriber.mdnever mentioned theterminal_flush_batch_sizeknob — a user reading the published docs couldn't discover it.Adds:
DELETEs; one batched worker out-throughputs a four-worker per-row subscriber), the idle-flush no-added-latency behavior, and the at-least-once redelivery tradeoff on an ungraceful crash (bounded bybatch_size, requires idempotent handlers, graceful stop flushes cleanly), plus the backlog-visibility and lease-ceiling effects to size for.Framing per the maintainer decision: off by default stays (byte-for-byte the per-row path), documented as a recommended per-subscriber opt-in for high-throughput idempotent queues rather than a flipped default.
Docs-only;
mkdocs build --strictclean (new#batching-terminal-deletesanchor resolves).🤖 Generated with Claude Code