👐🏽 🕰️ 🐇 स्प्रिंग बूट एप्लिकेशन में डेटाबेस संरचना का प्रबंधन करने के लिए लिक्विबेस का उपयोग करना। भाग २ 📕 📔 🍴

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

मान लीजिए हमें अपने डेटाबेस की संरचना में कुछ बदलाव करने की आवश्यकता है। उदाहरण के लिए, हम चाहते हैं कि ईमेल शून्य न हो। बेशक, इस तरह के एक छोटे से बदलाव के लिए, आप मैन्युअल रूप से कोड और स्क्रिप्ट्स को सही कर सकते हैं, लेकिन क्या होगा अगर अधिक परिवर्तन हों? इस मामले में, लिक्विबेस में निर्मित डेटाबेस की तुलना करने की क्षमता हमारी सहायता के लिए आएगी। इसकी एक दिलचस्प विशेषता यह है कि आप न केवल दो डेटाबेस की तुलना कर सकते हैं, बल्कि हमारे आवेदन में JPA संस्थाओं के एक सेट के साथ डेटाबेस भी कर सकते हैं। ठीक यही अब हम करेंगे!

लिबास-डिफरेंस का उपयोग करके परिवर्तन के साथ एक स्क्रिप्ट बनाएं

Pom.xml फ़ाइल के प्लगइन्स अनुभाग में, हम इसके बजाय जटिल डिज़ाइन को जोड़ते हैं। यह लिबास-मावेन-प्लगइन है , जिसके लिए एक निर्भरता हाइबरनेट संस्थाओं के विश्लेषण और यमनी फाइलों के साथ काम करने के लिए जुड़ी हुई है। प्लगइन हमें दो डेटाबेस में संरचनाओं की तुलना करके या यहां तक कि एक डेटाबेस में डेटा संरचना और हमारे आवेदन में हाइबरनेट संस्थाओं का एक सेट ( liquibase-hibernate5 इसके लिए जोड़ा जाता है ) से तुलना करके स्वचालित रूप से शराब बनाने की स्क्रिप्ट बनाने में मदद करेगा।

<plugin> <groupId>org.liquibase</groupId> <artifactId>liquibase-maven-plugin</artifactId> <version>3.8.1</version> <configuration> <propertyFile>${project.build.outputDirectory}/liquibase-maven-plugin.properties</propertyFile> <systemProperties> <user.name>your_liquibase_username</user.name> </systemProperties> <logging>info</logging> </configuration> <dependencies> <dependency> <groupId>org.liquibase.ext</groupId> <artifactId>liquibase-hibernate5</artifactId> <version>3.6</version> </dependency> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-data-jpa</artifactId> <version>2.2.0.RELEASE</version> </dependency> </dependencies> </plugin>

User.name सेटिंग पर ध्यान दें। यह वैकल्पिक है, लेकिन इसके बिना लिकबिज़ बनाई गई लिपियों में वर्तमान ओएस उपयोगकर्ता के नाम का संकेत देगा जिसके तहत प्लगइन लॉन्च किया गया है।

प्लगइन के लिए सेटिंग्स सीधे pom.xml को लिखा जा सकता है या मावेन को कॉल करते समय कमांड लाइन मापदंडों के रूप में पारित किया जा सकता है, लेकिन मैं एक अलग लिबास- maven-plugin.properties फ़ाइल के साथ विकल्प पसंद करता हूं। इसकी सामग्री कुछ इस तरह दिखाई देगी।

 changeLogFile= @project.basedir@/src/main/resources/db/changelog/db.changelog-master.yaml url= jdbc:mysql://localhost:3306/geek_db?createDatabaseIfNotExist=true&allowPublicKeyRetrieval=true&useSSL=false&useUnicode=true&characterEncoding=UTF-8&serverTimezone=UTC username= dbusername password= dbpassword driver= com.mysql.cj.jdbc.Driver referenceUrl= hibernate:spring:ru.usharik.liquibase.demo.persist.model?dialect=org.hibernate.dialect.MySQLDialect diffChangeLogFile= @project.basedir@/src/main/resources/db/changelog/db.changelog-@timestamp@.yaml ignoreClasspathPrefix= true

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

अब हमें सेटिंग फ़ाइल में प्लेसहोल्डर को बदलने के लिए मावेन-संसाधन-प्लगइन को कॉन्फ़िगर करने की आवश्यकता है, जैसे कि @project.basedir@ और @timestamp@ । ऐसा करने के लिए, निम्न प्रपत्र के संसाधन अनुभाग को बिल्ड अनुभाग में जोड़ें

 <resources> <resource> <directory>src/main/resources</directory> <filtering>true</filtering> <includes> <include>*.properties</include> </includes> </resource> <resource> <directory>src/main/resources</directory> <filtering>false</filtering> <includes> <include>**/*.*</include> </includes> </resource> </resources>

वैसे, स्प्रिंग बूट ${smth} से @smth@ तक maven-resource-plugin का उपयोग करके पॉपुलेटेड प्लेसहोल्डर्स के लिए मानक प्रारूप में परिवर्तन करता है। तथ्य यह है कि स्प्रिंग बूट में @smth@ प्लेसहोल्डर्स का उपयोग वातावरण चर और स्प्रिंग बूट एप्लिकेशन के मापदंडों को स्थानापन्न करने के लिए किया जाता है।

इसके अलावा, हम अपनी आवश्यकता के प्रारूप में टाइमस्टैम्प चर के मान को नियत करने के लिए pom.xml में गुणों के खंड को थोड़ा बदल देते हैं। काश, मानक प्रारूप में कुछ ऑपरेटिंग सिस्टम के लिए फ़ाइल नाम में निषिद्ध वर्ण हो सकते हैं।

 <properties> <java.version>1.8</java.version> <timestamp>${maven.build.timestamp}</timestamp> <maven.build.timestamp.format>yyyyMMdd-HHmmssSSS</maven.build.timestamp.format> </properties>

अब उपयोगकर्ता वर्ग में ईमेल फ़ील्ड को बदलते हैं

  @Column(name = "email", nullable = false) private String email;

अंत में, तुलना के लिए लिबास-मावेन-प्लगइन का उपयोग करके बिल्ड कमांड चलाएं।

 mvn clean install liquibase:diff -DskipTests=true

इस मामले में, हमें पूरी तरह से परियोजना को फिर से बनाने की आवश्यकता है, क्योंकि प्लगइन (लिबास: भिन्न) संकलित स्रोतों का उपयोग नहीं करेगा, लेकिन विश्लेषण के लिए लक्ष्य फ़ोल्डर से संकलित इकाई श्रेणी की फाइलें।

यदि सब कुछ सही ढंग से किया जाता है, तो संसाधनों / डीबी / चेंगलॉग फ़ोल्डर में कमांड के सफल निष्पादन के बाद, आपको db.changelog-20190723-100748666.yaml नाम से एक फ़ाइल दिखाई देगी । इस तथ्य के कारण कि हम फ़ाइल नाम में वर्तमान दिनांक और समय का उपयोग करते हैं, प्रत्येक लॉन्च के साथ हमारे पास एक नई फ़ाइल होगी, जो काफी सुविधाजनक है। यदि आपने पिछले पाठ के अनुरूप तालिका संरचना के साथ एक डेटाबेस पहले ही बना लिया है, तो फ़ाइल की सामग्री इस तरह होनी चाहिए।

 databaseChangeLog: - changeSet: id: 1563876485764-1 author: your_liquibase_username (generated) changes: - addNotNullConstraint: columnDataType: varchar(255) columnName: email tableName: users

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

अगला, हम बस इस फाइल से परिवर्तन को कॉपी कर सकते हैं db.changelog-master.yaml पर या हम इस फाइल को एक निर्देश के साथ जोड़ सकते हैं

  - include: file: db.changelog-20190723-100748666.yaml relativeToChangelogFile: true

इसके अलावा इस फ़ाइल में आपको logicalFilePath: db/changelog/db.changelog-20190723-100748666.yaml को निर्दिष्ट करने की आवश्यकता है logicalFilePath: db/changelog/db.changelog-20190723-100748666.yaml , logicalFilePath: db/changelog/db.changelog-20190723-100748666.yaml यह कैसे किया गया था।
यह कुछ समस्याओं से निपटने में मदद करेगा जो कि एप्लिकेशन में बिल्ट-इन एल्कोहल बीन और लिबास-मावेन-प्लगइन का उपयोग करते समय संभव हैं। उसके बाद, एप्लिकेशन को पुनरारंभ करें या कमांड चलाएं:

 mvn liquibase:update

आइए कोड में कुछ और अधिक जटिल परिवर्तन करने का प्रयास करें। उदाहरण के लिए, एक भूमिका तालिका जोड़ें जिसमें उपयोगकर्ता तालिका के साथ कई-से-कई संबंध होंगे।

 @Entity @Table(name = "roles") public class Role implements Serializable { @Id @GeneratedValue(strategy = GenerationType.IDENTITY) @Column(name = "id") private Long id; @Column(name = "name", unique = true, nullable = false) private String name; @ManyToMany(mappedBy = "roles") private Set<User> users; //  , ,  }

और उपयोगकर्ता तालिका में हम जोड़ते हैं

  @ManyToMany(fetch = FetchType.LAZY) @JoinTable(name = "users_roles", joinColumns = @JoinColumn(name = "user_id"), inverseJoinColumns = @JoinColumn(name = "role_id")) private Set<Role> roles;

तुलना शुरू करने के बाद, हमें निम्नलिखित सामग्रियों के साथ एक फ़ाइल मिलती है

 databaseChangeLog: - changeSet: id: 1563877765929-1 author: your_liquibase_username (generated) changes: - createTable: columns: - column: autoIncrement: true constraints: primaryKey: true primaryKeyName: rolesPK name: id type: BIGINT - column: constraints: nullable: false name: name type: VARCHAR(255) tableName: roles - changeSet: id: 1563877765929-2 author: your_liquibase_username (generated) changes: - createTable: columns: - column: constraints: nullable: false name: user_id type: BIGINT - column: constraints: nullable: false name: role_id type: BIGINT tableName: users_roles - changeSet: id: 1563877765929-3 author: your_liquibase_username (generated) changes: - addPrimaryKey: columnNames: user_id, role_id tableName: users_roles - changeSet: id: 1563877765929-4 author: your_liquibase_username (generated) changes: - addUniqueConstraint: columnNames: name constraintName: UC_ROLESNAME_COL tableName: roles - changeSet: id: 1563877765929-5 author: your_liquibase_username (generated) changes: - addForeignKeyConstraint: baseColumnNames: user_id baseTableName: users_roles constraintName: FK2o0jvgh89lemvvo17cbqvdxaa deferrable: false initiallyDeferred: false referencedColumnNames: id referencedTableName: users - changeSet: id: 1563877765929-6 author: your_liquibase_username (generated) changes: - addForeignKeyConstraint: baseColumnNames: role_id baseTableName: users_roles constraintName: FKj6m8fwv7oqv74fcehir1a9ffy deferrable: false initiallyDeferred: false referencedColumnNames: id referencedTableName: roles

हम इस फाइल को आसानी से वर्किंग स्क्रिप्ट में जोड़ सकते हैं।

रोल बैक परिवर्तन

अब देखते हैं कि किए गए परिवर्तनों को वापस कैसे रोल करें। किसी कारण से, उन पहचानकर्ता जिन्हें हमने परिवर्तनसेट में निर्दिष्ट किया था, उन्हें वापस रोल करने के लिए उपयोग नहीं किया जा सकता है। तीन विकल्प हैं, एक रोलबैक बिंदु निर्दिष्ट करें

परिवर्तन की संख्या के माध्यम से वर्तमान से गिनता है
परिवर्तन की तारीख के बाद
टैग के माध्यम से (सेट का उपयोग करके एक विशेष प्रकार का सेट)

टैग निम्नानुसार सेट है।

  - changeSet: id: some_uniqui_id author: liquibase_user_name changes: - tagDatabase: tag: db_tag

खैर, रोलबैक करने के लिए तीन सूचीबद्ध तरीकों के लिए आदेश

 mvn liquibase:rollback -Dliquibase.rollbackTag=db_tag mvn liquibase:rollback -Dliquibase.rollbackCount=1 mvn liquibase:rollback "-Dliquibase.rollbackDate=Jun 03, 2017"

और अंत में, कुछ अतिरिक्त सामग्री

निश्चित रूप से, मैं किसी भी टिप्पणी, परिवर्धन, स्पष्टीकरण आदि के लिए बहुत खुश रहूंगा।

स्प्रिंग बूट एप्लिकेशन में डेटाबेस संरचना का प्रबंधन करने के लिए लिक्विबेस का उपयोग करना। भाग २

लिबास-डिफरेंस का उपयोग करके परिवर्तन के साथ एक स्क्रिप्ट बनाएं

रोल बैक परिवर्तन

More articles: