A Safe Schema Evolution Workflow
A disciplined workflow can make schema evolution predictable:
- Introduce the replacement field or type.
- Keep the existing field working.
- Deprecate the old field with a migration reason.
- Identify clients still using the deprecated field.
- Migrate those clients.
- Verify that usage has reached zero or an approved threshold.
- Remove the deprecated field in a controlled change.
This approach minimizes unexpected client failures.