liveBook · Manning

Split-brain

As explained in Architecting an Apache Iceberg Lakehouse

A split-brain scenario is a distributed-system condition in which multiple systems independently believe they own the authoritative state of the same resource.

A split-brain scenario occurs when multiple systems believe they own the authoritative state of the same resource. In Iceberg recovery, registering identical exported metadata in multiple catalogs and permitting writes in more than one environment can create divergent table states and metadata corruption. section 11.3.3

Treat registered metadata as read-only for inspection, validation, or testing. When independent ownership is required, clone the table by copying data and regenerating metadata, rather than sharing writable metadata. Delay destructive operations until replicated metadata has caught up. section 11.3.3 section 11.3.3

Cross-environment validation

A team exports metadata.json from production and uses register_table in a test catalog to reproduce a table state. The test registration remains read-only; otherwise, production and test could concurrently modify the same Iceberg table state. section 11.3.3

How Architecting an Apache Iceberg Lakehouse covers it

How deep it goes
Defines the failure mode, traces divergence and metadata corruption, and prescribes read-only registration or independent cloning.
Examples
Uses exported metadata.json, register_table, isolated test catalogs, and delayed cleanup during replication lag.
What it assumes
Assumes familiarity with Iceberg tables, catalogs, metadata snapshots, and replication across environments.
What you can do after
Operate cross-environment recovery without granting concurrent write ownership to shared table metadata.
How it connects
Connects Iceberg metadata snapshots, catalogs, table cloning, object-storage replication, and snapshot expiration.

Also explained in

Compare how 3 books explain split-brain →

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.