add new graph reference deprecations #1317
Merged
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
modules/ROOT/pages/deprecations-additions-removals-compatibility.adoc
Outdated
Show resolved
Hide resolved
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] |
There was a problem hiding this comment.
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]. |
There was a problem hiding this comment.
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]. |
Co-authored-by: Jens Pryce-Åklundh <[email protected]>
JPryce-Aklundh
approved these changes
Jun 24, 2025
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
see also: