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 method. This will also inform us about the fact that the migration cannot be reversed. There are different types of changes that we make in the migration – creating, modifying and removing tables, columns or indexes. Deleting and modifying operations are the most sensitive to change. Why? Let’s consider the following scenario:We are working with the master branch, which is our main working path. Currently we have one table:
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.