Graph reference updates for Cypher 25 / Neo4j 2025.06 #2443

l-heemann · 2025-06-24T12:16:11Z

Documentation for:
CIP-212
https://github.com/neo-technology/neo4j/pull/31208
https://github.com/neo-technology/neo4j/pull/31418

Lojjs

Overall, I think this is a good way to explain a complex topic. I am happy with the structure we landed in. Only a bunch of smaller comments on various details.

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

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

Lojjs

Thanks for the fixes, looks good now

renetapopova

Thanks, Lasse. I added some comments.

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

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

...les/ROOT/pages/database-administration/composite-databases/querying-composite-databases.adoc

l-heemann · 2025-06-26T10:24:43Z

Thanks for the review @renetapopova

I've added links for the GQL codes but it seems I did it wrong since the build fails now? 🤷

renetapopova · 2025-06-26T10:26:51Z

Thanks for the review @renetapopova

I've added links for the GQL codes but it seems I did it wrong since the build fails now? 🤷

There is somewhere unterminated example block

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

renetapopova

Let me fix those unterminated blocks.

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

renetapopova · 2025-06-26T10:35:26Z

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

+. Constituent alias `flowers` within composite database `my.garden.beautiful`.
+. Regular non-composite alias `my.garden.beautiful.flowers`.
+
+.Query


Ah, this query needs to go away as it duplicates the one above now.

I think I fixed this now with 8c36c96

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

renetapopova

I think it looks great! Just one typo.

l-heemann · 2025-06-26T13:59:27Z

I think it looks great! Just one typo.

Great! I don't want to interfere with the other PRs going on in this repo, so I think I'll wait with rebase/merging this until those are merged :)

Hunterness · 2025-06-30T14:08:13Z

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

+CYPHER 25 CREATE ALIAS `garden.flowers` FOR DATABASE `northwind-graph`
+CYPHER 25 CREATE ALIAS `garden.flowers` FOR DATABASE `northwind-graph`


shouldn't one of these be un escaped to show some difference in the commands?

I think this was intentional. As Cypher 25 is going out today, we will merge this PR but feel free to double-check this with Lasse when he is back from vacation

Sure, @l-heemann can confirm if that is something we want to update when he gets back :P

Yes this is intentional to show the difference between Cypher 5 and 25 (by toggling the tabbed view back and forth)

But having both the CYPHER 25 commands be identical feels weird to me... if I did that in Cypher 5 I would fail on it trying to create the same thing twice as well... so why not have one garden.flowers (unescaped) and one `garden.flowers` (escaped together) in the Cypher 25 example 🤔 wouldn't that be closer to the commands for Cypher 5 (that does differ in that one is escaped together and one separately)

That would be making it less clear by introducing a third variation (unquoted). The whole point of this section is to show that the syntax used to differentiate between composite constituent and regular alias, but now there is no syntactic difference and therefore the error says "these things are the same".

I didn't come up with a better way to highlight "no syntactic difference" other than showing the two identical lines next to each other.

🤷 just looked odd to me

Hunterness · 2025-06-30T14:12:43Z

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

-Database names are the only identifier for which dots do not need to be quoted.
-For example `main.db` is a valid database name.


wouldn't these two make sense to keep? 🤔

There is a conflict on this line, so it seems this text is not looking like this in dev anymore. When I did a rebase this text was already removed as part of some already merged PR

I'm fine with it, but I still think having Database names are the only identifier for which dots do not need to be quoted. might be nice, since that is something that separates the database names with other identifiers 🤷

…tain dots'

…ses-composite-databases.adoc Co-authored-by: Lasse Heemann <[email protected]>

Co-authored-by: Reneta Popova <[email protected]>

Move label from individual examples to whole section Co-authored-by: Reneta Popova <[email protected]>

…ses-composite-databases.adoc

GQL section review fixes Co-authored-by: Reneta Popova <[email protected]>

…ses-composite-databases.adoc Co-authored-by: Reneta Popova <[email protected]>

neo4j-docops-agent · 2025-07-02T09:45:14Z

Thanks for the documentation updates.

The preview documentation has now been torn down - reopening this PR will republish it.

Documentation for: CIP-212 neo-technology/neo4j#31208 neo-technology/neo4j#31418 --------- Co-authored-by: Louise Berglund <[email protected]> Co-authored-by: Reneta Popova <[email protected]>

Backporting relevant parts of #2443 to 5.26 as the previous deprecation has been removed from 5.26.9

renetapopova added the DO NOT MERGE label Jun 24, 2025

l-heemann force-pushed the graph-reference-C25 branch from adc6ac6 to 975bf2c Compare June 25, 2025 08:14

l-heemann added the team-cypher-operations label Jun 25, 2025

l-heemann assigned Lojjs Jun 25, 2025

l-heemann changed the title ~~Graph reference updates for Cypher 25 / Neo4j 2025.06 (targeting dev)~~ Graph reference updates for Cypher 25 / Neo4j 2025.06 Jun 25, 2025

Lojjs requested changes Jun 25, 2025

View reviewed changes

Lojjs approved these changes Jun 26, 2025

View reviewed changes

renetapopova requested changes Jun 26, 2025

View reviewed changes

renetapopova reviewed Jun 26, 2025

View reviewed changes

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

renetapopova reviewed Jun 26, 2025

View reviewed changes

renetapopova self-requested a review June 26, 2025 13:11

renetapopova reviewed Jun 26, 2025

View reviewed changes

modules/ROOT/pages/database-administration/aliases/manage-aliases-composite-databases.adoc Outdated Show resolved Hide resolved

renetapopova approved these changes Jun 26, 2025

View reviewed changes

renetapopova added cherry-pick-this-to-cypher-25 and removed DO NOT MERGE labels Jun 26, 2025

This was referenced Jun 27, 2025

Remove old graph reference deprecation #2451

Closed

Dots in database name are no longer deprecated. #2452

Merged

Hunterness reviewed Jun 30, 2025

View reviewed changes

renetapopova added 2025.06 and removed cherry-pick-this-to-cypher-25 labels Jul 1, 2025

l-heemann and others added 7 commits July 2, 2025 11:24

Update hidden setup code to use Cypher 25

3cddea6

Update naming 'Note!'s

aa245ea

Update composite example

49d24ac

Update detailed description section on 'Database alias names that con…

693d69a

…tain dots'

Review comments

0e6ef95

Update modules/ROOT/pages/database-administration/aliases/manage-alia…

5c4de06

…ses-composite-databases.adoc Co-authored-by: Lasse Heemann <[email protected]>

Apply suggestions from code review

0cb47c2

Co-authored-by: Reneta Popova <[email protected]>

l-heemann and others added 7 commits July 2, 2025 11:28

Apply suggestions from code review

8d60ba6

Move label from individual examples to whole section Co-authored-by: Reneta Popova <[email protected]>

Add GQL statuses

3cab69a

Update modules/ROOT/pages/database-administration/aliases/manage-alia…

8e50066

…ses-composite-databases.adoc

Remove duplicate example

78d4381

Apply suggestions from code review

dabed61

GQL section review fixes Co-authored-by: Reneta Popova <[email protected]>

Fix unterminated blocks

5fece98

Update modules/ROOT/pages/database-administration/aliases/manage-alia…

8046749

…ses-composite-databases.adoc Co-authored-by: Reneta Popova <[email protected]>

Lojjs force-pushed the graph-reference-C25 branch from 90f8297 to 8046749 Compare July 2, 2025 09:43

NataliaIvakina merged commit 47973b3 into neo4j:dev Jul 2, 2025
8 checks passed

Lojjs added a commit that referenced this pull request Jul 7, 2025

Dots in database name are no longer deprecated. (#2452)

e2e4985

Backporting relevant parts of #2443 to 5.26 as the previous deprecation has been removed from 5.26.9

		CYPHER 25 CREATE ALIAS `garden.flowers` FOR DATABASE `northwind-graph`
		CYPHER 25 CREATE ALIAS `garden.flowers` FOR DATABASE `northwind-graph`

		Database names are the only identifier for which dots do not need to be quoted.
		For example `main.db` is a valid database name.

Graph reference updates for Cypher 25 / Neo4j 2025.06 #2443

Graph reference updates for Cypher 25 / Neo4j 2025.06 #2443

Uh oh!

Conversation

l-heemann commented Jun 24, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Lojjs left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Lojjs left a comment • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

renetapopova left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

l-heemann commented Jun 26, 2025

Uh oh!

renetapopova commented Jun 26, 2025

Uh oh!

Uh oh!

renetapopova left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

renetapopova left a comment

Choose a reason for hiding this comment

Uh oh!

l-heemann commented Jun 26, 2025

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Lojjs Jul 2, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

l-heemann commented Jun 24, 2025 •

edited

Loading

Lojjs left a comment •

edited

Loading

Lojjs Jul 2, 2025 •

edited

Loading

neo4j-docops-agent commented Jul 2, 2025 •

edited

Loading