SQL Source Control 4

How V2 migration scripts are used in deployment

We're going to remove the migrations V2 beta from SQL Source Control in version 5. We're replacing it with an improved version of the original migration scripts feature, which supports more version control systems and actions.

Download the SQL Source Control 5 beta

Scripts created using the V2 beta of migrations won't be compatible with SQL Source Control 5. To learn more, see Upgrading from old versions of migration scripts.

This page refers to the Migrations V2 beta. For information about how to use V1 migration scripts, see Working with migration scripts.

Imagine a database developer, Lucy, is working on a database. We'll call Lucy's current version of the database revision A.

Lucy renames a table and adds a migration script to prevent data loss (just like this example). Then she commits the change, including the migration script, to source control. This creates revision B.

Another developer on Lucy's team, Sam, has his own database. This is still at revision A. He updates it to revision B and gets Lucy's change. 

To do this, SQL Source Control runs a series of steps:


SQL Source Control stores migration scripts in table-valued functions on the database. To check if there are migration scripts to run in this deployment, SQL Source Control compares the table-valued functions in revision A (in Sam's database) and B (in source control).


SQL Source Control finds Lucy's migration script in revision B, and finds that it doesn't exist in Sam's database. This means it hasn't been run on Sam's database yet.


Before SQL Source Control runs the migration script on Sam's database, it creates a temporary database and copies Sam's schema to it. This is so Sam's database is unaffected if any of the following steps fail.

You can choose whether the database is created on the server or on LocalDB. For more information, see Setting the location of the temporary database.


SQL Source Control runs the migration script on the temporary database.

This creates a temporary new revision, A1. Revision A1 consists of revision A plus the changes made by Lucy's migration script.



To determine the remaining differences, SQL Source Control compares revision A1 and revision B.

Sam's database is still unchanged at this point.


To update the temporary database to revision B, SQL Source Control writes a new script with the remaining changes. We'll call this the remainder script.

SQL Source Control will only run the remainder script script on the temporary database, which is at revision A1. The remainder script won't work on Sam's database, which is still at revision A.



SQL Source Control prepends Lucy's migration script from step 2 to the remainder script from step 6. This creates the final deployment script.


Finally, the deployment script is run on Sam's database to update it to revision B. The temporary database is deleted.



Didn't find what you were looking for?