Skip to main content

MIGRATIONS

Static MIGRATIONS 

Source
static MIGRATIONS: LazyLock<Vec<MigrationStep>>
Expand description

Builtin schema migrations required to upgrade to the current build version.

Migration steps for old versions must be retained around according to the upgrade policy. For example, if we support upgrading one major version at a time, the release of version N.0.0 can delete all migration steps with versions before (N-1).0.0.

Exception: when a builtin’s SystemObjectDescription changes — e.g. a builtin table is converted to a materialized view (see migrate_builtin_tables_to_mvs), or a builtin is renamed or removed — existing steps naming the old description must be removed regardless of version, because validate_migration_steps panics on steps that don’t resolve to a current builtin. This is safe only if a Replacement step for the new description is added at the conversion version: every environment that needed the removed steps upgrades from an even older version, so the new replacement subsumes them.

Smallest supported version: 0.147.0