testing_project/Documentation: dev_guide/internals/iproto/streams — Russian @ Weblate: net_box = require('net.box') conn = net_box.connect('localhost:3302') stream = conn:new

Zen

	English	Russian	Actions
	:ref:`IPROTO_ROLLBACK <box_protocol-rollback>`
	0x10
	Rollback the transaction in the specified stream
	IPROTO_BEGIN
	Code: 0x0e.
	Begin a transaction in the specified stream. See :ref:`stream:begin() <net_box-stream_begin>`. The body is optional and can contain two items:
	IPROTO_TIMEOUT is an optional timeout (in seconds). After it expires, the transaction will be rolled back automatically.
	IPROTO_COMMIT
	Code: 0x0f.
	Commit the transaction in the specified stream. See :ref:`stream:commit() <net_box-stream_commit>`.
	IPROTO_ROLLBACK
	Codde: 0x10.
	Rollback the transaction in the specified stream. See :ref:`stream:rollback() <net_box-stream_rollback>`.
	Example
	Suppose that the client has started a stream with the :ref:`net.box module <net_box-module>`	Предположим, что клиент запустил стрим с помощью :ref:`модуля net.box<net_box-module>`.
	net_box = require('net.box') conn = net_box.connect('localhost:3302') stream = conn:new_stream()	net_box = require('net.box') conn = net_box.connect('localhost:3302') stream = conn:new_stream()
	At this point the stream object will look like a duplicate of the conn object, with just one additional member: ``stream_id``. Now, using stream instead of conn, the client sends two requests:	В этот момент объект ``stream`` будет выглядеть так же, как объект ``conn``, но включать один дополнительный элемент: ``stream_id``. Пусть теперь клиент, используя ``stream`` вместо ``conn``, отправит два запроса:
	stream.space.T:insert{1} stream.space.T:insert{2}	stream.space.T:insert{1} stream.space.T:insert{2}
	The header and body of these requests will be the same as in non-stream :ref:`IPROTO_INSERT <box_protocol-insert>` requests, except that the header will contain an additional item: IPROTO_STREAM_ID=0x0a with MP_UINT=0x01. It happens to equal 1 for this example because each call to conn:new_stream() assigns a new number, starting with 1.	Заголовок и тело этих запросов будут такими же, как в обычных запросах :ref:`IPROTO_INSERT <box_protocol-insert>`, но заголовок будет содержать дополнительный элемент ``IPROTO_STREAM_ID=0x0a``, где ``MP_UINT=0x01``. В этом примере значение IPROTO_STREAM_ID равно 1, так как при вызове ``conn:new_stream()`` идентификатору каждого нового стрима присваивается уникальное значение, начиная с 1.
	The client makes stream transactions by sending, in order:
	IPROTO_BEGIN with an optional transaction timeout in the IPROTO_TIMEOUT field of the request body.
	The transaction data-change and query requests.
	IPROTO_COMMIT or IPROTO_ROLLBACK.
	All these requests must contain the same IPROTO_STREAM_ID value.
	A rollback will happen automatically if a disconnect occurs or the transaction timeout expires before the commit is possible.
	Thus there are now multiple ways to do transactions: with ``net_box`` ``stream:begin()`` and ``stream:commit()`` or ``stream:rollback()`` which cause IPROTO_BEGIN and IPROTO_COMMIT or IPROTO_ROLLBACK with the current value of stream.stream_id; with :ref:`box.begin() <box-begin>` and :ref:`box.commit() <box-commit>` or :ref:`box.rollback() <box-rollback>`; with SQL and :ref:`START TRANSACTION <sql_start_transaction>` and :ref:`COMMIT <sql_commit>` or :ref:`ROLLBACK <sql_rollback>`. An application can use any or all of these ways.	Таким образом, у приложения есть несколько способов выполнять транзакции. Во-первых, можно использовать модуль ``net_box`` с методами ``stream:begin()`` и ``stream:commit()``/``stream:rollback()``, которые отправляют запросы IPROTO_BEGIN и IPROTO_COMMIT/IPROTO_ROLLBACK с текущим значением ``stream.stream_id``. Другой способ --- применять методы :ref:`box.begin() <box-begin>` и :ref:`box.commit() <box-commit>`/:ref:`box.rollback() <box-rollback>`. Наконец, можно пользоваться инструкциями SQL :ref:`START TRANSACTION <sql_start_transaction>` и :ref:`COMMIT <sql_commit>`/:ref:`ROLLBACK <sql_rollback>`.