Denna blogpost är en fortsättning på Att underhålla en databas (del 1).
Microsoft släppte i våras Entity Framework Migrations, vilket är ett Migrations-verktyg för oss som sitter i .Net. Idén bakom verktyget är inte nytt, då det t.ex kommer med ramverket ruby on rails där det kallas Active Records Migrations, och det har även funnits tredjeparts ramverk till C# så som DotNetMigrations. Så hur fungerar EF Migrations och på vilket sätt är det det bästa migrations-verktyget som jag än så länge har sett (oberoende av plattform)?
Ett migrations-verktyg bygger på principen av förändringsskript som jag beskrev i min föregående blogpost. Migrations bygger vidare på den idén genom att definiera en struktur för skripten, och automatiserar hanteringen av dem.
I EF Migrations så är strukturen så simpel som en mapp med .cs filer, där varje fil representerar en migration. En migration består av två förändringsskript; Ett “Up”-skript för hur en förändring appliceras, samt ett “Down”-skript för hur samma förändring reverseras. Varje migration får dessutom en timestamp prefixat på sitt filnamn, så att det finns en enkel och tydlig ordning mellan de olika skripten.
För att hålla reda på i vilket tillstånd din databas befinner sig i så skapar EF migrations en tabell i din databas som heter __MigrationHistory som innehåller information om vilka migrations som är applicerade på databasen, så att när du ber om att uppdatera databasen till en viss version, så vet den vilka migrations den behöver applicera alternativt reversera. Man kan be EF Migrations att antingen applicera förändringarna direkt, eller att få ut ett SQL skript som man kan ge till en DBA att köra vid produktionssättning och uppdatering.
Det är hela idén. Så simpelt är det. Men det är även det som gör det så vackert och smidigt att arbeta med.
Vill man skapa en ny migration så öppnar man Package Manager Console och skriver “Add-Migration” följt av namnet på sin migration (i exemplet nedan AddTableEmployees) och man möts då av en tom fil:
<span style="color: blue">using </span>System.Data.Entity.Migrations;
<span style="color: blue">public partial class </span><span style="color: #2b91af">AddTableEmployees </span>: <span style="color: #2b91af">DbMigration
</span>{
<span style="color: blue">public override void </span>Up()
{
}
<span style="color: blue">public override void </span>Down()
{
}
}
Det som är verkligt smidigt med EF Migrations, och som får det att bli mycket mer attraktivt än de andra migrationsramverken som jag har använt, är hur man kan skriva sina migrations helt i C#:
<span style="color: blue">using </span>System.Data.Entity.Migrations;
<span style="color: blue">public partial class </span><span style="color: #2b91af">AddTableEmployees </span>: <span style="color: #2b91af">DbMigration
</span>{
<span style="color: blue">public override void </span>Up()
{
CreateTable(
<span style="color: #a31515">"Employees"</span>,
cb => <span style="color: blue">new
</span>{
EmployeeId = cb.Long(
nullable: <span style="color: blue">false</span>,
identity: <span style="color: blue">true</span>),
FirstName = cb.String(
nullable: <span style="color: blue">true</span>,
unicode: <span style="color: blue">true</span>,
maxLength: 150)
});
}
<span style="color: blue">public override void </span>Down()
{
DropTable(<span style="color: #a31515">"Employees"</span>);
}
}
Men man kan samtidigt lika enkelt skriva vanlig SQL:
<span style="color: blue">public partial class </span><span style="color: #2b91af">ExampleSqlMigration </span>: <span style="color: #2b91af">DbMigration
</span>{
<span style="color: blue">public override void </span>Up()
{
Sql(<span style="color: #a31515">@"UPDATE Employees
SET FirstName = ''
WHERE FirstName IS NULL"</span>);
}
<span style="color: blue">public override void </span>Down()
{
<span style="color: green">// Reversal of migration not necessary.
</span>}
}
För att applicera migrations mot sin lokala databas så skriver man “Update-Database” i Package Manager Console. För att reversera så kan man använda “-TargetMigration:” flaggan och namnge den migration som man vill gå till.
Jag har medvetet utelämnat det som kallas för “Code first migrations” från Entity Framework, för jag tycker pesonligen inte att det är det som gör migrations fantastiskt, även om det är mycket kraftfullt. Vem vet, det kanske blir en del 3 i framtiden som handlar om just detta.
Jag kommer prata mer om Entity Framework Migrations på nforum den 19:e september 2012, så kom gärna och lyssna!