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
