Skip to content

Commit e6e1352

Browse files
committed
update removals & deprecations for graph references
1 parent e509773 commit e6e1352

File tree

1 file changed

+36
-8
lines changed

1 file changed

+36
-8
lines changed

modules/ROOT/pages/deprecations-additions-removals-compatibility.adoc

Lines changed: 36 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -50,6 +50,20 @@ CREATE DATABASE db OPTIONS { existingDataSeedInstance: ... }
5050
| The option `existingDataSeedInstance` is removed from the `CREATE DATABASE` `OPTIONS` map and replaced by `existingDataSeedServer`.
5151
For more information, see link:{neo4j-docs-base-uri}/operations-manual/current/database-administration/standard-databases/create-databases/#manage-databases-create-database-options[Operations Manual -> Database administration -> Create databases].
5252

53+
a|
54+
[#_graph_reference_removed_name_parts_quoting]
55+
label:functionality[]
56+
label:removed[]
57+
[source, cypher, role=noheader]
58+
----
59+
CREATE ALIAS composite.`1` FOR DATABASE neo4j
60+
----
61+
[source, cypher, role=noheader]
62+
----
63+
USE composite.`1`
64+
----
65+
| Graph references with separately backticked name parts have been removed. Use parameters or backtick the entire name, e.g. `USE `composite.1``
66+
5367

5468
a|
5569
label:functionality[]
@@ -277,6 +291,7 @@ Several xref:clauses/transaction-clauses.adoc#query-listing-transactions[`SHOW
277291
* The current query-related columns — `currentQuery`, `currentQueryId`, `parameters`, `planner`, `runtime`, `indexes`, `currentQueryStartTime`, `currentQueryElapsedTime`, `currentQueryCpuTime`, `currentQueryIdleTime`, and `currentQueryStatus` — now return `null` when no query is executing.
278292

279293
a|
294+
[#_graph_reference_updated_graph_by_name_quotes]
280295
label:functionality[]
281296
label:updated[]
282297
[source, cypher, role="noheader"]
@@ -731,9 +746,18 @@ label:deprecated[]
731746
USE my.db ...
732747
733748
----
734-
| 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.
735-
Names containing `.` should be quoted using backticks.
736-
For example, `USE `my.db`` is valid.
749+
| 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.
750+
751+
However, starting from version 2025.06, this deprecation has been withdrawn, and replaced by two new deprecations.
752+
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.
753+
For more information, see:
754+
755+
* xref::deprecations-additions-removals-compatibility.adoc#_graph_reference_removed_name_parts_quoting[removed support for quoted name parts in graph references]
756+
757+
* xref::deprecations-additions-removals-compatibility.adoc#_graph_reference_updated_graph_by_name_quotes[update to graph functions]
758+
759+
* xref::values-and-types/graph-references.adoc#rules[graph reference rules]
760+
737761

738762
|===
739763

@@ -3352,12 +3376,16 @@ label:deprecated[]
33523376
CREATE DATABASE databaseName.withDot ...
33533377
----
33543378
a|
3355-
Creating a database with dots in the name has been deprecated, instead quote the database name using backticks:
3379+
Creating a database with dots in the name has been deprecated in versions 5.26 to 2025.05.
3380+
However, starting from version 2025.06, this deprecation has been withdrawn, and replaced by two new deprecations.
3381+
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.
3382+
For more information, see:
33563383

3357-
[source, cypher, role="noheader"]
3358-
----
3359-
CREATE DATABASE `databaseName.withDot` ...
3360-
----
3384+
* xref::deprecations-additions-removals-compatibility.adoc#_graph_reference_removed_name_parts_quoting[removed support for quoted name parts in graph references]
3385+
3386+
* xref::deprecations-additions-removals-compatibility.adoc#_graph_reference_updated_graph_by_name_quotes[update to graph functions]
3387+
3388+
* xref::values-and-types/graph-references.adoc#rules[graph reference rules]
33613389

33623390
a|
33633391
[[cypher-5_0-d_4]]

0 commit comments

Comments
 (0)