🥇 Tarantool मा, तपाईं एक सुपर-फास्ट डाटाबेस र तिनीहरूसँग काम गर्न एउटा अनुप्रयोग संयोजन गर्न सक्नुहुन्छ। यहाँ यो कति सजिलो छ

पाँच वर्षअघि मैले टारन्टुलसँग काम गर्ने प्रयास गरेँ, तर त्यसले मेरो लागि काम गरेन। तर भर्खरै मैले वेबिनार राखें जहाँ मैले Hadoop को बारेमा कुरा गरें, MapReduce कसरी काम गर्दछ। त्यहाँ मलाई प्रश्न सोधियो - "यस कामको लागि टारन्टुल किन प्रयोग नगर्ने?"।

जिज्ञासाको खातिर, मैले यसमा फर्कने निर्णय गरें, नवीनतम संस्करणको परीक्षण गर्नुहोस् - र यस पटक मलाई यो परियोजना मनपर्यो। अब म Tarantool मा एक साधारण अनुप्रयोग कसरी लेख्ने देखाउनेछु, यसलाई लोड गर्नुहोस् र कार्यसम्पादन जाँच गर्नुहोस्, र तपाईले देख्नुहुनेछ कि त्यहाँ सबै कुरा कत्ति सजिलो र राम्रो छ।

Tarantool के हो

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

दोस्रो, यो एक अनुप्रयोग सर्भर हो। तपाइँ यसमा तपाइँका अनुप्रयोगहरू लेख्न सक्नुहुन्छ, डाटासँग काम गर्नुहोस्, उदाहरणका लागि, निश्चित नियमहरू अनुसार पृष्ठभूमिमा पुराना प्रविष्टिहरू मेटाउनुहोस्। तपाईले टारान्टुलामा सीधै Http सर्भर लेख्न सक्नुहुन्छ जुन डाटासँग काम गर्दछ: तिनीहरूको नम्बर दिनुहोस्, त्यहाँ नयाँ डाटा लेख्नुहोस् र यो सबैलाई मास्टरमा घटाउनुहोस्।

मैले एउटा लेख पढें कि केटाहरूले कसरी 300-लाइन सन्देश लाइन बनायो, जसले केवल आँसु र पिट्छ - तिनीहरूसँग प्रति सेकेन्ड 20 सन्देशहरूको न्यूनतम प्रदर्शन छ। यहाँ तपाईं साँच्चै घुम्न सक्नुहुन्छ र धेरै ठूलो अनुप्रयोग लेख्न सक्नुहुन्छ, र यी भण्डारण गरिने छैन, PostgreS मा जस्तै।

लगभग यस्तो सर्भर, मात्र सरल, म यस लेखमा वर्णन गर्ने प्रयास गर्नेछु।

सेटिङ

परीक्षणको लागि, मैले तीनवटा मानक भर्चुअल मेसिनहरू सुरु गरें - एक 20 गिगाबाइट हार्ड ड्राइभ, Ubuntu 18.04। २ भर्चुअल CPU र ४ गिगाबाइट मेमोरी।

हामी Tarantool स्थापना गर्छौं - एक bash स्क्रिप्ट चलाउनुहोस् वा भण्डार थप्नुहोस् र उपयुक्त प्राप्त गर्नुहोस् Tarantool स्थापना गर्नुहोस्। लिपिमा लिङ्क - (कर्ल -L https://tarantool.io/installer.sh | VER=2.4 sudo -E bash)। हामीसँग आदेशहरू छन्:

tarantoolctl Tarantula उदाहरणहरू प्रबन्ध गर्नको लागि मुख्य आदेश हो।
/etc/tarantool - यहाँ सम्पूर्ण कन्फिगरेसन छ।
var/log/tarantool - यहाँ लगहरू छन्।
var/lib/tarantool - यहाँ डाटा छ, र त्यसपछि तिनीहरू उदाहरणहरूमा विभाजित छन्।

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

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

उदाहरण व्यवस्थापन

हामीसँग tarantoolctl आदेश छ जसले हामीलाई Tarantula उदाहरणहरू व्यवस्थापन गर्न अनुमति दिन्छ। उदाहरणको लागि, tarantoolctl चेक उदाहरणले कन्फिगरेसन फाइल जाँच गर्नेछ र यदि कुनै सिन्ट्याक्स त्रुटिहरू छैनन् भने फाइल ठीक छ भन्दछ।

तपाईंले उदाहरणको स्थिति हेर्न सक्नुहुन्छ - tarantoolctl स्थिति उदाहरण। त्यसै गरी, तपाइँ सुरु गर्न सक्नुहुन्छ, रोक्नुहोस्, पुन: सुरु गर्नुहोस्।

एक पटक एक उदाहरण चलिरहेको छ, त्यहाँ जडान गर्न दुई तरिकाहरू छन्।

1. प्रशासनिक कन्सोल

पूर्वनिर्धारित रूपमा, Tarantool ले सकेट खोल्छ र Tarantula नियन्त्रण गर्न सादा ASCII पाठ पठाउँछ। कन्सोलमा जडान सँधै प्रशासक प्रयोगकर्ता अन्तर्गत हुन्छ, त्यहाँ कुनै प्रमाणीकरण छैन, त्यसैले तपाईंले टारान्टुला बाहिर नियन्त्रण गर्न कन्सोल पोर्ट बाहिर निकाल्नु पर्दैन।

यस तरिकामा जडान गर्न, तपाईंले Tarantoolctl इनस्ट्यान्स नाम प्रविष्ट गर्न आवश्यक छ। आदेशले कन्सोल सुरु गर्नेछ र प्रशासक प्रयोगकर्ताको रूपमा जडान गर्नेछ। कन्सोल पोर्टलाई कहिले पनि बाहिर नदेखाउनुहोस् - यसलाई एकाइ सकेटको रूपमा छोड्नु राम्रो हुन्छ। त्यसपछि सकेटमा लेख्ने पहुँच भएकाहरूले मात्र टारान्टुलामा जडान गर्न सक्षम हुनेछन्।

यो विधि प्रशासनिक चीजहरूको लागि आवश्यक छ। डाटा संग काम गर्न, दोस्रो विधि प्रयोग गर्नुहोस् - बाइनरी प्रोटोकल।

2. एक विशेष पोर्टमा जडान गर्न बाइनरी प्रोटोकल प्रयोग गर्दै

कन्फिगरेसनमा सुन्न निर्देशन छ जसले बाह्य संचारको लागि पोर्ट खोल्छ। यो पोर्ट बाइनरी प्रोटोकल संग प्रयोग गरिन्छ र प्रमाणीकरण त्यहाँ सक्षम छ।

यस जडानको लागि, पोर्ट नम्बरमा tarantoolctl जडान प्रयोग गरिन्छ। यसलाई प्रयोग गरेर, तपाईं रिमोट सर्भरहरूमा जडान गर्न सक्नुहुन्छ, प्रमाणीकरण प्रयोग गर्नुहोस् र विभिन्न पहुँच अधिकारहरू दिन सक्नुहुन्छ।

डाटा रेकर्डिङ र बक्स मोड्युल

टारन्टूल डाटाबेस र एप्लिकेसन सर्भर भएको हुनाले यसमा विभिन्न मोड्युलहरू छन्। हामी बक्स मोड्युलमा रुचि राख्छौं - यसले डेटासँग काम लागू गर्दछ। जब तपाइँ बक्समा केहि लेख्नुहुन्छ, Tarantool ले डिस्कमा डाटा लेख्छ, मेमोरीमा भण्डार गर्दछ, वा यसको साथ केहि गर्दछ।

रेकर्डिंग

उदाहरणका लागि, हामी बक्स मोड्युलमा जान्छौं र box.once प्रकार्यलाई कल गर्छौं। यसले सर्भर प्रारम्भ हुँदा हाम्रो कोड चलाउन Tarantool लाई बाध्य पार्छ। हामी एउटा ठाउँ सिर्जना गर्छौं जहाँ हाम्रो डाटा भण्डारण हुनेछ।

local function bootstrap()
    local space = box.schema.create_space('example')
    space:create_index('primary')
    box.schema.user.grant('guest', 'read,write,execute', 'universe')

    -- Keep things safe by default
    --  box.schema.user.create('example', { password = 'secret' })
    --  box.schema.user.grant('example', 'replication')
    --  box.schema.user.grant('example', 'read,write,execute', 'space', 'example')
end

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

त्यसपछि हामी अतिथि प्रयोगकर्तालाई अनुदान दिन्छौं, जस अन्तर्गत हामी बाइनरी प्रोटोकल मार्फत जडान गर्छौं। हामी सम्पूर्ण उदाहरणमा पढ्न, लेख्ने र कार्यान्वयन गर्न अनुमति दिन्छौं।

परम्परागत डाटाबेसको तुलनामा, यहाँ सबै कुरा एकदम सरल छ। हामीसँग ठाउँ छ - एउटा क्षेत्र जसमा हाम्रो डाटा सजिलै भण्डारण गरिन्छ। प्रत्येक प्रविष्टिलाई टपल भनिन्छ। यो MessagePack मा प्याकेज गरिएको छ। यो धेरै राम्रो ढाँचा हो - यो बाइनरी हो र कम ठाउँ लिन्छ - 18 बाइट बनाम 27।

उहाँसँग काम गर्न धेरै सुविधाजनक छ। लगभग हरेक पङ्क्तिमा, प्रत्येक डेटा प्रविष्टिमा पूर्ण रूपमा फरक स्तम्भहरू हुन सक्छन्।

हामी Box.space आदेश प्रयोग गरेर सबै खाली ठाउँहरू हेर्न सक्छौं। एउटा विशिष्ट उदाहरण चयन गर्न, हामी box.space उदाहरण लेख्छौं र यसमा पूर्ण जानकारी प्राप्त गर्दछौं।

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

विनाइलले डिस्कमा डाटालाई बढी परिचित फारममा भण्डारण गर्दछ - त्यो हो, तपाईले हामीसँग मेमोरी भएको भन्दा धेरै डाटा भण्डारण गर्न सक्नुहुन्छ, र टारान्टुलाले यसलाई डिस्कबाट पढ्नेछ।

अब हामी मेमोरी प्रयोग गर्नेछौं।

unix/:/var/run/tarantool/example.control> box.space.example
---
- engine: memtx
  before_replace: 'function: 0x41eb02c8'
  on_replace: 'function: 0x41eb0568'
  ck_constraint: []
  field_count: 0
  temporary: false
  index:
    0: &0
      unique: true
      parts:
      - type: unsigned
        is_nullable: false
        fieldno: 1
      id: 0
      space_id: 512
      type: TREE
      name: primary
    primary: *0
  is_local: false
  enabled: true
  name: example
  id: 512
...

unix/:/var/run/tarantool/example.control>

अनुक्रमणिका:

कुनै पनि स्पेसको लागि प्राथमिक अनुक्रमणिका सिर्जना गर्नुपर्छ, किनभने यो बिना केहि काम गर्दैन। कुनै पनि डाटाबेसमा जस्तै, हामी पहिलो फिल्ड सिर्जना गर्छौं - रेकर्ड आईडी।

पार्ट्स:

यो जहाँ हामी निर्दिष्ट गर्छौं कि हाम्रो सूचकांक के समावेश छ। यसमा एउटा भाग हुन्छ - हामीले प्रयोग गर्ने पहिलो फिल्ड, अहस्ताक्षरित टाइप गर्नुहोस् - सकारात्मक पूर्णांक। जहाँसम्म मैले कागजातबाट सम्झन्छु, अधिकतम संख्या 18 क्विन्टिलियन हुन सक्छ। धेरै गजब।

त्यसपछि हामी insert आदेश प्रयोग गरेर डाटा घुसाउन सक्छौं।

unix/:/var/run/tarantool/example.control> box.space.example:insert{1, 'test1', 'test2'}
---
- [1, 'test1', 'test2']
...

unix/:/var/run/tarantool/example.control> box.space.example:insert{2, 'test2', 'test3', 'test4'}
---
- [2, 'test2', 'test3', 'test4']
...

unix/:/var/run/tarantool/example.control> box.space.example:insert{3, 'test3'}
---
- [3, 'test3']
...

unix/:/var/run/tarantool/example.control> box.space.example:insert{4, 'test4'}
---
- [4, 'test4']
...

unix/:/var/run/tarantool/example.control>

पहिलो क्षेत्र प्राथमिक कुञ्जीको रूपमा प्रयोग गरिन्छ, त्यसैले यो अद्वितीय हुनुपर्छ। हामी स्तम्भहरूको संख्यामा सीमित छैनौं, त्यसैले हामी त्यहाँ जति मनपर्छ डेटा सम्मिलित गर्न सक्छौं। तिनीहरू MessagePack ढाँचामा निर्दिष्ट गरिएका छन्, जुन मैले माथि वर्णन गरेको छु।

डाटा आउटपुट

त्यसपछि हामी चयन आदेशको साथ डाटा प्रदर्शन गर्न सक्छौं।

Box.example.select कुञ्जीसँग {1} ले इच्छित प्रविष्टि प्रदर्शन गर्नेछ। यदि हामीले कुञ्जी छोड्यौं भने, हामीसँग भएका सबै रेकर्डहरू देख्नेछौं। तिनीहरू सबै स्तम्भहरूको संख्यामा फरक छन्, तर यहाँ, सिद्धान्तमा, त्यहाँ स्तम्भहरूको कुनै अवधारणा छैन - त्यहाँ फिल्ड नम्बरहरू छन्।

तपाईले चाहानु भएको धेरै डेटा हुन सक्छ। र उदाहरणका लागि, हामीले तिनीहरूलाई दोस्रो क्षेत्रमा खोज्न आवश्यक छ। यो गर्नको लागि, हामी नयाँ माध्यमिक सूचकांक बनाउँछौं।


box.space.example:create_index( ‘secondary’, { type = ‘TREE’, unique = false, parts = {{field = 2, type =’string’} }})

हामी Create_index आदेश प्रयोग गर्छौं।
हामी यसलाई माध्यमिक भन्छौं।

त्यस पछि, तपाइँ प्यारामिटरहरू निर्दिष्ट गर्न आवश्यक छ। अनुक्रमणिका प्रकार TREE हो। यो अद्वितीय नहुन सक्छ, त्यसैले हामी अद्वितीय = गलत प्रविष्ट गर्छौं।

त्यसपछि हामी संकेत गर्छौं कि हाम्रो सूचकांक कुन भागहरू समावेश गर्दछ। फिल्ड भनेको फिल्डको संख्या हो जसमा हामीले अनुक्रमणिका बाँध्छौं, र स्ट्रिङ प्रकार निर्दिष्ट गर्दछ। र त्यसैले यो सिर्जना गरियो।

unix/:/var/run/tarantool/example.control> box.space.example:create_index('secondary', { type = 'TREE', unique = false, parts = {{field = 2, type = 'string'}}})
---
- unique: false
  parts:
  - type: string
    is_nullable: false
    fieldno: 2
  id: 1
  space_id: 512
  type: TREE
  name: secondary
...

unix/:/var/run/tarantool/example.control>

अब हामी यसलाई कसरी कल गर्न सक्छौं:

unix/:/var/run/tarantool/example.control> box.space.example.index.secondary:select('test1')
---
- - [1, 'test1', 'test2']
...

संरक्षण

यदि हामीले उदाहरण पुन: सुरु गर्यौं र डेटालाई फेरि कल गर्ने प्रयास गर्यौं भने, हामी देख्नेछौं कि तिनीहरू त्यहाँ छैनन् - सबै खाली छ। यो हुन्छ किनभने Tarantool ले चेकपोइन्टहरू बनाउँछ र डिस्कमा डाटा बचत गर्छ, तर यदि हामीले अर्को बचत गर्नु अघि काम गर्न छोड्यौं भने, हामी सबै कार्यहरू गुमाउनेछौं - किनभने हामी अन्तिम चेकपोइन्टबाट पुन: प्राप्ति गर्नेछौं, जुन उदाहरणका लागि, दुई घण्टा अघि थियो।

प्रत्येक सेकेन्ड बचत गर्नु पनि काम गर्दैन - किनकि 20 GB लाई डिस्कमा निरन्तर डम्प गर्नु एक यस्तो विचार हो।

यसका लागि, लेखन-अगाडि लग को अवधारणा आविष्कार र कार्यान्वयन गरियो। यसको मद्दतले, डेटामा प्रत्येक परिवर्तनको लागि, एउटा सानो लेखन-अगाडि लग फाइलमा रेकर्ड सिर्जना गरिन्छ।

चेकपोइन्टसम्मको प्रत्येक प्रविष्टि तिनीहरूमा भण्डार गरिएको छ। यी फाइलहरूको लागि, हामीले साइज सेट गर्छौं - उदाहरणका लागि, 64 एमबी। जब यो भरिन्छ, रेकर्डिङ दोस्रो फाइलमा जान सुरु हुन्छ। र पुन: सुरु गरेपछि, Tarantool अन्तिम चेकपोइन्टबाट पुन: प्राप्ति हुन्छ र त्यसपछि सबै लेनदेनहरू बन्द नगरेसम्म रोल गर्दछ।

यस्तो रेकर्डिङ प्रदर्शन गर्न, तपाईंले box.cfg सेटिङहरूमा एक विकल्प निर्दिष्ट गर्न आवश्यक छ (example.lua फाइलमा):

wal_mode = “write”;

डाटा उपयोग

हामीले अहिले के लेखेका छौं, तपाईले डाटा भण्डारण गर्न Tarantula प्रयोग गर्न सक्नुहुन्छ र यसले डाटाबेसको रूपमा धेरै छिटो काम गर्नेछ। र अब केक मा चेरी - तपाईं यो सबै संग के गर्न सक्नुहुन्छ।

एउटा आवेदन लेख्दै

उदाहरणका लागि, Tarantula लागि यस्तो आवेदन लेखौं

स्पोइलर अन्तर्गत आवेदन हेर्नुहोस्

box.cfg {
    listen = '0.0.0.0:3301';
    io_collect_interval = nil;
    readahead = 16320;
    memtx_memory = 128 * 1024 * 1024; -- 128Mb
    memtx_min_tuple_size = 16;
    memtx_max_tuple_size = 128 * 1024 * 1024; -- 128Mb
    vinyl_memory = 128 * 1024 * 1024; -- 128Mb
    vinyl_cache = 128 * 1024 * 1024; -- 128Mb
    vinyl_max_tuple_size = 128 * 1024 * 1024; -- 128Mb
    vinyl_write_threads = 2;
    wal_mode = "write";
    wal_max_size = 256 * 1024 * 1024;
    checkpoint_interval = 60 * 60; -- one hour
    checkpoint_count = 6;
    force_recovery = true;
    log_level = 5;
    log_nonblock = false;
    too_long_threshold = 0.5;
    read_only   = false
}

local function bootstrap()
    local space = box.schema.create_space('example')
    space:create_index('primary')

    box.schema.user.create('example', { password = 'secret' })
    box.schema.user.grant('example', 'read,write,execute', 'space', 'example')

    box.schema.user.create('repl', { password = 'replication' })
    box.schema.user.grant('repl', 'replication')
end

-- for first run create a space and add set up grants
box.once('replica', bootstrap)

-- enabling console access
console = require('console')
console.listen('127.0.0.1:3302')

-- http config
local charset = {}  do -- [0-9a-zA-Z]
    for c = 48, 57  do table.insert(charset, string.char(c)) end
    for c = 65, 90  do table.insert(charset, string.char(c)) end
    for c = 97, 122 do table.insert(charset, string.char(c)) end
end

local function randomString(length)
    if not length or length <= 0 then return '' end
    math.randomseed(os.clock()^5)
    return randomString(length - 1) .. charset[math.random(1, #charset)]
end

local http_router = require('http.router')
local http_server = require('http.server')
local json = require('json')

local httpd = http_server.new('0.0.0.0', 8080, {
    log_requests = true,
    log_errors = true
})

local router = http_router.new()

local function get_count()
 local cnt = box.space.example:len()
 return cnt
end

router:route({method = 'GET', path = '/count'}, function()
    return {status = 200, body = json.encode({count = get_count()})}
end)

router:route({method = 'GET', path = '/token'}, function()
    local token = randomString(32)
    local last = box.space.example:len()
    box.space.example:insert{ last + 1, token }
    return {status = 200, body = json.encode({token = token})}
end)

prometheus = require('prometheus')

fiber = require('fiber')
tokens_count = prometheus.gauge("tarantool_tokens_count",
                              "API Tokens Count")

function monitor_tokens_count()
  while true do
    tokens_count:set(get_count())
    fiber.sleep(5)
  end
end
fiber.create(monitor_tokens_count)

router:route( { method = 'GET', path = '/metrics' }, prometheus.collect_http)

httpd:set_router(router)
httpd:start()

हामी लुआमा केही तालिका घोषणा गर्छौं जसले प्रतीकहरू परिभाषित गर्दछ। यो तालिका अनियमित स्ट्रिङ उत्पन्न गर्न आवश्यक छ।

local charset = {}  do -- [0-9a-zA-Z]
    for c = 48, 57  do table.insert(charset, string.char(c)) end
    for c = 65, 90  do table.insert(charset, string.char(c)) end
    for c = 97, 122 do table.insert(charset, string.char(c)) end
end

त्यस पछि, हामी एक प्रकार्य घोषणा गर्छौं - randomString र कोष्ठकमा लम्बाई मान दिन्छौं।

local function randomString(length)
    if not length or length <= 0 then return '' end
    math.randomseed(os.clock()^5)
    return randomString(length - 1) .. charset[math.random(1, #charset)]
end

त्यसपछि हामी http राउटर र http सर्भरलाई हाम्रो टारन्टुला सर्भर, JSON मा जडान गर्छौं, जुन हामीले ग्राहकलाई दिनेछौं।

local http_router = require('http.router')
local http_server = require('http.server')
local json = require('json')

त्यस पछि, हामी सबै http सर्भर इन्टरफेसहरूमा पोर्ट 8080 मा सुरु गर्छौं, जसले सबै अनुरोधहरू र त्रुटिहरू लग गर्नेछ।

local httpd = http_server.new('0.0.0.0', 8080, {
    log_requests = true,
    log_errors = true
})

अर्को, हामी एक मार्ग घोषणा गर्छौं कि यदि GET विधिको साथ अनुरोध पोर्ट 8080 /count मा आइपुग्छ भने, हामी एक लाइनबाट प्रकार्यलाई कल गर्छौं। यसले स्थिति फर्काउँछ - 200, 404, 403 वा हामीले निर्दिष्ट गरेको जुनसुकै।

router:route({method = 'GET', path = '/count'}, function()
    return {status = 200, body = json.encode({count = get_count()})}
end)

मुख्य भागमा, हामी json.encode फर्काउँछौं, हामी यसमा गणना र getcount निर्दिष्ट गर्छौं, जसलाई भनिन्छ र हाम्रो डाटाबेसमा रेकर्डहरूको संख्या देखाउँदछ।

दोस्रो तरिका

router:route({method = 'GET', path = '/token'}, function() 
    local token = randomString(32) 
    local last = box.space.example:len() 
    box.space.example:insert{ last + 1, token } 
    return {status = 200, body = json.encode({token = token})}
end)

जहाँ लाइन मा राउटर: मार्ग({विधि = 'GET', पथ = '/टोकन'}, प्रकार्य() हामी प्रकार्यलाई कल गर्छौं र टोकन उत्पन्न गर्छौं।

लाइन स्थानीय टोकन = randomString(32) 32 वर्णहरूको अनियमित स्ट्रिङ हो।
क्रममा स्थानीय अन्तिम = box.space.example:len() हामी अन्तिम तत्व बाहिर निकाल्छौं।
र लाइन मा box.space.example: insert{ last + 1, token } हामी हाम्रो डाटाबेसमा डाटा लेख्छौं, अर्थात्, हामी आईडीलाई 1 ले बढाउँछौं। यो यस्तो अनाड़ी तरीकाले मात्र होइन, गर्न सकिन्छ। टारान्टुलासँग यस केसका लागि अनुक्रमहरू छन्।

हामी त्यहाँ टोकन लेख्छौं।

यसरी, हामीले एउटा फाइलमा आवेदन लेख्यौं। तपाईंले तुरुन्तै डाटा पहुँच गर्न सक्नुहुन्छ, र बक्स मोड्युलले तपाईंको लागि सबै फोहोर काम गर्नेछ।

यसले http सुन्छ र डाटासँग काम गर्दछ, सबै कुरा एकल उदाहरणमा हुन्छ - एप र डाटा दुवै। त्यसैले, सबै कुरा एकदम चाँडै हुन्छ।

चलाउनको लागि, हामी http मोड्युल स्थापना गर्छौं:

हामी यसलाई कसरी गर्छौं, स्पोइलर अन्तर्गत हेर्नुहोस्

root@test2:/# tarantoolctl rocks install http
Installing http://rocks.tarantool.org/http-scm-1.src.rock
Missing dependencies for http scm-1:
   checks >= 3.0.1 (not installed)

http scm-1 depends on checks >= 3.0.1 (not installed)
Installing http://rocks.tarantool.org/checks-3.0.1-1.rockspec

Cloning into 'checks'...
remote: Enumerating objects: 28, done.
remote: Counting objects: 100% (28/28), done.
remote: Compressing objects: 100% (19/19), done.
remote: Total 28 (delta 1), reused 16 (delta 1), pack-reused 0
Receiving objects: 100% (28/28), 12.69 KiB | 12.69 MiB/s, done.
Resolving deltas: 100% (1/1), done.
Note: checking out '580388773ef11085015b5a06fe52d61acf16b201'.

You are in 'detached HEAD' state. You can look around, make experimental
changes and commit them, and you can discard any commits you make in this
state without impacting any branches by performing another checkout.

If you want to create a new branch to retain commits you create, you may
do so (now or later) by using -b with the checkout command again. Example:

  git checkout -b <new-branch-name>

No existing manifest. Attempting to rebuild...
checks 3.0.1-1 is now installed in /.rocks (license: BSD)

-- The C compiler identification is GNU 7.5.0
-- Check for working C compiler: /usr/bin/cc
-- Check for working C compiler: /usr/bin/cc -- works
-- Detecting C compiler ABI info
-- Detecting C compiler ABI info - done
-- Detecting C compile features
-- Detecting C compile features - done
-- Found TARANTOOL: /usr/include (found version "2.4.2-80-g18f2bc82d")
-- Tarantool LUADIR is /.rocks/share/tarantool/rocks/http/scm-1/lua
-- Tarantool LIBDIR is /.rocks/share/tarantool/rocks/http/scm-1/lib
-- Configuring done
-- Generating done
CMake Warning:
  Manually-specified variables were not used by the project:

    version


-- Build files have been written to: /tmp/luarocks_http-scm-1-V4P9SM/http/build.luarocks
Scanning dependencies of target httpd
[ 50%] Building C object http/CMakeFiles/httpd.dir/lib.c.o
In file included from /tmp/luarocks_http-scm-1-V4P9SM/http/http/lib.c:32:0:
/tmp/luarocks_http-scm-1-V4P9SM/http/http/lib.c: In function ‘tpl_term’:
/usr/include/tarantool/lauxlib.h:144:15: warning: this statement may fall through [-Wimplicit-fallthrough=]
    (*(B)->p++ = (char)(c)))
    ~~~~~~~~~~~^~~~~~~~~~~~
/tmp/luarocks_http-scm-1-V4P9SM/http/http/lib.c:62:7: note: in expansion of macro ‘luaL_addchar’
       luaL_addchar(b, '\');
       ^~~~~~~~~~~~
/tmp/luarocks_http-scm-1-V4P9SM/http/http/lib.c:63:6: note: here
      default:
      ^~~~~~~
In file included from /tmp/luarocks_http-scm-1-V4P9SM/http/http/lib.c:39:0:
/tmp/luarocks_http-scm-1-V4P9SM/http/http/tpleval.h: In function ‘tpe_parse’:
/tmp/luarocks_http-scm-1-V4P9SM/http/http/tpleval.h:147:9: warning: this statement may fall through [-Wimplicit-fallthrough=]
    type = TPE_TEXT;
    ~~~~~^~~~~~~~~~
/tmp/luarocks_http-scm-1-V4P9SM/http/http/tpleval.h:149:3: note: here
   case TPE_LINECODE:
   ^~~~
In file included from /tmp/luarocks_http-scm-1-V4P9SM/http/http/lib.c:40:0:
/tmp/luarocks_http-scm-1-V4P9SM/http/http/httpfast.h: In function ‘httpfast_parse’:
/tmp/luarocks_http-scm-1-V4P9SM/http/http/httpfast.h:372:22: warning: this statement may fall through [-Wimplicit-fallthrough=]
                 code = 0;
                 ~~~~~^~~
/tmp/luarocks_http-scm-1-V4P9SM/http/http/httpfast.h:374:13: note: here
             case status:
             ^~~~
/tmp/luarocks_http-scm-1-V4P9SM/http/http/httpfast.h:393:23: warning: this statement may fall through [-Wimplicit-fallthrough=]
                 state = message;
                 ~~~~~~^~~~~~~~~
/tmp/luarocks_http-scm-1-V4P9SM/http/http/httpfast.h:395:13: note: here
             case message:
             ^~~~
[100%] Linking C shared library lib.so
[100%] Built target httpd
[100%] Built target httpd
Install the project...
-- Install configuration: "Debug"
-- Installing: /.rocks/share/tarantool/rocks/http/scm-1/lua/http/VERSION.lua
-- Installing: /.rocks/share/tarantool/rocks/http/scm-1/lib/http/lib.so
-- Installing: /.rocks/share/tarantool/rocks/http/scm-1/lua/http/server/init.lua
-- Installing: /.rocks/share/tarantool/rocks/http/scm-1/lua/http/server/tsgi_adapter.lua
-- Installing: /.rocks/share/tarantool/rocks/http/scm-1/lua/http/nginx_server/init.lua
-- Installing: /.rocks/share/tarantool/rocks/http/scm-1/lua/http/router/init.lua
-- Installing: /.rocks/share/tarantool/rocks/http/scm-1/lua/http/router/fs.lua
-- Installing: /.rocks/share/tarantool/rocks/http/scm-1/lua/http/router/matching.lua
-- Installing: /.rocks/share/tarantool/rocks/http/scm-1/lua/http/router/middleware.lua
-- Installing: /.rocks/share/tarantool/rocks/http/scm-1/lua/http/router/request.lua
-- Installing: /.rocks/share/tarantool/rocks/http/scm-1/lua/http/router/response.lua
-- Installing: /.rocks/share/tarantool/rocks/http/scm-1/lua/http/tsgi.lua
-- Installing: /.rocks/share/tarantool/rocks/http/scm-1/lua/http/utils.lua
-- Installing: /.rocks/share/tarantool/rocks/http/scm-1/lua/http/mime_types.lua
-- Installing: /.rocks/share/tarantool/rocks/http/scm-1/lua/http/codes.lua
http scm-1 is now installed in /.rocks (license: BSD)

root@test2:/#

हामीलाई दौडनको लागि प्रोमेथियस पनि चाहिन्छ:

root@test2:/# tarantoolctl rocks install prometheus
Installing http://rocks.tarantool.org/prometheus-scm-1.rockspec

Cloning into 'prometheus'...
remote: Enumerating objects: 19, done.
remote: Counting objects: 100% (19/19), done.
remote: Compressing objects: 100% (19/19), done.
remote: Total 19 (delta 2), reused 5 (delta 0), pack-reused 0
Receiving objects: 100% (19/19), 10.73 KiB | 10.73 MiB/s, done.
Resolving deltas: 100% (2/2), done.
prometheus scm-1 is now installed in /.rocks (license: BSD)

root@test2:/#

हामी सुरु गर्छौं र मोड्युलहरू पहुँच गर्न सक्छौं

root@test2:/# curl -D - -s http://127.0.0.1:8080/token
HTTP/1.1 200 Ok
Content-length: 44
Server: Tarantool http (tarantool v2.4.2-80-g18f2bc82d)
Connection: keep-alive

{"token":"e2tPq9l5Z3QZrewRf6uuoJUl3lJgSLOI"}

root@test2:/# curl -D - -s http://127.0.0.1:8080/token
HTTP/1.1 200 Ok
Content-length: 44
Server: Tarantool http (tarantool v2.4.2-80-g18f2bc82d)
Connection: keep-alive

{"token":"fR5aCA84gj9eZI3gJcV0LEDl9XZAG2Iu"}

root@test2:/# curl -D - -s http://127.0.0.1:8080/count
HTTP/1.1 200 Ok
Content-length: 11
Server: Tarantool http (tarantool v2.4.2-80-g18f2bc82d)
Connection: keep-alive

{"count":2}root@test2:/#

/ गणनाले हामीलाई 200 स्थिति दिन्छ।
/token ले टोकन जारी गर्छ र यो टोकन डाटाबेसमा लेख्छ।

परीक्षण गति

50 प्रश्नहरूको लागि बेन्चमार्क चलाउनुहोस्। प्रतिस्पर्धी अनुरोधहरू 000 हुनेछन्।

root@test2:/# ab -c 500 -n 50000 http://127.0.0.1:8080/token
This is ApacheBench, Version 2.3 <$Revision: 1807734 $>
Copyright 1996 Adam Twiss, Zeus Technology Ltd, http://www.zeustech.net/
Licensed to The Apache Software Foundation, http://www.apache.org/

Benchmarking 127.0.0.1 (be patient)
Completed 5000 requests
Completed 10000 requests
Completed 15000 requests
Completed 20000 requests
Completed 25000 requests
Completed 30000 requests
Completed 35000 requests
Completed 40000 requests
Completed 45000 requests
Completed 50000 requests
Finished 50000 requests


Server Software:        Tarantool
Server Hostname:        127.0.0.1
Server Port:            8080

Document Path:          /token
Document Length:        44 bytes

Concurrency Level:      500
Time taken for tests:   14.578 seconds
Complete requests:      50000
Failed requests:        0
Total transferred:      7950000 bytes
HTML transferred:       2200000 bytes
Requests per second:    3429.87 [#/sec] (mean)
Time per request:       145.778 [ms] (mean)
Time per request:       0.292 [ms] (mean, across all concurrent requests)
Transfer rate:          532.57 [Kbytes/sec] received

Connection Times (ms)
              min  mean[+/-sd] median   max
Connect:        0   10 103.2      0    3048
Processing:    12   69 685.1     15   13538
Waiting:       12   69 685.1     15   13538
Total:         12   78 768.2     15   14573

Percentage of the requests served within a certain time (ms)
  50%     15
  66%     15
  75%     16
  80%     16
  90%     16
  95%     16
  98%     21
  99%     42
 100%  14573 (longest request)
root@test2:/#

टोकन जारी गरिन्छ। र हामी निरन्तर डाटा रेकर्ड गर्दैछौं। 99% अनुरोधहरू 42 मिलिसेकेन्डमा पूरा भयो। तदनुसार, हामीसँग एउटा सानो मेसिनमा प्रति सेकेन्ड लगभग 3500 अनुरोधहरू छन्, जहाँ 2 कोर र 4 गिगाबाइट मेमोरी छन्।

तपाइँ केहि 50000 टोकन पनि चयन गर्न सक्नुहुन्छ र यसको मूल्य हेर्न सक्नुहुन्छ।

तपाईले http मात्र प्रयोग गर्न सक्नुहुन्न, तपाइँको डाटा प्रशोधन गर्ने पृष्ठभूमि प्रकार्यहरू चलाउनुहोस्। साथै त्यहाँ विभिन्न ट्रिगरहरू छन्। उदाहरणका लागि, तपाइँ अपडेटहरूमा प्रकार्यहरू कल गर्न सक्नुहुन्छ, केहि जाँच गर्नुहोस् - विवादहरू समाधान गर्नुहोस्।

तपाईले डाटाबेस सर्भरमा सिधै स्क्रिप्ट अनुप्रयोगहरू लेख्न सक्नुहुन्छ, र कुनै पनि कुरामा सीमित हुनुहुन्न, कुनै पनि मोड्युलहरू जडान गर्नुहोस् र कुनै पनि तर्क लागू गर्नुहोस्।

अनुप्रयोग सर्भरले बाह्य सर्भरहरू पहुँच गर्न, डाटा सङ्कलन गर्न र यसको डाटाबेसमा थप्न सक्छ। यस डाटाबेसको डाटा अन्य अनुप्रयोगहरूले प्रयोग गर्नेछ।

यो टारान्टुला आफैले गर्नेछ, र छुट्टै आवेदन लेख्न आवश्यक छैन।

निष्कर्षमा

यो एउटा ठूलो कामको पहिलो भाग मात्र हो। दोस्रो धेरै चाँडै Mail.ru समूह ब्लगमा प्रकाशित हुनेछ, र हामी निश्चित रूपमा यस लेखमा यसको लिङ्क थप्नेछौं।

यदि तपाइँ घटनाहरूमा भाग लिन इच्छुक हुनुहुन्छ जहाँ हामीले यी चीजहरू अनलाइन सिर्जना गर्छौं र वास्तविक समयमा प्रश्नहरू सोध्छौं भने, जडान गर्नुहोस् REBRAIN च्यानल द्वारा DevOps.

यदि तपाइँ क्लाउडमा जान आवश्यक छ वा तपाइँको पूर्वाधारको बारेमा प्रश्नहरू छन् भने, अनुरोध पेश गर्न स्वतन्त्र महसुस गर्नुहोस्.

PS हामीसँग प्रति महिना 2 नि: शुल्क अडिटहरू छन्, सायद तपाइँको परियोजना ती मध्ये एक हुनेछ।

स्रोत: www.habr.com