Сврха овог чланка је да користимо пример библиотеке шема-чувар прикажу алате који могу значајно да поједноставе процес развоја база података у оквиру ПХП пројеката коришћењем ПостгреСКЛ ДБМС.

Информације из овог чланка ће, пре свега, бити корисне програмерима који желе да максимално искористе ПостгреСКЛ могућности, али се суочавају са проблемима у одржавању пословне логике смештене у бази података.

Овај чланак неће описати предности или недостатке чувања пословне логике у бази података. Претпоставља се да је читалац већ направио избор.

Разматраће се следећа питања:

1. У ком облику треба да се чува думп структуре базе података у систему за контролу верзија (у даљем тексту ВЦС)
2. Како пратити промене у структури базе података након чувања думпа
3. Како пренети промене у структури базе података у друга окружења без сукоба и огромних датотека за миграцију
4. Како организовати процес паралелног рада на пројекту неколико програмера
5. Како безбедно применити више промена у структури базе података у производном окружењу
   

   СцхемаКеепер дизајниран за рад са ускладиштеним процедурама написаним на језику ПЛ / пгСКЛ. Тестирање са другим језицима није обављено, тако да употреба можда неће бити тако ефикасна или можда неће бити могућа.

Како сачувати думп структуре базе података у ВЦС

библиотека шема-чувар пружа функцију saveDump, који чува структуру свих објеката из базе података као засебне текстуалне датотеке. Излаз је директоријум који садржи структуру базе података, подељену у груписане датотеке које се лако могу додати у ВЦС.

Хајде да погледамо претварање објеката из базе података у датотеке користећи неколико примера:

Тип објекта
Схема
Име
Релативна путања до датотеке

РуР ° Ф ± Ф "икре † П °
јавност
рачуни
./public/tables/accounts.txt

Сачувана процедура
јавност
аутх (хеш бигинт)
./public/functions/auth(int8).sql

Увод
резервисање
тарифе
./booking/views/tariffs.txt

Садржај датотека је текстуални приказ структуре одређеног објекта базе података. На пример, за ускладиштене процедуре, садржај датотеке ће бити пуна дефиниција ускладиштене процедуре, почевши од блока CREATE OR REPLACE FUNCTION.

Као што се може видети из горње табеле, путања до датотеке чува информације о типу, шеми и називу објекта. Овај приступ олакшава навигацију кроз думп и преглед кода промена у бази података.

продужетак .sql за датотеке са изворним кодом ускладиштене процедуре, ово је изабрано тако да ИДЕ аутоматски обезбеђује алате за интеракцију са базом података када се датотека отвори.

Како пратити промене у структури базе података након чувања думпа

Чувањем думпа тренутне структуре базе података у ВЦС-у, добијамо прилику да проверимо да ли су у структури базе података направљене промене након креирања дампа. У библиотеци шема-чувар за откривање промена у структури базе података обезбеђена је функција verifyDump, који враћа информације о разликама без нежељених ефеката.

Алтернативни начин провере је да поново позовете функцију saveDump, наводећи исти директоријум и проверите у ВЦС-у за промене. Пошто су сви објекти из базе података сачувани у одвојеним датотекама, ВЦС ће приказати само измењене објекте.
Главни недостатак ове методе је потреба за преписивањем датотека да би се виделе промене.

Како пренети промене у структури базе података у друга окружења без сукоба и огромних датотека за миграцију

Захваљујући функцији deployDump Изворни код ускладиштених процедура може се уређивати на потпуно исти начин као и обичан изворни код апликације. Можете додати/обрисати нове линије у коду ускладиштене процедуре и одмах убацити промене у контролу верзија, или креирати/брисати ускладиштене процедуре креирањем/брисањем одговарајућих датотека у директоријуму думп.

На пример, за креирање нове ускладиштене процедуре у шеми public само направите нову датотеку са екстензијом .sql у именику public/functions, у њега поставите изворни код ускладиштене процедуре, укључујући блок CREATE OR REPLACE FUNCTION, а затим позовите функцију deployDump. Измена и брисање ускладиштене процедуре се дешава на исти начин. Дакле, код улази и у ВЦС и у базу података у исто време.

Ако се појави грешка у изворном коду било које ускладиштене процедуре, или неслагање између имена датотеке и ускладиштене процедуре, онда deployDump неће успети, приказујући текст грешке. Неподударање ускладиштених процедура између думпа и тренутне базе података је немогуће када се користи deployDump.

Приликом креирања нове ускладиштене процедуре, нема потребе да ручно уносите исправно име датотеке. Довољно је да датотека има екстензију .sql. После позива deployDump текст грешке ће садржати тачно име, које се може користити за преименовање датотеке.

deployDump вам омогућава да промените параметре функције или типа повратка без додатних радњи, док би код класичног приступа морали да
изврши прво DROP FUNCTION, и тек тада CREATE OR REPLACE FUNCTION.

Нажалост, постоје ситуације када deployDump није могуће аутоматски применити промене. На пример, ако се уклони функција окидача коју користи најмање један окидач. Такве ситуације се решавају ручно помоћу датотека за миграцију.

Ако сте одговорни за миграцију промена у ускладиштене процедуре шема-чувар, онда се датотеке за миграцију морају користити за пренос других промена у структури. На пример, добра библиотека за рад са миграцијама је доктрина/миграције.

Миграције се морају применити пре покретања deployDump. Ово вам омогућава да извршите све промене у структури и решите проблематичне ситуације тако да се промене у ускладиштеним процедурама накнадно преносе без проблема.

Рад са миграцијама биће детаљније описан у наредним одељцима.

Како организовати процес паралелног рада на пројекту неколико програмера

Неопходно је креирати скрипту за потпуну иницијализацију базе података, коју ће програмер покренути на својој радној машини, доводећи структуру локалне базе података у складу са дампом који се чува у ВЦС-у. Најлакши начин је да поделите иницијализацију локалне базе података у 3 корака:

1. Увезите датотеку са основном структуром која ће се звати нпр. base.sql
2. Примена миграција
3. Изазов deployDump

base.sql је почетна тачка на којој се примењују и извршавају миграције deployDumpТо је, base.sql + миграции + deployDump = актуальная структура БД. Можете креирати такву датотеку помоћу услужног програма pg_dump. Користи се base.sql искључиво при иницијализацији базе података од нуле.

Позовимо скрипту за комплетну иницијализацију базе података refresh.sh. Ток посла би могао изгледати овако:

1. Програмер покреће у свом окружењу refresh.sh и добија тренутну структуру базе података
2. Програмер почиње да ради на задатку, модификујући локалну базу података како би задовољио потребе нове функционалности (ALTER TABLE ... ADD COLUMN итд)
3. Након завршетка задатка, програмер позива функцију saveDumpза урезивање промена направљених у бази података у ВЦС
4. Поновно покретање програмера refresh.sh, онда verifyDumpкоји сада приказује листу промена које треба укључити у миграцију
5. Програмер преноси све промене структуре у датотеку за миграцију, поново се покреће refresh.sh и verifyDumpи, ако је миграција правилно састављена, verifyDump неће показати никакве разлике између локалне базе података и сачуваног думпа

Горе описани процес је компатибилан са принципима гитфлов-а. Свака грана у ВЦС-у ће садржати сопствену верзију дампа, а приликом спајања грана, думпови ће бити спојени. У већини случајева није потребно предузети никакве додатне радње након спајања, али ако су промене направљене у различитим гранама, на пример, у истој табели, може доћи до сукоба.

Хајде да размотримо конфликтну ситуацију користећи пример: постоји грана развити, из које се гранају две гране: функцијаКСНУМКС и функцијаКСНУМКС, који немају сукоба са развити, али имају сукобе једни са другима. Задатак је спојити обе гране у развити. У овом случају, препоручује се прво спајање једне од грана у развитиа затим спојити развити на преосталу грану, решавање сукоба у преосталој грани, а затим спајање последње гране у развити. Током фазе решавања конфликта, можда ћете морати да поправите датотеку за миграцију у последњој грани тако да одговара коначном думпу, који укључује резултате спајања.

Како безбедно применити више промена у структури базе података у производном окружењу

Захваљујући присуству депоније тренутне структуре базе података у ВЦС-у, постаје могуће проверити производну базу података да ли је тачна усклађеност са потребном структуром. Ово осигурава да су све промене које су програмери намеравали успешно пренете у производну базу.

Као ДДЛ у ПостгреСКЛ-у је трансакциона, препоручује се да се придржавате следећег редоследа постављања, тако да, у случају неочекиване грешке, можете „безболно“ извршити ROLLBACK:

1. Започните трансакцију
2. Извршите све миграције у трансакцији
3. У истој трансакцији извршите deployDump
4. Без довршетка трансакције извршите verifyDump. Ако нема грешака, покрените COMMIT. Ако постоје грешке, покрените ROLLBACK

Ови кораци се могу лако интегрисати у постојеће приступе имплементацији апликација, укључујући нулто време застоја.

Закључак

Захваљујући горе описаним методама, могуће је извући максималне перформансе из „ПХП + ПостгреСКЛ“ пројеката, жртвујући притом релативно малу погодност развоја у поређењу са имплементацијом све пословне логике у коду главне апликације. Штавише, обрада података у ПЛ / пгСКЛ често изгледа транспарентније и захтева мање кода од исте функционалности написане у ПХП-у.

Извор: ввв.хабр.цом