diff --git a/modules/ROOT/pages/deprecations-additions-removals-compatibility.adoc b/modules/ROOT/pages/deprecations-additions-removals-compatibility.adoc index 5715f481c..ba704be56 100644 --- a/modules/ROOT/pages/deprecations-additions-removals-compatibility.adoc +++ b/modules/ROOT/pages/deprecations-additions-removals-compatibility.adoc @@ -51,6 +51,20 @@ CREATE DATABASE db OPTIONS { existingDataSeedInstance: ... } | The option `existingDataSeedInstance` is removed from the `CREATE DATABASE` `OPTIONS` map and replaced by `existingDataSeedServer`. 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]. +a| +[#_graph_reference_removed_name_parts_quoting] +label:functionality[] +label:removed[] +[source, cypher, role=noheader] +---- +CREATE ALIAS composite.`1` FOR DATABASE neo4j +---- +[source, cypher, role=noheader] +---- +USE composite.`1` +---- +| Graph references with separately backticked name parts have been removed. Use parameters or backtick the entire name, e.g. `USE `composite.1`` + a| label:functionality[] @@ -278,6 +292,7 @@ Several xref:clauses/transaction-clauses.adoc#query-listing-transactions[`SHOW * 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. a| +[#_graph_reference_updated_graph_by_name_quotes] label:functionality[] label:updated[] [source, cypher, role="noheader"] @@ -732,9 +747,16 @@ 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. +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 was withdrawn in Neo4j 2025.06, and replaced by the following updates in Cypher 25: + +* 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_updated_graph_by_name_quotes[Update to graph functions] + +This is because the previous quoting rules were inconsistent and ambiguous. +The rules are clarified and improved in Cypher 25. +For more information, see xref::values-and-types/graph-references.adoc#rules[Graph reference rules] |=== @@ -3353,12 +3375,16 @@ 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 . characters was deprecated in 5.0. +However, this deprecation was withdrawn in 2025.06, and replaced by the following updates in Cypher 25: -[source, cypher, role="noheader"] ----- -CREATE DATABASE `databaseName.withDot` ... ----- +* 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_updated_graph_by_name_quotes[Update to graph functions] + +This is because the previous quoting rules were inconsistent and ambiguous. +The rules are clarified and improved in Cypher 25. +For more information, see xref::values-and-types/graph-references.adoc#rules[Graph reference rules] a| [[cypher-5_0-d_4]]