liveBook · Manning

Row group

As explained in Architecting an Apache Iceberg Lakehouse

A row group is a storage and I/O unit containing a subset of a columnar file's rows.

A row group is a Parquet storage and I/O unit containing a subset of a columnar file’s rows. Within it, column chunks let query engines read only requested columns, while footer statistics help skip irrelevant groups through predicate pushdown. section 5.3.1

Row-group design creates several practical tradeoffs:

  • Smaller row groups can improve parallelism and reduce memory pressure, while oversized groups can cause execution spills because groups are not splittable. section 10.2.2
  • File size and row-group size are related but distinct: files are splittable, whereas parallelism is driven by row-group size. section 10.2.2
  • The appropriate size depends on query-engine behavior, compression, table width, nested data, executor memory, and I/O bandwidth. section 10.2.2
Figure 5.8 Using metadata in Parquet row-group footers, we can tell which row groups to scan and which to skip for faster reads.

Inspect how Parquet row-group footer metadata identifies groups to scan or skip during query planning. section 5.3.1

How Architecting an Apache Iceberg Lakehouse covers it

How deep it goes
Explains storage layout, column chunks, footer statistics, and sizing tradeoffs, but not row-group creation internals.
Examples
Uses Parquet footer metadata diagrams and compaction commands targeting 256 MB output files.
What it assumes
Assumes familiarity with columnar files and Iceberg tables while defining row groups and column chunks directly.
What you can do after
Diagnose memory, spill, parallelism, and scan-efficiency issues by evaluating row-group and file-size choices.
How it connects
Connects Parquet, Iceberg, predicate pushdown, column chunks, compaction, and query-engine parallelism.

Also explained in

Compare how 3 books explain row group →

Related concepts

This explainer was generated by Manning's knowledge graph from the text of Architecting an Apache Iceberg Lakehouse. The section links point to the parts of the book it draws on.