👫 🚽 🍮 लिकिबेस और मावेन 🚚 🙎 🍑

परिचय

लिकेबेस एक डेटाबेस संस्करण नियंत्रण प्रणाली है, यह मुख्य रूप से संरचना की चिंता करता है और, कुछ हद तक, डेटाबेस की सामग्री। इसके अलावा, डेटाबेस का वर्णन एक तरफ है, बल्कि सार है और निचले स्तर पर विभिन्न DBMS के उपयोग की अनुमति देता है, और दूसरी तरफ, आप हमेशा एक विशिष्ट DBMS की SQL बोली पर स्विच कर सकते हैं, जो काफी लचीला है। लिकिबेस एक स्थापित ओपन सोर्स प्रोजेक्ट है और इसका उपयोग अपने मूल जावा वातावरण के बाहर सक्रिय रूप से किया जाता है और इसके लिए जावा के गहन ज्ञान की आवश्यकता नहीं है। एक XML प्रारूप का उपयोग ऐतिहासिक रूप से आधार संरचना और आधार परिवर्तनों का वर्णन करने के लिए किया गया है, लेकिन अब YAML और JSON समानांतर में समर्थित हैं।

इस लेख में, हम पिछली पीढ़ियों के अनुभव को संक्षेप में प्रस्तुत करेंगे और मावेन का उपयोग करके लिबास के साथ काम करने पर ध्यान केंद्रित करेंगे। हम उबंटू को एक परीक्षण ऑपरेटिंग सिस्टम के रूप में उपयोग करेंगे।

लिलीबेस के बारे में अन्य लेख

पर्यावरण की स्थापना

लिलीबेस शुरू करने के कई तरीके हैं, हालांकि, मावेन या ग्रैडल का उपयोग करना सबसे सुविधाजनक है।

sudo apt install maven mvn -version

यहां pom.xml एक मेकफाइल के रूप में कार्य करता है - इसमें पहले से ही सभी आवश्यक निर्भरताएं, सेटिंग्स और प्रोफाइल शामिल हैं।

pom.xml

 <?xml version="1.0" encoding="UTF-8"?> <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd"> <modelVersion>4.0.0</modelVersion> <groupId>com.test.db</groupId> <artifactId>db</artifactId> <version>1.0.0</version> <name>db</name> <description>Test Database</description> <packaging>pom</packaging> <properties> <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding> <project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding> <slf4j.version>1.7.24</slf4j.version> <logback.version>1.2.3</logback.version> <liquibase.version>3.6.2</liquibase.version> <postgresql.version>42.2.5</postgresql.version> <snakeyaml.version>1.23</snakeyaml.version> </properties> <dependencies> <!--Logging--> <dependency> <groupId>org.slf4j</groupId> <artifactId>slf4j-api</artifactId> <version>${slf4j.version}</version> </dependency> <dependency> <groupId>org.slf4j</groupId> <artifactId>log4j-over-slf4j</artifactId> <version>${slf4j.version}</version> </dependency> <dependency> <groupId>org.slf4j</groupId> <artifactId>jcl-over-slf4j</artifactId> <version>${slf4j.version}</version> </dependency> <dependency> <groupId>ch.qos.logback</groupId> <artifactId>logback-classic</artifactId> <version>${logback.version}</version> </dependency> <!--JDBC drivers--> <dependency> <groupId>org.postgresql</groupId> <artifactId>postgresql</artifactId> <version>${postgresql.version}</version> </dependency> <dependency> <groupId>org.liquibase</groupId> <artifactId>liquibase-core</artifactId> <version>${liquibase.version}</version> </dependency> <dependency> <groupId>org.yaml</groupId> <artifactId>snakeyaml</artifactId> <version>${snakeyaml.version}</version> </dependency> </dependencies> <build> <plugins> <plugin> <groupId>org.liquibase</groupId> <artifactId>liquibase-maven-plugin</artifactId> <version>${liquibase.version}</version> <configuration> <propertyFile>${profile.propertyFile}</propertyFile> <changeLogFile>${profile.changeLogFile}</changeLogFile> <dataDir>${profile.dataDir}</dataDir> <!-- log --> <verbose>${profile.verbose}</verbose> <logging>${profile.logging}</logging> <promptOnNonLocalDatabase>false</promptOnNonLocalDatabase> </configuration> </plugin> </plugins> </build> <profiles> <!-- Development settings, -Denv=dev --> <profile> <id>dev</id> <activation> <property> <name>env</name> <value>dev</value> </property> </activation> <properties> <profile.propertyFile>dev/liquibase.properties</profile.propertyFile> <profile.changeLogFile>dev/master.xml</profile.changeLogFile> <profile.dataDir>dev/data</profile.dataDir> <profile.verbose>true</profile.verbose> <profile.logging>debug</profile.logging> </properties> </profile> <!-- Production settings, -Denv=prod --> <profile> <id>prod</id> <activation> <property> <name>env</name> <value>prod</value> </property> </activation> <properties> <profile.propertyFile>prod/liquibase.properties</profile.propertyFile> <profile.changeLogFile>prod/master.xml</profile.changeLogFile> <profile.dataDir>prod/data</profile.dataDir> <profile.verbose>false</profile.verbose> <profile.logging>info</profile.logging> </properties> </profile> </profiles> </project>

हम अपडेट लॉन्च करते हैं

जब हमने pom.xml किया है, तब हम डेटाबेस को अपडेट करना शुरू कर सकते हैं - शराबखाना: अपडेट कमांड।

इसके लिए हमें चाहिए:

liquibase.properties डेटाबेस से कनेक्ट करने के लिए सेटिंग्स के साथ फ़ाइल (उपयोगकर्ता नाम / पासवर्ड और संभवतः अन्य पैरामीटर)
बेस परिवर्तन के साथ xml फ़ाइल
sh डेटाबेस अपडेट स्टार्टअप स्क्रिप्ट

डेटाबेस कनेक्शन सेटिंग्स फ़ाइल

liquibase.properties

 username=test password=test referenceUsername=test #     #url=jdbc:postgresql://dev/test #referenceUrl=jdbc:postgresql://dev/test_reference

आधार परिवर्तन फ़ाइल

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

 <?xml version="1.1" encoding="UTF-8" standalone="no"?> <databaseChangeLog xmlns="http://www.liquibase.org/xml/ns/dbchangelog" xmlns:ext="http://www.liquibase.org/xml/ns/dbchangelog-ext" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.liquibase.org/xml/ns/dbchangelog-ext http://www.liquibase.org/xml/ns/dbchangelog/dbchangelog-ext.xsd http://www.liquibase.org/xml/ns/dbchangelog http://www.liquibase.org/xml/ns/dbchangelog/dbchangelog-3.6.xsd"> <changeSet context="legacy" author="author (generated)" id="1"> <createTable tableName="test"> <column autoIncrement="true" name="id" type="SERIAL"> <constraints nullable="false"/> </column> <column name="user_name" type="VARCHAR(255)"/> <column name="preferences" type="TEXT"/> </createTable> </changeSet> </databaseChangeLog>

डेटाबेस अद्यतन स्टार्टअप स्क्रिप्ट

यहां लिबास: अपडेट को देविबे और बेस से लिबास के लिए निष्पादित किया जाता है, जो कि मानक जेडीबीसी प्रारूप में निर्दिष्ट है। अद्यतन के बाद, तालिका में परिवर्तित किया गया संकेत और दो सेवा तालिकाएँ databasechangelog और databasechangeloglock डेटाबेस में दिखाई देती हैं ।

 #!/usr/bin/env bash mvn liquibase:update\ -Denv=dev\ -Dliquibase.url="jdbc:postgresql://dev/test?prepareThreshold=0&stringtype=unspecified"

डेटाबेस को अपडेट किए बिना SQL पीढ़ी

कभी-कभी, परिवर्तन शुरू करने से पहले, आपको उत्पन्न अनुरोधों की सामग्री को देखना होगा। The liquibase: updateSQL और liquibase: rollbackSQL कमांड्स इस उद्देश्य के लिए हैं।

 #!/usr/bin/env bash mvn liquibase:updateSQL\ -Denv=dev\ -Dliquibase.url="jdbc:postgresql://dev/test?prepareThreshold=0&stringtype=unspecified" > /tmp/script.sql

चेंजसेट पर अधिक

परिवर्तन विभिन्न स्वरूपों में हो सकते हैं, जिसमें नियमित एसक्यूएल या एक अलग फ़ाइल शामिल है।

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

सामान्य प्रारूप

 <changeSet context="legacy" author="author (generated)" id="1"> <createTable tableName="test"> <column autoIncrement="true" name="id" type="SERIAL"> <constraints primaryKey="true" primaryKeyName="test_pkey"/> </column> <column name="c1" type="VARCHAR(255)"/> <column name="c2" type="INTEGER"/> <column name="c3" type="SMALLINT"/> <column name="c4" type="VARCHAR(255)"/> <column name="c5" type="TEXT"/> <column name="c6" type="VARCHAR(255)"/> </createTable> </changeSet>

एंबेडेड एसक्यूएल

 <changeSet context="legacy" author="author" id="1-domain-some-domain"> <sql> CREATE DOMAIN public.some_domain AS bigint; ALTER DOMAIN public.some_domain OWNER TO test; </sql> <rollback> DROP DOMAIN public.some_domain; </rollback> </changeSet>

SQL फ़ाइल

 <changeSet context="legacy" author="author" id="1-user"> <sqlFile dbms="postgresql" path="sql/some.sql" relativeToChangelogFile="true" /> <rollback> delete from "some"; </rollback> </changeSet>

संदर्भों को लॉन्च करें

विभिन्न विन्यासों के अधिक सुविधाजनक प्रबंधन के लिए, उदाहरण के लिए, विकास / उत्पादन, संदर्भों का उपयोग किया जा सकता है। संदर्भ के परिवर्तन की विशेषता में संदर्भ निर्दिष्ट किया गया है और फिर मावेन द्वारा -Dcontexts पैरामीटर के साथ लॉन्च किया गया है।

संदर्भ के साथ बदलें

 <changeSet context="legacy" author="author" id="1-initial-changeset"> <tagDatabase tag="initial"/> </changeSet>

ट्रिगरिंग संदर्भ परिवर्तन

 #!/usr/bin/env bash mvn liquibase:update\ -Denv=dev\ -Dliquibase.url="jdbc:postgresql://dev/test?prepareThreshold=0&stringtype=unspecified"\ -Dliquibase.contexts=non-legacy

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

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

रोलबैक के साथ बदलें

 <changeSet context="legacy" author="author" id="1-domain-some-domain"> <sql> CREATE DOMAIN public.some_domain AS bigint; ALTER DOMAIN public.some_domain OWNER TO test; </sql> <rollback> DROP DOMAIN public.some_domain; </rollback> </changeSet>

रोलबैक लॉन्च करें

 #!/usr/bin/env bash mvn liquibase:update\ -Denv=dev\ -Dliquibase.url="jdbc:postgresql://dev/test?prepareThreshold=0&stringtype=unspecified"\ -Dliquibase.contexts=non-legacy

तुलना

विकास में, किए गए परिवर्तनों के लिए दो मौजूदा डेटाबेस की तुलना करना उपयोग करना सुविधाजनक है। सेटिंग्स (या लॉन्च पैरामीटर) में, आपको इसे एक्सेस करने के लिए संदर्भ डेटाबेस और डेटा के लिए एक लिंक जोड़ना होगा।

liquibase.properties

 referenceUsername=test referenceUrl=jdbc:postgresql://dev/test_reference

सर्किट तुलना

Url और ReferenceUrl योजनाओं की तुलना करना।

 #!/usr/bin/env bash mvn liquibase:diff\ -Denv=dev\ -Dliquibase.referenceUrl="jdbc:postgresql://dev/test?prepareThreshold=0"\ -Dliquibase.url="jdbc:postgresql://dev/test_reference?prepareThreshold=0"\ -Dliquibase.diffChangeLogFile=dev/diff.xml

सेविंग स्कीमा

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

खाते में डेटा लेने के बिना एक स्कीमा को सहेजना

किसी मौजूदा डेटाबेस के स्कीमा को सहेजना।

 #!/usr/bin/env bash mvn liquibase:generateChangeLog\ -Denv=dev\ -Dliquibase.url="jdbc:postgresql://dev/test_reference?prepareThreshold=0"\ -Dliquibase.outputChangeLogFile=dev/changelog.xml

डेटा के साथ एक स्कीमा सहेजना

मौजूदा डेटाबेस के स्कीमा को डेटा के साथ सहेजना।

 #!/usr/bin/env bash mvn liquibase:generateChangeLog\ -Denv=dev\ -Dliquibase.url="jdbc:postgresql://dev/test_reference?prepareThreshold=0"\ -Dliquibase.outputChangeLogFile=dev/changelog.xml

सीमाएं और समस्याएं

डेटाबेस में बाइनरी डेटा के साथ काम करना

बाइनरी डेटा अपलोड करने, तुलना करने और उपयोग करने के साथ कुछ समस्याएं हैं, विशेष रूप से, परिवर्तन उत्पन्न करने वाली समस्या।

वंशानुक्रम और सामान्य स्तंभ

स्रोत कोड

https://github.com/liquibase/liquibase

वैकल्पिक समाधान

flyway

Liquibase के साथ-साथ जावा समुदाय में लोकप्रिय है - http://flywaydb.org/documentation

Sqitch

पर्ल समकक्ष - http://sqitch.org

FluentMigrator

एनालॉग .Net के लिए - https://github.com/schambers/fluentmigrator

DBGeni

रूबी के लिए एनालॉग - http://dbgeni.appsintheopen.com/manual.html

क्षुधा

परियोजना की संरचना

 pom.xml - maven makefile dev liquibase.properties - login/password etc master.xml - changesets

किसी मौजूदा प्रोजेक्ट में लिबास कैसे जोड़ें

आधार कैसे काम करता है

परिवर्तन प्रारूप के बारे में अधिक

अद्यतन के बारे में अधिक

https://www.liquibase.org/documentation/maven/generated/update-mojo.html

चेंज जनरेशन पर अधिक

https://www.liquibase.org/documentation/maven/generated/generateChangeLog-mojo.html

कस्टम SQL के बारे में अधिक

डेटाबेस-विशिष्ट डेटा प्रकारों को संसाधित करना

 <createTable tableName="t_name"> ... <column name="doubleArray" type="DOUBLE_ARRAY"/> ... </createTable> <modifySql dbms="postgresql"> <replace replace="DOUBLE_ARRAY" with="double precision[][]"/> </modifySql>

अन्य

https://news.ycombinator.com/item?id=10145933

लिकिबेस और मावेन