💂🏼 🤛 🚞 लिलीबेस के साथ डाटाबेस माइग्रेशन मैनेजमेंट 🧚 🌱 🌡️

बहुत पहले नहीं, हमने अपनी अधिकांश परियोजनाओं में लिक्विड स्कीमा माइग्रेशन टूल के रूप में लिक्विबेस को नए और मौजूदा रूप में पेश करना शुरू किया। Liquibase डेटाबेस स्कीमा माइग्रेशन सिस्टम अच्छा है क्योंकि यह आपको एप्लिकेशन डेटाबेस के संशोधनों को प्रबंधित करने के लिए संस्करण नियंत्रण प्रणाली, VCS, (उदाहरण के लिए, Git) का उपयोग करने की अनुमति देता है। विशेष रूप से, वीसीएस एक डेटाबेस स्कीमा को एक संशोधन से दूसरे में स्थानांतरित करने के लिए आवश्यक परिवर्तनों का वर्णन करता है।

हालाँकि एक डेटाबेस स्कीमा को माइग्रेट करना शुरू में एक काफी सरल कार्य लगता है, फिर भी यह तब और मुश्किल हो जाता है जब आप स्कीमा में हुए बदलावों को दोबारा बनाए बिना इसे वापस रोल करना चाहते हैं।
डीडीएल स्कीमा और संचालन के अलावा, लिलीबेस आपको डेटा को बदलने और उन्हें वापस रोल करने के लिए समर्थन के साथ, एप्लिकेशन डेटा को स्थानांतरित करने की अनुमति देता है।

चलो सरल शुरू करते हैं। इस आलेख में चर्चा किए गए उदाहरण के लिए, मैं लिक्विडबेस का उपयोग करूंगा, कमांड लाइन से चलाऊंगा, साथ ही MySQL के लिए एक साधारण सीएलआई क्लाइंट भी।
लिक्विबेस भी मावेन (एक लक्ष्य के रूप में) या स्प्रिंग (एक बीन के रूप में अच्छी तरह से एकीकृत करता है जो संदर्भ आरंभीकरण के दौरान चलता है)।

आइए एक बहुत ही सरल PERSON तालिका से शुरू करें, जिसमें केवल ID (प्राथमिक कुंजी) और नाम शामिल हैं:

mysql> describe Person; +-------+--------------+------+-----+---------+----------------+ | Field | Type | Null | Key | Default | Extra | +-------+--------------+------+-----+---------+----------------+ | id | bigint(20) | NO | PRI | NULL | auto_increment | | name | varchar(255) | NO | UNI | NULL | | +-------+--------------+------+-----+---------+----------------+ 2 rows in set (0.00 sec)

लिक्विबेस डीडीएल स्टेटमेंट का वर्णन करने के लिए तथाकथित "बदलाव" (बदलाव - एक सेट का परिवर्तन), एक्सएमएल-कोड का उपयोग करता है। वे चेंगलॉग फाइलें रचते हैं। अगला परिवर्तक एक तालिका (टैग "createTable") और दो कॉलम (टैग "कॉलम") बनाएगा।

 <databasechangelog xmlns="http://www.liquibase.org/xml/ns/dbchangelog" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemalocation="http://www.liquibase.org/xml/ns/dbchangelog http://www.liquibase.org/xml/ns/dbchangelog/dbchangelog-2.0.xsd"> <changeset id="1" author="mueller@synyx.de" runonchange="true"> <createtable tablename="Person"> <column autoincrement="true" name="id" type="BIGINT"> <constraints nullable="false" primarykey="true"> </constraints> </column> <column name="name" type="VARCHAR(255)"> <constraints nullable="false"> </constraints> </column> </createtable> </changeset> </databasechangelog>

इस XML कोड का उपयोग करते हुए, लिक्विबेस एक "व्यक्ति" तालिका जोड़ेगा। कमांड लाइन इंटरफ़ेस से इसे निष्पादित करने वाला कमांड "अपडेट" है:

 ./liquibase --url=jdbc:mysql://localhost:3306/liquiblog --driver=com.mysql.jdbc.Driver --username=root --password="" --changeLogFile=db.changelog-0.1.0.xml update

लिकेबेज ने कुछ प्रकार के चेंजिप्स को वापस रोल करने के लिए अंतर्निहित समर्थन किया है, उदाहरण के लिए, createTable। यदि हम "अपडेट" के बजाय "लाइनबैककाउंट 1" के तर्क के साथ कमांड लाइन के माध्यम से लिकिबेस को कॉल करते हैं, तो अंतिम परिवर्तक को वापस रोल किया जाएगा: PERSON तालिका हटा दी जाएगी।

अन्य प्रकार के चेंजर सेट को स्वचालित रूप से हटाया नहीं जा सकता है। एक उदाहरण के रूप में, PERSON ("इन्सर्ट" टैग) में डेटा जोड़ने वाले निम्नलिखित परिवर्तकों पर विचार करें:

 <databasechangelog xmlns="http://www.liquibase.org/xml/ns/dbchangelog" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemalocation="http://www.liquibase.org/xml/ns/dbchangelog http://www.liquibase.org/xml/ns/dbchangelog/dbchangelog-2.0.xsd"> <changeset id="init-1" author="mueller@synyx.de"> <insert tablename="Person"> <column name="name" value="John Doe"> </column> </insert> <rollback> DELETE FROM Person WHERE name LIKE 'John Doe'; </rollback> </changeset> </databasechangelog>

मैंने मैन्युअल रूप से "रोलबैक" टैग जोड़ा है, जिसमें एसक्यूएल स्टेटमेंट शामिल हैं जो इस परिवर्तक में परिवर्तन वापस करते हैं। इस टैग में SQL स्टेटमेंट और रेगुलर लिलीबेस टैग दोनों हो सकते हैं।
चूंकि अब हमारे पास दो XML चेंगलॉग फाइलें हैं, मैंने एक "मुख्य" फाइल बनाई जो डेटाबेस के सही संशोधन के लिए आवश्यक क्रम में अन्य फाइलों को आयात करती है:

 <databasechangelog xmlns="http://www.liquibase.org/xml/ns/dbchangelog/1.9" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemalocation="http://www.liquibase.org/xml/ns/dbchangelog/1.9 http://www.liquibase.org/xml/ns/dbchangelog/dbchangelog-1.9.xsd"> <include file="db.changelog-0.1.0.xml"></include> <include file="db.changelog-0.1.0.init.xml"></include> </databasechangelog>

जब चेंजर सेट में से प्रत्येक के लिए "अपडेट" कमांड को कॉल किया जाता है, तो यह जांचा जाता है कि क्या यह सर्किट पर लागू किया गया है। यदि परिवर्तक को अभी तक लागू नहीं किया गया है, तो इसे निष्पादित किया जाता है। ऐसा करने के लिए, लिक्विबेस डैटाबेसैन्चेंजलॉग्स सहायक तालिका में डेटा बचाता है, जिसमें पहले से उपयोग किए गए चेंजगेट्स, साथ ही साथ उनके हैश मान भी शामिल हैं। हैश का उपयोग किया जाता है ताकि पहले से ही बदल चुके चेंजसेट को बदलना संभव न हो।

 mysql> select id, md5sum, description from DATABASECHANGELOG; +--------+------------------------------------+--------------+ | id | md5sum | description | +--------+------------------------------------+--------------+ | 1 | 3:5a36f447e90b35c3802cb6fe16cb12a7 | Create Table | | init-1 | 3:43c29e0011ebfcfd9cfbbb8450179a41 | Insert Row | +--------+------------------------------------+--------------+ 2 rows in set (0.00 sec)

अब जबकि सरल उदाहरण ने काम कर दिया है, तो आइए कुछ और जटिल प्रयास करें: स्कीमा को बदलना, जिसे स्कीमा को माइग्रेट करने और डेटा को अपडेट करने की आवश्यकता होती है। PERSON तालिका में वर्तमान में NAME नाम के लिए केवल एक कॉलम है, और मैं NAME को दो स्तंभों में विभाजित करना चाहता हूं - FIRSTNAME और LASTNAME। डेटाबेस माइग्रेशन शुरू करने से पहले, मैं एक लिक्विबेस "टैग" डालने जा रहा हूं ताकि भविष्य में इस टैग में सभी परिवर्तन वापस कर सकूं:

 ./liquibase --url=jdbc:mysql://localhost:3306/liquiblog --driver=com.mysql.jdbc.Driver --username=root --password="" --changeLogFile=changelog-master.xml tag liquiblog_0_1_0

मैंने एक नया परिवर्तक बनाया है जो दो नए कॉलम जोड़ता है:

 <changeset id="1" author="mueller@synyx.de" runonchange="true"> <addcolumn tablename="Person"> <column name="firstname" type="VARCHAR(255)"> <constraints nullable="false"> </constraints> </column> <column name="lastname" type="VARCHAR(255)"> <constraints nullable="false"> </constraints> </column> </addcolumn> </changeset>

और इस बार, लिलीबेस जानता है कि इस चेंजसेट को कैसे रोल किया जाए, इसलिए हम "रोलबैक" टैग नहीं जोड़ सकते।

अब, PERSON तालिका में दो अतिरिक्त कॉलम हैं, और अप्रचलित NAME कॉलम को हटाने से पहले हमें मौजूदा डेटा को एक नए स्कीमा में माइग्रेट करने का ध्यान रखना चाहिए। चूंकि लिक्विडबेस द्वारा डेटा हेरफेर का समर्थन नहीं किया जाता है, इसलिए हमें चेंजर में देशी एसक्यूएल को शामिल करने के लिए एसक्यूएल टैग का उपयोग करना चाहिए।

 <changeset author="mueller@synyx.de" id="2"> <sql> UPDATE Person SET firstname = SUBSTRING_INDEX(name, ' ', 1); UPDATE Person SET lastname = SUBSTRING_INDEX(name, ' ', -1); </sql> <rollback> UPDATE Person SET firstname = ''; UPDATE Person SET lastname = ''; </rollback> </changeset>

यह ध्यान दिया जाना चाहिए कि "रोलबैक" टैग की सामग्री निरर्थक लगती है, लेकिन यह टैग स्वयं आवश्यक है क्योंकि लिकरिब केवल बैक चेंजर्स को रोल करने की अनुमति देता है:

जो स्पष्ट रूप से एक रोलबैक टैग है, जैसे कि createTable
रोलबैक टैग को स्पष्ट रूप से जोड़ा गया है

लिक्विबेस को "अपडेट" विकल्प के साथ शुरू करने के बाद, नया परिवर्तक योजना पर लागू होता है: निर्मित कॉलम FIRSTNAME और LASTNAME में पहले से ही डेटा है।

अगला, मैं पुराने NAME कॉलम से छुटकारा पाना चाहता हूं।

 <changeset id="3" author="mueller@synyx.de" runonchange="true"> <dropcolumn tablename="Person" columnname="name"> </dropcolumn> <rollback> <addcolumn tablename="Person"> <column name="name" type="VARCHAR(255)"> <constraints nullable="false"> </constraints> </column> </addcolumn> <sql> UPDATE Person SET name = CONCAT(firstname, CONCAT(' ', lastname)); </sql> </rollback> </changeset>

चेंजर स्वयं बहुत सरल है, क्योंकि लिलीबेस कॉलम हटाने का समर्थन करता है, लेकिन रोलबैक टैग अधिक जटिल हो गया है:

मैं मानक टैग "addColumn" का उपयोग करके पुराने कॉलम NAME को फिर से जोड़ता हूं
मैं इस कॉलम में डेटा रिकवर करने के लिए SQL स्टेटमेंट का उपयोग करता हूं

परिवर्तन परिणाम:

 mysql> select * from Person; +----+-----------+------------+ | id | firstname | lastname | +----+-----------+------------+ | 1 | John | Doe | +----+-----------+------------+ 1 rows in set (0.00 sec)

इस तथ्य के कारण कि हमने शुरू में टैग के साथ स्कीमा को टैग किया था, और हमारे सभी परिवर्तक सेटों में परिवर्तन वापस करने के निर्देश भी जोड़े, हम डेटा खोए बिना डेटाबेस स्कीमा संशोधनों को वापस कर सकते हैं! कॉल कर रहा है ...

 ./liquibase --url=jdbc:mysql://localhost:3306/liquiblog --driver=com.mysql.jdbc.Driver --username=root --password="" --changeLogFile=changelog-master.xml rollback liquiblog_0_1_0

... हम डेटाबेस स्कीमा की स्थिति में वापस आ गए हैं!

PERSON नाम के तारों को विभाजित / विलय करने का उदाहरण कुछ हद तक विरोधाभासी है, लेकिन एक ही सिद्धांत को अधिक गंभीर डेटा परिवर्तनों पर लागू किया जा सकता है।
एक मौजूदा डोमेन क्लास (एक टेबल के अनुसार) को तीन भागों में विभाजित करने पर काम करते हुए मुझे इस पोस्ट के लिए एक विचार आया: एक एब्सट्रैक्ट बेस क्लास और दो सबक्लासेस, जिसमें डेटा अखंडता को संरक्षित करने की आवश्यकता को ध्यान में रखते हुए।

लिलीबेस के साथ डाटाबेस माइग्रेशन मैनेजमेंट

More articles: