Select Cypher version #1123

JPryce-Aklundh · 2024-11-27T14:01:15Z

Operations manual PRs mentioned in this PR:

TODO: Add clarifying note on Additions page

modules/ROOT/pages/queries/select-version.adoc

…cs-cypher into select_version

Hunterness

Should not be a surprise that I have several comments XD

modules/ROOT/pages/queries/select-version.adoc

…cs-cypher into select_version

modules/ROOT/pages/queries/select-version.adoc

mnd999 · 2025-02-26T10:01:47Z

modules/ROOT/pages/queries/select-version.adoc

+.Create a database with Cypher 5 as the default language
+[source, cypher]
+----
+CREATE DATABASE my_database DEFAULT LANGUAGE CYPHER 5


I have linked back to these sections from the operations manual documentation of these commands. There doesn't seem much point documenting it twice.

I think all sections related to database administration should go to the Operations manual, and here, we can add just one link.

Hunterness · 2025-02-26T14:16:02Z

modules/ROOT/pages/queries/select-version.adoc

+*Existing user databases:* `CYPHER 5` +
+*New user databases default:* `CYPHER 5`


Do we want to add something like this for the remote alias case I mentioned on slack (in addition to having a short sentence about it somewhere as we discussed)

Suggested change

*Existing user databases:* `CYPHER 5` +

*New user databases default:* `CYPHER 5`

*Existing user databases:* `CYPHER 5` +

*Existing non-constituent remote database aliases:* `CYPHER 5` +

*New user databases and non-constituent remote database aliases default:* `CYPHER 5`

(if yes, then we should also update the other two rows in the table)

I guess we decided not to care about aliases on this page and leave that for the operations manual

…cs-cypher into select_version

modules/ROOT/pages/queries/select-version.adoc

Hunterness · 2025-04-17T11:08:48Z

modules/ROOT/pages/queries/select-version.adoc


 To select a different default Cypher version for a database, add `DEFAULT LANGUAGE <language version>` to the link:{neo4j-docs-base-uri}/operations-manual/current/database-administration/standard-databases/create-databases/[`CREATE DATABASE`] statement.
 This can be done on any Neo4j database.

-Selecting `CYPHER 5` as the default database language ensures that every query run on that database uses the language as it existed at the time of the Neo4j 5.26 LTS release (unless a query is prepended with `CYPHER 25`, which overrides this default).
-Any changes introduced after 5.26 will not affect the semantics of the query.
+Selecting `CYPHER 5` as the default database language ensures that every query run on that database uses the language as it existed at the time of the Neo4j **TBC** release (unless a query is prepended with `CYPHER 25`, which overrides this default).


this bit seems more odd when considering CYPHER 5 is the default, it feels more like it's pointing out a difference to the default (probably due to being added to do just that before :P)

modules/ROOT/pages/queries/select-version.adoc

stefano-ottolenghi · 2025-06-02T05:15:08Z

modules/ROOT/pages/queries/select-version.adoc

+For information about Cypher 5, see the link:https://neo4j.com/docs/cypher-manual/5/introduction/[Cypher 5 Manual].
+
+[NOTE]
+Although Cypher 5 queries are currently supported on Neo4j 2025.06+ databases, they will eventually need to be migrated to Cypher 25, as support for Cypher 5 will be discontinued in a future release (anticipated no earlier than two additional server LTS cycles).


Can we give a time horizon for when Cypher 5 will be discontinued? Or at least a no earlier than? As we say people are going to have to migrate eventually, it's useful for customers to know by when they need to allocate work to make it happen.

stefano-ottolenghi · 2025-06-02T05:15:51Z

modules/ROOT/pages/queries/select-version.adoc

+======
+=====
+
+Selecting `CYPHER 25` ensures that all queries run on that database will be executed using the language as it exists in the version of Neo4j that the database is currently running, provided it is on Neo4j 2025.06 or later (unless a query is prepended with `CYPHER 5`, which overrides this default).


Suggested change

Selecting `CYPHER 25` ensures that all queries run on that database will be executed using the language as it exists in the version of Neo4j that the database is currently running, provided it is on Neo4j 2025.06 or later (unless a query is prepended with `CYPHER 5`, which overrides this default).

Selecting `CYPHER 25` ensures that all queries run on that database will be executed using the language as it exists in the version of Neo4j that the database is currently running, provided it is on Neo4j 2025.06 or later (unless a query is xref:selection-query-cypher-version[prepended with `CYPHER 5`], which overrides this default).

stefano-ottolenghi · 2025-06-02T05:19:44Z

modules/ROOT/pages/queries/select-version.adoc

+To select the Cypher version of a query, prepend it with `CYPHER <language version>`.
+This selection will override the default language for the database the query is executed against, and allows you to either work with Cypher 25 features in a database that has Cypher 5 as the default language, or to continue running your Cypher 5 queries on a database that has Cypher 25 as the default language.
+
+Queries run with Cypher 5 will eventually need to be updated to Cypher 25 as support for Cypher 5 will be discontinued in the future (anticipated no earlier than two additional server LTS cycles).


As above, time horizon.

stefano-ottolenghi · 2025-06-02T05:22:31Z

modules/ROOT/pages/queries/select-version.adoc

+Selecting `CYPHER 25` ensures that the query will be executed using the language as it exists in the version of Neo4j that the database is currently running, provided it is on Neo4j 2025.06 or later.
+
+Selecting `CYPHER 5` ensures that the query will be executed using the language as it existed at the time of the Neo4j 2025.05 release.
+Any changes introduced after the 2025.05 release will not affect the query.


Does this literally mean that no changes at all will go into Cypher 5 after 25 is out? If one takes this too literally it means no bugfixes or any form of improvement. I'd find clearer a rephrasing along the lines of using the language in its LTS form.

stefano-ottolenghi · 2025-06-02T05:23:52Z

modules/ROOT/pages/queries/select-version.adoc

+
+For example, APOC 2025.06 removed Cypher 25 support of the procedure `apoc.create.uuids()`, meaning it is not available to queries running Cypher 25.
+However, it can still be used on APOC 2025.06 if queries are prepended with `CYPHER 5`, or if the database’s default version is set to `CYPHER 5`.
+In this case, Neo4j will use APOC and Cypher as they existed at the time of the 2025.05 release.


…cs-cypher into select_version

neo4j-docops-agent · 2025-06-23T19:18:31Z

Thanks for the documentation updates.

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

Operations manual PRs mentioned in this PR: - neo4j/docs-operations#2153 - neo4j/docs-operations#2116 TODO: Add clarifying note on Additions page --------- Co-authored-by: Stefano Ottolenghi <[email protected]>

Hunterness

I know this has been merged but I anyway wanted to take a look at what it ended up like before looking at the operations manual one and the additions/deprecations/removal page updates.

And of course I found some things :P It's mainly the two comments around needed privileges that actually needs some updates as at least one of them is straight up lying and one feels incomplete.

Hunterness · 2025-06-26T08:31:53Z

modules/ROOT/pages/queries/select-version.adoc

+To select a default Cypher version when creating a database, add `DEFAULT LANGUAGE <language version>` to the link:{neo4j-docs-base-uri}/operations-manual/current/database-administration/standard-databases/create-databases/[`CREATE DATABASE`] statement.
+
+[NOTE]
+Setting the default language requires the link:{neo4j-docs-base-uri}/operations-manual/current/authentication-authorization/dbms-administration/#access-control-dbms-administration-database-management[`SET DATABASE DEFAULT LANGUAGE` privilege].


This only applies for the ALTER DATABASE command. For CREATE DATABASE and CREATE COMPOSITE DATABASE commands only the CREATE DATABASE/CREATE COMPOSITE DATABASE privileges are needed.

might not need the note at all since it should only say that to create you need privilege to create, which isn't anything new, in difference to that alter case that has new/separate privileges 🤷

Hunterness · 2025-06-26T08:35:39Z

modules/ROOT/pages/queries/select-version.adoc

+.Cypher 25
+[source,cypher]
+----
+CREATE DATABASE actors DEFAULT LANGUAGE CYPHER 25


Suggested change

CREATE DATABASE actors DEFAULT LANGUAGE CYPHER 25

CREATE DATABASE actors SET DEFAULT LANGUAGE CYPHER 25

This is optional, I prefer having the SET 🤷

SET was added as an optional keyword in the Cypher 25 version of CREATE DATABASE (for all sub-clauses) and isn't available in Cypher 5

Hunterness · 2025-06-26T08:37:02Z

modules/ROOT/pages/queries/select-version.adoc

+To alter the default Cypher version on an existing database, add `SET DEFAULT LANGUAGE <language version>` to the link:{neo4j-docs-base-uri}/operations-manual/current/database-administration/standard-databases/alter-databases/[`ALTER DATABASE`] command.
+
+[NOTE]
+Altering the default language requires the link:{neo4j-docs-base-uri}/operations-manual/current/authentication-authorization/dbms-administration/#access-control-dbms-administration-database-management[`SET DATABASE DEFAULT LANGUAGE` privilege].


This only applies for standard and system database, for composite databases you'll need the ALTER COMPOSITE DATABASE privilege instead (it doesn't have a lower level privilege like the standard database case does).

Hunterness · 2025-06-26T08:48:46Z

modules/ROOT/pages/queries/select-version.adoc

+*Existing user databases:* `CYPHER 5` +
+*New user databases default:* `CYPHER 5`


I guess we decided not to care about aliases on this page and leave that for the operations manual

write cypher selection page

8514b29

JPryce-Aklundh added the Cypher 25 label Nov 27, 2024

NataliaIvakina reviewed Nov 29, 2024

View reviewed changes

modules/ROOT/pages/queries/select-version.adoc Outdated Show resolved Hide resolved

JPryce-Aklundh added 2 commits December 20, 2024 13:43

change 2025.01 to 2025.02

85f4663

change page-version to current in links

8b25fa4

JPryce-Aklundh mentioned this pull request Jan 30, 2025

Conditional queries (WHEN) #1175

Merged

JPryce-Aklundh and others added 11 commits February 3, 2025 13:22

2025.03 update and procedures section

6a54b9a

Merge branch 'cypher-25' into select_version

e1a6900

add config info

b5b82b4

conflict fix

11e8788

Merge branch 'select_version' of https://github.com/JPryce-Aklundh/do…

5e285b4

…cs-cypher into select_version

fix links

fc023a6

clarify table

360f226

typo in example

3d5f74f

ambiguity clearup

5b0baa8

Merge branch 'select_version' of https://github.com/JPryce-Aklundh/do…

1b3f808

…cs-cypher into select_version

typos

7be498c

Hunterness reviewed Feb 25, 2025

View reviewed changes

JPryce-Aklundh added 2 commits February 25, 2025 14:42

post review edit

8d44f62

Merge branch 'select_version' of https://github.com/JPryce-Aklundh/do…

4b4133b

…cs-cypher into select_version

JPryce-Aklundh marked this pull request as ready for review February 25, 2025 14:23

Hunterness reviewed Feb 25, 2025

View reviewed changes

modules/ROOT/pages/queries/select-version.adoc Outdated Show resolved Hide resolved

modules/ROOT/pages/queries/select-version.adoc Outdated Show resolved Hide resolved

mnd999 mentioned this pull request Feb 25, 2025

Docs for DEFAULT LANGUAGE neo4j/docs-operations#2153

Closed

correction

034101b

Hunterness reviewed Feb 26, 2025

View reviewed changes

modules/ROOT/pages/queries/select-version.adoc Outdated Show resolved Hide resolved

modules/ROOT/pages/queries/select-version.adoc Outdated Show resolved Hide resolved

mnd999 reviewed Feb 26, 2025

View reviewed changes

add links to ops manual privilege and update default value

b8a9d64

Hunterness reviewed Feb 26, 2025

View reviewed changes

JPryce-Aklundh added 2 commits March 12, 2025 16:12

2025.03 to 2025.04

66afae4

note attempt

b4f0831

JPryce-Aklundh added 2 commits April 17, 2025 10:55

Merge branch 'select_version' of https://github.com/JPryce-Aklundh/do…

096d0d3

…cs-cypher into select_version

update

40e019d

neo4j deleted a comment from neo-technology-commit-status-publisher Apr 17, 2025

Hunterness reviewed Apr 17, 2025

View reviewed changes

remove inexplicable underscores

11b09df

Hunterness reviewed Apr 17, 2025

View reviewed changes

modules/ROOT/pages/queries/select-version.adoc Outdated Show resolved Hide resolved

modules/ROOT/pages/queries/select-version.adoc Outdated Show resolved Hide resolved

modules/ROOT/pages/queries/select-version.adoc Outdated Show resolved Hide resolved

JPryce-Aklundh added 5 commits April 17, 2025 14:51

config setting underscores

4e1bf7d

rewrite

d463f0d

restructure

2de872d

emphasis

63d64d4

spelling

e5c3eef

stefano-ottolenghi reviewed Jun 2, 2025

View reviewed changes

stefano-ottolenghi changed the base branch from cypher-25 to dev June 17, 2025 08:42

stefano-ottolenghi and others added 9 commits June 17, 2025 10:43

Merge branch 'dev' into select_version

ee37101

reword

57907c5

Merge branch 'select_version'

6985f5c

query fix

1d4701d

proper role

cb1a5f0

Merge branch 'dev' into select_version

0de4ff5

final

ca45c21

Merge branch 'select_version' of https://github.com/JPryce-Aklundh/do…

1bdf52d

…cs-cypher into select_version

Merge branch 'dev' into select_version

5e533a9

JPryce-Aklundh merged commit caeeee4 into neo4j:dev Jun 23, 2025
5 checks passed

JPryce-Aklundh deleted the select_version branch June 23, 2025 19:22

Hunterness reviewed Jun 26, 2025

View reviewed changes

This was referenced Jun 26, 2025

Add language version control commands to Additions page #1314

Merged

Update Select Cypher versions guide with relevant links to Operations Manual and Upgrade and migration guide #1327

Merged

		Existing user databases: `CYPHER 5` +
		New user databases default: `CYPHER 5`

	Selecting `CYPHER 25` ensures that all queries run on that database will be executed using the language as it exists in the version of Neo4j that the database is currently running, provided it is on Neo4j 2025.06 or later (unless a query is prepended with `CYPHER 5`, which overrides this default).
	Selecting `CYPHER 25` ensures that all queries run on that database will be executed using the language as it exists in the version of Neo4j that the database is currently running, provided it is on Neo4j 2025.06 or later (unless a query is xref:selection-query-cypher-version[prepended with `CYPHER 5`], which overrides this default).

	CREATE DATABASE actors DEFAULT LANGUAGE CYPHER 25
	CREATE DATABASE actors SET DEFAULT LANGUAGE CYPHER 25

Select Cypher version #1123

Select Cypher version #1123

Uh oh!

Conversation

JPryce-Aklundh commented Nov 27, 2024 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Uh oh!

Hunterness 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!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

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!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

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!

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!

neo4j-docops-agent commented Jun 23, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Uh oh!

Hunterness left a comment

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!

Uh oh!

JPryce-Aklundh commented Nov 27, 2024 •

edited

Loading

Hunterness left a comment •

edited

Loading

neo4j-docops-agent commented Jun 23, 2025 •

edited

Loading