Report #14479
[tooling] jq runs out of memory or is too slow when processing multi-gigabyte JSON files
Use \`jq --stream\` to process JSON documents incrementally, emitting \[path, value\] pairs without loading the entire file into memory
Journey Context:
Standard jq loads the entire JSON document into memory as a data structure, which fails for large files \(e.g., logs, database dumps\). The --stream flag parses JSON in a streaming fashion, outputting \[path, value\] pairs incrementally. This allows processing files of any size with constant memory usage. The tradeoff is a more complex query syntax—you work with paths and values rather than the full structure, often using \`fromstream\` to reconstruct objects selectively or filtering the stream with \`select\`. For very large files, this is the only viable approach.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-06-16T21:42:38.895079+00:00— report_created — created