Skip to content

Commit 58b8b55

Browse files
renetapopovaLojjsNataliaIvakinahvublidiazuin
authored
Publish 2025.10.1 (#403)
Co-authored-by: Louise Berglund <[email protected]> Co-authored-by: NataliaIvakina <[email protected]> Co-authored-by: Louise Söderström <[email protected]> Co-authored-by: Hannes Voigt <[email protected]> Co-authored-by: Lidia Zuin <[email protected]> Co-authored-by: Alex Fox Gill <[email protected]> Co-authored-by: Neil Dewhurst <[email protected]> Co-authored-by: Lasse Heemann <[email protected]> Co-authored-by: Gem Lamont <[email protected]> Co-authored-by: JoelBergstrand <[email protected]> Co-authored-by: Nick Giles <[email protected]> Co-authored-by: Therese Magnusson <[email protected]> Co-authored-by: ConorNeo <[email protected]> Co-authored-by: Balazs Lendvai <[email protected]> Co-authored-by: Satia Herfert <[email protected]> Co-authored-by: Olivia Ytterbrink <[email protected]> Co-authored-by: Greg Woods <[email protected]> Co-authored-by: MishaDemianenko <[email protected]> Co-authored-by: Antonio Barcélos <[email protected]> Co-authored-by: Evelina Danielsson <[email protected]> Co-authored-by: Pontus Melke <[email protected]>
1 parent 1bbfec2 commit 58b8b55

File tree

6 files changed

+199
-4
lines changed

6 files changed

+199
-4
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.09'
3+
version: '2025.10'
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.09'
11-
neo4j-version-exact: '2025.09.0'
12-
neo4j-buildnumber: '2025.09'
10+
neo4j-version: '2025.10'
11+
neo4j-version-exact: '2025.10.1'
12+
neo4j-buildnumber: '2025.10'

modules/ROOT/content-nav.adoc

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -266,6 +266,7 @@
266266
**** xref:errors/gql-errors/42I65.adoc[]
267267
**** xref:errors/gql-errors/42I66.adoc[]
268268
**** xref:errors/gql-errors/42I67.adoc[]
269+
**** xref:errors/gql-errors/42I68.adoc[]
269270
**** xref:errors/gql-errors/42N00.adoc[]
270271
**** xref:errors/gql-errors/42N01.adoc[]
271272
**** xref:errors/gql-errors/42N02.adoc[]
@@ -510,6 +511,7 @@
510511
**** xref:errors/gql-errors/52N41.adoc[]
511512
**** xref:errors/gql-errors/52U00.adoc[]
512513
*** xref:errors/gql-errors/index.adoc#function-exceptions[Function exceptions]
514+
**** xref:errors/gql-errors/53N33.adoc[]
513515
**** xref:errors/gql-errors/53N34.adoc[]
514516
**** xref:errors/gql-errors/53N35.adoc[]
515517
**** xref:errors/gql-errors/53N37.adoc[]
Lines changed: 30 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,30 @@
1+
:page-role: new-2025.10
2+
= 42I68
3+
4+
== Status description
5+
error: syntax error or access rule violation - mismatched pattern. Pattern, `{ <<input>>1 }`, does not match input, `{ <<input>>2 }`. Verify that the pattern is valid for constructing `{ <<valueType>> }`.
6+
7+
== Example scenario
8+
9+
For example, when parsing a duration string value:
10+
11+
[source,cypher]
12+
----
13+
RETURN duration("5 hours 12 minutes 15 seconds", "h 'hours' m 'minutes'") AS d
14+
----
15+
16+
You will receive an error with GQLSTATUS xref:errors/gql-errors/42001.adoc[42001].
17+
This error has a cause detailed in xref:errors/gql-errors/42I68.adoc[42I68] and status description:
18+
19+
20+
[source]
21+
----
22+
error: syntax error or access rule violation - mismatched pattern. Pattern, `"h 'hours' m 'minutes'"`, does not match input, `"5 hours 12 minutes 15 seconds"`. Verify that the pattern is valid for constructing `DURATION`.
23+
----
24+
25+
ifndef::backend-pdf[]
26+
[discrete.glossary]
27+
== Glossary
28+
29+
include::partial$glossary.adoc[]
30+
endif::[]
Lines changed: 29 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,29 @@
1+
:page-role: new-2025.10
2+
= 53N33
3+
4+
== Status description
5+
error: function exception - function invocation failed. Failed to invoke function `{ <<sig>> }` caused by: `{ <<msg>> }`
6+
7+
== Example scenario
8+
9+
For example, when parsing a duration string value:
10+
11+
[source,cypher]
12+
----
13+
RETURN duration({hours: 1}, "hh-mm-ss") as r
14+
----
15+
16+
You will receive an error with GQLSTATUS xref:errors/gql-errors/53N33.adoc[53N33] and status description:
17+
18+
19+
[source]
20+
----
21+
error: function exception - function invocation failed. Failed to invoke function duration(input :: ANY, pattern = DEFAULT_TEMPORAL_ARGUMENT :: STRING) :: DURATION caused by: A pattern can only be used in conjunction with a `STRING` input.
22+
----
23+
24+
ifndef::backend-pdf[]
25+
[discrete.glossary]
26+
== Glossary
27+
28+
include::partial$glossary.adoc[]
29+
endif::[]

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

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1092,6 +1092,11 @@ Status description:: error: syntax error or access rule violation - pattern pars
10921092

10931093
Status description:: error: syntax error or access rule violation - unsupported language feature. The query is a valid `CYPHER { <<feat>>2 }` query, but it is run in `CYPHER { <<feat>>1 }`. Consider changing the database default Cypher version using `ALTER DATABASE SET DEFAULT LANGUAGE` or prefix the query with `CYPHER { <<feat>>2 }`.
10941094

1095+
[role=label--new-2025.10]
1096+
=== xref:errors/gql-errors/42I68.adoc[42I68]
1097+
1098+
Status description:: error: syntax error or access rule violation - mismatched pattern. Pattern, `{ <<input>>1 }`, does not match input, `{ <<input>>2 }`. Verify that the pattern is valid for constructing `{ <<valueType>> }`.
1099+
10951100
[role=label--changed-2025.03]
10961101
=== xref:errors/gql-errors/42N00.adoc[42N00]
10971102

@@ -2084,6 +2089,11 @@ Status description:: error: procedure exception - custom procedure execution err
20842089
[[function-exceptions]]
20852090
== Function exceptions
20862091

2092+
[role=label--new-2025.10]
2093+
=== xref:errors/gql-errors/53N33.adoc[53N33]
2094+
2095+
Status description:: error: function exception - function invocation failed. Failed to invoke function `{ <<sig>> }` caused by: `{ <<msg>> }`
2096+
20872097
=== xref:errors/gql-errors/53N34.adoc[53N34]
20882098

20892099
Status description:: error: function exception - function restricted. `{ <<fun>> }` is restricted and accesses database internals. User-defined function restriction is controlled by the `dbms.security.procedures.unrestricted` setting. Only un-restrict user-defined functions you can trust with access to database internals.

modules/ROOT/pages/notifications/all-notifications.adoc

Lines changed: 124 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -3649,6 +3649,130 @@ m|SECURITY
36493649
m|WARNING
36503650
|===
36513651

3652+
[#_neo_clientnotification_security_oidccredentialforwardingnotenabled]
3653+
=== OIDC credential forwarding is not enabled
3654+
3655+
.Notification details
3656+
[cols="<1s,<4"]
3657+
|===
3658+
|Neo4j code
3659+
m|Neo.ClientNotification.Security.OidcCredentialForwardingNotEnabled
3660+
|Title
3661+
a|OIDC credential forwarding is not enabled.
3662+
|Description
3663+
a|Use setting 'dbms.security.allow_oidc_credential_forwarding_enabled' to enable OIDC credential forwarding.
3664+
|Category
3665+
m|SECURITY
3666+
|GQLSTATUS code
3667+
m|01N74
3668+
|Status description
3669+
|warn: OIDC credential forwarding disabled.
3670+
Use the setting `dbms.security.allow_oidc_credential_forwarding_enabled` to enable OIDC credential forwarding.
3671+
|Classification
3672+
m|SECURITY
3673+
|SeverityLevel
3674+
m|WARNING
3675+
|===
3676+
3677+
.Create a remote database alias with remote credentials set to OIDC credential forwarding when OIDC credential forwarding is not enabled.
3678+
[.tabbed-example]
3679+
=====
3680+
[.include-with-GQLSTATUS-code]
3681+
======
3682+
Command::
3683+
+
3684+
[source, cypher]
3685+
----
3686+
CREATE ALIAS `remote-neo4j` FOR DATABASE `neo4j` AT "neo4j+s://location:7687" OIDC CREDENTIAL FORWARDING
3687+
----
3688+
3689+
Returned GQLSTATUS code::
3690+
01N74
3691+
3692+
Returned status description::
3693+
warn: OIDC credential forwarding disabled.
3694+
Use the setting 'dbms.security.allow_oidc_credential_forwarding_enabled' to enable OIDC credential forwarding.
3695+
3696+
Suggestions for improvement::
3697+
The remote database alias has been successfully created, but OIDC credential forwarding is not enabled. To use the alias to connect to the remote Neo4j DBMS, allow OIDC credential forwarding by setting `dbms.security.allow_oidc_credential_forwarding_enabled` to `true`.
3698+
3699+
======
3700+
[.include-with-neo4j-code]
3701+
======
3702+
Command::
3703+
+
3704+
[source, cypher]
3705+
----
3706+
CREATE ALIAS `remote-neo4j` FOR DATABASE `neo4j` AT "neo4j+s://location:7687" OIDC CREDENTIAL FORWARDING
3707+
----
3708+
3709+
Suggestions for improvement::
3710+
The remote database alias has been successfully created, but OIDC credential forwarding is not enabled. To use the alias to connect to the remote Neo4j DBMS, allow OIDC credential forwarding by setting `dbms.security.allow_oidc_credential_forwarding_enabled` to `true`.
3711+
======
3712+
=====
3713+
3714+
[#_neo_clientnotification_security_shardedperformance]
3715+
=== Sharded privilege performance
3716+
3717+
.Notification details
3718+
[cols="<1s,<4"]
3719+
|===
3720+
|Neo4j code
3721+
m|Neo.ClientNotification.Security.ShardedPrivilegePerformance
3722+
|Title
3723+
a|Privilege with a severe performance impact on sharded databases.
3724+
|Description
3725+
a|The specified privilege severely reduces the performance of queries run on sharded databases. Consider excluding sharded databases for now.
3726+
|Category
3727+
m|SECURITY
3728+
|GQLSTATUS code
3729+
m|01N73
3730+
|Status description
3731+
|warn: sharded privilege performance.
3732+
The specified privilege severely reduces the performance of queries run on sharded databases. Consider excluding sharded databases for now.
3733+
|Classification
3734+
m|SECURITY
3735+
|SeverityLevel
3736+
m|WARNING
3737+
|===
3738+
3739+
.Grant a property access rule privilege on all databases
3740+
[.tabbed-example]
3741+
=====
3742+
[.include-with-GQLSTATUS-code]
3743+
======
3744+
Command::
3745+
+
3746+
[source, cypher]
3747+
----
3748+
GRANT TRAVERSE ON GRAPH * TO ROLE exampleRole
3749+
----
3750+
3751+
Returned GQLSTATUS code::
3752+
01N73
3753+
3754+
Returned status description::
3755+
warn: sharded privilege performance.
3756+
The specified privilege severely reduces the performance of queries run on sharded databases. Consider excluding sharded databases for now.
3757+
3758+
Suggestions for improvement::
3759+
Grant the privilege explicitly to databases instead of to all.
3760+
3761+
======
3762+
[.include-with-neo4j-code]
3763+
======
3764+
Command::
3765+
+
3766+
[source, cypher]
3767+
----
3768+
GRANT TRAVERSE ON GRAPH * TO ROLE exampleRole
3769+
----
3770+
3771+
Suggestions for improvement::
3772+
Grant the privilege explicitly to databases instead of to all.
3773+
======
3774+
=====
3775+
36523776

36533777
[#_topology_notifications]
36543778
== `TOPOLOGY` notifications

0 commit comments

Comments
 (0)