Skip to content

add new graph reference deprecations #1317

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 5 commits into from
Jun 24, 2025
Merged

add new graph reference deprecations #1317

Changes from 1 commit
Commits
Show all changes
5 commits
Select commit Hold shift + click to select a range
405460b
add new graph reference deprecations
nadja-muller Jun 23, 2025
70cf93b
Apply suggestions from code review
nadja-muller Jun 24, 2025
2f65556
handle review feedback
nadja-muller Jun 24, 2025
df231a6
proper backtick formatting
JPryce-Aklundh Jun 24, 2025
cfd0a72
fix links
JPryce-Aklundh Jun 24, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
45 changes: 41 additions & 4 deletions modules/ROOT/pages/deprecations-additions-removals-compatibility.adoc
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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

Expand Down Expand Up @@ -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]
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
| 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]
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:
* 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].


|===


Expand Down Expand Up @@ -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].
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
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:
* 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].


[source, cypher, role="noheader"]
----
Expand Down