हैलो, रेवेनडीबी

हाल ही में, उन्होंने NoSQL-solution RavenDB का सक्रिय रूप से अध्ययन और उपयोग करना शुरू किया। और इसलिए मैंने रेवेनडीबी का उपयोग शुरू करने के तरीके के बारे में एक परिचयात्मक पोस्ट लिखने का फैसला किया। वास्तव में, यह लेख परियोजना की वेबसाइट पर "हैलो वर्ल्ड" निर्देशों से बहुत अलग नहीं है (और मैंने वहां से भी उदाहरण लिया है), लेकिन मैं वहां जो कुछ लिखा गया है, उसे कुछ जोड़ देने की कोशिश करूंगा। मैं तुरंत कहना चाहता हूं कि मैं रेवेनडीबी का विशेषज्ञ नहीं हूं, और हाल ही में अपनी परियोजनाओं और कार्यों के लिए इसका उपयोग कर रहा हूं।



PS क्यों नहीं MongoDB या CouchDB? मुझे नहीं पता, मैं सिर्फ इस विशेष समाधान की कोशिश करना चाहता था। और एक हद तक यह निर्णय अभी तक जलाया नहीं गया था।





सबसे पहले आपको प्रोजेक्ट वेबसाइट से नवीनतम संस्करण डाउनलोड करना होगा ।



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

डेटाबेस को एक्सेस करने के लिए रनिंग सर्वर एक वेब इंटरफेस प्रदान करता है। डिफ़ॉल्ट रूप से, इसका पता http: // localhost: 8080 है। इसमें, आप उन दस्तावेज़ों को प्रबंधित कर सकते हैं जो डेटाबेस में हैं, इंडेक्स जोड़ें और निकालें।







सर्वर शुरू होने और डेटाबेस बनने के बाद, विजुअल स्टूडियो खोलें और कंसोल एप्लिकेशन बनाएं। यदि आपके पास NuGet स्थापित है, तो संदर्भ पर राइट-क्लिक करें और लाइब्रेरी पैकेज संदर्भ जोड़ें पर क्लिक करें। हम ऑनलाइन टैब पर जाते हैं, वहां रेवेनबेड ढूंढते हैं और इसे इंस्टॉल करते हैं। अगर आपके पास NuGet नहीं है, तो डाल दो आपको क्लाइंट फ़ोल्डर से 3 असेंबली जोड़ने की आवश्यकता है (यदि आप .NET 3.5 का उपयोग कर रहे हैं, तो क्लाइंट-3.5 फ़ोल्डर से):

• Newtonsoft.Json.dll
• Raven.Abstractions.dll
• Raven.Client.Lightweight.dll

अब आप कोड लिखना शुरू कर सकते हैं। निम्नलिखित 2 पंक्तियाँ DocumentStore वर्ग का एक ऑब्जेक्ट बनाती हैं, जिनका उपयोग बाद में डेटाबेस के साथ काम करने के लिए किया जाएगा:

var store = new DocumentStore {Url = "http://localhost:8080" };

store.Initialize();



अब हम कुछ कक्षाएं लिखेंगे जो हमारे डोमेन मॉडल का वर्णन करेंगे।

public class Product

{

public string Id { get ; set ; }

public string Name { get ; set ; }

public decimal Cost { get ; set ; }

}



public class Order

{

public string Id { get ; set ; }

public string Customer { get ; set ; }

public IList OrderLines { get ; set ; }



public Order()

{

OrderLines = new List ();

}

}



public class OrderLine

{

public string ProductId { get ; set ; }

public int Quantity { get ; set ; }

}



कृपया ध्यान दें कि प्रत्येक वर्ग के पास Id संपत्ति है, यह एक शर्त है, इस संपत्ति में RavenDB आपके दस्तावेज़ के लिए एक अद्वितीय संख्या संग्रहीत करेगा।



निम्न कोड डेटाबेस में 2 दस्तावेज़ जोड़ता है:

using ( var session = store.OpenSession())

{

var product = new Product

{

Cost = 3.99m,

Name = "Milk" ,

};

session.Store(product);

session.SaveChanges();



session.Store( new Order

{

Customer = "customers/ayende" ,

OrderLines =

{

new OrderLine

{

ProductId = product.Id,

Quantity = 3

},

}

});

session.SaveChanges();

}



एपीआई कार्य पैटर्न की इकाई को लागू करता है। पहले, हम एक सत्र ऑब्जेक्ट बनाते हैं, फिर ऑब्जेक्ट को इसमें स्टोर करते हैं (स्टोर विधि)। इस स्तर पर, उत्पाद ऑब्जेक्ट हमारे एप्लिकेशन की मेमोरी में स्थित होता है और केवल SaveChanges विधि को कॉल करने के बाद डेटाबेस में भेजा जाता है।



एप्लिकेशन चलाने के बाद, आप हमारे सर्वर (http: // localhost: 8080) पर जा सकते हैं और दस्तावेज़ टैब पर आप 2 दस्तावेज़ देख सकते हैं। यदि आप एक दस्तावेज़ खोलते हैं, तो आप ऊपर वर्णित वर्गों से इसके सभी गुणों को देख सकते हैं, साथ ही साथ दस्तावेज़ मेटाडेटा टैब से गुण भी देख सकते हैं। वे ऑब्जेक्ट के .NET प्रकार, रेवेनडीबी सर्वर के संस्करण, डेटाबेस में संस्थाओं के नाम का वर्णन करते हैं।







अपने आवेदन से इन वस्तुओं को पढ़ने के लिए, बस निम्नलिखित कोड लिखें:

using ( var session = store.OpenSession())

{

var order = session.Load( "orders/1" );

Console .WriteLine( "Customer: {0}" , order.Customer);

foreach ( var orderLine in order.OrderLines)

{

Console .WriteLine( "Product: {0} x {1}" , orderLine.ProductId, orderLine.Quantity);

}

}



यानी हम दस्तावेज़ों को संस्थाओं के 1 के बराबर आईडी के साथ लोड करते हैं।



वास्तविक अनुप्रयोगों के लिए, दस्तावेज़ खोजने के लिए ऐसी कार्यक्षमता स्पष्ट रूप से पर्याप्त नहीं है, इसलिए, फ़ील्ड द्वारा खोज आवश्यक है, और इसके लिए अनुक्रमणिका जोड़ना आवश्यक है:

store.DatabaseCommands.PutIndex( "OrdersContainingProduct" , new IndexDefinition

{

Map = orders => from order in orders

from line in order.OrderLines

select new { line.ProductId }

});



अब आप ProductId द्वारा दस्तावेजों का चयन कर सकते हैं:

using ( var session = store.OpenSession())

{

var orders = session.LueneQuery( "OrdersContainingProduct" )

.Where( "ProductId:products/1" )

.ToArray();



foreach ( var order in orders)

{

Console .WriteLine( "Id: {0}" , order.Id);

Console .WriteLine( "Customer: {0}" , order.Customer);

foreach ( var orderLine in order.OrderLines)

{

Console .WriteLine( "Product: {0} x {1}" , orderLine.ProductId, orderLine.Quantity);

}

}

}

यह रेवेनडीबी के साथ खेलने के लिए पर्याप्त है। केवल एक चीज मैं दो बिंदुओं को नोट करना चाहूंगा:

1. यदि आपको बहुत सी वस्तुओं को लोड करने की आवश्यकता है, तो उन्हें कई भागों में विभाजित करने और भागों में लोड करने की आवश्यकता है। ऐसा इसलिए है क्योंकि जब तक SaveChanges के तरीकों को निष्पादित नहीं किया जाता है, तब तक सभी डेटा को मेमोरी में संग्रहीत किया जाता है, और इसे आसानी से याद किया जा सकता है। और रेवेनबेड लाइब्रेरी, SaveChanges को 30 से अधिक कॉल करने की अनुमति नहीं देता है।
2. जब आप डेटाबेस खोजते हैं, तो रेवेनडीबी इंजन 128 टुकड़ों के पृष्ठों में डेटा लौटाता है, इसलिए उन सभी को प्रदर्शित करने के लिए, आपको कुछ इस तरह लिखना होगा:
   
   
   
   

   var query = session.Advanced.LuceneQuery<Order>( "OrdersContainingProduct" )

.Where( "ProductId:products/1" );

int actual = 0;

const int pageSize = 128;

int count = query.QueryResult.TotalResults;



do

{

var orders = session.Advanced

.LuceneQuery<Order>( "OrdersContainingProduct" )

.Where( "ProductId:products/1" )

.Skip(actual)

.Take(pageSize);



actual = actual + pageSize;

foreach ( var order in orders)

{

App.Logger.Info( "Id: {0}" , order.Id);

App.Logger.Info( "Customer: {0}" , order.Customer);

}



if (actual >= count)

break ;

} while ( true );


   
   
   
   

   
   
   

संदर्भ

परियोजना स्थल

रेवन डीबी क्यों?

रेवेनडीबी - एक परिचय