Skip to content

docs: recommend Parquet and storage policies for compression instead of ZFS - #590

Merged
javier merged 1 commit into
mainfrom
jv/compression_parquet
Oct 19, 2026
Merged

javier merged 1 commit into
mainfrom
jv/compression_parquet

Conversation

@javier

@javier javier commented Oct 19, 2026

Copy link
Copy Markdown
Collaborator

Summary

ZFS used to be the only way to compress QuestDB data, but it works outside the database. Parquet partitions are now the recommended approach: converted by hand on OSS, or automatically with storage policies on Enterprise.

  • AWS, Azure, GCP: recommend ext4/xfs, compress with a TO PARQUET storage policy, and tier to object storage with TO REMOTE for further savings (cheaper storage, a single shared copy across instances, history beyond one volume)
  • Enterprise quick start: fold compression and storage policies into one step, explaining that storage policies also compress data on local volumes, not only tier to cold storage. Removes the ZFS setup (which had a broken zpool command) and updates the compression FAQ
  • Capacity planning: drop the claim that ZFS is required for compression
  • ZFS compression page: add a warning recommending Parquet
  • Remove the misleading Docker ZFS storage driver note and an unused file system snippet

…of ZFS

Cloud deployment pages, capacity planning and the Enterprise quick start now point to Parquet conversion (storage policies on Enterprise, manual conversion on OSS) and tiering to object storage. The quick start folds compression and storage policies into one step. The ZFS page gets a warning recommending Parquet, the Docker ZFS note and an unused file system snippet are removed.
@github-actions

Copy link
Copy Markdown

🤖 Component Converter Reminder

A component in src/components/ or src/theme/ was modified in this pull request.

We are creating markdown correspondents of every path (e.g. questdb.com/docs/quick-start/ → questdb.com/docs/quick-start.md) for LLM consumption.
If the component usage is shadowing useful content, it may need a converter for markdown output in convert-components.js.

Quick Check

  • ✅ Content component (code, tables, data) → Add converter if not exists
  • ❌ UI/visual component (styling, buttons, decorative) → No converter needed

💡 This is a friendly reminder, not a blocker. Ignore if not applicable.

@javier javier added the preview label Oct 19, 2026
@javier
javier marked this pull request as ready for review October 19, 2026 15:49
@javier
javier merged commit ef57850 into main Oct 19, 2026
5 checks passed
@javier
javier deleted the jv/compression_parquet branch October 19, 2026 16:00
@github-actions

Copy link
Copy Markdown

🚀 Build success!

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

Commit SHA: 1d11172

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

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant