Skip to content

Add out-of-order data concept page#454

Merged
javier merged 1 commit into
mainfrom
jv/out_of_order_story
May 26, 2026
Merged

Add out-of-order data concept page#454
javier merged 1 commit into
mainfrom
jv/out_of_order_story

Conversation

@javier
Copy link
Copy Markdown
Collaborator

@javier javier commented May 26, 2026

Summary

  • New /docs/concepts/out-of-order-data/ page consolidating what was previously scattered across designated-timestamp, partitions, capacity-planning, ILP overview, CSV import, WAL, and time-series-optimizations. Covers per-ingestion-method behavior, engine mechanics, write amplification (with the recently exposed table_write_amp_* columns and a more honest framing of what "high" means, validated against Slack discussions with the engineering team), tuning, and common scenarios.
  • Clarifies that write amplification is not exclusively caused by out-of-order writes: incremental materialized view refreshes (replace-range commits) and UPDATE statements contribute too. Capacity-planning page updated to reflect this.
  • Inbound links added from designated-timestamp, partitions, write-ahead-log, capacity-planning, schema-design-essentials, ILP overview, CSV import, and time-series-optimizations.
  • Piggybacked: date-time functions page now has a tip pointing at the dedicated timestamp() function page (which is otherwise hard to find), and the SELECT subsection of that page gets a warning about silent wrong results when data isn't sorted by the elected column. Also corrected an inline typo where LATEST BY was listed twice.

New /docs/concepts/out-of-order-data/ page with per-ingestion-method
behavior, engine mechanics, write amplification monitoring (per-table
via tables() and cluster-wide via Prometheus), tuning, and common
scenarios. Notes that write amplification also comes from incremental
materialized view refreshes and UPDATE, not only out-of-order writes.

Shrinks the OOO subsection in designated-timestamp.md and adds inbound
links from partitions, write-ahead-log, capacity-planning,
schema-design-essentials, ILP overview, CSV import, and
time-series-optimizations.

Adds a tip on the date-time functions page pointing at the dedicated
timestamp() function page, and a sort-order warning to the SELECT
subsection of that page.
@github-actions
Copy link
Copy Markdown

🚀 Build success!

Latest successful preview: https://preview-454--questdb-documentation.netlify.app/docs/

Commit SHA: 729cd39

📦 Build generates a preview & updates link on each commit.

@javier javier merged commit b9c9a1f into main May 26, 2026
3 checks passed
@javier javier deleted the jv/out_of_order_story branch May 26, 2026 15:59
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant