From 5df96f6a69ee3fb4995797e52c4a1fbf59d86ce4 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Nadja=20M=C3=BCller?= Date: Tue, 7 Jan 2025 14:42:40 +0100 Subject: [PATCH 1/3] document deprecation of graph names with unesacped dots in USE clauses --- .../deprecations-additions-removals-compatibility.adoc | 10 ++++++++++ 1 file changed, 10 insertions(+) diff --git a/modules/ROOT/pages/deprecations-additions-removals-compatibility.adoc b/modules/ROOT/pages/deprecations-additions-removals-compatibility.adoc index 50047fdc6..9cece87b7 100644 --- a/modules/ROOT/pages/deprecations-additions-removals-compatibility.adoc +++ b/modules/ROOT/pages/deprecations-additions-removals-compatibility.adoc @@ -150,6 +150,16 @@ CREATE DATABASE db OPTIONS { storeFormat: 'high_limit' } | The `standard` and `high_limit` store formats have been deprecated. Creating databases with these formats is therefore also deprecated. For more information on the deprecation of these formats, see link:{neo4j-docs-base-uri}/operations-manual/{page-version}/database-internals/store-formats/#format-deprecations[Store formats -> Format deprecations]. + +a| +label:functionality[] +label:deprecated[] +[source, cypher, role="noheader"] +---- +USE my.db ... + +---- +| In USE clauses, databases and aliases with unescaped `.` are deprecated unless to indicate that they belong to a composite database. Names containing `.` should be escaped. In the above example: USE `my.db` ... |=== From 5a4a323d55d5b25174b2c82adeac8a7f6e3bae62 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Nadja=20M=C3=BCller?= Date: Tue, 7 Jan 2025 14:52:22 +0100 Subject: [PATCH 2/3] escape quotes --- .../pages/deprecations-additions-removals-compatibility.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/modules/ROOT/pages/deprecations-additions-removals-compatibility.adoc b/modules/ROOT/pages/deprecations-additions-removals-compatibility.adoc index 9cece87b7..9d0b9d50e 100644 --- a/modules/ROOT/pages/deprecations-additions-removals-compatibility.adoc +++ b/modules/ROOT/pages/deprecations-additions-removals-compatibility.adoc @@ -159,7 +159,7 @@ label:deprecated[] USE my.db ... ---- -| In USE clauses, databases and aliases with unescaped `.` are deprecated unless to indicate that they belong to a composite database. Names containing `.` should be escaped. In the above example: USE `my.db` ... +| In USE clauses, databases and aliases with unescaped `.` are deprecated unless to indicate that they belong to a composite database. Names containing `.` should be escaped. In the above example: USE \`my.db` ... |=== From 5aff5489582fdf177ffcbb16086037d8151124fc Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Nadja=20M=C3=BCller?= <73830555+nadja-muller@users.noreply.github.com> Date: Tue, 7 Jan 2025 15:17:15 +0100 Subject: [PATCH 3/3] Update modules/ROOT/pages/deprecations-additions-removals-compatibility.adoc MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-authored-by: Jens Pryce-Åklundh <112686610+JPryce-Aklundh@users.noreply.github.com> --- .../pages/deprecations-additions-removals-compatibility.adoc | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/modules/ROOT/pages/deprecations-additions-removals-compatibility.adoc b/modules/ROOT/pages/deprecations-additions-removals-compatibility.adoc index 9d0b9d50e..1b97862d8 100644 --- a/modules/ROOT/pages/deprecations-additions-removals-compatibility.adoc +++ b/modules/ROOT/pages/deprecations-additions-removals-compatibility.adoc @@ -159,7 +159,9 @@ label:deprecated[] USE my.db ... ---- -| In USE clauses, databases and aliases with unescaped `.` are deprecated unless to indicate that they belong to a composite database. Names containing `.` should be escaped. In the above example: 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. |===