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.

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

Open
wants to merge 3 commits into
base: cypher-5
Choose a base branch
from

Conversation

Comment on lines 280 to 284
| 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].

Comment on lines 2904 to 2907
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].

nadja-muller and others added 2 commits June 24, 2025 11:01
Co-authored-by: Jens Pryce-Åklundh <112686610+JPryce-Aklundh@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants