@@ -11,46 +11,46 @@ box.info.synchro
11
11
Since version :doc: `2.8.1 </release/2.8.1 >`.
12
12
Show the current state of synchronous replication.
13
13
14
- In :ref: `synchronous replication <repl_sync >`, a transaction is considered committed only after achieving
14
+ In :ref: `synchronous replication <repl_sync >`, transaction is considered committed only after achieving
15
15
the required quorum number.
16
- While the transactions are collecting confirmations from remote nodes, these transactions are waiting in the queue.
16
+ While transactions are collecting confirmations from remote nodes, these transactions are waiting in the queue.
17
17
18
18
The following information is provided:
19
19
20
20
* ``queue ``:
21
21
22
- - ``owner `` -- ID of the replica that owns the synchronous transaction queue.
23
- Once an owner instance appears, all other instances become read-only.
24
- If the ``owner `` field is ``0 ``, then every instance is writeable ,
22
+ - ``owner `` (since version :doc: ` 2.10.0 < /release/2.10.0 >`) -- ID of the replica that owns the synchronous
23
+ transaction queue. Once an owner instance appears, all other instances become read-only.
24
+ If the ``owner `` field is ``0 ``, then every instance may be writable ,
25
25
but they can't create any synchronous transactions.
26
26
To claim or reclaim the queue, use :ref: `box.ctl.promote() <box_ctl-promote >` on the instance that you want
27
27
to promote.
28
- With elections enabled, the instance runs ``box.ctl.promote() `` automatically after winning the elections.
29
- Since version :doc: `2.10.0 </release/2.10.0 >`.
28
+ With elections enabled, an instance runs ``box.ctl.promote() `` command automatically after winning the elections.
30
29
31
- - ``term `` -- current queue term.
32
- It contains the term of the last ``PROMOTE ``.
33
- Usually it is equal to :ref: `box.info.election.term <box_info_election >`.
30
+ - ``term `` (since version :doc: ` 2.10.0 < /release/2.10.0 >`) -- current queue term.
31
+ It contains the term of the last ``PROMOTE `` request .
32
+ Usually, it is equal to :ref: `box.info.election.term <box_info_election >`.
34
33
However, the queue term value may be less than the corresponding one in the election term.
35
- It can happen when a new round of elections started, but no one has promoted yet.
36
- Since version :doc: `2.10.0 </release/2.10.0 >`.
34
+ It can happen when a new round of elections started, but no instance has been promoted yet.
37
35
38
36
- ``len `` -- current number of entries that are waiting in the queue.
39
37
40
- - ``busy `` -- the boolean value is set to ``true `` if there is a synchronous transaction in progress.
41
- Until the active transaction is complete, any other incoming synchronous transactions will be delayed.
42
- Since version :doc: `2.10.0 </release/2.10.0 >`.
38
+ - ``busy `` (since version :doc: `2.10.0 </release/2.10.0 >`) -- the boolean value is ``true ``
39
+ when the instance is processing or writing some system request that modifies the queue
40
+ (for example, ``PROMOTE ``, ``CONFIRM ``, or ``ROLLBACK ``).
41
+ Until the request is complete, any other incoming synchronous transactions and system requests
42
+ will be delayed.
43
43
44
44
* ``quorum `` -- evaluated value of the
45
45
:ref: `replication_synchro_quorum <cfg_replication-replication_synchro_quorum >` configuration option.
46
46
Since version :doc: `2.5.3 </release/2.5.3 >`, the option can be set as a dynamic formula.
47
- In this case, the value in the ``quorum `` member depends on the current number of replicas.
47
+ In this case, the value of the ``quorum `` member depends on the current number of replicas.
48
48
49
49
**Example 1: **
50
50
51
51
In this example, the ``quorum `` field is equal to ``1 ``.
52
- This means that the synchronous transactions work like asynchronous.
53
- `1 ` means that successful WAL write to the master is enough to commit.
52
+ That is, synchronous transactions work like asynchronous ones .
53
+ `1 ` means that a successful WAL writing to the master is enough to commit.
54
54
55
55
.. code-block :: tarantoolsession
56
56
@@ -97,7 +97,7 @@ box.info.synchro
97
97
tarantool> s = box.schema.space.create("sync", {is_sync=true})
98
98
tarantool> _ = s:create_index('pk')
99
99
100
- After that, use ``box.ctl.promote `` function to claim the queue:
100
+ After that, use ``box.ctl.promote() `` function to claim a queue:
101
101
102
102
.. code-block :: tarantoolsession
103
103
0 commit comments