From b8c24161075dfdd9e14429dcfd9b27b347e01669 Mon Sep 17 00:00:00 2001 From: Didar Shayarov Date: Mon, 18 May 2026 19:19:16 +0300 Subject: [PATCH 1/4] IGNITE-28688 Add missed transaction's system view descriptions doc --- .../monitoring-metrics/system-views.adoc | 50 +++++++++---------- 1 file changed, 25 insertions(+), 25 deletions(-) diff --git a/docs/_docs/monitoring-metrics/system-views.adoc b/docs/_docs/monitoring-metrics/system-views.adoc index fca31033d13a9..3cafc2ab11dd6 100644 --- a/docs/_docs/monitoring-metrics/system-views.adoc +++ b/docs/_docs/monitoring-metrics/system-views.adoc @@ -270,31 +270,31 @@ This view exposes information about currently running transactions. [{table_opts}] |=== |NAME | TYPE | DESCRIPTION -|ORIGINATING_NODE_ID | UUID | -|STATE | string | -|XID | UUID | -|LABEL | string | -|START_TIME | long | -|ISOLATION | string | -|CONCURRENCY | string | -|KEYS_COUNT | int | -|CACHE_IDS | string | -|COLOCATED | boolean | -|DHT | boolean | -|DURATION | long | -|IMPLICIT | boolean | -|IMPLICIT_SINGLE | boolean | -|INTERNAL | boolean | -|LOCAL | boolean | -|LOCAL_NODE_ID | UUID | -|NEAR | boolean | -|ONE_PHASE_COMMIT | boolean | -|OTHER_NODE_ID | UUID | -|SUBJECT_ID | UUID | -|SYSTEM | boolean | -|THREAD_ID | long | -|TIMEOUT | long | -|TOP_VER | string | +|ORIGINATING_NODE_ID | UUID | ID of the node that directly started the transaction +|STATE | string | Current transaction state +|XID | UUID | Unique transaction identifier +|LABEL | string | Transaction label +|START_TIME | long | Start time of the transaction on this node +|ISOLATION | string | Transaction isolation level +|CONCURRENCY | string | Transaction concurrency mode +|KEYS_COUNT | int | Number of cache keys participating in the transaction +|CACHE_IDS | string | Comma-separated IDs of caches participating in the transaction +|COLOCATED | boolean | `True` if the transaction is DHT colocated +|DHT | boolean | `True` if the transaction is DHT +|DURATION | long | Transaction duration in milliseconds +|IMPLICIT | boolean | `True` if the transaction was started implicitly +|IMPLICIT_SINGLE | boolean | `True` if the transaction is implicit with only one key +|INTERNAL | boolean | `True` if the transaction has at least one internal entry +|LOCAL | boolean | `True` if the transaction is local, `false` if it is remote +|LOCAL_NODE_ID | UUID | Local node ID +|NEAR | boolean | `True` if the transaction is near +|ONE_PHASE_COMMIT | boolean | `True` if the transaction is a one-phase-commit transaction +|OTHER_NODE_ID | UUID | ID of an additional node involved in the transaction +|SUBJECT_ID | UUID | ID of the subject that initiated the transaction +|SYSTEM | boolean | `True` if the transaction was started for a system cache +|THREAD_ID | long | ID of the thread in which the transaction started +|TIMEOUT | long | Transaction timeout in milliseconds +|TOP_VER | string | Topology version |=== == NODES From c89f4990c8cc1430d5b5f926cd12e3ff5cc743a2 Mon Sep 17 00:00:00 2001 From: Didar Shayarov Date: Wed, 27 May 2026 17:59:49 +0300 Subject: [PATCH 2/4] IGNITE-28688 Documentation: Add missed transaction's system view descriptions --- docs/_docs/SQL/sql-calcite.adoc | 2 ++ docs/_docs/monitoring-metrics/system-views.adoc | 12 +++++++----- 2 files changed, 9 insertions(+), 5 deletions(-) diff --git a/docs/_docs/SQL/sql-calcite.adoc b/docs/_docs/SQL/sql-calcite.adoc index 1f3368195bec8..d60a732cd66bc 100644 --- a/docs/_docs/SQL/sql-calcite.adoc +++ b/docs/_docs/SQL/sql-calcite.adoc @@ -960,6 +960,8 @@ The Calcite-based SQL engine currently supports the following user-facing functi |`TABLE(SYSTEM_RANGE(start, end[, increment]))` |Returns a table with one `BIGINT` column named `X` and one row for each value in the range. +|=== + === Supported Data Types Below are the data types supported by the Calcite-based SQL engine: diff --git a/docs/_docs/monitoring-metrics/system-views.adoc b/docs/_docs/monitoring-metrics/system-views.adoc index cd868f2428d2b..70fa35ba4d8a6 100644 --- a/docs/_docs/monitoring-metrics/system-views.adoc +++ b/docs/_docs/monitoring-metrics/system-views.adoc @@ -267,10 +267,12 @@ methods. The parameter is empty, if you use `IgniteCompute` APIs that don't targ This view exposes information about currently running transactions. +Each row in this view represents a transaction object on the node where the view is queried. A distributed transaction can be represented by several transaction objects on different nodes, such as near, DHT-local, and DHT-remote transaction objects. Therefore, rows for the same distributed transaction can differ from node to node. + [{table_opts}] |=== |NAME | TYPE | DESCRIPTION -|ORIGINATING_NODE_ID | UUID | ID of the node that directly started the transaction +|ORIGINATING_NODE_ID | UUID | |ORIGINATING_NODE_ID | UUID | ID of the node that initiated the current transaction object. For a transaction object mapped to a primary partition, this is the transaction initiator node; for a transaction object mapped to a backup partition, this is the node that owns the primary partition |STATE | string | Current transaction state |XID | UUID | Unique transaction identifier |LABEL | string | Transaction label @@ -280,12 +282,12 @@ This view exposes information about currently running transactions. |KEYS_COUNT | int | Number of cache keys participating in the transaction |CACHE_IDS | string | Comma-separated IDs of caches participating in the transaction |COLOCATED | boolean | `True` if the transaction is DHT colocated -|DHT | boolean | `True` if the transaction is DHT +|DHT | boolean | `True` if current node has data for this transaction |DURATION | long | Transaction duration in milliseconds |IMPLICIT | boolean | `True` if the transaction was started implicitly |IMPLICIT_SINGLE | boolean | `True` if the transaction is implicit with only one key -|INTERNAL | boolean | `True` if the transaction has at least one internal entry -|LOCAL | boolean | `True` if the transaction is local, `false` if it is remote +|INTERNAL | boolean | `True` if transaction operates with keys related to Ignite internal data structures +|LOCAL | boolean | `True` if this transaction object is on the initiator side or mapped to a primary partition, `false` if it is mapped to a backup partition |LOCAL_NODE_ID | UUID | Local node ID |NEAR | boolean | `True` if the transaction is near |ONE_PHASE_COMMIT | boolean | `True` if the transaction is a one-phase-commit transaction @@ -294,7 +296,7 @@ This view exposes information about currently running transactions. |SYSTEM | boolean | `True` if the transaction was started for a system cache |THREAD_ID | long | ID of the thread in which the transaction started |TIMEOUT | long | Transaction timeout in milliseconds -|TOP_VER | string | Topology version +|TOP_VER | string | Topology version assigned to the transaction. If not assigned explicitly, it is a topology version of the latest partition exchange. |=== == NODES From 1a9ae318844624c2f9408efaff2c82d4a6508879 Mon Sep 17 00:00:00 2001 From: Didar Shayarov <75740594+w3ll1ngt@users.noreply.github.com> Date: Wed, 27 May 2026 22:12:59 +0300 Subject: [PATCH 3/4] Apply suggestion from @sergey-chugunov-1985 Co-authored-by: Sergey Chugunov --- docs/_docs/monitoring-metrics/system-views.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/_docs/monitoring-metrics/system-views.adoc b/docs/_docs/monitoring-metrics/system-views.adoc index 70fa35ba4d8a6..7d36be18a1806 100644 --- a/docs/_docs/monitoring-metrics/system-views.adoc +++ b/docs/_docs/monitoring-metrics/system-views.adoc @@ -294,7 +294,7 @@ Each row in this view represents a transaction object on the node where the view |OTHER_NODE_ID | UUID | ID of an additional node involved in the transaction |SUBJECT_ID | UUID | ID of the subject that initiated the transaction |SYSTEM | boolean | `True` if the transaction was started for a system cache -|THREAD_ID | long | ID of the thread in which the transaction started +|THREAD_ID | long | ID of the thread started the transaction |TIMEOUT | long | Transaction timeout in milliseconds |TOP_VER | string | Topology version assigned to the transaction. If not assigned explicitly, it is a topology version of the latest partition exchange. |=== From de423424f14bb487dbaba3949798c0b6dad2a091 Mon Sep 17 00:00:00 2001 From: Didar Shayarov Date: Thu, 28 May 2026 11:16:25 +0300 Subject: [PATCH 4/4] IGNITE-28688 Documentation: Add missed transaction's system view descriptions --- docs/_docs/monitoring-metrics/system-views.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/_docs/monitoring-metrics/system-views.adoc b/docs/_docs/monitoring-metrics/system-views.adoc index 7d36be18a1806..93c72f3672d01 100644 --- a/docs/_docs/monitoring-metrics/system-views.adoc +++ b/docs/_docs/monitoring-metrics/system-views.adoc @@ -272,7 +272,7 @@ Each row in this view represents a transaction object on the node where the view [{table_opts}] |=== |NAME | TYPE | DESCRIPTION -|ORIGINATING_NODE_ID | UUID | |ORIGINATING_NODE_ID | UUID | ID of the node that initiated the current transaction object. For a transaction object mapped to a primary partition, this is the transaction initiator node; for a transaction object mapped to a backup partition, this is the node that owns the primary partition +|ORIGINATING_NODE_ID | UUID | ID of the node that initiated the current transaction object. For a transaction object mapped to a primary partition, this is the transaction initiator node; for a transaction object mapped to a backup partition, this is the node that owns the primary partition |STATE | string | Current transaction state |XID | UUID | Unique transaction identifier |LABEL | string | Transaction label