Skip to content

Commit 021baae

Browse files
committed
Review comments
1 parent 975bf2c commit 021baae

File tree

2 files changed

+9
-8
lines changed

2 files changed

+9
-8
lines changed

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

Lines changed: 8 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -223,14 +223,14 @@ Dots in alias names are ambiguous.
223223
They could either be interpreted as part of the name itself, or as the dot that separates a composite namespace from the alias name.
224224

225225
=== Conflicting names
226-
Before Neo4j 2025.06 it was possible to create conflicting aliases such as the constituent alias `flowers` within the composite database `garden` as well as the non-composite local alias `garden.flowers`.
226+
Before Neo4j 2025.06, it was possible to create conflicting aliases such as the constituent alias `flowers` within the composite database `garden` as well as the non-composite local alias `garden.flowers`.
227227
Both of these would be referred to by the same name `garden.flowers`.
228228

229-
Neo4j 2025.06 ensures that no such conflicts exist and will throw an exception when attempting to create a new alias with the same name as an existing alias.
229+
Neo4j 2025.06 and later versions ensure that no such conflicts exist and will throw an exception when attempting to create a new alias with the same name as an existing alias.
230230

231231
[.tabbed-example]
232232
=====
233-
[role=include-with-cypher-5]
233+
[role=include-with-cypher-5 label--new-2025.06]
234234
======
235235
Creating a regular alias with the same name as an existing composite constituent is disallowed:
236236

@@ -325,7 +325,7 @@ Creating a composite constituent with the same name as an existing non-composite
325325

326326
Cypher 25 relies on the guarantee that no conflicting names are allowed in Neo4j 2025.06 and later.
327327
The following queries all act on the same alias, regardless if that alias is a composite constituent or not.
328-
The special quoting of separate name parts that was necessary in Cypher 5 is not necessary / permitted in Cypher 25.
328+
The special quoting of separate name parts that was necessary in Cypher 5 is not permitted in Cypher 25.
329329

330330
.Parameters
331331
[source, javascript]
@@ -343,7 +343,7 @@ CYPHER 25 USE `my.garden.beautiful.flowers` RETURN 1
343343
----
344344

345345
==== Creating a new alias with dots
346-
During `CREATE`, Cypher25 will split the given name on each dot, left to right, and check if a corresponding composite database exists.
346+
During `CREATE`, Cypher 25 will split the given name on each dot, left to right, and check if a corresponding composite database exists.
347347
If no composite database is found, Cypher25 will fall back to creating a regular non-composite alias instead.
348348

349349
The following query attempts to create in order:
@@ -369,6 +369,7 @@ Since it finds the composite database `my.garden` it will create the constituent
369369

370370
The composite database name and the database alias name need to be quoted individually.
371371
Backticks may be added regardless of whether the name contains special characters or not, so it is good practice to always backtick both names, e.g. `++`composite`++.++`alias`++`.
372+
Note however that separating composite database name and alias name with backticks is no longer supported in Cypher 25.
372373

373374
The following example creates a database alias named `my alias with spaces` as a constituent in the composite database named `my-composite-database-with-dashes`:
374375

@@ -412,9 +413,9 @@ CYPHER 5 CREATE ALIAS `my.alias.with.dots` FOR DATABASE `northwind-graph`
412413
CYPHER 5 CREATE ALIAS `my.composite.database.with.dots`.`my.other.alias.with.dots` FOR DATABASE `northwind-graph`
413414
----
414415

415-
416-
[role=label--deprecated]
417416
==== Single dots and local database aliases
417+
[NOTE]
418+
This used to be deprecated, but the deprecation has since been revoked.
418419

419420
There is a special case for local database aliases with a single dot without any existing composite database.
420421
If a composite database `some` exists, the query below will create a database alias named `alias` within the composite database `some`.

modules/ROOT/pages/database-administration/aliases/naming-aliases.adoc

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -21,5 +21,5 @@ The name restrictions and escaping rules apply to all the different database ali
2121
====
2222
Having dots (`.`) in the database alias names is not recommended.
2323
This is due to the difficulty of determining if a dot is part of the database alias name or a delimiter for a database alias in a composite database.
24-
For more details, see xref:database-administration/aliases/manage-aliases-composite-databases.adoc#alias-management-escaping[names and escaping for database aliases targeting composite databases].
24+
For more details, see xref:database-administration/aliases/manage-aliases-composite-databases.adoc#alias-management-escaping[database alias names that contain dots].
2525
====

0 commit comments

Comments
 (0)