Att utveckla en app innebär inte bara att implementera nya funktioner eller patcha den. Ibland måste man backa ändringarna och gå tillbaka till det tidigare stadiet i ett projekt. Ett vanligt problem som kan dyka upp när man arbetar med flera grenar är kopplat till att upprätthålla rätt version av en databasstruktur. Programmerare som använder rails har färdiga lösningar till sitt förfogande. Dessa lösningar stöder implementering och kontroll av databasändringar - det här är migreringar. Jag kommer inte att beskriva hur det fungerar och vilka möjligheter det ger - jag skulle vilja fokusera på problemet med att upprätthålla lämplig version av en databasstruktur medan du byter grenar.
Databaslagret i en app är en separat varelse och styrs endast av migreringar. När du skapar nya migreringar ska du komma ihåg att göra den planerade omvandlingen av en databasstruktur reversibel. Naturligtvis kan vi i extrema fall höja IrreversibelMigration
i ner metod. Detta kommer också att informera oss om det faktum att migreringen inte kan återkallas. Det finns olika typer av ändringar som vi gör i migreringen - vi skapar, ändrar och tar bort tabeller, kolumner eller index. Radering och modifiering är de operationer som är mest känsliga för förändringar. Varför är det så? Låt oss tänka på följande scenario:Vi arbetar med mastergrenen, som är vår huvudsakliga arbetsväg. För närvarande har vi en tabell:
class CreateArticles < ActiveRecord::Migration
def ändra
create_table :artiklar do |t|
t.sträng :namn
t.text :beskrivning
t.string :status, null: false
t.tidsstämplar null: false
slut
slut
slut
Vår Artikel
modellen har sådana valideringar som kräver att det finns namn, beskrivning och status attribut.
klass Artikel < ActiveRecord::Bas
validerar :namn, närvaro: true
validerar :description, närvaro: true
validerar :status, närvaro: true
slut
Vi genomför förändringar i vårt Artiklar bord på funktion utvecklingsgren och vi tar bort status kolumn.
class RemoveStatusColumnFromArticles < ActiveRecord::Migration
def ändra
remove_column :artiklar, :status, :sträng
slut
slut
Vi verkställer migreringen:
$ [exempel/funktion]: bundle exec rake db:migrate
== 20150605120955 RemoveStatusColumnFromArticles: migrering ===================
-- remove_column(:artiklar, :status, :sträng)
-> 0.0717s
== 20150605120955 RemoveStatusColumnFromArticles: migrerad (0.0718s) ==========
Schemat för en databas ändras:
diff --git a/db/schema.rb b/db/schema.rb
index 2a100a9..76438c1 100644 --- a/db/schema.rb +++ b/db/schema.rb @@ -11,14 +11,13 @@ #
Det rekommenderas starkt att du checkar in den här filen i ditt versionskontrollsystem.
-ActiveRecord::Schema.define(version: 20150605120350) do
+ActiveRecord::Schema.define(version: 20150605120955) do
createtable "articles", force: :cascade do |t|
t.sträng "namn"
t.text "beskrivning"
- t.string "status", null: false t.datetime "createdat", null: false
t.datetime "updated_at", null: false
slut
slut
Därefter överför vi ändringarna till funktion gren. För att simulera det här problemet byter vi den aktuella grenen till master. Basstrukturen ändrades genom migrering, vilket tar bort status kolumn på funktion gren. Låt oss försöka använda följande kommando:
Artikel.skapa!(namn: "Kaboom", beskrivning: "Lorem ipsum...", status: "aktiv")
Vad kommer att hända efter att ha utfört ovan nämnda kod? Felet: ActiveRecord::UnknownAttributeError: okänt attribut 'status' för artikel
kommer att uppstå och det beror på den inkompatibla strukturversionen av en databas. Innan vi ändrar grenen till master bör vi rulla tillbaka en migrering som raderar status kolumn från Artikel bord.
Vad kan vi göra för att kontrollera om vi måste rulla tillbaka några migreringar innan vi byter grenar? Med hjälp av versionskontrollsystemet (här är det git) kan vi kontrollera vårt arbete genom att skapa ett användbart alias:
~/.gitconfig
[alias]
migreringar = "!f() { git diff --name-only $1..$2 db/migrate | tr -d '[A-Za-z/_.]'; }; f"
Exekvering av git migreringar master funktion
kommandot kommer att resultera i en lista över migreringsversioner, som finns på funktion grenar, och som inte kan hittas på mästare.
$ [exempel/funktion]: git-migreringar masterfunktion
20150605120955
Tack vare denna information kan vi enkelt rulla tillbaka de ändringar som gjorts i databasstrukturen innan vi bytte till master.
$ [exempel/funktion]: bundle exec rake db:migrate:down VERSION=20150605120955
== 20150605120955 RemoveStatusColumnFromArticles: återställer ===================
-- add_column(:artiklar, :status, :sträng)
-> 0.0009s
== 20150605120955 RemoveStatusColumnFromArticles: reverted (0.0045s) ==========
Ytterligare en sak som vi bör göra efter att ha rullat tillbaka migreringen är att återställa statusen för ett databasschema.
$ [exempel/funktion]: git status
På gren funktion
Ändringar inte iscensatta för commit:
(använd "git add ..." för att uppdatera vad som kommer att skickas)
(använd "git checkout -- ..." för att kasta ändringar i arbetskatalogen)
modifierad: db/schema.rb
inga ändringar tillagda till commit (använd "git add" och/eller "git commit -a")
$ [exempel/funktion]: git checkout db/schema.rb
$ [exempel/funktion]: git status
På gren funktion
inget att göra, arbetskatalog ren
Nu kan vi enkelt växla till mästare gren.
Det här exemplet är inte särskilt komplicerat att lösa, men det bör hjälpa dig att inse hur viktigt det är att behålla strukturen i en databas när arbetssituationen förändras.