Schema & Map Version Control
Versions are derived from the ledger, not the other way round. SchemaVersionPublished and MappingVersionPublished entries are the canonical source of every semantic version increment — patch, minor, or major — and the diff between them is a hash‑checkable subsection of the chain.
Every change to a schema or mapping in Magellan is versioned automatically using semantic versioning (major.minor.patch), creating a complete history of how your metadata has evolved.
Semantic versioning communicates the nature of each change: patch versions for backward‑compatible fixes, minor versions for additive changes, and major versions for breaking changes — giving downstream consumers clear signals about compatibility.
Each version increment writes `SchemaVersionPublished` or `MappingVersionPublished` to the ledger, carrying the prior version, the new version, the change classification (patch/minor/major), and the diff hash. Version history is a derivation of the ledger, not a parallel record that can drift.
Users can compare any two versions side by side to see exactly what changed — added fields, removed mappings, modified rules.
Roll‑back capability means that if a change causes problems, you can instantly revert to a known‑good version without manual reconstruction. The rollback itself writes `VersionRolledBack` to the ledger — append-only forward, even when the effect is to restore an older state.
Version history supports compliance audits by providing a timestamped, attributed record of every change to your data governance assets.
Audit ledger entries written by this feature
Each action in this feature appends one of the following entry types to the ULID‑keyed, SHA‑256 hash‑chained audit ledger. A reviewer can replay the chain to reconstruct exactly what happened, when, and under which role.
SchemaVersionPublishedMappingVersionPublishedVersionRolledBackVersionDiffComputedRelated glossary terms
Definitions for the technical, regulatory, and standards terms referenced on this page. Each link opens the term in the full glossary.
Open the full glossary