Skip to content

Commit 21d32bc

Browse files
Editorial update
1 parent 343fb7b commit 21d32bc

File tree

3 files changed

+16
-9
lines changed

3 files changed

+16
-9
lines changed

modules/ROOT/content-nav.adoc

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -5,6 +5,8 @@
55
** xref:actions/transaction-flow.adoc[]
66
** xref:actions/query-format.adoc[]
77
** xref:actions/result-format.adoc[]
8+
** xref:actions/routing.adoc[]
9+
** xref:actions/transaction-configuration.adoc[]
810
** xref:actions/begin-a-transaction.adoc[]
911
** xref:actions/execute-statements-in-an-open-transaction.adoc[]
1012
** xref:actions/reset-transaction-timeout-of-an-open-transaction.adoc[]

modules/ROOT/pages/actions/routing.adoc

Lines changed: 5 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -19,7 +19,9 @@ The level of support depends on whether link:https://neo4j.com/docs/operations-m
1919
|Clusters support routing for queries that involve a xref::/actions/begin-and-commit-a-transaction-in-one-request.adoc[single request] (i.e. via the `tx/commit` endpoint).
2020
This is because the cluster does not currently support transaction identifiers across the cluster.
2121

22-
By default, all transactions are considered `WRITE` transactions, even if they contain no Cypher with write operations. This can be overridden by setting a value of `READ` in the `access-mode` header of the request (see xref::/actions/transaction-configuration.adoc[Transaction Configuration - Access Mode]).
22+
By default, all transactions are considered `WRITE` transactions, even if they contain no Cypher with write operations.
23+
This can be overridden by setting a value of `READ` in the `access-mode` header of the request (For more information, see xref::/actions/transaction-configuration.adoc[Transaction Configuration - Access Mode]).
2324

24-
This default has the effect that all queries are ultimately executed on the leader. To ensure efficient load balancing of `READ` transactions, you must label them as such in the request.
25-
|===
25+
This default value ensures that all queries are ultimately run on the leader.
26+
To ensure efficient load balancing of `READ` transactions, you should label them as such in the request.
27+
|===
Lines changed: 9 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,15 +1,18 @@
1-
[[http-api-actions-transaction-configuration]]
2-
31
:description: Configuring HTTP Transactions.
42

5-
3+
[[http-api-actions-transaction-configuration]]
64
= Transaction Configuration
75

8-
For any transaction initiating request (i.e. `/tx` or `tx/commit` ) you can provide configuration options that apply for the duration of the whole transaction.
6+
For any transaction-initiating request (such as `/tx` or `tx/commit`), you can provide configuration options that apply for the duration of the whole transaction.
97

108
== Access Mode
119
To ensure that efficient load balancing across a cluster, it is important to label transactions that only contain `READ` statements with a `READ` access mode.
1210

13-
This can be done by adding an `access-mode` header to the request with a value of `READ`.
11+
This can be done by adding an `access-mode` header to the request, with a value of `READ`.
12+
13+
[WARNING]
14+
====
15+
If an `access-mode` configuration has *not* been provided, the default value is `WRITE`.
1416
15-
The default value if an `access-mode` configuration has not been provided is `WRITE` (expect for clusters where Server-side routing has been disabled where it is `READ`).
17+
However, if you have clusters with link:https://neo4j.com/docs/operations-manual/current/clustering/internals/#clustering-routing[Server-side routing] disabled, the default value is `READ`.
18+
====

0 commit comments

Comments
 (0)