liveBook · Manning

Snapshot reference

As explained in Architecting an Apache Iceberg Lakehouse

A snapshot reference is a named pointer to a particular table snapshot.

A snapshot reference is a named pointer to a particular Apache Iceberg table snapshot. Tags remain fixed, while branches can advance as new snapshots are added. section 11.2.2

Use snapshot references to:

  • Bookmark a known-good release for reproducible reporting or downstream jobs. section 11.2.2
  • Isolate development or QA changes through branches that advance with new snapshots. section 11.2.2
  • Tie snapshot retention and garbage collection to references rather than raw timestamps. section 11.2.2
SELECT ref_name, type, snapshot_id, max_reference_age_in_ms
FROM "db "."critical_fact_table.refs ";

Inspect a table’s refs table to list reference names, types, target snapshots, and maximum reference ages. section 11.2.2

How Architecting an Apache Iceberg Lakehouse covers it

How deep it goes
Defines branches and tags, explains their lifecycle roles, and stops short of cross-table isolation.
Examples
Uses main, dev, and release_2023_09 references to illustrate production, testing, and fixed-release snapshots.
What you can do after
Operate table-level version governance by creating stable tags, advancing branches, and inspecting reference age policies.
How it connects
Connects snapshots with branches, tags, snapshot isolation, rollback, reproducibility, and retention policies.

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.