Skip to content

Commit 16e57f9

Browse files
renetapopovarenetapopova
authored
Merge branch 'dev' into dev-errors-cypherops
2 parents eabfbe9 + 798f0d3 commit 16e57f9

File tree

11 files changed

+251
-8
lines changed

11 files changed

+251
-8
lines changed

‎antora.yml‎

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,12 +1,12 @@
11
name: status-codes
22
title: Status Codes for Errors & Notifications
3-
version: '2025.10'
3+
version: '2025.11'
44
start_page: ROOT:index.adoc
55
nav:
66
- modules/ROOT/content-nav.adoc
77
asciidoc:
88
attributes:
99
page-origin-private: false
10-
neo4j-version: '2025.10'
11-
neo4j-version-exact: '2025.10.0'
12-
neo4j-buildnumber: '2025.10'
10+
neo4j-version: '2025.11'
11+
neo4j-version-exact: '2025.11.0'
12+
neo4j-buildnumber: '2025.11'

‎modules/ROOT/content-nav.adoc‎

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -175,6 +175,7 @@
175175
**** xref:errors/gql-errors/25N14.adoc[]
176176
**** xref:errors/gql-errors/25N15.adoc[]
177177
**** xref:errors/gql-errors/25N16.adoc[]
178+
**** xref:errors/gql-errors/25N17.adoc[]
178179
*** xref:errors/gql-errors/index.adoc#invalid-transaction-termination[Invalid transaction termination]
179180
**** xref:errors/gql-errors/2DN01.adoc[]
180181
**** xref:errors/gql-errors/2DN02.adoc[]
@@ -369,6 +370,7 @@
369370
**** xref:errors/gql-errors/42NA8.adoc[]
370371
**** xref:errors/gql-errors/42NA9.adoc[]
371372
**** xref:errors/gql-errors/42NAA.adoc[]
373+
**** xref:errors/gql-errors/42NAB.adoc[]
372374
**** xref:errors/gql-errors/42NAC.adoc[]
373375
**** xref:errors/gql-errors/42NFC.adoc[]
374376
**** xref:errors/gql-errors/42NFD.adoc[]
@@ -393,6 +395,8 @@
393395
**** xref:errors/gql-errors/50N20.adoc[]
394396
**** xref:errors/gql-errors/50N21.adoc[]
395397
**** xref:errors/gql-errors/50N23.adoc[]
398+
**** xref:errors/gql-errors/50N24.adoc[]
399+
**** xref:errors/gql-errors/50N25.adoc[]
396400
**** xref:errors/gql-errors/50N26.adoc[]
397401
**** xref:errors/gql-errors/50N42.adoc[]
398402
*** xref:errors/gql-errors/index.adoc#system-configuration-or-operation-exceptions[System configuration or operation exceptions]

‎modules/ROOT/pages/changelogs.adoc‎

Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,18 @@
11
:description: This page lists all changes to status codes per Neo4j version.
22
= Changes to status codes per Neo4j version
33

4+
== Neo4j 2025.11
5+
**New:**
6+
[options="header", cols="<1m,<1"]
7+
|===
8+
| GQLSTATUS
9+
| Neo4j code
10+
11+
| 01N83
12+
| Neo.ClientNotification.Request.UnsupportedType
13+
14+
|===
15+
416
== Neo4j 2025.01
517
**New:**
618
[options="header", cols="<1m,<1"]

‎modules/ROOT/pages/errors/gql-errors/25N17.adoc‎

Lines changed: 20 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,20 @@
1+
:page-role: new-2025.09
2+
= 25N17
3+
4+
== Status description
5+
error: invalid transaction state - implicit transaction required. The attempted operation requires an implicit transaction.
6+
7+
== Scenario
8+
9+
This error occurs when running a query using the `CALL { ... } IN TRANSACTIONS` construct in an explicit transaction.
10+
11+
== Possible solution
12+
13+
Make sure you use the driver API to create an implicit transaction, or, if using Browser/Query, use the `:auto` command.
14+
15+
ifndef::backend-pdf[]
16+
[discrete.glossary]
17+
== Glossary
18+
19+
include::partial$glossary.adoc[]
20+
endif::[]

‎modules/ROOT/pages/errors/gql-errors/42NAB.adoc‎

Lines changed: 48 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,48 @@
1+
:page-role: new-2025.11
2+
= 42NAB
3+
4+
== Status description
5+
error: syntax error or access rule violation - not supported standalone call. `WHERE` is not supported in a standalone call. Use `CALL ... YIELD ... WHERE ... RETURN ...` instead.
6+
7+
== Explanation
8+
A standalone call of a procedure does not support a `WHERE` clause, i.e., it does not support the filtering of the procedure result.
9+
Either remove the `WHERE` clause or add a `RETURN` clause after the call to turn it into an in-query call.
10+
11+
== Example scenario
12+
For example, trying to filter the result of the procedure `db.labels()` in a standalone call:
13+
14+
[source,cypher]
15+
----
16+
CALL db.labels() YIELD label WHERE label <> 'A'
17+
----
18+
19+
An error will be thrown with GQLSTATUS 42NAB and the following status description:
20+
21+
[source]
22+
----
23+
error: syntax error or access rule violation - not supported standalone call. WHERE is not supported in a standalone call. Use `CALL ... YIELD ... WHERE ... RETURN ...` instead.
24+
----
25+
26+
== Possible solutions
27+
28+
You can abstain from filtering to get a valid query:
29+
30+
[source,cypher]
31+
----
32+
CALL db.labels() YIELD label
33+
----
34+
35+
However, if you still want to filter the result of the procedure `db.labels()`, you can add a `RETURN` clause:
36+
37+
.Query
38+
[source, cypher]
39+
----
40+
CALL db.labels() YIELD label WHERE label <> 'A' RETURN label
41+
----
42+
43+
ifndef::backend-pdf[]
44+
[discrete.glossary]
45+
== Glossary
46+
47+
include::partial$glossary.adoc[]
48+
endif::[]

‎modules/ROOT/pages/errors/gql-errors/50N24.adoc‎

Lines changed: 19 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,19 @@
1+
:page-role: new-2025.11
2+
= 50N24
3+
4+
== Status description
5+
6+
error: general processing exception - sharded properties transaction handling database error. Unexpected exception while getting transaction state.
7+
8+
== Scenario
9+
10+
This error occurs when there is an issue on the graph shard while getting transaction state from a property shard.
11+
For example, the graph shard receives an unexpected response from a property shard.
12+
13+
14+
ifndef::backend-pdf[]
15+
[discrete.glossary]
16+
== Glossary
17+
18+
include::partial$glossary.adoc[]
19+
endif::[]

‎modules/ROOT/pages/errors/gql-errors/50N25.adoc‎

Lines changed: 19 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,19 @@
1+
:page-role: new-2025.11
2+
= 50N25
3+
4+
== Status description
5+
6+
error: general processing exception - sharded properties transaction handling client error. Unexpected exception while getting transaction state.
7+
8+
== Scenario
9+
10+
This error occurs when there is an issue on the graph shard while getting transaction state from a property shard.
11+
For example, the graph shard times out while waiting for transaction state from property shards.
12+
13+
14+
ifndef::backend-pdf[]
15+
[discrete.glossary]
16+
== Glossary
17+
18+
include::partial$glossary.adoc[]
19+
endif::[]

‎modules/ROOT/pages/errors/gql-errors/52N11.adoc‎

Lines changed: 18 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,24 @@
11
= 52N11
22

33
== Status description
4-
error: procedure exception - generic topology procedure error. An unexpected error has occurred. Please refer to the server's debug log for more information.
4+
error: procedure exception - generic topology procedure error. An unexpected error has occurred: `{ <<msg>> }`.
5+
6+
== Example scenario
7+
8+
For example, trying to set default number of primaries to 12:
9+
10+
[source,cypher]
11+
----
12+
CALL dbms.setDefaultAllocationNumbers(12,0);
13+
----
14+
15+
You will receive an error with GQLSTATUS xref:errors/gql-errors/52N02.adoc[52N02].
16+
This error has a cause detailed in xref:errors/gql-errors/52N11.adoc[52N11] and status description:
17+
18+
[source]
19+
----
20+
error: procedure exception - generic topology procedure error. An unexpected error has occurred: Number of primaries '12' may not exceed 11 and needs to be at least 1.
21+
----
522

623
ifndef::backend-pdf[]
724
[discrete.glossary]

‎modules/ROOT/pages/errors/gql-errors/52N17.adoc‎

Lines changed: 18 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,24 @@
11
= 52N17
22

33
== Status description
4-
error: procedure exception - quarantine change failed. Setting/removing the quarantine marker failed.
4+
error: procedure exception - quarantine change failed. Setting/removing the quarantine marker failed: `{ <<msg>> }`.
5+
6+
== Example scenario
7+
8+
For example, trying to lift a quarantine which does not exist:
9+
10+
[source,cypher]
11+
----
12+
CALL dbms.unquarantineDatabase("0c000000", "neo4j");
13+
----
14+
15+
You will receive an error with GQLSTATUS xref:errors/gql-errors/52N02.adoc[52N02].
16+
This error has a cause detailed in xref:errors/gql-errors/52N17.adoc[52N11] and status description:
17+
18+
[source]
19+
----
20+
error: quarantine change failed. Setting/removing the quarantine marker failed: Database 'neo4j' on server '0c000000-aa21-4ab4-b1c1-aed40bfcb875' is not in quarantine.
21+
----
522

623
ifndef::backend-pdf[]
724
[discrete.glossary]

‎modules/ROOT/pages/errors/gql-errors/index.adoc‎

Lines changed: 22 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -717,6 +717,11 @@ Status description:: error: invalid transaction state - transaction termination
717717

718718
Status description:: error: invalid transaction state - transaction termination transient error. The transaction has been terminated. Retry your operation in a new transaction, and you should see a successful result. Reson: `{ <<msg>> }`
719719

720+
[role=label--new-2025.09]
721+
=== xref:errors/gql-errors/25N17.adoc[25N17]
722+
723+
Status description:: error: invalid transaction state - implicit transaction required. The attempted operation requires an implicit transaction.
724+
720725

721726
[[invalid-transaction-termination]]
722727
== Invalid transaction termination
@@ -1508,6 +1513,11 @@ Status description:: error: syntax error or access rule violation - system datab
15081513

15091514
Status description:: error: syntax error or access rule violation - incorrectly formatted graph reference. Incorrectly formatted graph reference `{ <<input>> }`. Expected a single quoted or unquoted identifier. Separate name parts should not be quoted individually.
15101515

1516+
[role=label--new-2025.11]
1517+
=== xref:errors/gql-errors/42NAB.adoc[42NAB]
1518+
1519+
Status description:: error: syntax error or access rule violation - not supported standalone call. `WHERE` is not supported in a standalone call. Use `CALL ... YIELD ... WHERE ... RETURN ...` instead.
1520+
15111521
[role=label--new-2025.11]
15121522
=== xref:errors/gql-errors/42NAC.adoc[42NAC]
15131523

@@ -1607,11 +1617,21 @@ Status description:: error: general processing exception - no such schema descri
16071617

16081618
Status description:: error: general processing exception - transaction retry aborted. Transaction retry aborted after `{ <<count>> }` attempts. Retry timed out with a maximum retry duration of `{ <<timeAmount>> }` `{ <<timeUnit>> }`.
16091619

1620+
[role=label--new-2025.11]
1621+
=== xref:errors/gql-errors/50N24.adoc[50N24]
1622+
1623+
Status description:: error: general processing exception - sharded properties transaction handling database error. Unexpected exception while getting transaction state.
1624+
1625+
[role=label--new-2025.11]
1626+
=== xref:errors/gql-errors/50N25.adoc[50N25]
1627+
16101628
[role=label--new-2025.11]
16111629
=== xref:errors/gql-errors/50N26.adoc[50N26]
16121630

16131631
Status description:: error: general processing exception - invalid backup metadata script. The backup metadata script contains invalid syntax.
16141632

1633+
Status description:: error: general processing exception - sharded properties transaction handling client error. Unexpected exception while getting transaction state.
1634+
16151635
=== xref:errors/gql-errors/50N42.adoc[50N42]
16161636

16171637
Status description:: error: general processing exception - unexpected error. Unexpected error has occurred. See debug log for details.
@@ -1977,7 +1997,7 @@ Status description:: error: procedure exception - invalid address key. An addres
19771997

19781998
=== xref:errors/gql-errors/52N11.adoc[52N11]
19791999

1980-
Status description:: error: procedure exception - generic topology procedure error. An unexpected error has occurred. Please refer to the server's debug log for more information.
2000+
Status description:: error: procedure exception - generic topology procedure error. An unexpected error has occurred: `{ <<msg>> }`
19812001

19822002
=== xref:errors/gql-errors/52N12.adoc[52N12]
19832003

@@ -1997,7 +2017,7 @@ Status description:: error: procedure exception - invalid procedure argument lis
19972017

19982018
=== xref:errors/gql-errors/52N17.adoc[52N17]
19992019

2000-
Status description:: error: procedure exception - quarantine change failed. Setting/removing the quarantine marker failed.
2020+
Status description:: error: procedure exception - quarantine change failed. Setting/removing the quarantine marker failed: `{ <<msg>> }`
20012021

20022022
=== xref:errors/gql-errors/52N18.adoc[52N18]
20032023

0 commit comments

Comments
 (0)