The translation is temporarily closed for contributions due to maintenance, please come back later.
The translation was automatically locked due to following alerts: Could not merge the repository.
Zen

Translation

English
box.cfg{}
net_box = require('net.box')
conn = net_box.connect('localhost:3302')
109/790 · 79
English Russian Actions
Understanding the binary protocol
 
Overview
 
To communicate with each other, Tarantool instances use a binary protocol called iproto. To learn more, see the :ref:`Binary protocol <box_protocol>` section.
 
In this set of examples, the user will be looking at binary code transferred via iproto. The code is intercepted with ``tcpdump``, a monitoring utility.
 
Examples
Примеры
To follow the examples in this section, get a single Linux computer and start three command-line shells ("terminals").
Чтобы выполнить примеры, приведенные в этом разделе, запустите на компьютере с Linux три командных оболочки (терминала).
-- On terminal #1, Start monitoring port 3302 with `tcpdump <https://www.tcpdump.org/manpages/tcpdump.1.html>`_: |br|
-- На терминале №1 запустите мониторинг порта 3302 с помощью `tcpdump <https://www.tcpdump.org/manpages/tcpdump.1.html>`_: |br|
sudo tcpdump -i lo 'port 3302' -X
sudo tcpdump -i lo 'port 3302' -X
On terminal #2, start a server with:
На терминале №2 запустите сервер так:
box.cfg{listen=3302}
box.schema.space.create('tspace')
box.space.tspace:create_index('I')
box.space.tspace:insert{280}
box.schema.user.grant('guest','read,write,execute,create,drop','universe')
box.cfg{listen=3302}
box.schema.space.create('tspace')
box.space.tspace:create_index('I')
box.space.tspace:insert{280}
box.schema.user.grant('guest','read,write,execute,create,drop','universe')
On terminal #3, start another server, which will act as a client, with:
На терминале №3 запустите ещё один сервер, который будет выступать в качестве клиента, так:
box.cfg{}
net_box = require('net.box')
conn = net_box.connect('localhost:3302')
box.cfg{}
net_box = require('net.box')
conn = net_box.connect('localhost:3302')
conn.space.tspace:select(280)
IPROTO_SELECT
 
On terminal #3, run the following:
 
conn.space.tspace:select(280)
 
Now look at what tcpdump shows for the job connecting to 3302 -- the "request". After the words "length 32" is a packet that ends with these 32 bytes (we have added indented comments):
Теперь посмотрите, что tcpdump покажет для запроса на подключение к порту 3302. После слов «length 32» идет пакет, который заканчивается этими 32 байтами (комментарии отделены отступами):
ce 00 00 00 1b MP_UINT = decimal 27 = number of bytes after this
82 MP_MAP, size 2 (we'll call this "Main-Map")
01 IPROTO_SYNC (Main-Map Item#1)
04 MP_INT = 4 = number that gets incremented with each request
00 IPROTO_REQUEST_TYPE (Main-Map Item#2)
01 IPROTO_SELECT
86 MP_MAP, size 6 (we'll call this "Select-Map")
10 IPROTO_SPACE_ID (Select-Map Item#1)
cd 02 00 MP_UINT = decimal 512 = id of tspace (could be larger)
11 IPROTO_INDEX_ID (Select-Map Item#2)
00 MP_INT = 0 = id of index within tspace
14 IPROTO_ITERATOR (Select-Map Item#3)
00 MP_INT = 0 = Tarantool iterator_type.h constant ITER_EQ
13 IPROTO_OFFSET (Select-Map Item#4)
00 MP_INT = 0 = amount to offset
12 IPROTO_LIMIT (Select-Map Item#5)
ce ff ff ff ff MP_UINT = 4294967295 = biggest possible limit
20 IPROTO_KEY (Select-Map Item#6)
91 MP_ARRAY, size 1 (we'll call this "Key-Array")
cd 01 18 MP_UINT = 280 (Select-Map Item#6, Key-Array Item#1)
-- 280 is the key value that we are searching for
ce 00 00 00 1b MP_UINT = 27, десятичное число = число байт после этого
82 MP_MAP, размер 2 (назовем это Main-Map)
01 IPROTO_SYNC (1-й элемент Main-Map)
04 MP_INT = 4 = число, которое увеличивается на 1 с каждым запросом
00 IPROTO_REQUEST_TYPE (2-й элемент Main-Map)
01 IPROTO_SELECT
86 MP_MAP, размер 6 (назовем это Select-Map)
10 IPROTO_SPACE_ID (1-й элемент Select-Map)
cd 02 00 MP_UINT = 512, десятичное число = id tspace (может быть больше)
11 IPROTO_INDEX_ID (2-й элемент Select-Map)
00 MP_INT = 0 = id индекса в tspace
14 IPROTO_ITERATOR (3-й элемент Select-Map)
00 MP_INT = 0 = константа Tarantool iterator_type.h ITER_EQ
13 IPROTO_OFFSET (4-й элемент Select-Map)
00 MP_INT = 0 = смещение
12 IPROTO_LIMIT (5-й элемент Select-Map)
ce ff ff ff ff MP_UINT = 4294967295 = наибольший возможный предел
20 IPROTO_KEY (6-й элемент Select-Map)
91 MP_ARRAY, размер 1 (назовем это Key-Array)
cd 01 18 MP_UINT = 280 (6-й элемент Select-Map, 1-й элемент Key-Array)
-- 280, ключевое значение, которое мы ищем
Now read the source code file `net_box.c <https://github.com/tarantool/tarantool/blob/master/src/box/lua/net_box.c>`_ and skip to the line ``netbox_encode_select(lua_State *L)``. From the comments and from simple function calls like ``mpstream_encode_uint(&stream, IPROTO_SPACE_ID);`` you will be able to see how net_box put together the packet contents that you have just observed with tcpdump.
Теперь в файле исходного кода `net_box.c <https://github.com/tarantool/tarantool/blob/master/src/box/lua/net_box.c>`_ перейдите к строке ``netbox_encode_select(lua_State *L)``. Из комментариев и из простых вызовов функций типа ``mpstream_encode_uint(&stream, IPROTO_SPACE_ID);`` можно понять, как net_box собирает воедино содержимое пакета, описанного выше с помощью tcpdump.
There are libraries for reading and writing MessagePack objects. C programmers sometimes include `msgpuck.h <https://github.com/rtsisyk/msgpuck>`_.
Существуют библиотеки для чтения и записи объектов в формате MessagePack. Программисты на языке C иногда включают `msgpuck.h <https://github.com/rtsisyk/msgpuck>`_.
Now you know how Tarantool itself makes requests with the binary protocol. When in doubt about a detail, consult ``net_box.c`` -- it has routines for each request. Some :ref:`connectors <index-box_connectors>` have similar code.
Теперь вы знаете, как сам Tarantool выполняет запросы по бинарному протоколу. Если какие-то детали остаются неясными, обратитесь к файлу ``net_box.c``, где описаны процедуры для каждого запроса. Некоторые :ref:`коннекторы <index-box_connectors>` написаны аналогично.
IPROTO_UPDATE
 
For an IPROTO_UPDATE example, suppose a user changes field #2 in tuple #2 in space #256 to ``'BBBB'``. The body will look like this: (notice that in this case there is an extra map item IPROTO_INDEX_BASE, to emphasize that field numbers start with 1, which is optional and can be omitted):
Рассмотрим пример IPROTO_UPDATE. Предположим, пользователь изменяет поле №2 кортежа №2 в спейсе №256 на `'BBBB'``. Тело будет выглядеть так (обратите внимание, что в этом случае дополнительный необязательный элемент ассоциативного массива IPROTO_INDEX_BASE подчеркивает, что номера полей начинаются с 1 — это можно опустить):
04 IPROTO_UPDATE
85 IPROTO_MAP, size 5
10 IPROTO_SPACE_ID, Map Item#1
cd 02 00 MP_UINT 256
11 IPROTO_INDEX_ID, Map Item#2
00 MP_INT 0 = primary-key index number
15 IPROTO_INDEX_BASE, Map Item#3
01 MP_INT = 1 i.e. field numbers start at 1
21 IPROTO_TUPLE, Map Item#4
91 MP_ARRAY, size 1, for array of operations
93 MP_ARRAY, size 3
a1 3d MP_STR = OPERATOR = '='
02 MP_INT = FIELD_NO = 2
a5 42 42 42 42 42 MP_STR = VALUE = 'BBBB'
20 IPROTO_KEY, Map Item#5
91 MP_ARRAY, size 1, for array of key values
02 MP_UINT = primary-key value = 2
04 IPROTO_UPDATE
85 IPROTO_MAP, размер 5
10 IPROTO_SPACE_ID, 1-й элемент ассоциативного массива
cd 02 00 MP_UINT 256
11 IPROTO_INDEX_ID, 2-й элемент ассоциативного массива
00 MP_INT 0 = номер индекса первичного ключа
15 IPROTO_INDEX_BASE, 3-й элемент ассоциативного массива
01 MP_INT = 1, т.е. нумерация полей начинается с 1
21 IPROTO_TUPLE, 4-й элемент ассоциативного массива
91 MP_ARRAY, размер 1, для массива операций
93 MP_ARRAY, размер 3
a1 3d MP_STR = OPERATOR = '='
02 MP_INT = FIELD_NO = 2
a5 42 42 42 42 42 MP_STR = VALUE = 'BBBB'
20 IPROTO_KEY, 5--й элемент ассоциативного массива
91 MP_ARRAY, размер 1, для массива ключей
02 MP_UINT = значение первичного ключа = 2
IPROTO_EXECUTE
 
Byte codes for the :ref:`IPROTO_EXECUTE <box_protocol-execute>` example:
Пример байт-кода :ref:`IPROTO_EXECUTE <box_protocol-execute>`:
0b IPROTO_EXECUTE
83 MP_MAP, size 3
43 IPROTO_STMT_ID Map Item#1
ce d7 aa 74 1b MP_UINT value of n.stmt_id
41 IPROTO_SQL_BIND Map Item#2
92 MP_ARRAY, size 2
01 MP_INT = 1 = value for first parameter
a1 61 MP_STR = 'a' = value for second parameter
2b IPROTO_OPTIONS Map Item#3
90 MP_ARRAY, size 0 (there are no options)
0b IPROTO_EXECUTE
83 MP_MAP, размер 3
43 IPROTO_STMT_ID 1-й элемент ассоциативного массива
ce d7 aa 74 1b MP_UINT значение n.stmt_id
41 IPROTO_SQL_BIND 2-й элемент ассоциативного массива
92 MP_ARRAY, размер 2
01 MP_INT = 1 = значение первого параметра
a1 61 MP_STR = 'a' = значение второго параметра
2b IPROTO_OPTIONS 3-й элемент ассоциативного массива
90 MP_ARRAY, размер 0 (никакие опции не выбраны)
IPROTO_INSERT
 

Loading…

User avatar None

String updated in the repository

testing_project / Documentation: how-to/other/iproto — Russian

box.cfg{}
net_box = require('net.box')
conn = net_box.connect('localhost:3302')
box.cfg{}
net_box = require('net.box')
conn = net_box.connect('localhost:3302')
conn.space.tspace:select(280)
2 years ago
Browse all string changes

Things to check

Mismatching line breaks

Number of new lines in translation does not match source

Reset

Glossary

English Russian
No related strings found in the glossary.

String information

String age
2 years ago
Last updated
2 years ago
Source string age
2 years ago
Translation file
locale/ru/LC_MESSAGES/how-to/other/iproto.po, string 12