mirror of
https://github.com/clockworklabs/SpacetimeDB.git
synced 2026-05-13 03:08:40 -04:00
Phoebe Goldman
41eec04ea6
# Description of Changes Prior to this commit, we had special handling for deletes from `st_table` during replay, but we did not pair them with inserts to form updates, instead only treating the delete as a dropped table. With this commit, we record inserts to `st_table` which will form update pairs during replay, and handle them appropriately, updating the table's schema and not dropping the table. There is a tricky case where a table exists but is empty, and then within a single transaction: - The table undergoes a migration s.t. its `table_access` or `primary_key` changes. - At least one row is inserted into the table. In this case, the in-memory table structure will not exist at the point of the `st_table` insert, but will be created before the corresponding `st_table` delete, meaning there will be two conflicting `st_table` rows resident. To handle this case, `CommittedState` tracks a side table, `replay_table_updated`, which stores a `RowPointer` to the correct most-recent `st_table` row for the migrating table. I've also renamed the one previously-extant replay-only side table, `table_dropped`, to include the `replay_` prefix, which IMO improves clarity. And I've made it so `replay_table_dropped` is cleared at the end of each transaction, as the previous behavior of continuing to ignore a table that should be unreachable masked errors which would have been helpful when debugging this issue. This PR also includes an extended error message when encountering a unique constraint violation while replaying, which I found helpful while debugging. # API and ABI breaking changes N/a # Expected complexity level and risk 2 - replay is complicated and scary, but this PR isn't gonna make things *more* broken than they already were. # Testing - [x] Manually replayed a commitlog which included a migration that altered a table's `table_access`, which was previously broken but now replays successfully.
⚠️ Internal Crate ⚠️
This crate is intended for internal use only. It is not stable and may change without notice.