From b151f54d8f264e8dbf25067353b2640ef55b2a31 Mon Sep 17 00:00:00 2001 From: Lasse Heemann Date: Wed, 6 Nov 2024 09:42:33 +0100 Subject: [PATCH 1/3] Disallow unquoted database names with dot --- .../standard-databases/naming-databases.adoc | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/modules/ROOT/pages/database-administration/standard-databases/naming-databases.adoc b/modules/ROOT/pages/database-administration/standard-databases/naming-databases.adoc index c828aaed2..eb925da33 100644 --- a/modules/ROOT/pages/database-administration/standard-databases/naming-databases.adoc +++ b/modules/ROOT/pages/database-administration/standard-databases/naming-databases.adoc @@ -19,9 +19,9 @@ Naming rules for databases are as follows: The `-` (dash) and `.` (dot) characters are not legal in Cypher variables. Names with a `-` in them must be enclosed within backticks. For example, `CREATE DATABASE ++`main-db`++` is a valid database name. -Database names are the only identifier for which dots do not need to be quoted. -For example `main.db` is a valid database name. -However, this behavior is deprecated due to the difficulty of determining if a dot is part of the database name or a delimiter for a database alias in a composite database. +Since Neo4j 5.27 names with a `.` in them must be enclosed within backticks. +However, database names with dots in them are not recommended, due to the difficulty of determining if a dot is part of the database name or a delimiter for a database alias in a composite database. +A future version of Neo4j may disallow database names with dots entirely. ==== It is possible to create an alias to refer to an existing database to avoid these restrictions. From 6c14524542bb26b09311c032575d4ec7cc9032ae Mon Sep 17 00:00:00 2001 From: Lasse Heemann <7661319+l-heemann@users.noreply.github.com> Date: Mon, 25 Nov 2024 09:55:34 +0100 Subject: [PATCH 2/3] Update modules/ROOT/pages/database-administration/standard-databases/naming-databases.adoc --- .../standard-databases/naming-databases.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/modules/ROOT/pages/database-administration/standard-databases/naming-databases.adoc b/modules/ROOT/pages/database-administration/standard-databases/naming-databases.adoc index eb925da33..d0c1702f4 100644 --- a/modules/ROOT/pages/database-administration/standard-databases/naming-databases.adoc +++ b/modules/ROOT/pages/database-administration/standard-databases/naming-databases.adoc @@ -19,7 +19,7 @@ Naming rules for databases are as follows: The `-` (dash) and `.` (dot) characters are not legal in Cypher variables. Names with a `-` in them must be enclosed within backticks. For example, `CREATE DATABASE ++`main-db`++` is a valid database name. -Since Neo4j 5.27 names with a `.` in them must be enclosed within backticks. +Since Cypher 25 names with a `.` in them must be enclosed within backticks. However, database names with dots in them are not recommended, due to the difficulty of determining if a dot is part of the database name or a delimiter for a database alias in a composite database. A future version of Neo4j may disallow database names with dots entirely. ==== From 1e7d5dbbbc2123e6c3707c62fe72b16279603b9c Mon Sep 17 00:00:00 2001 From: Lasse Heemann <7661319+l-heemann@users.noreply.github.com> Date: Wed, 27 Nov 2024 09:21:49 +0100 Subject: [PATCH 3/3] Apply suggestions from code review Co-authored-by: Reneta Popova --- .../standard-databases/naming-databases.adoc | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/modules/ROOT/pages/database-administration/standard-databases/naming-databases.adoc b/modules/ROOT/pages/database-administration/standard-databases/naming-databases.adoc index d0c1702f4..414cdac7b 100644 --- a/modules/ROOT/pages/database-administration/standard-databases/naming-databases.adoc +++ b/modules/ROOT/pages/database-administration/standard-databases/naming-databases.adoc @@ -19,9 +19,9 @@ Naming rules for databases are as follows: The `-` (dash) and `.` (dot) characters are not legal in Cypher variables. Names with a `-` in them must be enclosed within backticks. For example, `CREATE DATABASE ++`main-db`++` is a valid database name. -Since Cypher 25 names with a `.` in them must be enclosed within backticks. -However, database names with dots in them are not recommended, due to the difficulty of determining if a dot is part of the database name or a delimiter for a database alias in a composite database. -A future version of Neo4j may disallow database names with dots entirely. +In Cypher 25, names that contain a dot (`.`) must be quoted in backticks. +However, using dots in database names is not recommended, as it makes it difficult to determine if a dot is part of the database name or a delimiter for a database alias in a composite database. +A future version of Neo4j may entirely disallow database names with dots. ==== It is possible to create an alias to refer to an existing database to avoid these restrictions.