Tarantool માં, તમે સુપર-ફાસ્ટ ડેટાબેઝ અને તેમની સાથે કામ કરવા માટેની એપ્લિકેશનને જોડી શકો છો. તે કરવું કેટલું સરળ છે તે અહીં છે

પાંચ વર્ષ પહેલાં મેં ટેરેન્ટૂલ સાથે કામ કરવાનો પ્રયાસ કર્યો, પરંતુ તે પછી તે મારા માટે કામ કરતું ન હતું. પરંતુ તાજેતરમાં મેં એક વેબિનારનું આયોજન કર્યું હતું જ્યાં મેં Hadoop અને MapReduce કેવી રીતે કાર્ય કરે છે તે વિશે વાત કરી હતી. ત્યાં તેઓએ મને એક પ્રશ્ન પૂછ્યો: "શા માટે આ કાર્ય માટે ટેરેન્ટૂલનો ઉપયોગ નથી કરતા?"

જિજ્ઞાસાથી, મેં તેના પર પાછા ફરવાનું નક્કી કર્યું, નવીનતમ સંસ્કરણનું પરીક્ષણ કર્યું - અને આ વખતે મને ખરેખર પ્રોજેક્ટ ગમ્યો. હવે હું તમને બતાવીશ કે ટેરેન્ટૂલમાં એક સરળ એપ્લિકેશન કેવી રીતે લખવી, તેને લોડ કરવી અને તેનું પ્રદર્શન તપાસવું, અને તમે જોશો કે બધું કેટલું સરળ અને સરસ છે.

ટેરન્ટૂલ શું છે

ટેરન્ટૂલ પોતાની જાતને અતિ-ફાસ્ટ ડેટાબેઝ તરીકે સ્થાન આપે છે. તમને જોઈતો કોઈપણ ડેટા તમે ત્યાં મૂકી શકો છો. ઉપરાંત, તેમની નકલ કરો, શાર્ડ - એટલે કે ઘણા બધા સર્વર્સ પર વિશાળ માત્રામાં ડેટા વિભાજિત કરો અને તેમાંથી પરિણામોને જોડો - દોષ-સહિષ્ણુ માસ્ટર-માસ્ટર જોડાણો બનાવો.

બીજું, આ એક એપ્લિકેશન સર્વર છે. તમે તેના પર તમારી એપ્લિકેશનો લખી શકો છો, ડેટા સાથે કામ કરી શકો છો, ઉદાહરણ તરીકે, ચોક્કસ નિયમો અનુસાર પૃષ્ઠભૂમિમાં જૂના રેકોર્ડ્સ કાઢી નાખો. તમે ટેરેન્ટુલામાં સીધા જ Http સર્વર લખી શકો છો જે ડેટા સાથે કામ કરશે: તેમનો જથ્થો આપો, ત્યાં નવો ડેટા લખો અને તે બધું માસ્ટરને ઓછું કરો.

મેં એક લેખ વાંચ્યો કે કેવી રીતે છોકરાઓએ 300 લાઇનની સંદેશ કતાર બનાવી છે, જે ફક્ત છલકાઇ રહી છે અને દોડી રહી છે - તેમની પાસે પ્રતિ સેકન્ડ 20 સંદેશાઓનું ન્યૂનતમ પ્રદર્શન છે. અહીં તમે ખરેખર ફેરવી શકો છો અને ખૂબ મોટી એપ્લિકેશન લખી શકો છો, અને તે સ્ટોરેજ નહીં હોય, જેમ કે PostgreS માં.

હું આ લેખમાં આ સર્વર જેવું કંઈક વર્ણન કરવાનો પ્રયાસ કરીશ, ફક્ત સરળ.

સ્થાપન

પરીક્ષણ માટે, મેં ત્રણ પ્રમાણભૂત વર્ચ્યુઅલ મશીનો શરૂ કર્યા - એક 20 GB હાર્ડ ડ્રાઈવ, ઉબુન્ટુ 18.04. 2 વર્ચ્યુઅલ CPU અને 4 જીગ્સ મેમરી.

અમે ટેરન્ટૂલ ઇન્સ્ટોલ કરીએ છીએ - બેશ સ્ક્રિપ્ટ ચલાવો અથવા રીપોઝીટરી ઉમેરો અને યોગ્ય રીતે ટેરેન્ટૂલ ઇન્સ્ટોલ કરો. સ્ક્રિપ્ટની લિંક - (curl -L https://tarantool.io/installer.sh | VER=2.4 sudo -E bash). અમારી પાસે આદેશો છે જેમ કે:

tarantoolctl — ટેરેન્ટુલા દાખલાઓનું સંચાલન કરવા માટેનો મુખ્ય આદેશ.
/etc/tarantool - અહીં સમગ્ર રૂપરેખાંકન છે.
var/log/tarantool - અહીં લોગ છે.
var/lib/tarantool — ડેટા અહીં આવેલો છે, અને પછી તેને ઉદાહરણોમાં વિભાજિત કરવામાં આવે છે.

ફોલ્ડર્સ ઇન્સ્ટન્સ-ઉપલબ્ધ છે અને ઇન્સ્ટન્સ-સક્ષમ છે - તેમાં શું લોન્ચ કરવામાં આવશે તે શામેલ છે - લુઆ કોડ સાથેની એક ઇન્સ્ટન્સ રૂપરેખાંકન ફાઇલ, જે વર્ણવે છે કે તે કયા પોર્ટ્સ પર સાંભળે છે, તેના માટે કઈ મેમરી ઉપલબ્ધ છે, વિનીલ એન્જિન સેટિંગ્સ, કોડ કે જે સ્ટાર્ટઅપ પર ચાલે છે સર્વર્સ, શાર્ડિંગ, કતાર, અપ્રચલિત ડેટા કાઢી નાખવું, અને તેથી વધુ.

દાખલાઓ PostgreS ની જેમ કામ કરે છે. ઉદાહરણ તરીકે, તમે ડેટાબેઝની ઘણી નકલો ચલાવવા માંગો છો જે વિવિધ પોર્ટ્સ પર અટકી જાય છે. તે તારણ આપે છે કે એક સર્વર પર ઘણા ડેટાબેઝ દાખલાઓ લોંચ કરવામાં આવે છે, જે વિવિધ પોર્ટ પર અટકી જાય છે. તેમની પાસે સંપૂર્ણપણે અલગ સેટિંગ્સ હોઈ શકે છે - એક ઉદાહરણ એક તર્ક લાગુ કરે છે, બીજો - બીજો.

ઇન્સ્ટન્સ મેનેજમેન્ટ

અમારી પાસે tarantoolctl આદેશ છે, જે તમને ટેરેન્ટુલા ઉદાહરણોનું સંચાલન કરવાની મંજૂરી આપે છે. ઉદાહરણ તરીકે, tarantoolctl ચેક ઉદાહરણ રૂપરેખાંકન ફાઇલને તપાસશે અને કહેશે - જો ત્યાં કોઈ વાક્યરચના ભૂલો ન હોય તો ફાઇલ બરાબર છે.

તમે દાખલાની સ્થિતિ જોઈ શકો છો - tarantoolctl status example. એ જ રીતે તમે સ્ટાર્ટ, સ્ટોપ, રીસ્ટાર્ટ કરી શકો છો.

એકવાર દાખલો ચાલુ થઈ જાય, તમે તેને બે રીતે કનેક્ટ કરી શકો છો.

1. વહીવટી કન્સોલ

મૂળભૂત રીતે, Tarantool એક સોકેટ ખોલે છે, સામાન્ય ASCII ટેક્સ્ટ ટેરેન્ટૂલને નિયંત્રિત કરવા માટે ત્યાં મોકલવામાં આવે છે. કન્સોલ સાથે કનેક્શન હંમેશા એડમિન વપરાશકર્તા હેઠળ થાય છે, ત્યાં કોઈ પ્રમાણીકરણ નથી, તેથી ટેરેન્ટુલાનું સંચાલન કરવા માટે કન્સોલ પોર્ટને બાહ્ય બનાવવાની જરૂર નથી.

આ પદ્ધતિનો ઉપયોગ કરીને કનેક્ટ કરવા માટે, તમારે Tarantoolctl દાખલ કરવાનું નામ દાખલ કરવું પડશે. આદેશ કન્સોલ લોન્ચ કરશે અને એડમિન વપરાશકર્તા તરીકે કનેક્ટ થશે. કન્સોલ પોર્ટને ક્યારેય બહારથી ખુલ્લું પાડશો નહીં - તેને યુનિટ સોકેટ તરીકે છોડવું વધુ સારું છે. પછી જેઓ સોકેટ પર લખવાની ઍક્સેસ ધરાવે છે તેઓ જ ટેરેન્ટુલા સાથે જોડાઈ શકશે.

આ પદ્ધતિ વહીવટી બાબતો માટે જરૂરી છે. ડેટા સાથે કામ કરવા માટે, બીજી પદ્ધતિનો ઉપયોગ કરો - બાઈનરી પ્રોટોકોલ.

2. ચોક્કસ પોર્ટ સાથે જોડાવા માટે બાઈનરી પ્રોટોકોલનો ઉપયોગ કરવો

રૂપરેખાંકનમાં સાંભળવાનું નિર્દેશન છે, જે બાહ્ય સંચાર માટે પોર્ટ ખોલે છે. આ પોર્ટનો ઉપયોગ બાઈનરી પ્રોટોકોલ સાથે થાય છે અને ત્યાં પ્રમાણીકરણ સક્ષમ છે.

આ જોડાણ માટે, પોર્ટ નંબર સાથે tarantoolctl connect નો ઉપયોગ થાય છે. તેનો ઉપયોગ કરીને, તમે રિમોટ સર્વર્સ સાથે કનેક્ટ કરી શકો છો, પ્રમાણીકરણનો ઉપયોગ કરી શકો છો અને વિવિધ ઍક્સેસ અધિકારો આપી શકો છો.

ડેટા રેકોર્ડિંગ અને બોક્સ મોડ્યુલ

ટેરન્ટૂલ ડેટાબેઝ અને એપ્લિકેશન સર્વર બંને હોવાથી, તેમાં વિવિધ મોડ્યુલો છે. અમને બોક્સ મોડ્યુલમાં રસ છે - તે ડેટા સાથે કામ કરવાનું અમલમાં મૂકે છે. જ્યારે તમે બૉક્સમાં કંઈક લખો છો, ત્યારે ટેરન્ટૂલ ડિસ્ક પર ડેટા લખે છે, તેને મેમરીમાં સંગ્રહિત કરે છે અથવા તેની સાથે કંઈક બીજું કરે છે.

રેકોર્ડિંગ

ઉદાહરણ તરીકે, આપણે બોક્સ મોડ્યુલમાં જઈએ છીએ અને box.once ફંક્શનને કૉલ કરીએ છીએ. જ્યારે સર્વર શરૂ થાય ત્યારે આ ટેરેન્ટૂલને અમારો કોડ ચલાવવા માટે દબાણ કરશે. અમે એક જગ્યા બનાવીએ છીએ જેમાં આપણો ડેટા સંગ્રહિત થશે.

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 ઉદાહરણ લખો અને તેના વિશે સંપૂર્ણ માહિતી મેળવો.

ટેરન્ટૂલમાં બે બિલ્ટ-ઇન એન્જિન છે: મેમરી અને વિનીલ. મેમરી તમામ ડેટાને મેમરીમાં સ્ટોર કરે છે. તેથી, બધું સરળ અને ઝડપથી કાર્ય કરે છે. ડેટાને ડિસ્ક પર ડમ્પ કરવામાં આવે છે, અને આગળ લખવાની લૉગ મિકેનિઝમ પણ છે, તેથી જો સર્વર ક્રેશ થાય તો અમે કંઈપણ ગુમાવીશું નહીં.

વિનાઇલ ડિસ્ક પર ડેટા સ્ટોર કરે છે જે અમને વધુ પરિચિત છે - એટલે કે, તમે અમારી પાસે મેમરી કરતાં વધુ ડેટા સ્ટોર કરી શકો છો, અને ટેરેન્ટુલા તેને ડિસ્કમાંથી વાંચશે.

અત્યારે આપણે મેમરીનો ઉપયોગ કરીશું.

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 ફોર્મેટમાં ઉલ્લેખિત છે, જે મેં ઉપર વર્ણવેલ છે.

ડેટા આઉટપુટ

પછી આપણે સિલેક્ટ કમાન્ડનો ઉપયોગ કરીને ડેટા પ્રદર્શિત કરી શકીએ છીએ.

{1} કી સાથે Box.example.select ઇચ્છિત એન્ટ્રી પ્રદર્શિત કરશે. જો આપણે ચાવી ઓછી કરીશું, તો આપણે આપણી પાસે જે રેકોર્ડ છે તે જોઈશું. તે બધા કૉલમની સંખ્યામાં ભિન્ન છે, પરંતુ અહીં, સૈદ્ધાંતિક રીતે, કૉલમનો કોઈ ખ્યાલ નથી - ત્યાં ફીલ્ડ નંબરો છે.

ડેટાની કોઈપણ માત્રા હોઈ શકે છે. અને ઉદાહરણ તરીકે, આપણે તેમને બીજા ક્ષેત્ર દ્વારા શોધવાની જરૂર છે. આ કરવા માટે, અમે એક નવી ગૌણ અનુક્રમણિકા બનાવીએ છીએ.

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

અમે Create_index આદેશનો ઉપયોગ કરીએ છીએ.
ચાલો તેને ગૌણ કહીએ.

આ પછી તમારે પરિમાણોનો ઉલ્લેખ કરવાની જરૂર છે. ઇન્ડેક્સ પ્રકાર TREE છે. તે અનન્ય ન હોઈ શકે, તેથી અનન્ય = false દાખલ કરો.

પછી અમે સૂચવીએ છીએ કે અમારા ઇન્ડેક્સમાં કયા ભાગોનો સમાવેશ થાય છે. ફીલ્ડ એ ફીલ્ડની સંખ્યા છે કે જેમાં આપણે ઇન્ડેક્સ બાંધીએ છીએ અને સ્ટ્રિંગ પ્રકારનો ઉલ્લેખ કરીએ છીએ. અને તેથી તે બનાવવામાં આવ્યું હતું.

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']
...

બચત

જો આપણે દાખલો પુનઃપ્રારંભ કરીએ અને ડેટાને ફરીથી કૉલ કરવાનો પ્રયાસ કરીએ, તો આપણે જોશું કે તે ત્યાં નથી - બધું ખાલી છે. આવું એટલા માટે થાય છે કારણ કે ટેરન્ટૂલ ચેકપોઇન્ટ બનાવે છે અને ડેટાને ડિસ્કમાં સેવ કરે છે, પરંતુ જો આપણે આગલી સેવ સુધી કામ કરવાનું બંધ કરી દઈએ, તો અમે તમામ કામગીરી ગુમાવી દઈશું - કારણ કે અમે છેલ્લા ચેકપોઈન્ટમાંથી પુનઃપ્રાપ્ત થઈશું, જે ઉદાહરણ તરીકે, બે કલાક પહેલા હતું.

તે દરેક સેકન્ડને બચાવવા માટે કામ કરશે નહીં, કારણ કે ડિસ્ક પર સતત 20 જીબી ડમ્પ કરવું એ સારો વિચાર નથી.

આ હેતુ માટે, લખવા-આગળ લોગની વિભાવનાની શોધ અને અમલ કરવામાં આવી હતી. તેની મદદથી, ડેટામાં દરેક ફેરફાર માટે, એક નાની લખાણ આગળની લોગ ફાઇલમાં એન્ટ્રી બનાવવામાં આવે છે.

ચેકપોઇન્ટ સુધીની દરેક એન્ટ્રી તેમાં સંગ્રહિત છે. આ ફાઇલો માટે અમે કદ સેટ કરીએ છીએ - ઉદાહરણ તરીકે, 64 MB. જ્યારે તે ભરાઈ જાય છે, ત્યારે રેકોર્ડિંગ બીજી ફાઇલ પર જવાનું શરૂ કરે છે. અને પુનઃપ્રારંભ કર્યા પછી, ટેરન્ટૂલને છેલ્લી ચેકપોઇન્ટથી પુનઃસ્થાપિત કરવામાં આવે છે અને પછી તે બંધ ન થાય ત્યાં સુધી તે પછીના તમામ વ્યવહારો પર ફેરવાય છે.

આવા રેકોર્ડિંગ હાથ ધરવા માટે, તમારે box.cfg સેટિંગ્સમાં વિકલ્પનો ઉલ્લેખ કરવાની જરૂર છે (example.lua ફાઇલમાં):

wal_mode = “write”;

ડેટા વપરાશ

અમે હમણાં જે લખ્યું છે તેની સાથે, તમે ડેટા સ્ટોર કરવા માટે ટેરેન્ટુલાનો ઉપયોગ કરી શકો છો અને તે ડેટાબેઝ તરીકે ખૂબ જ ઝડપથી કામ કરશે. અને હવે કેક પર આઈસિંગ એ છે કે તમે તે બધા સાથે શું કરી શકો છો.

અરજી લખી રહ્યા છીએ

ઉદાહરણ તરીકે, ચાલો ટેરેન્ટુલા માટે નીચેની એપ્લિકેશન લખીએ

સ્પોઇલર હેઠળ એપ્લિકેશન જુઓ

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 પરત કરીએ છીએ, તેમાં આપણે કાઉન્ટ અને ગેટકાઉન્ટ સૂચવીએ છીએ, જેને કહેવામાં આવે છે અને આપણા ડેટાબેઝમાં રેકોર્ડની સંખ્યા દર્શાવે છે.

બીજી પદ્ધતિ

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)

લાઈનમાં ક્યાં રાઉટર:રૂટ({મેથોડ = 'ગેટ', પાથ = '/ટોકન'}, ફંક્શન() અમે ફંક્શનને કૉલ કરીએ છીએ અને ટોકન જનરેટ કરીએ છીએ.

લાઇન સ્થાનિક ટોકન = રેન્ડમ સ્ટ્રિંગ(32) 32 અક્ષરોની રેન્ડમ સ્ટ્રિંગ છે.
લાઇનમાં સ્થાનિક લાસ્ટ = box.space.example:len() અમે છેલ્લું તત્વ બહાર કાઢીએ છીએ.
અને લાઇનમાં box.space.example:insert{ last + 1, token } અમે અમારા ડેટાબેઝમાં ડેટા લખીએ છીએ, એટલે કે, અમે ફક્ત 1 દ્વારા ID વધારીએ છીએ. આ ફક્ત આ અણઘડ રીતે જ નહીં, પણ થઈ શકે છે. ટેરેન્ટુલામાં આ માટે સિક્વન્સ છે.

અમે ત્યાં ટોકન લખીએ છીએ.

આમ, અમે એક ફાઇલમાં અરજી લખી. તમે ત્યાં ડેટાની સીધી હેરફેર કરી શકો છો, અને બોક્સ મોડ્યુલ તમારા માટે તમામ ગંદા કામ કરશે.

તે 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:/#

/count અમને 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