From 8845a33f158a8d03bbc55e4ccbddc9bf4f0edf9d Mon Sep 17 00:00:00 2001 From: Louise Berglund Date: Mon, 9 Jun 2025 11:18:44 +0200 Subject: [PATCH 1/9] Document new GQLSTATUS codes 51N76 and 42NAA --- modules/ROOT/content-nav.adoc | 2 + .../ROOT/pages/errors/gql-errors/42NAA.adoc | 44 +++++++++++++++++++ .../ROOT/pages/errors/gql-errors/51N76.adoc | 16 +++++++ 3 files changed, 62 insertions(+) create mode 100644 modules/ROOT/pages/errors/gql-errors/42NAA.adoc create mode 100644 modules/ROOT/pages/errors/gql-errors/51N76.adoc diff --git a/modules/ROOT/content-nav.adoc b/modules/ROOT/content-nav.adoc index 78adb891..78d96bfc 100644 --- a/modules/ROOT/content-nav.adoc +++ b/modules/ROOT/content-nav.adoc @@ -356,6 +356,7 @@ **** xref:errors/gql-errors/42NA7.adoc[] **** xref:errors/gql-errors/42NA8.adoc[] **** xref:errors/gql-errors/42NA9.adoc[] +**** xref:errors/gql-errors/42NAA.adoc[] **** xref:errors/gql-errors/42NFC.adoc[] **** xref:errors/gql-errors/42NFD.adoc[] **** xref:errors/gql-errors/42NFE.adoc[] @@ -454,6 +455,7 @@ **** xref:errors/gql-errors/51N72.adoc[] **** xref:errors/gql-errors/51N73.adoc[] **** xref:errors/gql-errors/51N74.adoc[] +**** xref:errors/gql-errors/51N76.adoc[] *** xref:errors/gql-errors/index.adoc#procedure-exceptions[Procedure exceptions] **** xref:errors/gql-errors/52N01.adoc[] **** xref:errors/gql-errors/52N02.adoc[] diff --git a/modules/ROOT/pages/errors/gql-errors/42NAA.adoc b/modules/ROOT/pages/errors/gql-errors/42NAA.adoc new file mode 100644 index 00000000..e1482291 --- /dev/null +++ b/modules/ROOT/pages/errors/gql-errors/42NAA.adoc @@ -0,0 +1,44 @@ += 42NAA + +== Status description +error: syntax error or access rule violation - incorrectly formatted graph reference. Incorrectly formatted graph reference `{ <> }`. Expected a single quoted or unquoted identifier. Separate name parts should not be quoted individually. + +== Explanation +As of Cypher 25, database names and aliases cannot include name parts that are quoted individually. +Either the whole name must be quoted, or the whole name must be unquoted. + +== Example scenario +For example, try to create a database with : + +[source,cypher] +---- +CREATE DATABASE `foo`.`bar` +---- + +An error will be thrown with GQLSTATUS 42NAA and the status description: + +[source] +---- +error: syntax error or access rule violation - incorrectly formatted graph reference. Incorrectly formatted graph reference '`foo`.`bar`'. Expected a single quoted or unquoted identifier. Separate name parts should not be quoted individually. +---- + +In this example scenario, the correct quoting would either be + +[source,cypher] +---- +CREATE DATABASE `foo.bar` +---- + +or + +[source,cypher] +---- +CREATE DATABASE foo.bar +---- + +ifndef::backend-pdf[] +[discrete.glossary] +== Glossary + +include::partial$glossary.adoc[] +endif::[] diff --git a/modules/ROOT/pages/errors/gql-errors/51N76.adoc b/modules/ROOT/pages/errors/gql-errors/51N76.adoc new file mode 100644 index 00000000..3ac2df2a --- /dev/null +++ b/modules/ROOT/pages/errors/gql-errors/51N76.adoc @@ -0,0 +1,16 @@ += 51N76 + + +== Status description +error: system configuration or operation exception - upgrade failed. The upgrade to a new Neo4j version failed. + +== Explanation +This error code can occur during a dbms upgrade to a new Neo4j version, in the rare case that something in the user's setup or dbms environment prevented the dbms from upgrading. +The error will be accompanied by a cause with a more concrete GQLSTATUS, describing what the user needs to change before retrying the upgrade. + +ifndef::backend-pdf[] +[discrete.glossary] +== Glossary + +include::partial$glossary.adoc[] +endif::[] From dcee79f142ab5e2643486813951d457de0df0ccf Mon Sep 17 00:00:00 2001 From: Louise Berglund Date: Tue, 10 Jun 2025 15:32:28 +0200 Subject: [PATCH 2/9] Document changes to graph reference deprecations. --- .../notifications/all-notifications.adoc | 136 +++++++++++++++++- 1 file changed, 135 insertions(+), 1 deletion(-) diff --git a/modules/ROOT/pages/notifications/all-notifications.adoc b/modules/ROOT/pages/notifications/all-notifications.adoc index 9b7f2912..852104b4 100644 --- a/modules/ROOT/pages/notifications/all-notifications.adoc +++ b/modules/ROOT/pages/notifications/all-notifications.adoc @@ -1246,8 +1246,10 @@ To continue using it, escape the identifier by adding backticks around the ident To continue using it, escape the identifier by adding backticks around the identifier `%s`. - label:new[Valid for Neo4j 5.5-5.25] All subqueries in a UNION [ALL] should have the same ordering for the return columns. Using differently ordered return items in a UNION [ALL] clause is deprecated and will be removed in a future version. -- Databases and aliases with unescaped `.` are deprecated unless to indicate that they belong to a composite database. +- label:new[Valid for Neo4j 5.26-2025.05] Databases and aliases with unescaped `.` are deprecated unless to indicate that they belong to a composite database. Names containing `.` should be escaped. (`%s`) +- label:new[Valid from 2025.06] Graph references with separately backticked name parts (`%s`) are deprecated. In future Cypher versions, use parameters or backtick the entire name (`%s`). +- label:new[Valid from 2025.06] Graph references with separately backticked name parts (`%s`) are deprecated. In future Cypher versions, remove the backticks (`%s`). |Category m|DEPRECATION |GQLSTATUS code @@ -1260,6 +1262,124 @@ m|DEPRECATION m|WARNING |=== +[#_graph_reference_deprecation] +.Using separately backticked name parts in graph references +[.tabbed-example] +===== +[.include-with-GQLSTATUS-code] +====== +Query:: ++ +[source,cypher] +---- +CYPHER 5 CREATE ALIAS `foo`.`bar` FOR DATABASE ... +---- + +Returned GQLSTATUS code:: +01N00 + +Returned status description:: +warn: feature deprecated. +Graph references with separately backticked name parts (\`foo`.\`bar`) are deprecated. In future Cypher versions, use parameters or backtick the entire name (\`foo.bar`). + +Suggestions for improvement:: +In newer Cypher versions, either the whole graph reference name should be backticked or it should be sent in as a parameter. ++ +[source,cypher] +---- +CYPHER 25 CREATE ALIAS `foo.bar` FOR DATABASE ... +---- ++ +[source,cypher] +---- +CYPHER 25 CREATE ALIAS $param FOR DATABASE ... +---- +For more information on the semantics of graph references, see link:https://neo4j.com/docs/cypher-manual/current/values-and-types/graph-references[Cypher manual -> Graph references]. + +====== +[.include-with-neo4j-code] +====== +Query:: ++ +[source,cypher] +---- +CYPHER 5 CREATE ALIAS `foo`.`bar` FOR DATABASE ... +---- + +Description of the returned code:: +Graph references with separately backticked name parts (\`foo`.\`bar`) are deprecated. In future Cypher versions, use parameters or backtick the entire name (\`foo.bar`). + +Suggestions for improvement:: +In newer Cypher versions, either the whole graph reference name should be backticked or it should be sent in as a parameter. ++ +[source,cypher] +---- +CYPHER 25 CREATE ALIAS `foo.bar` FOR DATABASE ... +---- ++ +[source,cypher] +---- +CYPHER 25 CREATE ALIAS $param FOR DATABASE ... +---- +For more information on the semantics of graph references, see link:https://neo4j.com/docs/cypher-manual/current/values-and-types/graph-references[Cypher manual -> Graph references]. + +====== +===== + +[#_graph_reference_deprecation_use] +.Using separately backticked name parts in graph references in USE clause +[.tabbed-example] +===== +[.include-with-GQLSTATUS-code] +====== +Query:: ++ +[source,cypher] +---- +CYPHER 5 USE graph.byName("`a.b`.c") ... +---- + +Returned GQLSTATUS code:: +01N00 + +Returned status description:: +warn: feature deprecated. +Graph references with separately backticked name parts (\`a.b`.\`c`) are deprecated. In future Cypher versions, remove the backticks (a.b.c). + +Suggestions for improvement:: +In newer Cypher versions, the backticks should be removed. ++ +[source,cypher] +---- +CYPHER 25 USE graph.byName("a.b.c") ... +---- +For more information on the semantics of graph references, see link:https://neo4j.com/docs/cypher-manual/current/values-and-types/graph-references[Cypher manual -> Graph references]. + +====== +[.include-with-neo4j-code] +====== +Query:: ++ +[source,cypher] +---- +CYPHER 5 USE graph.byName("`a.b`.c") ... +---- + +Description of the returned code:: +Graph references with separately backticked name parts (\`a.b`.\`c`) are deprecated. In future Cypher versions, remove the backticks (a.b.c). + +Suggestions for improvement:: +In newer Cypher versions, the backticks should be removed. ++ +[source,cypher] +---- +CYPHER 25 USE graph.byName("a.b.c") ... +---- +For more information on the semantics of graph references, see link:https://neo4j.com/docs/cypher-manual/current/values-and-types/graph-references[Cypher manual -> Graph references]. + +====== +===== + .Create a database with an unescaped name containing a dot [.tabbed-example] ===== @@ -1311,6 +1431,20 @@ CREATE DATABASE `foo.bar` ====== ===== +[NOTE] +==== +Databases and aliases with unescaped `.` are deprecated in versions 5.26 to 2025.05. +However, starting from version 2025.06, this deprecation has been withdrawn, and replaced by two new deprecations. +The reason for this change is that the previous quoting rules have been found inconsistent and ambiguous, and will be improved starting from Cypher 25. +For more information, see: + +<<_graph_reference_deprecation>> + +<<_graph_reference_deprecation_use>> + +link:https://neo4j.com/docs/cypher-manual/current/values-and-types/graph-references[Cypher manual -> Graph references]. +==== + .Using differently ordered return items in a `UNION` clause [.tabbed-example] ===== From 282921fa87909307b11a70da60c1c0d87c1825fb Mon Sep 17 00:00:00 2001 From: Louise Berglund Date: Mon, 16 Jun 2025 14:37:58 +0200 Subject: [PATCH 3/9] Improve 42NAA docs: - Mention parameters as the recommended approach - Change example to use CREATE ALIAS instead of CREATE DATABASE - Make it clearer which example queries only applies to Cypher 25 --- .../ROOT/pages/errors/gql-errors/42NAA.adoc | 29 +++++++++++++++---- 1 file changed, 23 insertions(+), 6 deletions(-) diff --git a/modules/ROOT/pages/errors/gql-errors/42NAA.adoc b/modules/ROOT/pages/errors/gql-errors/42NAA.adoc index e1482291..aa442cc7 100644 --- a/modules/ROOT/pages/errors/gql-errors/42NAA.adoc +++ b/modules/ROOT/pages/errors/gql-errors/42NAA.adoc @@ -6,34 +6,51 @@ error: syntax error or access rule violation - incorrectly formatted graph refer == Explanation As of Cypher 25, database names and aliases cannot include name parts that are quoted individually. Either the whole name must be quoted, or the whole name must be unquoted. +A recommended approach, which is consistent between different commands and Cypher versions, is to send in the database name or alias as a parameter rather than a string literal. == Example scenario -For example, try to create a database with : +For example, try to create a database with [source,cypher] ---- -CREATE DATABASE `foo`.`bar` +CYPHER 25 CREATE ALIAS `foo`.`bar` FOR DATABASE baz ---- -An error will be thrown with GQLSTATUS 42NAA and the status description: +An error will be thrown with GQLSTATUS 42NAA and the status description [source] ---- error: syntax error or access rule violation - incorrectly formatted graph reference. Incorrectly formatted graph reference '`foo`.`bar`'. Expected a single quoted or unquoted identifier. Separate name parts should not be quoted individually. ---- -In this example scenario, the correct quoting would either be +In this example scenario, the preferred way is to send in the alias name as a parameter + +.Parameters +[source, parameters] +---- +{ + "aliasName": "foo.bar" +} +---- + +.Query +[source, cypher] +---- +CREATE ALIAS $aliasName FOR DATABASE baz +---- + +Alternatively, if a string literal is used, the correct quoting for Cypher 25 would either be [source,cypher] ---- -CREATE DATABASE `foo.bar` +CYPHER 25 CREATE ALIAS `foo.bar` FOR DATABASE baz ---- or [source,cypher] ---- -CREATE DATABASE foo.bar +CYPHER 25 CREATE ALIAS foo.bar FOR DATABASE baz ---- ifndef::backend-pdf[] From d46ce145c93aed93705abee04c70bb8cdf5d6bb5 Mon Sep 17 00:00:00 2001 From: Louise Berglund Date: Thu, 19 Jun 2025 15:56:35 +0200 Subject: [PATCH 4/9] Update links to point at Cypher 25 docs for graph references (to be published in 2025.06) --- .../ROOT/pages/notifications/all-notifications.adoc | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/modules/ROOT/pages/notifications/all-notifications.adoc b/modules/ROOT/pages/notifications/all-notifications.adoc index 852104b4..4e65b665 100644 --- a/modules/ROOT/pages/notifications/all-notifications.adoc +++ b/modules/ROOT/pages/notifications/all-notifications.adoc @@ -1294,7 +1294,7 @@ CYPHER 25 CREATE ALIAS `foo.bar` FOR DATABASE ... ---- CYPHER 25 CREATE ALIAS $param FOR DATABASE ... ---- -For more information on the semantics of graph references, see link:https://neo4j.com/docs/cypher-manual/current/values-and-types/graph-references[Cypher manual -> Graph references]. +For more information on the semantics of graph references, see link:https://neo4j.com/docs/cypher-manual/25/values-and-types/graph-references[Cypher manual -> Graph references]. ====== [.include-with-neo4j-code] @@ -1321,7 +1321,7 @@ CYPHER 25 CREATE ALIAS `foo.bar` FOR DATABASE ... ---- CYPHER 25 CREATE ALIAS $param FOR DATABASE ... ---- -For more information on the semantics of graph references, see link:https://neo4j.com/docs/cypher-manual/current/values-and-types/graph-references[Cypher manual -> Graph references]. +For more information on the semantics of graph references, see link:https://neo4j.com/docs/cypher-manual/25/values-and-types/graph-references[Cypher manual -> Graph references]. ====== ===== @@ -1353,7 +1353,7 @@ In newer Cypher versions, the backticks should be removed. ---- CYPHER 25 USE graph.byName("a.b.c") ... ---- -For more information on the semantics of graph references, see link:https://neo4j.com/docs/cypher-manual/current/values-and-types/graph-references[Cypher manual -> Graph references]. +For more information on the semantics of graph references, see link:https://neo4j.com/docs/cypher-manual/25/values-and-types/graph-references[Cypher manual -> Graph references]. ====== [.include-with-neo4j-code] @@ -1375,7 +1375,7 @@ In newer Cypher versions, the backticks should be removed. ---- CYPHER 25 USE graph.byName("a.b.c") ... ---- -For more information on the semantics of graph references, see link:https://neo4j.com/docs/cypher-manual/current/values-and-types/graph-references[Cypher manual -> Graph references]. +For more information on the semantics of graph references, see link:https://neo4j.com/docs/cypher-manual/25/values-and-types/graph-references[Cypher manual -> Graph references]. ====== ===== @@ -1442,7 +1442,7 @@ For more information, see: <<_graph_reference_deprecation_use>> -link:https://neo4j.com/docs/cypher-manual/current/values-and-types/graph-references[Cypher manual -> Graph references]. +link:https://neo4j.com/docs/cypher-manual/25/values-and-types/graph-references[Cypher manual -> Graph references]. ==== .Using differently ordered return items in a `UNION` clause From f8c059af59acc06356362646c829be7645241e3b Mon Sep 17 00:00:00 2001 From: Reneta Popova Date: Tue, 1 Jul 2025 13:57:15 +0100 Subject: [PATCH 5/9] editorial updates --- modules/ROOT/pages/errors/gql-errors/42NAA.adoc | 8 +++++--- modules/ROOT/pages/errors/gql-errors/index.adoc | 8 ++++++++ 2 files changed, 13 insertions(+), 3 deletions(-) diff --git a/modules/ROOT/pages/errors/gql-errors/42NAA.adoc b/modules/ROOT/pages/errors/gql-errors/42NAA.adoc index aa442cc7..2365ee3b 100644 --- a/modules/ROOT/pages/errors/gql-errors/42NAA.adoc +++ b/modules/ROOT/pages/errors/gql-errors/42NAA.adoc @@ -9,21 +9,23 @@ Either the whole name must be quoted, or the whole name must be unquoted. A recommended approach, which is consistent between different commands and Cypher versions, is to send in the database name or alias as a parameter rather than a string literal. == Example scenario -For example, try to create a database with +For example, try to create a database with using the following Cypher 25 command: [source,cypher] ---- CYPHER 25 CREATE ALIAS `foo`.`bar` FOR DATABASE baz ---- -An error will be thrown with GQLSTATUS 42NAA and the status description +An error will be thrown with GQLSTATUS 42NAA and the following status description: [source] ---- error: syntax error or access rule violation - incorrectly formatted graph reference. Incorrectly formatted graph reference '`foo`.`bar`'. Expected a single quoted or unquoted identifier. Separate name parts should not be quoted individually. ---- -In this example scenario, the preferred way is to send in the alias name as a parameter +== Possible solutions + +To resolve this issue, the preferred way is to send in the alias name as a parameter: .Parameters [source, parameters] diff --git a/modules/ROOT/pages/errors/gql-errors/index.adoc b/modules/ROOT/pages/errors/gql-errors/index.adoc index 4493c775..e1e914d4 100644 --- a/modules/ROOT/pages/errors/gql-errors/index.adoc +++ b/modules/ROOT/pages/errors/gql-errors/index.adoc @@ -1446,6 +1446,10 @@ Status description:: error: syntax error or access rule violation - invalid refe Status description:: error: syntax error or access rule violation - system database procedure rules. The system database supports a restricted set of Cypher clauses. The supported clause structure for procedure calls is: `CALL`, `YIELD`, `RETURN`. `YIELD` and `RETURN` clauses are optional. The order of the clauses is fixed and each can only occur once. +=== xref:errors/gql-errors/42NAA.adoc[42NAA] + +Status description:: error: syntax error or access rule violation - incorrectly formatted graph reference. Incorrectly formatted graph reference `{ <> }`. Expected a single quoted or unquoted identifier. Separate name parts should not be quoted individually. + === xref:errors/gql-errors/42NFC.adoc[42NFC] Status description:: error: syntax error or access rule violation - auth info validation error. Authentication and/or authorization could not be validated. See security logs for details. @@ -1846,6 +1850,10 @@ Status description:: error: system configuration or operation exception - transa Status description:: error: system configuration or operation exception - maximum number of transactions reached. Failed to start a new transaction. The limit of concurrent transactions is reached. Increase the number of concurrent transactions using `{ <> }` in the neo4j.conf file. +=== xref:errors/gql-errors/51N76.adoc[51N76] + +Status description:: error: system configuration or operation exception - upgrade failed. The upgrade to a new Neo4j version failed. + [[procedure-exceptions]] == Procedure exceptions From 23a676de1375ff38a811143e4d481eb4aba31af3 Mon Sep 17 00:00:00 2001 From: Reneta Popova Date: Wed, 2 Jul 2025 14:27:54 +0100 Subject: [PATCH 6/9] replace the labels with text --- .../ROOT/pages/notifications/all-notifications.adoc | 12 +++++++----- 1 file changed, 7 insertions(+), 5 deletions(-) diff --git a/modules/ROOT/pages/notifications/all-notifications.adoc b/modules/ROOT/pages/notifications/all-notifications.adoc index 4e65b665..a415a1b0 100644 --- a/modules/ROOT/pages/notifications/all-notifications.adoc +++ b/modules/ROOT/pages/notifications/all-notifications.adoc @@ -1244,12 +1244,14 @@ a| To continue using it, escape the identifier by adding backticks around the identifier `%s`. - The character with the Unicode representation `%s` is deprecated for unescaped identifiers and will not be supported in the future. To continue using it, escape the identifier by adding backticks around the identifier `%s`. -- label:new[Valid for Neo4j 5.5-5.25] All subqueries in a UNION [ALL] should have the same ordering for the return columns. -Using differently ordered return items in a UNION [ALL] clause is deprecated and will be removed in a future version. -- label:new[Valid for Neo4j 5.26-2025.05] Databases and aliases with unescaped `.` are deprecated unless to indicate that they belong to a composite database. +- All subqueries in a `UNION [ALL]` should have the same ordering for the return columns. +[NOTE] +Using differently ordered return items in a `UNION [ALL]` clause is deprecated in versions 5.5 to 5.25. +However, starting from version 5.26, the deprecation has been withdrawn following cost-benefit analysis and valuable user feedback. +- Databases and aliases with unescaped `.` are deprecated unless the dots indicate that they belong to a composite database. Valid for Neo4j 5.26-2025.05. Names containing `.` should be escaped. (`%s`) -- label:new[Valid from 2025.06] Graph references with separately backticked name parts (`%s`) are deprecated. In future Cypher versions, use parameters or backtick the entire name (`%s`). -- label:new[Valid from 2025.06] Graph references with separately backticked name parts (`%s`) are deprecated. In future Cypher versions, remove the backticks (`%s`). +- Graph references with separately backticked name parts (`%s`) are deprecated starting from 2025.06. In future Cypher versions, use parameters or backtick the entire name (`%s`). +- Graph references with separately backticked name parts (`%s`) are deprecated starting from 2025.06. In future Cypher versions, remove the backticks (`%s`). |Category m|DEPRECATION |GQLSTATUS code From e4b94c4bad23ad58bb38bc7a7910e349ab5d233d Mon Sep 17 00:00:00 2001 From: Reneta Popova Date: Wed, 2 Jul 2025 14:45:49 +0100 Subject: [PATCH 7/9] further editorial updates --- modules/ROOT/pages/errors/gql-errors/42NAA.adoc | 4 ++-- modules/ROOT/pages/errors/gql-errors/51N76.adoc | 2 +- .../ROOT/pages/notifications/all-notifications.adoc | 10 +++++----- 3 files changed, 8 insertions(+), 8 deletions(-) diff --git a/modules/ROOT/pages/errors/gql-errors/42NAA.adoc b/modules/ROOT/pages/errors/gql-errors/42NAA.adoc index 2365ee3b..9e2f9572 100644 --- a/modules/ROOT/pages/errors/gql-errors/42NAA.adoc +++ b/modules/ROOT/pages/errors/gql-errors/42NAA.adoc @@ -25,7 +25,7 @@ error: syntax error or access rule violation - incorrectly formatted graph refer == Possible solutions -To resolve this issue, the preferred way is to send in the alias name as a parameter: +To resolve this issue, the preferred way is to replace the alias name with a parameter: .Parameters [source, parameters] @@ -41,7 +41,7 @@ To resolve this issue, the preferred way is to send in the alias name as a param CREATE ALIAS $aliasName FOR DATABASE baz ---- -Alternatively, if a string literal is used, the correct quoting for Cypher 25 would either be +Alternatively, if you use a string literal, the correct quoting for Cypher 25 will either be [source,cypher] ---- diff --git a/modules/ROOT/pages/errors/gql-errors/51N76.adoc b/modules/ROOT/pages/errors/gql-errors/51N76.adoc index 3ac2df2a..b6249cab 100644 --- a/modules/ROOT/pages/errors/gql-errors/51N76.adoc +++ b/modules/ROOT/pages/errors/gql-errors/51N76.adoc @@ -5,7 +5,7 @@ error: system configuration or operation exception - upgrade failed. The upgrade to a new Neo4j version failed. == Explanation -This error code can occur during a dbms upgrade to a new Neo4j version, in the rare case that something in the user's setup or dbms environment prevented the dbms from upgrading. +This error code can occur during a Neo4j upgrade to a new version in the rare case when something in the user's setup or DBMS environment prevents the upgrade. The error will be accompanied by a cause with a more concrete GQLSTATUS, describing what the user needs to change before retrying the upgrade. ifndef::backend-pdf[] diff --git a/modules/ROOT/pages/notifications/all-notifications.adoc b/modules/ROOT/pages/notifications/all-notifications.adoc index a415a1b0..5dcbcbb7 100644 --- a/modules/ROOT/pages/notifications/all-notifications.adoc +++ b/modules/ROOT/pages/notifications/all-notifications.adoc @@ -1264,7 +1264,7 @@ m|DEPRECATION m|WARNING |=== -[#_graph_reference_deprecation] +[[_graph_reference_deprecation]] .Using separately backticked name parts in graph references [.tabbed-example] ===== @@ -1328,7 +1328,7 @@ For more information on the semantics of graph references, see link:https://neo4 ====== ===== -[#_graph_reference_deprecation_use] +[[_graph_reference_deprecation_use]] .Using separately backticked name parts in graph references in USE clause [.tabbed-example] ===== @@ -1440,11 +1440,11 @@ However, starting from version 2025.06, this deprecation has been withdrawn, and The reason for this change is that the previous quoting rules have been found inconsistent and ambiguous, and will be improved starting from Cypher 25. For more information, see: -<<_graph_reference_deprecation>> +* <<_graph_reference_deprecation,Using separately backticked name parts in graph references>> -<<_graph_reference_deprecation_use>> +* <<_graph_reference_deprecation_use,Using separately backticked name parts in graph references in USE clause>> -link:https://neo4j.com/docs/cypher-manual/25/values-and-types/graph-references[Cypher manual -> Graph references]. +* link:https://neo4j.com/docs/cypher-manual/25/values-and-types/graph-references[Cypher manual -> Graph references]. ==== .Using differently ordered return items in a `UNION` clause From e1534f064f2de795ec9098b049f30143e2770155 Mon Sep 17 00:00:00 2001 From: Reneta Popova Date: Wed, 2 Jul 2025 16:25:32 +0100 Subject: [PATCH 8/9] bring back the labels --- .../pages/notifications/all-notifications.adoc | 17 +++++++++++++---- 1 file changed, 13 insertions(+), 4 deletions(-) diff --git a/modules/ROOT/pages/notifications/all-notifications.adoc b/modules/ROOT/pages/notifications/all-notifications.adoc index 5dcbcbb7..0a18fe03 100644 --- a/modules/ROOT/pages/notifications/all-notifications.adoc +++ b/modules/ROOT/pages/notifications/all-notifications.adoc @@ -1244,14 +1244,23 @@ a| To continue using it, escape the identifier by adding backticks around the identifier `%s`. - The character with the Unicode representation `%s` is deprecated for unescaped identifiers and will not be supported in the future. To continue using it, escape the identifier by adding backticks around the identifier `%s`. -- All subqueries in a `UNION [ALL]` should have the same ordering for the return columns. +- label:deprecated[Deprecated from 5.5 to 5.25] All subqueries in a `UNION [ALL]` should have the same ordering for the return columns. [NOTE] Using differently ordered return items in a `UNION [ALL]` clause is deprecated in versions 5.5 to 5.25. However, starting from version 5.26, the deprecation has been withdrawn following cost-benefit analysis and valuable user feedback. -- Databases and aliases with unescaped `.` are deprecated unless the dots indicate that they belong to a composite database. Valid for Neo4j 5.26-2025.05. +- label:valid[Valid from 5.26 till 2025.05] Databases and aliases with unescaped `.` are deprecated unless the dots indicate that they belong to a composite database. Names containing `.` should be escaped. (`%s`) -- Graph references with separately backticked name parts (`%s`) are deprecated starting from 2025.06. In future Cypher versions, use parameters or backtick the entire name (`%s`). -- Graph references with separately backticked name parts (`%s`) are deprecated starting from 2025.06. In future Cypher versions, remove the backticks (`%s`). +[NOTE] +Databases and aliases with unescaped `.` are deprecated in versions 5.26 to 2025.05. +However, starting from version 2025.06, this deprecation has been withdrawn, and replaced by two new deprecations. +The reason for this change is that the previous quoting rules have been found inconsistent and ambiguous, and will be improved starting from Cypher 25. +For more information, see: + +* <<_graph_reference_deprecation,Using separately backticked name parts in graph references>> +* <<_graph_reference_deprecation_use,Using separately backticked name parts in graph references in USE clause>> +* link:https://neo4j.com/docs/cypher-manual/25/values-and-types/graph-references[Cypher manual -> Graph references]. +- label:deprecated[Deprecated in 2025.06] Graph references with separately backticked name parts (`%s`) are deprecated. In future Cypher versions, use parameters or backtick the entire name (`%s`). +- label:deprecated[Deprecated in 2025.06] Graph references with separately backticked name parts (`%s`) are deprecated. In future Cypher versions, remove the backticks (`%s`). |Category m|DEPRECATION |GQLSTATUS code From 64cee37c7659861a9fcb3912a2f67aef5e6a22cc Mon Sep 17 00:00:00 2001 From: Reneta Popova Date: Wed, 2 Jul 2025 16:44:12 +0100 Subject: [PATCH 9/9] remove the valid label --- modules/ROOT/pages/notifications/all-notifications.adoc | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/modules/ROOT/pages/notifications/all-notifications.adoc b/modules/ROOT/pages/notifications/all-notifications.adoc index 0a18fe03..6247bda9 100644 --- a/modules/ROOT/pages/notifications/all-notifications.adoc +++ b/modules/ROOT/pages/notifications/all-notifications.adoc @@ -1244,11 +1244,11 @@ a| To continue using it, escape the identifier by adding backticks around the identifier `%s`. - The character with the Unicode representation `%s` is deprecated for unescaped identifiers and will not be supported in the future. To continue using it, escape the identifier by adding backticks around the identifier `%s`. -- label:deprecated[Deprecated from 5.5 to 5.25] All subqueries in a `UNION [ALL]` should have the same ordering for the return columns. +- All subqueries in a `UNION [ALL]` should have the same ordering for the return columns. [NOTE] -Using differently ordered return items in a `UNION [ALL]` clause is deprecated in versions 5.5 to 5.25. +In versions 5.5 to 5.25, using differently ordered return items in a `UNION [ALL]` clause is deprecated. However, starting from version 5.26, the deprecation has been withdrawn following cost-benefit analysis and valuable user feedback. -- label:valid[Valid from 5.26 till 2025.05] Databases and aliases with unescaped `.` are deprecated unless the dots indicate that they belong to a composite database. +- label:deprecated[Deprecated from 5.26 to 2025.05] Databases and aliases with unescaped `.` are deprecated unless the dots indicate that they belong to a composite database. Names containing `.` should be escaped. (`%s`) [NOTE] Databases and aliases with unescaped `.` are deprecated in versions 5.26 to 2025.05. @@ -1518,7 +1518,7 @@ RETURN 'val' as one, 'val' as two [NOTE] ==== -Using differently ordered return items in a UNION [ALL] clause is deprecated in versions 5.5 to 5.25. +In versions 5.5 to 5.25, using differently ordered return items in a `UNION [ALL]` clause is deprecated. However, starting from version 5.26, the deprecation has been withdrawn following cost-benefit analysis and valuable user feedback. ====