testing_project/Documentation: reference/reference_lua/net_box — Russian @ Weblate: ``require('net.box')`` -- to get a ``net.box`` object (named ``net

Translation

English

Russian

Needs editing

Skip

	English	Russian	Actions
	Module net.box	Модуль net.box
	Overview	Общие сведения
	The ``net.box`` module contains connectors to remote database systems. One variant, to be discussed later, is for connecting to MySQL or MariaDB or PostgreSQL (see :ref:`SQL DBMS modules <dbms_modules>` reference). The other variant, which is discussed in this section, is for connecting to Tarantool server instances via a network. For a quick start with ``net.box``, refer to the :ref:`tutorial <getting_started_net_box>`.	Модуль ``net.box`` включает в себя коннекторы для удаленных систем с базами данных. Одним из вариантов, который рассматривается позднее, является подключение к MySQL, MariaDB или PostgreSQL (см. справочник по :ref:`Модулям СУБД SQL <dbms_modules>`). Другим вариантом, который рассматривается в данном разделе, является подключение к экземплярам Tarantool-сервера по сети. Для быстрого знакомства с ``net.box`` вы можете обратиться к разделу :ref:`Начало работы с net.box <getting_started_net_box>`.
	You can call the following methods:	Можно вызвать следующие методы:
	``require('net.box')`` -- to get a ``net.box`` object (named ``net_box`` for examples in this section)	``require('net.box')`` -- для получения объекта ``net.box`` (который называется ``net_box`` для примеров в данном разделе);
	``net_box.connect()`` -- to connect and get a connection object (named ``conn`` for examples in this section)	``net_box.connect()`` -- для подключения и получения объекта подключения (который называется ``conn`` для примеров в данном разделе);
	other ``net.box()`` routines, passing ``conn:``, to execute requests on the remote database system	другие процедуры ``net.box()``, передающие ``conn:`` для выполнения запросов в удаленной системе базы данных;
	``conn:close`` -- to disconnect	``conn:close`` -- для отключения.
	All ``net.box`` methods are fiber-safe, that is, it is safe to share and use the same connection object across multiple concurrent fibers. In fact that is perhaps the best programming practice with Tarantool. When multiple fibers use the same connection, all requests are pipelined through the same network socket, but each fiber gets back a correct response. Reducing the number of active sockets lowers the overhead of system calls and increases the overall server performance. However for some cases a single connection is not enough -- for example, when it is necessary to prioritize requests or to use different authentication IDs.	Все методы ``net.box`` безопасны для файберов, то есть можно безопасно обмениваться и использовать один и тот же объект подключения в нескольких файберах одновременно. Фактически так лучше всего работать в Tarantool. Когда несколько файберов используют одно соединение, все запросы передаются по одному сетевому сокету, но каждый файбер получает правильный ответ. Уменьшение количества активных сокетов снижает затрату ресурсов на системные вызовы и увеличивает общую производительность сервера. Однако, в некоторых случаях отдельного соединения недостаточно --- например, когда необходимо отдавать приоритет разным запросам или использовать различные идентификаторы при аутентификации.
	Most ``net.box`` methods accept the last ``{options}`` argument, which can be:	В большинстве методов ``net.box`` можно использовать последний аргумент ``{options}``, который может быть следующим:
	``{timeout=...}``. For example, a method whose last argument is ``{timeout=1.5}`` will stop after 1.5 seconds on the local node, although this does not guarantee that execution will stop on the remote server node.	``{timeout=...}``. Например, метод с последним аргументом ``{timeout=1.5}`` остановится через 1,5 секунды на локальном узле, хотя это не гарантирует, что выполнение остановится на удаленном сервере.
	``{buffer=...}``. For an example, see the :ref:`buffer module <buffer-module>`.	``{buffer=...}``. Например, см. :ref:`модуль buffer <buffer-module>`.
	``{is_async=...}``. For example, a method whose last argument is ``{is_async=true}`` will not wait for the result of a request. See the :ref:`is_async <net_box-is_async>` description.	``{is_async=...}``. Например, метод с заключительным аргументом ``{is_async=true}`` не будет ждать результата выполнения запроса. См. описание :ref:`is_async <net_box-is_async>`.
	``{on_push=... on_push_ctx=...}``. For receiving out-of-band messages. See the :doc:`/reference/reference_lua/box_session/push` description.	``{on_push=... on_push_ctx=...}``. Для получения внеполосных сообщений. См. описание :doc:`/reference/reference_lua/box_session/push`.
	``{return_raw=...}`` (since version 2.10.0). If set to ``true``, net.box returns response data wrapped in a :ref:`MsgPack object <msgpack-object-info>` instead of decoding it to Lua. The default value is ``false``. For an example, see option description :ref:`below <net_box-return_raw>`.
	The diagram below shows possible connection states and transitions:	На диаграмме ниже представлены возможные состояния и варианты перехода из одного состояния в другое:
	net_states.png	net_states.svg
	On this diagram:	На этой диаграмме:
	``net_box.connect()`` method spawns a worker fiber, which will establish the connection and start the state machine.	Метод ``net_box.connect()`` запускает рабочий файбер, который устанавливает соединение и запускает рабочий процесс.
	The state machine goes to the ``initial`` state.	Работа начинается с начального состояния 'initial'.