सिरदर्द के बिना लिक्विबेस का उपयोग करना। वास्तविक दुनिया के विकास के अनुभव से 10 सुझाव

लिकिबेस एक डेटाबेस माइग्रेशन मैनेजमेंट सिस्टम है। लिक्विबेस पर यह दूसरा लेख है, इस बार सिस्टम के "मुकाबला" उपयोग के लिए युक्तियां। बुनियादी जानकारी के लिए, पहला अनुवाद लेख “लिक्विडबेस के साथ डेटाबेस माइग्रेशन का प्रबंध” ( लिंक ) उपयुक्त है।

सॉफ्टवेयर डेवलपर्स के लिए जीवन को आसान बनाने वाले कई उपकरणों की तरह, लिलीबेस के पास एक "फ्लिप साइड" है जिसे आपको जल्द या बाद में सामना करना होगा।

यहां 10 चीजें हैं जो लिक्विबेस के साथ काम करते समय किसी समय मेरे लिए एक रहस्योद्घाटन थे।

1. एप्लिकेशन संस्करण को माइग्रेशन के फ़ोल्डर संरचना में परिलक्षित होना चाहिए

यदि आप इस नियम का पालन नहीं करते हैं, तो चेंजलॉग फाइलें जल्दी से माइग्रेशन फ़ोल्डर को उनकी संख्या और असामान्य नामों से सजाएगी।
फिलहाल, खुद के लिए, मैंने फ़ाइलों और फ़ोल्डरों के नामकरण के लिए एक इष्टतम रणनीति विकसित की है। यहाँ यह है:

/db-migrations /v-1.0 /2013-03-02--01-initial-schema-import.xml /2013-03-02--02-core-data.xml /2013-03-04--01-notifications.xml /changelog-v.1.0-cumulative.xml /v-2.0 ... /changelog-v.2.0-cumulative.xml /changelog.xml 

अधिक जानकारी:

1.1। डेटाबेस परिवर्तनों के परिवर्तन को अलग-अलग फ़ोल्डर में रखा जाना चाहिए और अनुप्रयोग संस्करणों के अनुरूप होना चाहिए।

पेशेवरों:

• आप हमेशा आसानी से बता सकते हैं कि संस्करण से अनुप्रयोग संस्करण में संक्रमण के दौरान डेटा योजना में क्या परिवर्तन हुए हैं।
• फ़ोल्डरों में सटीकता बनाए रखी जाती है, यह आपको आराम करने की अनुमति नहीं देता है।

1.2। प्रत्येक संस्करण के लिए एक संचयी चैंज फ़ाइल है

मुख्य माइग्रेशन फ़ाइल /db-migrations/changelog.xml है। प्रत्येक संस्करण की केवल संचयी चेंजलॉग फाइलें इसमें शामिल हैं ("शामिल" टैग)।

 <?xml version="1.0" encoding="UTF-8"?> <databaseChangeLog xmlns="http://www.liquibase.org/xml/ns/dbchangelog"> <!-- Should be only links to per-version cumulative changelog files. --> <include file="v-1.0/changelog-v.1.0-cumulative.xml" relativeToChangelogFile="true"/> <include file="v-2.0/changelog-v.2.0-cumulative.xml" relativeToChangelogFile="true"/> </databaseChangeLog> 

बदले में, अनुप्रयोग संस्करणों के संचयी चेंगलॉग में चेंजर सेट के साथ विशिष्ट फाइलें शामिल हैं।
इस प्रकार, चेंजलॉग्स की मुख्य फ़ाइल को नहीं करना संभव है।

1.3। फ़ाइल नामकरण दिशानिर्देशों का पालन करें

फ़ाइल नामकरण नियम आपको समझने की अनुमति देता है कि संचयी फ़ाइल परिवर्तक को देखे बिना क्या किया गया था।

 -<DATE_INCR>-.xml 
 DATE –   
 DATE_INCR –      (      .) 
 DESCR – . 
 : 
 2013-03-02--01-initial-schema-import.xml 
 
 2.   ,   
   (    rollback )    . 
      ,      .    ,    . 
 
       ,        PROD-,    , ,      ,   . 
 
 3.    ,    
   —  .    , ,    . 
    ,       ,     rollback.           . 
 
 4. ,   ,    
       ,      Oracle  MySQL DDL-    . 
  ,       , DDL-,      . 
  ( ): 
 
 <changeSet id="2013-03-02-initial-schema-import-1" author="eg"> <createTable tableName="HOUSES"> <column name="ID" type="BIGINT" /> </createTable> <addPrimaryKey tableName="HOUSES" columnNames="ID" /> </changeSet> 
 -<DATE_INCR>-.xml 
 DATE –   
 DATE_INCR –      (      .) 
 DESCR – . 
 : 
 2013-03-02--01-initial-schema-import.xml 
 
 2.   ,   
   (    rollback )    . 
      ,      .    ,    . 
 
       ,        PROD-,    , ,      ,   . 
 
 3.    ,    
   —  .    , ,    . 
    ,       ,     rollback.           . 
 
 4. ,   ,    
       ,      Oracle  MySQL DDL-    . 
  ,       , DDL-,      . 
  ( ): 
 
 <changeSet id="2013-03-02-initial-schema-import-1" author="eg"> <createTable tableName="HOUSES"> <column name="ID" type="BIGINT" /> </createTable> <addPrimaryKey tableName="HOUSES" columnNames="ID" /> </changeSet> 
 -<DATE_INCR>-.xml 
 DATE –   
 DATE_INCR –      (      .) 
 DESCR – . 
 : 
 2013-03-02--01-initial-schema-import.xml 
 
 2.   ,   
   (    rollback )    . 
      ,      .    ,    . 
 
       ,        PROD-,    , ,      ,   . 
 
 3.    ,    
   —  .    , ,    . 
    ,       ,     rollback.           . 
 
 4. ,   ,    
       ,      Oracle  MySQL DDL-    . 
  ,       , DDL-,      . 
  ( ): 
 
 <changeSet id="2013-03-02-initial-schema-import-1" author="eg"> <createTable tableName="HOUSES"> <column name="ID" type="BIGINT" /> </createTable> <addPrimaryKey tableName="HOUSES" columnNames="ID" /> </changeSet> 
 -<DATE_INCR>-.xml 
 DATE –   
 DATE_INCR –      (      .) 
 DESCR – . 
 : 
 2013-03-02--01-initial-schema-import.xml 
 
 2.   ,   
   (    rollback )    . 
      ,      .    ,    . 
 
       ,        PROD-,    , ,      ,   . 
 
 3.    ,    
   —  .    , ,    . 
    ,       ,     rollback.           . 
 
 4. ,   ,    
       ,      Oracle  MySQL DDL-    . 
  ,       , DDL-,      . 
  ( ): 
 
 <changeSet id="2013-03-02-initial-schema-import-1" author="eg"> <createTable tableName="HOUSES"> <column name="ID" type="BIGINT" /> </createTable> <addPrimaryKey tableName="HOUSES" columnNames="ID" /> </changeSet> 
 -<DATE_INCR>-.xml 
 DATE –   
 DATE_INCR –      (      .) 
 DESCR – . 
 : 
 2013-03-02--01-initial-schema-import.xml 
 
 2.   ,   
   (    rollback )    . 
      ,      .    ,    . 
 
       ,        PROD-,    , ,      ,   . 
 
 3.    ,    
   —  .    , ,    . 
    ,       ,     rollback.           . 
 
 4. ,   ,    
       ,      Oracle  MySQL DDL-    . 
  ,       , DDL-,      . 
  ( ): 
 
 <changeSet id="2013-03-02-initial-schema-import-1" author="eg"> <createTable tableName="HOUSES"> <column name="ID" type="BIGINT" /> </createTable> <addPrimaryKey tableName="HOUSES" columnNames="ID" /> </changeSet> 
 -<DATE_INCR>-.xml 
 DATE –   
 DATE_INCR –      (      .) 
 DESCR – . 
 : 
 2013-03-02--01-initial-schema-import.xml 
 
 2.   ,   
   (    rollback )    . 
      ,      .    ,    . 
 
       ,        PROD-,    , ,      ,   . 
 
 3.    ,    
   —  .    , ,    . 
    ,       ,     rollback.           . 
 
 4. ,   ,    
       ,      Oracle  MySQL DDL-    . 
  ,       , DDL-,      . 
  ( ): 
 
 <changeSet id="2013-03-02-initial-schema-import-1" author="eg"> <createTable tableName="HOUSES"> <column name="ID" type="BIGINT" /> </createTable> <addPrimaryKey tableName="HOUSES" columnNames="ID" /> </changeSet> 
 -<DATE_INCR>-.xml 
 DATE –   
 DATE_INCR –      (      .) 
 DESCR – . 
 : 
 2013-03-02--01-initial-schema-import.xml 
 
 2.   ,   
   (    rollback )    . 
      ,      .    ,    . 
 
       ,        PROD-,    , ,      ,   . 
 
 3.    ,    
   —  .    , ,    . 
    ,       ,     rollback.           . 
 
 4. ,   ,    
       ,      Oracle  MySQL DDL-    . 
  ,       , DDL-,      . 
  ( ): 
 
 <changeSet id="2013-03-02-initial-schema-import-1" author="eg"> <createTable tableName="HOUSES"> <column name="ID" type="BIGINT" /> </createTable> <addPrimaryKey tableName="HOUSES" columnNames="ID" /> </changeSet> 

यदि इंडेक्स को जोड़ने के दौरान कोई त्रुटि होती है, तो HOUSES तालिका को हटाया नहीं जाएगा!
दर्द से कैसे बचें? डेटाबेस स्कीमा में प्रत्येक परिवर्तन को अपने स्वयं के चैंज में रहना चाहिए।

उदाहरण (इतना सही):

 <changeSet id="2013-03-02-initial-schema-import-1" author="eg"> <createTable tableName="HOUSES"> <column name="ID" type="BIGINT" /> </createTable> </changeSet> <changeSet id="2013-03-02-initial-schema-import-2" author="eg"> <addPrimaryKey tableName="HOUSES" columnNames="ID" /> </changeSet> 

5. माइग्रेशन स्क्रिप्ट चलाने का मार्ग मायने रखता है

डेटाबेस स्कीमा माइग्रेशन स्क्रिप्ट को चलाने के लिए दो कमांड देखें

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

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

ऐसा लगता है कि दूसरी टीम को कोई बदलाव नहीं करना चाहिए। लेकिन ऐसा नहीं है, लिक्विबेस डैटैबसैकेनजेल टेबल के FILENAME कॉलम में चेंजलॉग फ़ाइल के लिए पथ संग्रहीत करता है।
इस तथ्य के संबंध में, दूसरे लॉन्च पर लिक्बिबेस सभी चेंजर सेट को नया बनाने पर विचार करेगा। यह आपकी डेटा योजना को तोड़ सकता है!

दर्द से कैसे बचें? हमेशा उसी निर्देशिका से सापेक्ष पथों का उपयोग करके चैंज चलाएं।

6. पूर्व शर्त स्थिति चैंज के चेकसम को प्रभावित नहीं करती है

यह त्रुटि के प्रेमियों के लिए अच्छी खबर है (जो कि, हम सभी, जल्दी या बाद में)। कभी-कभी यह आपको परिवर्तन के उपयोग की शर्तों को बदलने की अनुमति देता है, इस प्रकार, "अतीत को सही करना।"

7. बार-बार बदलते डेटा के लिए लिक्विबेस इतना अच्छा नहीं है।

एक बार हमने एक ही प्रकार के डेटा को बहुत अधिक माइग्रेट करने की कोशिश की, लेकिन चेंजलॉग्स के माध्यम से कॉन्फ़िगरेशन डेटा के संस्करण से संस्करण में बदल दिया। यह बहुत दुखद निकला - लगातार टीम के किसी व्यक्ति से गलती हुई थी, त्रुटि परीक्षण वातावरण के लिए जा रही थी, इसे मैन्युअल रूप से पूरी तरह से वापस रोल करना पड़ा था (चिपसेट की चेकसम याद है?)।
एक विशिष्ट स्थिति के लिए शांत दृष्टिकोण से ब्लेक तस्वीर को ठीक करना पड़ा। लिक्विबेस को डेटा योजना को बदलने के लिए छोड़ दिया गया था, और प्रत्येक संस्करण के साथ कॉन्फ़िगरेशन डेटा को ग्रूवी स्क्रिप्ट के साथ डाला गया था जिसमें स्रोत के रूप में गुण फ़ाइल थी।

8. स्वचालित पीढ़ी के चेंजसेट्स के लिए लिपियों पर विश्वास न करें

लिकिबेस उत्पन्न कर सकता है

• मौजूदा डेटाबेस स्कीमा के अनुसार परिवर्तक,
• मौजूदा चेंजर सेट्स (ग्रेल्स के लिए लागू) की तुलना में डेटाबेस में होने वाला अंतर।

इन सुविधाओं को सावधानी के साथ व्यवहार किया जाना चाहिए। यह सिर्फ दिनचर्या से थोड़ा सा छुटकारा है, अब और नहीं। सभी परिवर्तक सेटों को देखने, समझने और सत्यापित करने की आवश्यकता है। आप एक तार्किक त्रुटि (एक बेवकूफ उपयोगिता के कारण) को सही नहीं करना चाहते हैं जो PROD के पास गया, है ना?

9. एक्सएमएल का इस्तेमाल करें, डीएसएल का नहीं

कभी-कभी आप "जीवन को आसान बनाना चाहते हैं" और एक छोटे से DSL (groovy, yaml, json) का उपयोग शुरू करके XML को छोड़ दें
यह सब बहुत अच्छा है जब तक आप करना चाहते हैं:

• IDE में स्वतः पूर्णता
• डेटा योजना के अनुसार दस्तावेज़ की औपचारिक निष्ठा का स्वत: सत्यापन

खैर, इस तरह की उपयोगी चीजों को संक्षिप्तता के पक्ष में क्यों छोड़ना चाहिए? जाहिर है, मैं कोड की थोड़ी बेहतर पठनीयता के लिए ऑटो-समापन से इनकार करने के लिए एक अच्छा प्रोग्रामर नहीं हूं।

10. किसी और के अनुभव को जानें

हालाँकि मैंने इस लेख के अधिकांश बिंदुओं को अपने अनुभव से सीखा, आधिकारिक लिकिबेस बेस्ट प्रैक्टिसेस गाइड टूल धारणा ( लिंक ) में सुधार करता है

सफल पलायन!