A release was blocked because a single table needed a new column.
Adding a new column is one of the most common changes in a database, yet it still stops teams in their tracks. Done wrong, it can lock tables, slow queries, or trigger hours of downtime. Done right, it deploys cleanly, preserves data integrity, and keeps production running without a hitch.
A new column alters both the data structure and the application layer. You need to decide its data type, default values, nullability, indexing, and migration path. In environments with zero downtime requirements, you must manage backward compatibility — more specifically, ensuring old code ignores the new column until the deployment is complete.
Best practice is a two-step migration. First, deploy the schema change to add the column in a non-blocking way, often without constraints. Then, once the application writes to the new column, apply constraints or indexes as a separate operation. This reduces lock contention and avoids unexpected query failures.