From 405460be4cd122a1404bcc82fe58ddf727647833 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Nadja=20M=C3=BCller?= Date: Mon, 23 Jun 2025 20:38:02 +0200 Subject: [PATCH 1/5] add new graph reference deprecations --- ...ions-additions-removals-compatibility.adoc | 45 +++++++++++++++++-- 1 file changed, 41 insertions(+), 4 deletions(-) diff --git a/modules/ROOT/pages/deprecations-additions-removals-compatibility.adoc b/modules/ROOT/pages/deprecations-additions-removals-compatibility.adoc index 2697611bb..670f4a5c9 100644 --- a/modules/ROOT/pages/deprecations-additions-removals-compatibility.adoc +++ b/modules/ROOT/pages/deprecations-additions-removals-compatibility.adoc @@ -16,6 +16,37 @@ New features are added to the language continuously, and occasionally, some feat This section lists all of the features that have been removed, deprecated, added, or extended in different Cypher versions. Replacement syntax for deprecated and removed features are also indicated. +[[cypher-deprecations-additions-removals-2025.06]] +== Neo4j 2025.06 + +[cols="2", options="header"] +|=== +| Feature +| Details + +a| +[#_graph_reference_removed_name_parts_quoting] +label:functionality[] +label:deprecated[] +[source,cypher] +---- +CYPHER 5 CREATE ALIAS `foo`.`bar` FOR DATABASE ... +---- +| Graph references with separately backticked name parts (\`foo`.\`bar`) are deprecated. In future Cypher versions, use parameters or backtick the entire name (\`foo.bar`). + + +a| +[#_graph_reference_updated_graph_by_name_quotes] +label:functionality[] +label:deprecated[] +[source,cypher] +---- +CYPHER 5 USE graph.byName("`a.b`.c") ... +---- +| Graph references with separately backticked name parts (\`a.b`.\`c`) are deprecated. In future Cypher versions, remove the backticks (a.b.c). + +|=== + [[cypher-deprecations-additions-removals-2025.04]] == Neo4j 2025.04 @@ -246,9 +277,12 @@ label:deprecated[] USE my.db ... ---- -| In xref:clauses/use.adoc[`USE`] clauses, databases and aliases with unquoted `.` are deprecated unless the `.` is used to indicate that the database or alias belongs to a composite database. -Names containing `.` should be quoted using backticks. -For example, `USE `my.db`` is valid. +| In xref:clauses/use.adoc[`USE`] clauses, databases and aliases with unquoted `.` are deprecated in versions 5.26 to 2025.05 unless the `.` is used to indicate that the database or alias belongs to a composite database. + +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 xref::deprecations-additions-removals-compatibility.adoc#_graph_reference_removed_name_parts_quoting[removed support for quoted name parts in graph references] + |=== @@ -2867,7 +2901,10 @@ label:deprecated[] CREATE DATABASE databaseName.withDot ... ---- a| -Creating a database with dots in the name has been deprecated, instead quote the database name using backticks: +Creating a database with dots in the name has been 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 xref::deprecations-additions-removals-compatibility.adoc#_graph_reference_removed_name_parts_quoting[removed support for quoted name parts in graph references]. [source, cypher, role="noheader"] ---- From 70cf93bc5667460acdea0d193f8a2541a6b6bf50 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Nadja=20M=C3=BCller?= <73830555+nadja-muller@users.noreply.github.com> Date: Tue, 24 Jun 2025 11:01:44 +0200 Subject: [PATCH 2/5] Apply suggestions from code review MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-authored-by: Jens Pryce-Åklundh <112686610+JPryce-Aklundh@users.noreply.github.com> --- .../pages/deprecations-additions-removals-compatibility.adoc | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) diff --git a/modules/ROOT/pages/deprecations-additions-removals-compatibility.adoc b/modules/ROOT/pages/deprecations-additions-removals-compatibility.adoc index 670f4a5c9..2997a2dbb 100644 --- a/modules/ROOT/pages/deprecations-additions-removals-compatibility.adoc +++ b/modules/ROOT/pages/deprecations-additions-removals-compatibility.adoc @@ -19,6 +19,8 @@ Replacement syntax for deprecated and removed features are also indicated. [[cypher-deprecations-additions-removals-2025.06]] == Neo4j 2025.06 +=== Deprecated features + [cols="2", options="header"] |=== | Feature @@ -43,7 +45,8 @@ label:deprecated[] ---- CYPHER 5 USE graph.byName("`a.b`.c") ... ---- -| Graph references with separately backticked name parts (\`a.b`.\`c`) are deprecated. In future Cypher versions, remove the backticks (a.b.c). +| Graph references with separately backticked name parts (\`a.b`.\`c`) are deprecated. +In future Cypher versions, remove the backticks (`a.b.c`). |=== From 2f655561cc64aa1ae1a6120bb8e429e1016b5371 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Nadja=20M=C3=BCller?= Date: Tue, 24 Jun 2025 11:06:36 +0200 Subject: [PATCH 3/5] handle review feedback --- ...ions-additions-removals-compatibility.adoc | 29 +++++++++++-------- 1 file changed, 17 insertions(+), 12 deletions(-) diff --git a/modules/ROOT/pages/deprecations-additions-removals-compatibility.adoc b/modules/ROOT/pages/deprecations-additions-removals-compatibility.adoc index 2997a2dbb..6d5ec7eff 100644 --- a/modules/ROOT/pages/deprecations-additions-removals-compatibility.adoc +++ b/modules/ROOT/pages/deprecations-additions-removals-compatibility.adoc @@ -280,12 +280,16 @@ label:deprecated[] USE my.db ... ---- -| In xref:clauses/use.adoc[`USE`] clauses, databases and aliases with unquoted `.` are deprecated in versions 5.26 to 2025.05 unless the `.` is used to indicate that the database or alias belongs to a composite database. +a| The use of unquoted `.` characters in xref:clauses/use.adoc[`USE`] clauses when specifying databases and aliases was deprecated in 5.26, except when `.` indicated that the database or alias belonged to a composite database. +However, this deprecation has been withdrawn in 2025.06, and replaced by two new deprecations in Cypher 5: -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 xref::deprecations-additions-removals-compatibility.adoc#_graph_reference_removed_name_parts_quoting[removed support for quoted name parts in graph references] +* xref::deprecations-additions-removals-compatibility.adoc#_graph_reference_removed_name_parts_quoting[Deprecated support for quoted name parts in graph references] +* xref::deprecations-additions-removals-compatibility.adoc#_graph_reference_updated_graph_by_name_quotes[Deprecation to graph functions] + +This is because the previous quoting rules were inconsistent and ambiguous. +The rules have been clarified and improved in Cypher 25. +For more information, see the link:https://neo4j.com/docs/cypher-manual//25/deprecations-additions-removals-compatibility/[Cypher 25 Manual -> Additions, deprecations, removals, and compatibility]. |=== @@ -2904,15 +2908,16 @@ label:deprecated[] CREATE DATABASE databaseName.withDot ... ---- a| -Creating a database with dots in the name has been 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 xref::deprecations-additions-removals-compatibility.adoc#_graph_reference_removed_name_parts_quoting[removed support for quoted name parts in graph references]. +Creating a database with dots in the name was deprecated in 5.0. +However, this deprecation was withdrawn in 2025.06, and replaced by two new deprecations in Cypher 5: -[source, cypher, role="noheader"] ----- -CREATE DATABASE `databaseName.withDot` ... ----- +* xref::deprecations-additions-removals-compatibility.adoc#_graph_reference_removed_name_parts_quoting[Deprecated support for quoted name parts in graph references] + +* xref::deprecations-additions-removals-compatibility.adoc#_graph_reference_updated_graph_by_name_quotes[Deprecation to graph functions] + +This because the previous quoting rules were inconsistent and ambiguous. +The rules have been clarified and improved in Cypher 25. +For more information, see the link:https://neo4j.com/docs/cypher-manual//25/deprecations-additions-removals-compatibility/[Cypher 25 Manual -> Additions, deprecations, removals, and compatibility]. a| [[cypher-5_0-d_4]] From df231a6c0069419caa0cb09cbeeaac249fd2cfaf Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Jens=20Pryce-=C3=85klundh?= <112686610+JPryce-Aklundh@users.noreply.github.com> Date: Tue, 24 Jun 2025 11:51:45 +0200 Subject: [PATCH 4/5] proper backtick formatting --- .../deprecations-additions-removals-compatibility.adoc | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/modules/ROOT/pages/deprecations-additions-removals-compatibility.adoc b/modules/ROOT/pages/deprecations-additions-removals-compatibility.adoc index 6d5ec7eff..f5a0def8c 100644 --- a/modules/ROOT/pages/deprecations-additions-removals-compatibility.adoc +++ b/modules/ROOT/pages/deprecations-additions-removals-compatibility.adoc @@ -34,8 +34,8 @@ label:deprecated[] ---- CYPHER 5 CREATE ALIAS `foo`.`bar` FOR DATABASE ... ---- -| Graph references with separately backticked name parts (\`foo`.\`bar`) are deprecated. In future Cypher versions, use parameters or backtick the entire name (\`foo.bar`). - +| Graph references with separately backticked name parts (`++`foo`.`bar`++`) are deprecated. +In future Cypher versions, use parameters or backtick the entire name (`++`foo.bar`++`). a| [#_graph_reference_updated_graph_by_name_quotes] @@ -45,7 +45,7 @@ label:deprecated[] ---- CYPHER 5 USE graph.byName("`a.b`.c") ... ---- -| Graph references with separately backticked name parts (\`a.b`.\`c`) are deprecated. +| Graph references with separately backticked name parts (`++`a.b`.`c`++`) are deprecated. In future Cypher versions, remove the backticks (`a.b.c`). |=== From cfd0a72e029386d17c2e5916256fb3af8b51ff90 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Jens=20Pryce-=C3=85klundh?= <112686610+JPryce-Aklundh@users.noreply.github.com> Date: Tue, 24 Jun 2025 11:57:07 +0200 Subject: [PATCH 5/5] fix links --- .../pages/deprecations-additions-removals-compatibility.adoc | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/modules/ROOT/pages/deprecations-additions-removals-compatibility.adoc b/modules/ROOT/pages/deprecations-additions-removals-compatibility.adoc index f5a0def8c..e078f3ede 100644 --- a/modules/ROOT/pages/deprecations-additions-removals-compatibility.adoc +++ b/modules/ROOT/pages/deprecations-additions-removals-compatibility.adoc @@ -289,7 +289,7 @@ However, this deprecation has been withdrawn in 2025.06, and replaced by two new This is because the previous quoting rules were inconsistent and ambiguous. The rules have been clarified and improved in Cypher 25. -For more information, see the link:https://neo4j.com/docs/cypher-manual//25/deprecations-additions-removals-compatibility/[Cypher 25 Manual -> Additions, deprecations, removals, and compatibility]. +For more information, see the link:https://neo4j.com/docs/cypher-manual/25/deprecations-additions-removals-compatibility/[Cypher 25 Manual -> Additions, deprecations, removals, and compatibility]. |=== @@ -2917,7 +2917,7 @@ However, this deprecation was withdrawn in 2025.06, and replaced by two new depr This because the previous quoting rules were inconsistent and ambiguous. The rules have been clarified and improved in Cypher 25. -For more information, see the link:https://neo4j.com/docs/cypher-manual//25/deprecations-additions-removals-compatibility/[Cypher 25 Manual -> Additions, deprecations, removals, and compatibility]. +For more information, see the link:https://neo4j.com/docs/cypher-manual/25/deprecations-additions-removals-compatibility/[Cypher 25 Manual -> Additions, deprecations, removals, and compatibility]. a| [[cypher-5_0-d_4]]