गो-एप्लिकेशन में डेटा संग्रहीत करने के लिए बॉक्स

गोलंग में लिखे कॉफ़र नामक एम्बेडेड कुंजी-मूल्य डेटाबेस के बारे में एक संक्षिप्त टिप्पणी। यदि बहुत संक्षेप में: जब डेटाबेस एक बंद राज्य में होता है, तो डेटा डिस्क पर होता है, जब यह शुरू होता है, तो डेटा को मेमोरी में कॉपी किया जाता है। पढ़ने से याददाश्त आती है। रिकॉर्डिंग के दौरान, मेमोरी डेटा को बदल दिया जाता है, और डिस्क लॉग में परिवर्तन लिखे जाते हैं। संग्रहीत डेटा का अधिकतम आकार रैम के आकार द्वारा सीमित है। एपीआई डेटा रिकॉर्ड को बनाए रखते हुए आपको डेटाबेस रिकॉर्ड के लिए हेडर बनाने और लेनदेन में उनका उपयोग करने की अनुमति देता है।

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

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

डेटा सुरक्षा

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

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

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

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

का विन्यास

डेटाबेस में काफी कुछ पैरामीटर होते हैं जिन्हें कॉन्फ़िगर किया जा सकता है, हालांकि, उनमें से लगभग सभी में डिफ़ॉल्ट मान होते हैं, इसलिए सब कुछ एक छोटी पंक्ति के cof, err, wrn := Db(dirPath).Create() में फिट किया जा सकता है cof, err, wrn := Db(dirPath).Create() त्रुटि वापस आ जाती है (यदि कोई त्रुटि होती है, तो डेटाबेस के साथ आगे का काम। निषिद्ध) और चेतावनी, जिसके बारे में आप जान सकते हैं, लेकिन यह डेटाबेस के संचालन में हस्तक्षेप नहीं करता है।

मैं बोझिल विवरणों के साथ पाठ को अव्यवस्थित नहीं करूंगा, यदि आवश्यक हो, तो कृपया उन्हें रिपॉजिटरी के रीडमी में देखें - github.com/claygod/coffer/blob/master/README_RU.d#config हैंडलर विधि को नोट करें जो लेन-देन के लिए हैंडलर को जोड़ता है, मैं उनके बारे में कुछ पंक्तियाँ लिखूंगा। कम, यहाँ मैं सिर्फ उन्हें सूचीबद्ध करता हूं:

• Db (dirPath)
• बैचसाइज़ (बैचसाइज़)
• LimitRecordsPerLogfile (सीमावर्तीकंपनियंत्रक)
• फॉलोपॉन्ज (100 * समय। आगे)
• LogsByCheckpoint (1000)
• AllowStartupErrLoadLogs (सच)
• MaxKeyLength (मैक्सकेलिफ्ट)
• MaxValueLength (maxValueLength)
• MaxRecsPerOperation (1,000,000)
• RemoveUnlessLogs (सच)
• लिमिटमिट्री (100 * 1,000,000)
• लिमिटिट (1000 * 1,000,000)
• हैंडलर ("हैंडलर 1", और हैंडलर 1)
• हैंडलर ("हैंडलर 2", और हैंडलर 2)
• हैंडलर (नक्शा [स्ट्रिंग] * हैंडलर)
• बनाएं ()

एपीआई

जहाँ तक संभव हो, मैंने एपीआई को सरल बनाया, और कुंजी-मूल्य के आधार के लिए, बहुत स्मार्ट न बनें:

• प्रारंभ - डेटाबेस शुरू करें
• बंद करो - डेटाबेस बंद करो
• स्टॉपहार्ड - अभी किए जा रहे संचालन की परवाह किए बिना एक स्टॉप (शायद मैं इसे हटा दूंगा)
• सहेजें - डेटाबेस की वर्तमान स्थिति का एक स्नैपशॉट सहेजें
• लिखें - डेटाबेस में एक रिकॉर्ड जोड़ें
• WriteList - डेटाबेस में कई रिकॉर्ड जोड़ें (सख्त और वैकल्पिक मोड)
• WriteListUnsafe - डेटा सुरक्षा के संबंध में डेटाबेस में कई रिकॉर्ड जोड़ें
• पढ़ें - कुंजी द्वारा एक रिकॉर्ड प्राप्त करें
• ReadList - रिकॉर्ड की एक सूची प्राप्त करें
• ReadListUnsafe - डेटा सुरक्षा की परवाह किए बिना रिकॉर्ड की एक सूची प्राप्त करें
• डिलीट - डिलीट वन रिकॉर्ड
• DeleteList - कई रिकॉर्ड्स को सख्त / वैकल्पिक मोड में हटाएं
• लेन-देन - एक लेन-देन निष्पादित करें
• गणना - डेटाबेस में कितने रिकॉर्ड
• CountUnsafe - डेटाबेस में कितने रिकॉर्ड (थोड़ा तेज, लेकिन असुरक्षित)
• RecordsList - सभी डेटाबेस कुंजियों की एक सूची
• RecordsListUnsafe - सभी डेटाबेस कुंजियों की एक सूची (थोड़ा तेज़, लेकिन असुरक्षित)
• RecordsListWithPrefix - निर्दिष्ट उपसर्ग के साथ कुंजियों की एक सूची
• RecordsListWithSuffix - निर्दिष्ट अंत के साथ कुंजियों की एक सूची

एपीआई के लिए लघु स्पष्टीकरण:

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

 package main import ( "fmt" "github.com/claygod/coffer" ) const curDir = "./" func main() { // STEP init db, err, wrn := coffer.Db(curDir).Create() switch { case err != nil: fmt.Println("Error:", err) return case wrn != nil: fmt.Println("Warning:", err) return } if !db.Start() { fmt.Println("Error: not start") return } defer db.Stop() // STEP write if rep := db.Write("foo", []byte("bar")); rep.IsCodeError() { fmt.Sprintf("Write error: code `%d` msg `%s`", rep.Code, rep.Error) return } // STEP read rep := db.Read("foo") rep.IsCodeError() if rep.IsCodeError() { fmt.Sprintf("Read error: code `%v` msg `%v`", rep.Code, rep.Error) return } fmt.Println(string(rep.Data)) } 

लेन-देन

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

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

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

प्रतिक्रियाएं प्राप्त करें और संसाधित करें

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

IsCodeError जाँच करना सभी त्रुटियों के साथ काम को सरल करता है, इसलिए यदि आप विवरण में रुचि नहीं रखते हैं, तो काम करना जारी रखें।
IsCodePanic चेक उन सभी मामलों को कवर करता है जिनमें डेटाबेस के साथ काम करना बंद कर देना चाहिए।

साधारण मामले में, प्रतिक्रिया को संसाधित करने के लिए एक ट्रिपल स्विच पर्याप्त है:

• IsCodeOk - IsCodeOk काम करना जारी रखें
• IsCodeError - रिपोर्ट से त्रुटि लॉग करें और आगे काम करें
• IsCodePanic - रिपोर्ट से त्रुटि लॉग करें और डेटाबेस के साथ काम करना बंद करें

Offtop

नाम के लिए, शब्द को अंग्रेजी में अनुवाद करने के लिए विकल्पों में से एक चुना गया था, मैं box को पसंद करूंगा, लेकिन यह बहुत लोकप्रिय शब्द है, मुझे उम्मीद है कि coffer भी coffer करेगा।
ACID वाला विषय मुझे समग्र प्रतीत होता है, इसलिए मैं कहूंगा कि कॉफ़र इसके लिए प्रतिबद्ध है, लेकिन एक तथ्य नहीं है, और मैं यह दावा नहीं करता कि वह सफल रहा।

उत्पादकता

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

• बेंचमार्क कॉफ़रट्रांसशिपेंस असेंसन -4 2000 227928 ns / op
• बेंचमार्क कॉफ्रेंटट्रांसपैरशन32 हलालफ़ाकनेंट -4 100000 4199 ns and op

वैसे, अगर कोई समय बिताता है और खुद को कॉफ़र के साथ एक रिपॉजिटरी के लिए कहता है, यदि संभव हो तो, इसमें पड़ी बेंच को चलाएं। मुझे इस बात में बहुत दिलचस्पी है कि प्रदर्शन किन मशीनों में डेटाबेस दिखाएगा। सबसे पहले, निश्चित रूप से यह सब डिस्क पर निर्भर करता है। हाल ही में मैंने एक नया सैमसंग EVO खरीदने के बाद यह मेरे लिए विशेष रूप से स्पष्ट हो गया। लेकिन चिंता न करें, यह एक मृत डिस्क का विकल्प नहीं है। पुराना तोशिबा ठीक से सेवा करना जारी रखता है और अब मेरे वीडियो संग्रह को संग्रहीत करता है।

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

लाइसेंस

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

निष्कर्ष

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

धन्यवाद

• बहुत अंत तक लेख पढ़ने वाले सभी को
• टिप्पणीकार अपनी राय साझा करना चाहते हैं
• पाठ में टाइपोस और त्रुटियों पर एक व्यक्तिगत जानकारी में भेजा गया
• रात में म्यूजिक ऑन करते हुए पड़ोसी

संदर्भ

DB भंडार
रूसी में वर्णन