👦 🔛 👨🏼‍🚒 MSSQL डेटाबेस संस्करण माइग्रेशन 🤜🏾 ♋️ 🚁

नमस्ते!

इस पोस्ट में मैं विशेष रूप से डेटाबेस और MSSQL में परिवर्तन के समर्थन और प्रवासन के विषय पर अपने विचार साझा करना चाहता हूं, साथ ही साथ अपने निर्णय भी।

समस्या

एक नियम के रूप में, अधिक या कम गंभीर परियोजनाओं में, कई स्वतंत्र वातावरण (पर्यावरण) हैं।

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

फिर, अधिक या कम गंभीर परियोजनाओं में, डेवलपर्स और परीक्षकों के पास एक से अधिक है, उनके वातावरण के साथ भी।

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

कट के तहत विवरण।

समस्या को हल करने के लिए विकल्प

परियोजनाओं में भाग लेने के अपने अनुभव के आधार पर, मैं डेटाबेस परिवर्तनों को माइग्रेट करने की प्रक्रिया को व्यवस्थित करने के कई तरीकों की पहचान कर सकता हूं:

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

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

3. और अंत में, आखिरी विकल्प और मेरे सबसे करीब एक डेटाबेस डेटाबेस संस्करण, जैसे कि फ्लेंटमिगेटर ,। नेट माइग्रेटर, और अन्य के लिए विशेष फ्रेमवर्क का उपयोग है।

मेरा फैसला

परियोजनाओं में से एक के लिए, मैंने एक एप्लिकेशन लिखा जो डेटाबेस संस्करणों को माइग्रेट करने की समस्या को बहुत सरल करना चाहिए।

कोड बेहद उदार एमआईटी लाइसेंस के तहत CodePlex.com पर पोस्ट किया गया है, इसलिए आप अपनी सुविधानुसार इस उत्पाद का उपयोग कर सकते हैं!

सिस्टम दो प्रोजेक्ट्स से युक्त एक WinForm एप्लीकेशन है। माइग्रेशन के लिए एक रूपरेखा के रूप में फ्लुएंटमिग्रेटर का उपयोग किया जाता है। मैं इस बारे में विवरण में नहीं जाऊंगा कि फ्लुएंटमिग्रेटर क्या है और मैं इसके साथ क्या खाता हूं; जो लोग इस रूपरेखा के बारे में विवरण पढ़ना चाहते हैं, वे इस लेख का उल्लेख कर सकते हैं।

मेरा प्रोजेक्ट, सरल नाम "C # डेटाबेस माइग्रेटर" के साथ है, यहाँ है: https://csharpdatabasemigrator.codeplex.com/

सिस्टम क्या कर सकता है:

1. कई प्रकार के डेटाबेस के साथ काम करें, अर्थात, आप विभिन्न संरचनाओं के साथ डेटाबेस के लिए माइग्रेशन बना सकते हैं। यह कैसे किया जाता है कोड में थोड़ा कम है।

2. सिस्टम डेटाबेस बैकअप बना सकता है, साथ ही उन्हें पुनर्स्थापित भी कर सकता है।

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

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

कैसे उपयोग करना शुरू करें

1. प्रोजेक्ट स्रोत का चयन करें https://csharpdatabasemigrator.codeplex.com/SourceControl/latest

2. स्टूडियो में एक प्रोजेक्ट खोलें

3. डिफ़ॉल्ट फ़ोल्डर (माइग्रेशन फ़ाइलों के लिए डिफ़ॉल्ट फ़ोल्डर) पर जाएं

4. एक माइग्रेशन फ़ाइल बनाएं। माइग्रेशन फ़ाइल बेस क्लास माइग्रेशन से विरासत में मिली एक श्रेणी है

using FluentMigrator; namespace Migrations.Default { [Migration(1, "Author: AuthorName; Description")] public class Migration_1: Migration { public override void Up() { // Migration Up code here } public override void Down() { // Migration Down code here } } }

5. क्लास की विशेषताओं में, संस्करण संख्या और उसका विवरण, साथ ही प्रवास के लिए कोड भी लिखें। उदाहरण के लिए, एक नई तालिका बनाना

 Create.Table("Users") .WithIdColumn() .WithColumn("Name").AsString().NotNullable();

आप SQL कमांड निष्पादित कर सकते हैं:

 Execute.Sql("DELETE TABLE Users");

आप सिंटैक्स विवरण यहाँ पढ़ सकते हैं: https://github.com/schambers/fluentmigrator/wiki/Fluent-Interface

6. प्रोजेक्ट संकलित करें और एप्लिकेशन चलाएँ:

7. डेटाबेस सर्वर से कनेक्ट करें

8. ड्रॉप-डाउन सूची में आवश्यक डेटाबेस का चयन करें

9. ऑपरेशन के प्रकार "नवीनतम संस्करण में अपडेट करें" का चयन करें और "नौकरी करें" बटन दबाएं

10. फॉर्म के दाईं ओर लॉग की जांच करें

कई प्रकार के डेटाबेस के साथ कैसे काम करें

समान डेटाबेस स्कीमा से संबंधित सभी माइग्रेशन फ़ाइलें समान नामस्थान में होनी चाहिए। डिफ़ॉल्ट रूप से, यह प्रोजेक्ट में फ़ोल्डर के नाम से "Migrations.Default" है। दूसरे प्रकार के माइग्रेशन को जोड़ने के लिए, आपको माइग्रेशन प्रोजेक्ट में एक और फ़ोल्डर बनाने की आवश्यकता है, उदाहरण के लिए, MySecondDatabase और कॉन्फ़िगरेशन फ़ाइल MigrationNamespaces.config संपादित करें

 <?xml version="1.0" encoding="utf-8" ?> <configuration> <MigrationNamespaces> <MigrationNamespace Name="Default" Path="Migrations.Default"/> <MigrationNamespace Name="My Second Database" Path="Migrations.MySecondDatabase"/> </MigrationNamespaces> </configuration>

उसके बाद, मुख्य एप्लिकेशन विंडो में "मेरा दूसरा डेटाबेस" प्रकार उपलब्ध होगा।

एक फ़ोल्डर से SQL फ़ाइलों को निष्पादित करना

1. सिस्टम निर्दिष्ट फ़ोल्डर से फ़ाइलों को माइग्रेशन के रूप में उपयोग कर सकता है। माइग्रेशन लागू होने पर सभी फ़ाइलों को नाम से क्रमित और निष्पादित किया जाएगा:

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

C # कोड से माइग्रेशन करने के लिए, आपको FluentMigrator.Runner असेंबली को कनेक्ट करना होगा और एक विधि को निष्पादित करना होगा:

 public Action<string> OnNewUpdateLog; public void UpdateToLatestVersion(string databaseName, string migrationNamespace) { // ,          FluentMigrator-a var announcer = new TextWriterAnnouncer(OnNewUpdateLog); //    var assembly = Assembly.GetExecutingAssembly(); //       ,     var migrationContext = new RunnerContext(announcer) { Namespace = migrationNamespace }; var options = new MigrationOptions { PreviewOnly = false, Timeout = 60 }; //   SqlServer2008 var factory = new FluentMigrator.Runner.Processors.SqlServer.SqlServer2008ProcessorFactory(); var processor = factory.Create(GetConnectionString(databaseName), announcer, options); //  runner var runner = new MigrationRunner(assembly, migrationContext, processor); //     runner.MigrateUp(true); OnNewUpdateLog("Done"); }

डेटाबेस बैकअप बनाने और पुनर्स्थापित करने के दो तरीके हैं:

 public void BackupDatabase(string databaseName, string destinationPath) { var sqlServer = new Server(_connection); databaseName = databaseName.Replace("[", "").Replace("]", ""); var sqlBackup = new Backup { Action = BackupActionType.Database, BackupSetDescription = "ArchiveDataBase:" + DateTime.Now.ToShortDateString(), BackupSetName = "Archive", Database = databaseName }; var deviceItem = new BackupDeviceItem(destinationPath, DeviceType.File); sqlBackup.Initialize = true; sqlBackup.Checksum = true; sqlBackup.ContinueAfterError = true; sqlBackup.Devices.Add(deviceItem); sqlBackup.Incremental = false; sqlBackup.ExpirationDate = DateTime.Now.AddDays(3); sqlBackup.LogTruncation = BackupTruncateLogType.Truncate; sqlBackup.PercentCompleteNotification = 10; sqlBackup.PercentComplete += (sender, e) => OnSqlBackupPercentComplete(e.Percent, e.Message); sqlBackup.Complete += (sender, e) => OnSqlBackupComplete(e.Error); sqlBackup.FormatMedia = false; sqlBackup.SqlBackup(sqlServer); } public void RestoreDatabase(string databaseName, string filePath) { var sqlServer = new Server(_connection); databaseName = databaseName.Replace("[", "").Replace("]", ""); var sqlRestore = new Restore(); sqlRestore.PercentCompleteNotification = 10; sqlRestore.PercentComplete += (sender, e) => OnSqlRestorePercentComplete(e.Percent, e.Message); sqlRestore.Complete += (sender, e) => OnSqlRestoreComplete(e.Error); var deviceItem = new BackupDeviceItem(filePath, DeviceType.File); sqlRestore.Devices.Add(deviceItem); sqlRestore.Database = databaseName; DataTable dtFileList = sqlRestore.ReadFileList(sqlServer); int lastIndexOf = dtFileList.Rows[1][1].ToString().LastIndexOf(@"\"); string physicalName = dtFileList.Rows[1][1].ToString().Substring(0, lastIndexOf + 1); string dbLogicalName = dtFileList.Rows[0][0].ToString(); if (!Directory.Exists(physicalName)) { physicalName = sqlServer.MasterDBPath + "\\"; } string dbPhysicalName = physicalName + databaseName + ".mdf"; string logLogicalName = dtFileList.Rows[1][0].ToString(); string logPhysicalName = physicalName + databaseName + "_log.ldf"; sqlRestore.RelocateFiles.Add(new RelocateFile(dbLogicalName, dbPhysicalName)); sqlRestore.RelocateFiles.Add(new RelocateFile(logLogicalName, logPhysicalName)); sqlServer.KillAllProcesses(sqlRestore.Database); Database db = sqlServer.Databases[databaseName]; if (db != null) { db.DatabaseOptions.UserAccess = DatabaseUserAccess.Single; db.Alter(TerminationClause.RollbackTransactionsImmediately); sqlServer.DetachDatabase(sqlRestore.Database, false); } sqlRestore.Action = RestoreActionType.Database; sqlRestore.ReplaceDatabase = true; sqlRestore.SqlRestore(sqlServer); db = sqlServer.Databases[databaseName]; db.SetOnline(); sqlServer.Refresh(); db.DatabaseOptions.UserAccess = DatabaseUserAccess.Multiple; }

DatabaseManager.cs वर्ग में विवरण

आप सभी को धन्यवाद!

MSSQL डेटाबेस संस्करण माइग्रेशन