MongoDB और स्प्रिंग बूट के साथ डेटा माइग्रेशन

हर डेवलपर जल्द या बाद में एक डेटाबेस में डेटा माइग्रेट करने की आवश्यकता का सामना करता है। हमारे प्रोजेक्ट पर, हम एक डेटाबेस के रूप में mongoDB का उपयोग करते हैं। हमने अलग-अलग तरीकों से डेटा माइग्रेशन किया:

• js स्क्रिप्ट लिखी और सीधे डेटाबेस में भाग गया

• इस्तेमाल किया Mongobee - स्वचालित पलायन के लिए एक उपकरण

  
  

  मोंगोबी ने तब तक ठीक काम किया जब तक हम एक ऐसी स्थिति में नहीं आ गए जहाँ हम एक अद्वितीय सूचकांक के साथ एक नया क्षेत्र जोड़ना चाहते थे। मान लीजिए कि हमारे पास एक वर्ग है:

  
  

  @Document @Data public class TestDocument { @Id private String id; private String text; } 

  
  

  अब हम एक नया क्षेत्र जोड़ते हैं:

  
  

   @Document @Data public class TestDocument { @Id private String id; private String text; @Indexed(unique = true) private String text2; } 

  
  

  हमने एक माइग्रेशन लिखा है, जिसमें सभी दस्तावेजों में टेक्स्ट 2 फ़ील्ड को अद्वितीय मानों के साथ भरना चाहिए:

  
  

   @ChangeLog public class TestDocumentChangelog { @ChangeSet(order = 1, id = "change1", author = "Stepan") public void changeset(MongoTemplate template) { template.findAll(Document.class, "testDocument").forEach(document -> { document.put("text2", UUID.randomUUID().toString()); template.save(document, "testDocument"); }); } } 

  
  

  लेकिन जब हमने एप्लिकेशन शुरू किया, तो हमने देखा कि हमारे प्रवास शुरू होने से पहले स्प्रिंग ने मैंगो डेटा घटकों को लॉन्च किया था, और इसलिए टेक्स्ट 2 फ़ील्ड के ऊपर इंडेक्स बनाते समय एक त्रुटि हुई, क्योंकि यह फ़ील्ड अभी तक किसी भी दस्तावेज़ द्वारा नहीं भरी गई है।
  इस घटना के बाद, हमने मोंगोबी को छोड़ने का फैसला किया और अपने स्वयं के टूल को लिखने की कोशिश की, जिससे माइग्रेशन लिखना भी आसान हो जाएगा, लेकिन इसके अलावा में इस तरह की विशेषताएं भी होंगी:

  
  
• मानगो डेटा से पहले चलाएँ
• MongoDB 4.0 में लेनदेन समर्थन जोड़ा गया
• ChangeLog कक्षाओं में निर्भरता इंजेक्शन

परिणाम एक पुस्तकालय है जिसे मोंगेशन कहा जाता है, जो ऊपर वर्णित सभी कार्यक्षमता का समर्थन करता है।

स्प्रिंग बूट जीवनचक्र समर्थन

पहला फ़ंक्शन ऑटो कॉन्फ़िगरेशन का उपयोग करके कार्यान्वित किया जाता है, जो MongoClient बनाने और रिपॉजिटरी को स्कैन करने से पहले शुरू होता है:

 @Configuration @AutoConfigureAfter(MongoAutoConfiguration.class) @AutoConfigureBefore(MongoDataAutoConfiguration.class) @Import(MongrationConfiguration.class) public class MongrationAutoConfiguration { } 

लेकिन ऑटो कॉन्फ़िगरेशन के साथ समस्या यह है कि यदि आप रिपॉजिटरी को सक्रिय करने के लिए @EnableMongoRepositories एनोटेशन का उपयोग करते हैं, तो हमारे ऑटो कॉन्फ़िगरेशन से पहले Mongo डेटा घटकों को प्रारंभ किया जाता है। इस समस्या से बचने के लिए, आपको @EnableMongration साथ @EnableMongration एनोटेशन का उपयोग करना होगा:

 @Configuration @EnableMongoRepositories @EnableMongration public class MongoRepositoriesConfiguration { } 

@EnableMongration समान कॉन्फ़िगरेशन लॉन्च करने से अधिक कुछ नहीं करता है, केवल आपको इसे पहले चलाने की अनुमति देता है:

 @Target(ElementType.TYPE) @Retention(RetentionPolicy.RUNTIME) @Import(MongrationConfiguration.class) public @interface EnableMongration { } 

लेन-देन का समर्थन

लेनदेन का समर्थन करने के लिए, आपको प्रतिकृति सेट MongoDB को कॉन्फ़िगर करना होगा। यह आवश्यक है कि MongoTransationManager बीन को घोषित किया जाए (यदि मोंटेशन इस बीन को संदर्भ में नहीं मिलता है, तो यह इसे स्वयं बना देगा)। परिशोधन आपको दो तरीकों से लेनदेन का उपयोग करने की अनुमति देता है:

• का @Transactional
  

   @Transactional @ChangeSet(order = 1, id = "change1", author = "Stepan") public void changeset(MongoTemplate template) { template.findAll(Document.class, "testDocument").forEach(document -> { document.put("text2", UUID.randomUUID().toString()); template.save(document, "testDocument"); }); } 

• TransactionTemplate का उपयोग करना
  

   @ChangeSet(order = 1, id = "change1", author = "Stepan") public void migration(MongoTemplate template, TransactionTemplate txTemplate) { template.createCollection("entity"); txTemplate.execute(new TransactionCallbackWithoutResult() { @Override protected void doInTransactionWithoutResult(TransactionStatus status) { template.save(new Document("index", "1").append("text", "1"), "entity"); template.save(new Document("index", "2").append("text", "2"), "entity"); template.save(new Document("index", "3").append("text", "3"), "entity"); } }); } 

  
  

दूसरी विधि इस मायने में उपयोगी है कि यह डीडीएल परिचालनों का उपयोग करने की अनुमति देता है जो एक लेनदेन में लॉन्च नहीं किया जा सकता है और एक ही माइग्रेशन में एक लेनदेन में लॉन्च किए गए डीएमएल संचालन।

ChangeLog कक्षाओं में निर्भरता इंजेक्शन

यह कार्यक्षमता इस तथ्य के कारण संभव है कि प्रत्येक चेंजलॉग क्लास स्वयं एक साधारण बीन है:

 @Target(ElementType.TYPE) @Retention(RetentionPolicy.RUNTIME) @Component public @interface ChangeLog { } 

यह ध्यान देने योग्य है कि आप उन बीजों को इंजेक्ट नहीं कर सकते हैं जिनके पास मैंगो डेटा घटकों पर निर्भरता है, क्योंकि जब तक माइग्रेशन पूरा हो जाता है तब तक वे अभी तक आरंभीकृत नहीं होते हैं।

पुस्तकालय का स्रोत कोड Github पर उपलब्ध है।