Skip to content

Commit c9ea71e

Browse files
committed
Dots in database name are no longer deprecated.
1 parent c9a08ea commit c9ea71e

File tree

2 files changed

+7
-5
lines changed

2 files changed

+7
-5
lines changed

modules/ROOT/pages/database-administration/aliases/manage-aliases-composite-databases.adoc

Lines changed: 6 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -51,7 +51,7 @@ For a description of all the returned columns of this command, and for ways in w
5151

5252
Both local and remote database aliases can be part of a xref::database-administration/composite-databases/concepts.adoc[composite database].
5353

54-
The database alias is made of two parts, separated by a dot: the namespace and the alias name.
54+
The database alias consists of two parts, separated by a dot: the namespace and the alias name.
5555

5656
The namespace must be the name of the composite database.
5757

@@ -266,9 +266,13 @@ CREATE ALIAS `my.composite.database.with.dots`.`my.other.alias.with.dots` FOR DA
266266
----
267267

268268

269-
[role=label--deprecated]
270269
=== Single dots and local database aliases
271270

271+
[NOTE]
272+
====
273+
As of Neo4j 5.26.9, this feature is no longer deprecated.
274+
====
275+
272276
There is a special case for local database aliases with a single dot without any existing composite database.
273277
If a composite database `some` exists, the query below will create a database alias named `alias` within the composite database `some`.
274278
If no such database exists, however, the same query will instead create a database alias named `some.alias`:

modules/ROOT/pages/database-administration/standard-databases/naming-databases.adoc

Lines changed: 1 addition & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -19,9 +19,7 @@ Naming rules for databases are as follows:
1919
The `-` (dash) and `.` (dot) characters are not legal in Cypher variables.
2020
Names with a `-` in them must be enclosed within backticks.
2121
For example, `CREATE DATABASE ++`main-db`++` is a valid database name.
22-
Database names are the only identifier for which dots do not need to be quoted.
23-
For example `main.db` is a valid database name.
24-
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.
22+
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.
2523
====
2624

2725
It is possible to create an alias to refer to an existing database to avoid these restrictions.

0 commit comments

Comments
 (0)