@@ -85,22 +85,9 @@ Rows currently have a populated `finished_at` and the status `hydrated`.
8585Resource columns are nullable because the available kernel and filesystem
8686observations depend on the replica platform.
8787
88- ## Retention and schema evolution
89-
90- ` replica_hydration_history_retention_period ` defaults to 120 days (four months),
91- independently of the object table's 30-day ` hydration_history_retention_period ` .
92- Replica history grows with replicas and episodes, rather than objects times
93- replicas times episodes. Its smaller size makes longer retention practical
94- for capacity planning and hydration and resource-usage trends across releases.
95-
96- Each table's collection and retention steps use its own cutoff. Replica history
97- ages out by ` finished_at ` , in bounded batches through the shared retention path.
98- A zero period expires all completed episodes and prevents their recollection.
99- Disabling collection suspends retention for both tables.
100-
101- The replica table commits to additive-only schema evolution that preserves
102- existing rows. It is exempt from bootstrap reset and forced re-sharding, and
103- capacity-planning history must not be discarded for routine schema
104- changes. An exceptional shard replacement remains a deliberate escape hatch:
105- remove the existing replacement assert and exemption together, and explicitly
106- call out the loss of replica history in the release notes.
88+ ## Addendum: separate replica retention
89+
90+ [ SQL-714] ( https://linear.app/materializeinc/issue/SQL-714 ) introduced
91+ ` replica_hydration_history_retention_period ` after this design, with a default of
92+ 120 days (four months). Object history retains its separate 30-day
93+ ` hydration_history_retention_period ` .
0 commit comments