Skip to content

Commit 664ac4a

Browse files
authored
Doc for TLI sysview (#16377)
1 parent add78ca commit 664ac4a

File tree

4 files changed

+292
-173
lines changed

4 files changed

+292
-173
lines changed

ydb/docs/en/core/concepts/glossary.md

Lines changed: 5 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -90,12 +90,13 @@ Technically, tablets are [actors](#actor) with a persistent state reliably saved
9090

9191
[Tablet implementation details](#tablet-implementation) and related terms, as well as [main tablet types](#tablet-types), are covered below in the advanced section.
9292

93-
### Distributed transactions {#distributed-transaction}
93+
### Transactions {#transactions}
9494

9595
{{ ydb-short-name }} implements **transactions** on two main levels:
9696

9797
* [Local database](#local-database) and the rest of [tablet infrastructure](#tablet-implementation) allow [tablets](#tablet) to manipulate their state using **local transactions** with [serializable isolation level](https://en.wikipedia.org/wiki/Isolation_%28database_systems%29#Serializable). Technically, they aren't really local to a single node as such a state persists remotely in [Distributed Storage](#distributed-storage).
9898
* In the context of {{ ydb-short-name }}, the term **distributed transactions** usually refers to transactions involving multiple tablets. For example, cross-table or even cross-row transactions are often distributed.
99+
* **Single-shard** transactions span a single tablet and are faster to complete. For example, transactions between rows in the same table partition are often single-shard.
99100

100101
Together, these mechanisms allow {{ ydb-short-name }} to provide [strict consistency](https://en.wikipedia.org/wiki/Consistency_model#Strict_consistency).
101102

@@ -601,7 +602,7 @@ A **channel** is a logical connection between a [tablet](#tablet) and [Distribut
601602

602603
### Distributed transactions implementation {#distributed-transaction-implementation}
603604

604-
Terms related to the implementation of [distributed transactions](#distributed-transaction) are explained below. The implementation itself is described in a separate article [{#T}](../contributor/datashard-distributed-txs.md).
605+
Terms related to the implementation of [distributed transactions](#transactions) are explained below. The implementation itself is described in a separate article [{#T}](../contributor/datashard-distributed-txs.md).
605606

606607
#### Deterministic transactions {#deterministic-transactions}
607608

@@ -627,15 +628,15 @@ In the case of read-only transactions, similar to "read uncommitted" in other da
627628

628629
#### Read-write set {#rw-set}
629630

630-
The **read-write set** or **RW set** is a set of data that will participate in executing a [distributed transaction](#distributed-transaction). It combines the read set, the data that will be read, and the write set, the data modifications to be carried out.
631+
The **read-write set** or **RW set** is a set of data that will participate in executing a [distributed transaction](#transactions). It combines the read set, the data that will be read, and the write set, the data modifications to be carried out.
631632

632633
#### Read set {#read-set}
633634

634635
The **read set** or **ReadSet data** is what participating shards forward during the transaction execution. In the case of data transactions, it may contain information about the state of [optimistic locks](#optimistic-locking), the readiness of the shard for commit, or the decision to cancel the transaction.
635636

636637
#### Transaction proxy {#transaction-proxy}
637638

638-
The **transaction proxy** or `TX_PROXY` is a service that orchestrates the execution of many [distributed transactions](#distributed-transaction): sequential phases, phase execution, planning, and aggregation of results. In the case of direct orchestration by other actors (for example, KQP data transactions), it is used for caching and allocation of unique [TxIDs](#txid).
639+
The **transaction proxy** or `TX_PROXY` is a service that orchestrates the execution of many [distributed transactions](#transactions): sequential phases, phase execution, planning, and aggregation of results. In the case of direct orchestration by other actors (for example, KQP data transactions), it is used for caching and allocation of unique [TxIDs](#txid).
639640

640641
#### Transaction flags {#txflags}
641642

0 commit comments

Comments
 (0)