
U ovom članku se detaljno objašnjava kako rešavati probleme vezane za kompatibilnost baza podataka tokom implementacije. Objasnićemo šta se može dogoditi sa vašim aplikacijama u produkciji ako pokušate da izvršite implementaciju bez prethodne pripreme. Zatim ćemo proći kroz faze životnog ciklusa aplikacije koje su potrebne da bismo postigli nulti vreme zastoja (napomena: dalje - nulti vreme zastoja). Rezultat naših operacija biće primena nepovratne promene baze podataka na nazad kompatibilan način.
Ako želite da se upoznate sa primerima koda iz članka, možete ih pronaći na .
Uvod
Nulti vreme zastoja implementacija
Šta je to misteriozno nulti vreme zastoja implementacija? Можно сказать, это когда ваше приложение развернуто так, что вы можете успешно вводить новую версию приложения на продакшн, в то время как пользователь не замечает его недоступности. С точки зрения пользователя и компании, это наилучший из возможных сценариев деплоя, поскольку таким образом можно вводить новые функции и устранять ошибки без перебоев в работе.
Kako to postići? Postoji nekoliko načina, evo jednog od njih:
- deploy-ujte verziju br. 1 vašeg servisa
- napravite migraciju baze podataka
- deploy-ujte verziju br. 2 vašeg servisa paralelno sa verzijom br. 1
- kada vidite da verzija br. 2 radi kako treba, uklonite verziju br. 1
- gotovo!
Lako, zar ne? Nažalost, to nije tako jednostavno, i kasnije ćemo to detaljnije razmotriti. A sada, hajde da proverimo još jedan prilično rasprostranjen proces implementacije - blue green deployment.
Da li ste nekada čuli za ? С Cloud Foundry это чрезвычайно легко сделать. Просто гляньте на , gde to detaljnije objašnjavamo. Ukratko, podsetimo se kako se radi blue green deployment:
- osigurajte rad dve kopije vašeg produkcionog koda ("plava" i "zelena");
- usmerite sav saobraćaj u plavu okolinu, tj. da URL-ovi produkcije vode tamo;
- implementirajte i testirajte sve izmene aplikacije u zelenoj okolini;
- prebacite URL-ove sa plave na zelenu okolinu
Blue green deployment je pristup koji vam omogućava da lako uvodite nove funkcije, ne brinući se da će produkcija propasti. To je zbog toga što, čak i ako se nešto dogodi, možete lako da se vratite na prethodnu okolinu jednostavno "prebacivanjem prekidača".
Pročivši sve navedeno, možda se pitate: Kakve veze nulti vreme zastoja ima sa blue green implementacijom?
Pa, imaju prilično mnogo zajedničkog, jer podrška za dve kopije iste okoline zahteva dvostruke napore za njihovo održavanje. Zato neki timovi, kako tvrdi , pridržavaju se varijacije ovog pristupa:
Druga opcija je korištenje iste DB, stvarajući plave i zelene preklopnike za web i slojeve domena. U ovom pristupu baze podataka često mogu predstavljati problem, posebno kada je potrebno promijeniti njezinu shemu kako bi se podržala nova verzija softvera.
I ovdje dolazimo do glavnog problema u ovom članku. Baza podataka. Pogledajmo još jednom ovu frazu.
Obavite migraciju DB.
Sada se morate zapitati — što ako je promjena baze podataka unazad nekompatibilna? Hoće li moja prva verzija aplikacije prestati raditi? U stvari, upravo će se to dogoditi…
Dakle, čak i usprkos ogromnim prednostima zero downtime / blue green deployment, tvrtke su sklone slijediti sljedeći sigurniji postupak implementacije svojih aplikacija:
- Pripremite paket s novom verzijom aplikacije
- Isključite pokrenutu aplikaciju
- Pokrenite skripte za migraciju baze podataka
- Implementirajte i pokrenite novu verziju aplikacije
U ovom članku ćemo detaljno opisati kako možete raditi s bazom podataka i kodom kako biste iskoristili prednosti zero downtime deployment.
Problemi s bazom podataka
Ako imate aplikaciju bez stanja koja ne pohranjuje nikakve podatke u DB, možete odmah dobiti zero downtime deployment. Nažalost, većina softvera mora negdje pohraniti podatke. Zato se trebate dobro zamisliti prije nego što napravite bilo kakve promjene u shemi. Prije nego što se zaronimo u detalje o tome kako promijeniti shemu da bi se omogućila implementacija bez zastoja, prvo se usredotočimo na shemu upravljanja verzijama.
Shema upravljanja verzijama
U ovom članku koristit ćemo kao alat za upravljanje verzijama (napomena: odnosi se na migracije DB). Naravno, također ćemo napisati Spring Boot aplikaciju koja ima ugrađenu podršku za Flyway i izvršit će migraciju sheme tijekom postavljanja konteksta aplikacije. Kada koristite Flyway, možete pohraniti migracijske skripte u mape svojih projekata (po defaultu u classpath:db/migration). Ovdje možete vidjeti primjer takvih migracijskih datoteka
└── db
└── migration
├── V1__init.sql
├── V2__Add_surname.sql
├── V3__Final_migration.sql
└── V4__Remove_lastname.sqlU ovom primjeru vidimo 4 scenarija migracije koja, ako nisu ranije izvršena, će se izvoditi jedan za drugim prilikom pokretanja aplikacije. Hajde da razmotrimo jednu od datoteka (V1__init.sql) kao primjer.
CREATE TABLE PERSON (
id BIGINT GENERATED BY DEFAULT AS IDENTITY,
first_name varchar(255) not null,
last_name varchar(255) not null
);
insert into PERSON (first_name, last_name) values ('Dave', 'Syer');Sve jasno govori samo za sebe: možete koristiti SQL da definišete kako vaša baza podataka treba biti promenjena. Za više informacija o Spring Boot i Flyway, pogledajte .
Koristeći alat za upravljanje verzijama sa Spring Boot, dobijate 2 velike prednosti:
- odvajate promjene baze podataka od promjena koda
- migracija baze podataka se dešava zajedno sa izdanjem vaše aplikacije, tj. vaš proces implementacije se pojednostavljuje
Rešavanje problema sa bazom podataka
U sljedećem dijelu članka fokusiraćemo se na razmatranje dva pristupa promjenama baze podataka.
- nazadna nekompatibilnost
- nazadna kompatibilnost
Prvi će biti razmatran kao upozorenje da ne pokušavate zero downtime deployment bez prethodne pripreme… Drugi nudi rešenje kako se može izvršiti deployment bez zastoja i istovremeno održavati nazadnu kompatibilnost.
Naš projekat na kojem ćemo raditi biće jednostavna aplikacija Spring Boot Flyway koja ima Osoba sa first_name i last_name u bazi podataka (napomena prev.: Osoba je tabela, a first_name i last_name — to su polja u njoj). Želimo da preimenujemo last_name u prezime.
Pretpostavke
Prije nego što se uključimo u detalje, potrebno je istaknuti nekoliko pretpostavki vezanih za naše aplikacije. Glavni rezultat koji želimo postići biće prilično jednostavan proces.
Napomena. Poslovni PRO-TIP. Pojednostavljenje procesa može vam uštedjeti mnogo novca na održavanju (što više ljudi radi u vašoj kompaniji, to više novca možete uštedjeti)!
Ne treba raditi rollback baze podataka
To pojednostavljuje proces implementacije (neki rollbackovi baza podataka su praktično nemogući, npr. rollback brisanja). Preferiramo da rollbackujemo samo aplikacije. Tako da, čak i ako imate različite baze podataka (npr. SQL i NoSQL), vaš deployment pipeline će izgledati isto.
Mora biti mogućnost da se APLIKACIJA uvek vrati na jednu verziju unazad (ne više)
Rollback should only be performed when necessary. If there is a bug in the current version that is difficult to fix, we must be able to revert to the last working version. We assume that this last working version is the previous one. Ensuring compatibility of the code and database for more than one deployment would be extremely challenging and costly.
Napomena. For better readability, in the context of this article, we will be changing the major version of the application.
Step 1: Initial state
Application version: 1.0.0
DB version: v1
Komentar
This will be the initial state of the application.
Database changes
The database contains last_name.
CREATE TABLE PERSON (
id BIGINT GENERATED BY DEFAULT AS IDENTITY,
first_name varchar(255) not null,
last_name varchar(255) not null
);
insert into PERSON (first_name, last_name) values ('Dave', 'Syer');Code changes
The application saves Person data in last_name:
/*
* Copyright 2012-2016 the original author or authors.
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
package sample.flyway;
import javax.persistence.Entity;
import javax.persistence.GeneratedValue;
import javax.persistence.Id;
@Entity
public class Person {
@Id
@GeneratedValue
private Long id;
private String firstName;
private String lastName;
public String getFirstName() {
return this.firstName;
}
public void setFirstName(String firstName) {
this.firstName = firstName;
}
public String getLastName() {
return this.lastName;
}
public void setLastName(String lastname) {
this.lastName = lastname;
}
@Override
public String toString() {
return "Person [firstName=" + this.firstName + ", lastName=" + this.lastName
+ "]";
}
}Backward incompatible renaming of the column
Let's look at an example of how to change a column name:
Attention. The following example will intentionally cause a breakage. We show this to demonstrate the database compatibility issue.
Application version: 2.0.0.BAD
DB version: v2bad
Komentar
Current changes do NOT allow us to run two instances (old and new) simultaneously. Therefore, zero downtime deployment will be difficult to achieve (given the assumptions, it is virtually impossible).
A/B testing
The current situation is that we have an application version 1.0.0, deployed in production, and the DB v1. We need to deploy the second instance of the application, version 2.0.0.BAD, and update the database to v2bad.
Koraci:
- a new instance of the application version
2.0.0.BAD, which updates the database tov2bad - in the database
v2badcolumnlast_nameno longer exists — it has been changed toprezime - the database and application update was successful, and some instances are running in
1.0.0, others in2.0.0.BAD. All are connected to the DBv2bad - all instances of version
1.0.0will start throwing errors because they will try to insert data into the columnlast_name, which no longer exists - all instances of version
2.0.0.BADwill work without issues
As you can see, if we make backward incompatible changes to the DB and the application, A/B testing is impossible.
Application rollback
Let's assume that after attempting to perform A/B deployment (note: the author likely meant A/B testing here) we decided that we need to roll back the application to version 1.0.0. Let's say we do not want to roll back the database.
Koraci:
- zaustavljamo instancu aplikacije verzije
2.0.0.BAD - baza podataka još uvijek
v2bad - budući da verzija
1.0.0ne razumije što jeprezime, vidjet ćemo greške - pakao je pobjegao, više se ne možemo vratiti
Kao što vidite, ako napravimo unatrag nekompatibilne promjene u BDP-u i aplikaciji, ne možemo se vratiti na prethodnu verziju.
Logovi izvršenja skripte
Scenarij unatrag nekompatibilnosti:
01) Pokrenite 1.0.0
02) Sačekajte da se aplikacija (1.0.0) pokrene
03) Generišite osobu pozivajući POST localhost:9991/person na verziji 1.0.0
04) Pokrenite 2.0.0.BAD
05) Sačekajte da se aplikacija (2.0.0.BAD) pokrene
06) Generišite osobu pozivajući POST localhost:9991/person na verziji 1.0.0 <-- ovo bi trebalo propasti
07) Generišite osobu pozivajući POST localhost:9992/person na verziji 2.0.0.BAD <-- ovo bi trebalo proći
Pokrećem aplikaciju u verziji 1.0.0
Generišite osobu u verziji 1.0.0
Šaljem POST na 127.0.0.1:9991/person. Ovo je odgovor:
{"firstName":"b73f639f-e176-4463-bf26-1135aace2f57","lastName":"b73f639f-e176-4463-bf26-1135aace2f57"}
Pokrećem aplikaciju u verziji 2.0.0.BAD
Generišite osobu u verziji 1.0.0
Šaljem POST na 127.0.0.1:9991/person. Ovo je odgovor:
curl: (22) Tražena URL adresa vratila grešku: 500 Interna greška servera
Generišite osobu u verziji 2.0.0.BAD
Šaljem POST na 127.0.0.1:9995/person. Ovo je odgovor:
{"firstName":"e156be2e-06b6-4730-9c43-6e14cfcda125","surname":"e156be2e-06b6-4730-9c43-6e14cfcda125"}Database changes
Skripta za migraciju koja preimenuje last_name u prezime
Izvorna Flyway skripta:
CREATE TABLE PERSON (
id BIGINT GENERATED BY DEFAULT AS IDENTITY,
first_name varchar(255) not null,
last_name varchar(255) not null
);
insert into PERSON (first_name, last_name) values ('Dave', 'Syer');Skripta koja preimenuje last_name.
-- Ova promjena je unatrag nekompatibilna - ne možete raditi A/B testiranje
ALTER TABLE PERSON CHANGE last_name surname VARCHAR;Code changes
Promijenili smo ime polja lastName na prezime.
Preimenovanje kolone unatrag kompatibilnim načinom
Ovo je najčešća situacija s kojom se možemo suočiti. Moramo napraviti unatrag nekompatibilne promjene. Već smo dokazali da za implementaciju bez prekida ne trebamo samo primijeniti migraciju bazu podataka bez dodatnih radnji. U ovom dijelu članka izvršit ćemo 3 implementacije aplikacije zajedno s migracijama baze podataka, da bismo postigli željeni rezultat i istovremeno sačuvali unatrag kompatibilnost.
Napomena. Podsjetimo se da imamo BDP verzije
v1. Sadrži kolonefirst_nameilast_name. Moramo promijenitilast_namenaprezime. Također imamo aplikaciju verzije1.0.0,koja trenutno ne koristiprezime.
Korak 2: Dodavanje surname
Application version: 2.0.0
DB version: v2
Komentar
Dodavanjem nove kolone i kopiranjem njenog sadržaja, stvaramo unatrag kompatibilne promjene BDP-a. U isto vrijeme, ako se vratimo na JAR ili ako imamo radni stari JAR, on se neće slomiti tokom izvršenja.
Izdavanje nove verzije
Koraci:
- izvršite migraciju BDP-a kako biste stvorili novu kolonu
prezime. Sada vaša BDP verzijav2 - kopira podatke iz
last_nameuprezime. Obratite pažnju, što, ako imate mnogo tih podataka, trebate razmotriti mogućnost paketne migracije! - napišite kod gde se koriste OBADVA i novi, i stari kolona. Sada vaša aplikacija verzije
2.0.0 - pročitajte vrijednost iz kolone
prezime, ako nijenull, ili iz last_name, akoprezimenije navedeno. Možete uklonitigetLastName()iz koda, jer će on vraćatinullprilikom vraćanja vaše aplikacije sa3.0.0do2.0.0.
Ako koristite Spring Boot Flyway, ova dva koraka će biti izvršena prilikom pokretanja verzije 2.0.0 aplikacije. Ako ručno pokrećete alat za upravljanje verzijama baze podataka, moraćete to uraditi u dva odvojena koraka (prvo ručno ažurirajte verziju db, a zatim implementirajte novu aplikaciju).
Važno. Zapamtite da novo kreirana kolona NE TREBA ovaj proces. NOT NULL. Ako radite vraćanje, stara aplikacija ne zna za novu kolonu i neće je postaviti tokom
Umetanja.Ali ako dodate ovo ograničenje, a vaša BDP će bitiv2, biće potrebno postaviti vrijednost nove kolone. Što će dovesti do kršenja ograničenja.Važno. Trebalo bi da uklonite metodu
getLastName(), pošto u verziji3.0.0u kodu nema pojma o kolonilast_name. To znači da će tamo biti postavljeni null. Možete ostaviti metodu i dodati provere nanull, ali mnogo bolje rešenje bi bilo osigurati da ste u logicigetSurname()izabrali pravu nenultu vrijednost.
A/B testing
The current situation is that we have an application version 1.0.0, implementiranu na produkciji, i BDP u v1. Moramo implementirati drugi primjerak aplikacije verzije 2.0.0, koji će ažurirati bazu podataka do v2.
Koraci:
- a new instance of the application version
2.0.0, which updates the database tov2 - u međuvremenu su neki upiti obrađivani primjercima verzije
1.0.0 - a ažuriranje je prošlo uspešno, i imate nekoliko radnih primjeraka aplikacije verzije
1.0.0i ostale verzije2.0.0.Svi komuniciraju sa BDP uv2 - verzija
1.0.0ne koristi u BDP kolonu prezime, dok verzija2.0.0koristi. One se ne ometaju međusobno, i grešaka ne bi trebalo biti. - verzija
2.0.0čuva podatke i u staroj i u novoj koloni, što osigurava unazadnu kompatibilnost
Važno. Ako imate bilo kakve upite koji prebrojavaju stavke na osnovu vrijednosti iz stare / nove kolone, trebate imati na umu da sada imate duplicirane vrijednosti (verovatno se još uvek migriraju). Na primjer, ako želite izbrojati broj korisnika čije prezime (kako god se ta kolona zvala) počinje sa slovom
A, do završetka migracije podataka (stara→novakolona) možete imati nekonzistentne podatke ako izvršavate upit na novoj koloni.
Application rollback
Sada imamo aplikaciju verzije 2.0.0 i bazu podataka u v2.
Koraci:
- vratite svoju aplikaciju na verziju
1.0.0. - verzija
1.0.0ne koristi u BDP kolonuprezime, stoga bi povrat trebao biti uspješan
Izmjene DB
DB sadrži stupac po imenu last_name.
Izvorna skripta Flyway:
CREATE TABLE PERSON (
id BIGINT GENERATED BY DEFAULT AS IDENTITY,
first_name varchar(255) not null,
last_name varchar(255) not null
);
insert into PERSON (first_name, last_name) values ('Dave', 'Syer');Skripta za dodavanje prezime.
Attention. Zapamtite da NE MOŽETE DODATI nikakva ograničenja NOT NULL u dodani stupac. Ako vraćate JAR, stara verzija ne zna za dodani stupac i automatski će mu postaviti NULL vrijednost. U slučaju postojanja takvog ograničenja, stara aplikacija će se jednostavno srušiti.
-- ZAPAMTITE: Ovo polje ne može imati ograničenje NOT NULL jer, ako se vratite, stara verzija neće znati za ovo polje
-- i uvijek će ga postaviti na NULL
ALTER TABLE PERSON ADD surname varchar(255);
-- PREDPOSTAVLJAMO DA JE TO BRZA MIGRACIJA - U SUPROTNOM BIH MORALI MIGRIRATI U SERIJAMA
UPDATE PERSON SET PERSON.surname = PERSON.last_nameCode changes
Čuvamo podatke kao u last_name, kao i u prezime. Pri tome čitamo iz last_name, jer je ovaj stupac najrelevantniji. Tokom implementacije, neki upiti mogli su biti obrađeni instancom aplikacije koja još nije ažurirana.
/*
* Copyright 2012-2016 the original author or authors.
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
package sample.flyway;
import javax.persistence.Entity;
import javax.persistence.GeneratedValue;
import javax.persistence.Id;
@Entity
public class Person {
@Id
@GeneratedValue
private Long id;
private String firstName;
private String lastName;
private String surname;
public String getFirstName() {
return this.firstName;
}
public void setFirstName(String firstName) {
this.firstName = firstName;
}
/**
* Reading from the new column if it's set. If not the from the old one.
*
* When migrating from version 1.0.0 -> 2.0.0 this can lead to a possibility that some data in
* the surname column is not up to date (during the migration process lastName could have been updated).
* In this case one can run yet another migration script after all applications have been deployed in the
* new version to ensure that the surname field is updated.
*
* However it makes sense since when looking at the migration from 2.0.0 -> 3.0.0. In 3.0.0 we no longer
* have a notion of lastName at all - so we don't update that column. If we rollback from 3.0.0 -> 2.0.0 if we
* would be reading from lastName, then we would have very old data (since not a single datum was inserted
* to lastName in version 3.0.0).
*/
public String getSurname() {
return this.surname != null ? this.surname : this.lastName;
}
/**
* Storing both FIRST_NAME and SURNAME entries
*/
public void setSurname(String surname) {
this.lastName = surname;
this.surname = surname;
}
@Override
public String toString() {
return "Person [firstName=" + this.firstName + ", lastName=" + this.lastName + ", surname=" + this.surname
+ "]";
}
}Korak 3: Brisanje last_name iz koda
Application version: 3.0.0
DB version:v3
Komentar
Nap. prev.: Očigledno je da je autor pogrešno kopirao tekst ovog bloka iz koraka 2 u izvornoj članku. U ovom koraku trebale bi se izvršiti promjene u kodu aplikacije kako bi se uklonila funkcionalnost koja koristi stupac last_name.
Dodavanjem novog stupca i kopiranjem njegovog sadržaja, stvorili smo unatrag kompatibilne izmjene DB. Također, ako vratimo JAR ili imamo radni stari JAR, neće se slomiti tokom izvođenja.
Application rollback
Trenutno imamo aplikaciju verzije 3.0.0 i bazu podataka v3. Verzija 3.0.0 ne pohranjuje podatke u last_name. To znači da se u prezime čuva najnovija informacija.
Koraci:
- vratite svoju aplikaciju na verziju
2.0.0. - verzija
2.0.0koristi ilast_nameiprezime. - verzija
2.0.0će uzetiprezime, ako nije nula, inače —last_name
Database changes
U DB nema strukturnih promjena. Izvodi se slijedeća skripta koja izvršava konačnu migraciju starih podataka:
-- PREDPOSTAVLJAMO DA JE TO BRZA MIGRACIJA - U SUPROTNOM BIH MORALI MIGRIRATI U SERIJAMA
-- TAKOĐE NE PROVJERAVAMO DA LI NE PREOVLAĐUJEMO POSTOJEĆE UNOSE. MORALI BIH UPOREDITI
-- VERZIJE UNOSA DA BI SE OSIGURALI DA AKO VEĆ POSTOJI UNOS S VIŠOM BROJEM VERZIJE
-- NEĆEMO GA PREOVLAĐIVATI.
UPDATE PERSON SET PERSON.surname = PERSON.last_name;
-- ODBACIVANJE OGRANIČENJA NOT NULL; INAČE ĆETE POKUŠATI UMETNUTI NULL VRIJEDNOST LAST_NAME
-- S OGRANIČENJEM NOT_NULL.
ALTER TABLE PERSON MODIFY COLUMN last_name varchar(255) NULL DEFAULT NULL;Code changes
Nap. prev.: Opis ovog bloka također je pogrešno kopiran od strane autora iz koraka 2. U skladu sa logikom pripovijedanja članka, promjene u kodu u ovom koraku trebaju biti usmjerene na uklanjanje elemenata koji rade sa stupcem last_name.
Čuvamo podatke kao u last_name, kao i u surname. Osim toga, čitamo iz kolone last_name, budući da je ona najrelevantnija. Tokom implementacije, neki zahtevi mogu biti obrađeni od strane instance koja još nije ažurirana.
/*
* Copyright 2012-2016 the original author or authors.
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
package sample.flyway;
import javax.persistence.Entity;
import javax.persistence.GeneratedValue;
import javax.persistence.Id;
@Entity
public class Person {
@Id
@GeneratedValue
private Long id;
private String firstName;
private String surname;
public String getFirstName() {
return this.firstName;
}
public void setFirstName(String firstName) {
this.firstName = firstName;
}
public String getSurname() {
return this.surname;
}
public void setSurname(String lastname) {
this.surname = lastname;
}
@Override
public String toString() {
return "Person [firstName=" + this.firstName + ", surname=" + this.surname
+ "]";
}
}Korak 4: Uklanjanje last_name iz baze podataka
Application version: 4.0.0
DB version: v4
Komentar
Zbog toga što kod verzije 3.0.0 nije koristio kolonu last_name, tokom izvršavanja neće doći do nikakvih problema ako se vratimo na 3.0.0 nakon uklanjanja kolone iz baze podataka.
Logovi izvršenja skripte
Učinićemo to na sledeći način:
01) Pokrenuti 1.0.0
02) Sačekati da se aplikacija (1.0.0) pokrene
03) Generisati osobu pozivom POST localhost:9991/person za verziju 1.0.0
04) Pokrenuti 2.0.0
05) Sačekati da se aplikacija (2.0.0) pokrene
06) Generisati osobu pozivom POST localhost:9991/person za verziju 1.0.0
07) Generisati osobu pozivom POST localhost:9992/person za verziju 2.0.0
08) Ubiti aplikaciju (1.0.0)
09) Pokrenuti 3.0.0
10) Sačekati da se aplikacija (3.0.0) pokrene
11) Generisati osobu pozivom POST localhost:9992/person za verziju 2.0.0
12) Generisati osobu pozivom POST localhost:9993/person za verziju 3.0.0
13) Ubiti aplikaciju (3.0.0)
14) Pokrenuti 4.0.0
15) Sačekati da se aplikacija (4.0.0) pokrene
16) Generisati osobu pozivom POST localhost:9993/person za verziju 3.0.0
17) Generisati osobu pozivom POST localhost:9994/person za verziju 4.0.0
Pokretanje aplikacije u verziji 1.0.0
Generisanje osobe u verziji 1.0.0
Slanje posta na 127.0.0.1:9991/person. Ovo je odgovor:
{"firstName":"52b6e125-4a5c-429b-a47a-ef18bbc639d2","lastName":"52b6e125-4a5c-429b-a47a-ef18bbc639d2"}
Pokretanje aplikacije u verziji 2.0.0
Generisanje osobe u verziji 1.0.0
Slanje posta na 127.0.0.1:9991/person. Ovo je odgovor:
{"firstName":"e41ee756-4fa7-4737-b832-e28827a00deb","lastName":"e41ee756-4fa7-4737-b832-e28827a00deb"}
Generisanje osobe u verziji 2.0.0
Slanje posta na 127.0.0.1:9992/person. Ovo je odgovor:
{"firstName":"0c1240f5-649a-4bc5-8aa9-cff855f3927f","lastName":"0c1240f5-649a-4bc5-8aa9-cff855f3927f","surname":"0c1240f5-649a-4bc5-8aa9-cff855f3927f"}
Ubiti aplikaciju 1.0.0
Pokretanje aplikacije u verziji 3.0.0
Generisanje osobe u verziji 2.0.0
Slanje posta na 127.0.0.1:9992/person. Ovo je odgovor:
{"firstName":"74d84a9e-5f44-43b8-907c-148c6d26a71b","lastName":"74d84a9e-5f44-43b8-907c-148c6d26a71b","surname":"74d84a9e-5f44-43b8-907c-148c6d26a71b"}
Generisanje osobe u verziji 3.0.0
Slanje posta na 127.0.0.1:9993/person. Ovo je odgovor:
{"firstName":"c6564dbe-9ab5-40ae-9077-8ae6668d5862","surname":"c6564dbe-9ab5-40ae-9077-8ae6668d5862"}
Ubiti aplikaciju 2.0.0
Pokretanje aplikacije u verziji 4.0.0
Generisanje osobe u verziji 3.0.0
Slanje posta na 127.0.0.1:9993/person. Ovo je odgovor:
{"firstName":"cbe942fc-832e-45e9-a838-0fae25c10a51","surname":"cbe942fc-832e-45e9-a838-0fae25c10a51"}
Generisanje osobe u verziji 4.0.0
Slanje posta na 127.0.0.1:9994/person. Ovo je odgovor:
{"firstName":"ff6857ce-9c41-413a-863e-358e2719bf88","surname":"ff6857ce-9c41-413a-863e-358e2719bf88"}Izmene baze podataka
U vezi sa tim v3 samo uklanjamo kolonu last_name i dodajemo nedostajuća ograničenja.
-- UKLONITE KOLONU
ALTER TABLE PERSON DROP last_name;
-- DODAJTE OGRANIČENJA
UPDATE PERSON SET surname='' WHERE surname IS NULL;
ALTER TABLE PERSON ALTER COLUMN surname VARCHAR NOT NULL;Code changes
Izmene u kodu nisu prisutne.
Zaključak
Uspešno smo primenili povratak nekompatibilne promene imena kolone, izvršavajući nekoliko unazad kompatibilnih implementacija. U nastavku je sažetak izvršenih radnji:
- implementacija aplikacije verzije
1.0.0sav1šema baze podataka (ime kolone =last_name) - implementacija aplikacije verzije
2.0.0,koja čuva podatke ulast_nameiprezime. Aplikacija čita izlast_name. Baza podataka se nalazi u verzijiv2, koja sadrži kolumne kao što sulast_name, kao iprezime. prezimeje kopija last_name. (NAPOMENA: ova kolumna ne bi trebala imati ograničenje not null) - implementacija aplikacije verzije
3.0.0, koja čuva podatke samo uprezimei čita iz prezimena. Što se tiče baze podataka, izvršava se posljednja migracijalast_nameuprezime. Takođe se uklanja ograničenje NOT NULL slast_name. Baza podataka je sada u verzijiv3 - implementacija aplikacije verzije
4.0.0— u kodu se ne vrše nikakve promene. Implementacija baze podatakav4, koja uklanjalast_name. Ovde možete dodati neka nedostajuća ograničenja u bazu podataka.
Prateći ovaj pristup, uvek se možete vratiti na jednu verziju unazad, ne kršeći kompatibilnost baze podataka / aplikacije.
Kod
Sav kod korišćen u ovom članku dostupno je na . Ispod dodatno objašnjenje.
Projekti
Nakon kloniranja repozitorijuma, videćete sledeću strukturu foldera.
├── boot-flyway-v1 - 1.0.0 verzija aplikacije sa v1 šemom
├── boot-flyway-v2 - 2.0.0 verzija aplikacije sa v2 šemom (kompatibilna unazad - aplikacija se može vratiti)
├── boot-flyway-v2-bad - 2.0.0.BAD verzija aplikacije sa v2bad šemom (nekompatibilna unazad - aplikacija se ne može vratiti)
├── boot-flyway-v3 - 3.0.0 verzija aplikacije sa v3 šemom (aplikacija se može vratiti)
└── boot-flyway-v4 - 4.0.0 verzija aplikacije sa v4 šemom (aplikacija se može vratiti)Skripte
Možete pokrenuti skripte opisane u sledećim skriptama, koje će demonstrirati promene koje su kompatibilne i nekompatibilne unazad u bazi podataka.
Da biste videli slučaj sa promenama kompatibilnim unazad, pokrenite:
.\/scripts\/scenario_backward_compatible.shA da biste videli slučaj sa promenama nekompatibilnim unazad, pokrenite:
.\/scripts\/scenario_backward_incompatible.shSpring Boot Uzorak Flyway
Svi primeri su uzeti sa Spring Boot Uzorak Flyway.
Možete pogledati http://localhost:8080/flyway, tu je lista skripti.
Ovaj primer takođe uključuje H2 konzolu (na http://localhost:8080/h2-console), tako da možete pregledati stanje baze podataka (URL jdbc prema zadatku — jdbc:h2:mem:testdb).
Dodatno
Također pročitajte ostale članke na našem blogu:
Izvor: habr.com
