फ्लुएंटमिग्रेटर - वर्जन माइग्रेशन सिस्टम

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

लेख सामग्री

परियोजना के बारे में
संक्षेप में सुविधाएँ
सिस्टम घटक
यह कैसे काम करता है
ब्योरा
निष्कर्ष

परियोजना के बारे में

यह परियोजना स्वयं GitHub: github.com/schambers/fluentmigrator पर आधारित है
मेरा कांटा: github.com/tabushi/fluentmigrator
12/17/2008 को रिपॉजिटरी परिवर्तन का इतिहास शुरू होता है
लाइसेंस के तहत वितरित: अपाचे लाइसेंस 2.0
सी # अंडरनेट फ्रेमवर्क 3.5 में लिखा गया है

संक्षेप में सुविधाएँ

समर्थित DBMS

• जेट
• MySQL
• ओरेकल
• PostgreSQL
• SQLite
• Microsoft SQL सर्वर

समर्थित कार्य

• तालिकाएँ बनाएँ, हटाएँ
• कॉलम जोड़ें, हटाएं, संशोधित करें
• निर्माण, प्राथमिक, विदेशी कुंजी, अनुक्रमित का विलोपन
• सम्मिलित करें, अपडेट करें, डेटा हटाएं (बल्कि सुविधाओं में मामूली)
• डेटाबेस में स्कीमा, टेबल, कॉलम, इंडेक्स के अस्तित्व की जांच करना
• एक मनमाना sql का निष्पादन, एक संसाधन से sql स्क्रिप्ट या एक बाहरी फ़ाइल से (जब पिछले सब कुछ पर्याप्त नहीं है)

सिस्टम घटक

• फ्लुएंटमिग्रेटर - प्रोग्राम का मूल, यह संपूर्ण माइग्रेशन सिंटैक्स को लागू करता है
• FluentMigrator.Console - माइग्रेशन शुरू करने के लिए एक कंसोल एप्लिकेशन, जिसमें बड़ी संख्या में पैरामीटर हैं
• FluentMigrator.MSBuild - MSBuild के लिए माइग्रेशन प्रारंभ करें
• FluentMigrator.NAnt - NAnt के लिए माइग्रेशन प्रारंभ करें
• FluentMigrator.Runner - कोर स्क्रिप्ट इंस्टॉलेशन प्रोग्राम, पिछली तीन परियोजनाओं का आधार है, जो अनिवार्य रूप से 1 .cs फ़ाइल में छोटे गोले हैं। इसमें आवश्यक डीबीएमएस के लिए माइग्रेशन करने और माइग्रेशन को एसक्यूएल में परिवर्तित करने के सभी तर्क शामिल हैं। सुंदर खिड़कियों और आवश्यक कार्यक्षमता के साथ लाठी के साथ अपने धावक को लिखना बहुत आसान है।
• FluentMigrator.SchemaDump - मैंने व्यक्तिगत रूप से इसका उपयोग नहीं किया है, लेकिन मैंने इसे विशेष रूप से इस लेख के लिए देखा। यह sql फ़ाइल में डेटाबेस संरचना को बचाने के लिए डिज़ाइन किया गया है। केवल MS SQL सर्वर के लिए लागू किया गया।
• FluentMigrator.Tests - परीक्षण, जहां उनके बिना। NUnit का उपयोग करता है

यह कैसे काम करता है

और अब चलो माइग्रेशन फ़ाइल पर करीब से नज़र डालें। इसलिए, माइग्रेशन फ़ाइल में निम्नलिखित शामिल हो सकते हैं:

• प्रवास
• प्रोफाइल
• संस्करण तालिका विवरण
• एम्बेडेड संसाधनों के रूप में sql स्क्रिप्ट
• शायद कुछ और जो मैंने अभी तक सामना नहीं किया है

इन संस्थाओं पर अधिक

हम निम्नलिखित उदाहरण से प्रवास पर विचार करेंगे:

using System;
using FluentMigrator;

namespace ExampleDatabaseMigrations
{
[Migration(2011091900)]
public class ExampleMigration : Migration
{
public override void Up()
{
if (!Schema.Table( "EXAMPLE_TABLE" ).Exists())
{
Create.Table( "EXAMPLE_TABLE" )
.WithColumn( "ID" ).AsInt16().NotNullable().PrimaryKey( "PK_EXAMTABL_ID" )
.WithColumn( "NAME" ).AsAnsiString(100).NotNullable()
.WithColumn( "SHORT_NAME" ).AsAnsiString(50).Nullable()
.WithColumn( "START_DATE" ).AsDate().NotNullable()
.WithColumn( "END_DATE" ).AsDate().Nullable();
Insert.IntoTable( "IDX_EXAMTABL_NAME" )
.Row( new {Id = 1, Name = "TEST" , Start_Date = new DateTime (2011, 9, 19)});
}
if (!Schema.Table( "EXAMPLE_TABLE" ).Index( "IDX_EXAMTABL_NAME" ).Exists())
{
Create.Index( "IDX_EXAMTABL_NAME" )
.OnTable( "EXAMPLE_TABLE" )
.OnColumn( "NAME" ).Ascending();
}
if (!Schema.Table( "EXAMPLE_TABLE" ).Index( "IDX_EXAMTABL_STARDATE_ENDDATE" ).Exists())
{
Create.Index( "IDX_EXAMTABL_STARDATE_ENDDATE" )
.OnTable( "EXAMPLE_TABLE" )
.OnColumn( "START_DATE" ).Ascending()
.OnColumn( "END_DATE" ).Ascending();
}
}

public override void Down()
{
if (Schema.Table( "EXAMPLE_TABLE" ).Exists())
Delete.Table( "EXAMPLE_TABLE" );
}
}
}

* This source code was highlighted with Source Code Highlighter .

उदाहरण में, मैंने टेबल / इंडेक्स निर्माण योजना का कहीं भी संकेत नहीं दिया, लेकिन निश्चित रूप से ऐसी संभावना है।
पलायन की संख्या में वृद्धि होनी चाहिए, जो तर्कसंगत है। लेकिन केवल संख्या के क्रम में, यह हमें सुविधाजनक नहीं लगा, इसलिए नंबरिंग फॉर्म yyyMMddxx के लिए अपनाया गया, जहां: yyyy वर्ष है, MM महीना है, dd दिन है, xx 00 से 99 के क्रम में संख्या है। इस प्रकार, क्रम रखा गया है और क्रमांकन अधिक कहते हैं प्रवासन के समय के बारे में।
यह उदाहरण एक अनुमानित विचार देता है कि माइग्रेशन कैसा दिखता है, और हम यहां रुकेंगे।

प्रोफ़ाइल टेम्प्लेट

using FluentMigrator;

namespace ExampleDatabaseMigrations
{
[Profile( "Example" )]
public class ExampleProfile : Migration
{
public override void Up()
{
//do something
}

public override void Down()
{
//empty, not used
}
}
}

* This source code was highlighted with Source Code Highlighter .

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

विशेषताओं को छोड़कर प्रोफ़ाइल और माइग्रेशन में क्या अंतर है? तथ्य यह है कि:

1. प्रोफ़ाइल को केवल तभी निष्पादित किया जाता है जब यह स्पष्ट रूप से सेट किया गया हो, माइग्रेशन के दौरान उसका नाम निर्दिष्ट करना;
2. प्रोफ़ाइल को हमेशा सफल माइग्रेशन के बाद निष्पादित किया जाता है; यदि माइग्रेशन से इंस्टॉल करने के लिए कुछ भी नहीं था, तो प्रोफ़ाइल अभी भी निष्पादित की जाती है।

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

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

संस्करण तालिका

using FluentMigrator.VersionTableInfo;

namespace ExampleDatabaseMigrations
{
[VersionTableMetaData]
public class ExampleVersionInfo : IVersionTableMetaData
{
public string SchemaName { get { return "EXAMPLE_SCHEMA" ; } }
public string TableName { get { return "EXAMPLE_VERSION_TABLE" ; } }
public string ColumnName { get { return "EXAMPLE_VERSION_COLUMN" ; } }
}
}

* This source code was highlighted with Source Code Highlighter .

इस प्रकार, यहां तक ​​कि एक स्कीमा में, आपके पास विभिन्न परियोजनाओं के लिए संस्करणों के साथ कई अलग-अलग टेबल हो सकते हैं, या परियोजना के साथ योजना से अलग संस्करणों के साथ एक तालिका रख सकते हैं।
सर्किट नाम के बजाय एक खाली स्ट्रिंग सेट करने पर क्या होगा, इसके बारे में ऊपर लिखा गया है।

एंबेडेड लिपियों

एंबेडेड स्क्रिप्ट नियमित एसक्यूएल स्क्रिप्ट हैं, जिनमें से फाइलें परियोजना से जुड़ी हैं और संपत्ति "बिल्ड एक्शन" = "एंबेडेड संसाधन" है। मुझे उनके बारे में अधिक बात करने की आवश्यकता नहीं है।

यह कैसे काम करता है

अगला, मान लीजिए कि हम ऊपर की ओर पलायन कर रहे हैं, अर्थात्। डेटाबेस संरचना का नवीनतम संस्करण स्थापित करें।

कार्य एल्गोरिथ्म

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

एक प्रवास

प्रवासन को 2 चरणों में विभाजित किया गया है

1. अप () विधि (या नीचे) का निष्पादन, माइग्रेशन सेट करने के मामले में), जो अभिव्यक्ति की सूची में अभिव्यक्ति जोड़ता है
2. अभिव्यक्तियों को sql में बदलें और डेटाबेस में निष्पादन के लिए सबमिट करें

ब्योरा

परिवर्तन हमेशा वापस नहीं किए जाते हैं, क्योंकि सभी DBMS डीडीएल संचालन के रोलबैक का समर्थन नहीं करते हैं। ऐसे DBMS के लिए, एक ऑपरेशन से, जितना संभव हो उतना छोटा पलायन करना वांछनीय है। यदि यह एक ऑपरेशन स्थापित नहीं है, तो इसे वापस रोल करने की आवश्यकता नहीं होगी।

ऐसा लगता है कि शुरू में सभी समर्थित DBMS (और बुनियादी सरल कार्यों के लिए यह काम करता है) के लिए एक बार माइग्रेशन लिखने के लिए परियोजना की कल्पना की गई थी। फिर भी, यह स्वीकार करने योग्य है कि DBMS क्षमताओं और वाक्यविन्यास बहुत अलग हैं (उदाहरण के लिए, कुछ DBMS ऑटो-इन्क्रीमेंट फ़ील्ड का उपयोग करते हैं, जबकि अन्य क्रमबद्धता का उपयोग करते हैं), इसलिए हाल ही में स्पीकिंग नाम ifDatabase एक फ़ंक्शन माइग्रेशन के लिए उपलब्ध हो गया है।

निष्कर्ष

परियोजना खुला स्रोत है, इसलिए आपको इससे चमत्कार की उम्मीद नहीं करनी चाहिए। जाँच करें कि आवश्यक DBMS पर क्या हुआ, क्योंकि ऐसा हो सकता है कि इस DBMS के लिए कुछ लागू नहीं किया गया हो। कीड़े का वर्णन करें - ठीक करें, या उन्हें ठीक करने में स्वयं की सहायता करें।

पुनश्च: मैं आपसे यह पूछना चाहता हूं कि आप और क्या जानना चाहते हैं। मैं इसके बारे में लिखूंगा।