Skip to content
Merged
Changes from 4 commits
Commits
Show all changes
42 commits
Select commit Hold shift + click to select a range
8514b29
write cypher selection page
JPryce-Aklundh Nov 14, 2024
85f4663
change 2025.01 to 2025.02
JPryce-Aklundh Dec 20, 2024
8b25fa4
change page-version to current in links
JPryce-Aklundh Jan 10, 2025
6a54b9a
2025.03 update and procedures section
JPryce-Aklundh Feb 3, 2025
e1a6900
Merge branch 'cypher-25' into select_version
JPryce-Aklundh Feb 25, 2025
b5b82b4
add config info
JPryce-Aklundh Feb 25, 2025
11e8788
conflict fix
JPryce-Aklundh Feb 25, 2025
5e285b4
Merge branch 'select_version' of https://github.com/JPryce-Aklundh/do…
JPryce-Aklundh Feb 25, 2025
fc023a6
fix links
JPryce-Aklundh Feb 25, 2025
360f226
clarify table
JPryce-Aklundh Feb 25, 2025
3d5f74f
typo in example
stefano-ottolenghi Feb 25, 2025
5b0baa8
ambiguity clearup
JPryce-Aklundh Feb 25, 2025
1b3f808
Merge branch 'select_version' of https://github.com/JPryce-Aklundh/do…
JPryce-Aklundh Feb 25, 2025
7be498c
typos
stefano-ottolenghi Feb 25, 2025
8d44f62
post review edit
JPryce-Aklundh Feb 25, 2025
4b4133b
Merge branch 'select_version' of https://github.com/JPryce-Aklundh/do…
JPryce-Aklundh Feb 25, 2025
034101b
correction
JPryce-Aklundh Feb 26, 2025
b8a9d64
add links to ops manual privilege and update default value
JPryce-Aklundh Feb 26, 2025
66afae4
2025.03 to 2025.04
JPryce-Aklundh Mar 12, 2025
b4f0831
note attempt
JPryce-Aklundh Mar 12, 2025
2bf10cc
conflict fix
JPryce-Aklundh Mar 12, 2025
0dfb4b9
2025.05 update
JPryce-Aklundh Apr 3, 2025
6dc83e8
Merge branch 'cypher-25' into select_version
JPryce-Aklundh Apr 3, 2025
1c72599
merge cypher-25 branch
JPryce-Aklundh Apr 17, 2025
9b847b0
draft update of default language information
JPryce-Aklundh Apr 17, 2025
096d0d3
Merge branch 'select_version' of https://github.com/JPryce-Aklundh/do…
JPryce-Aklundh Apr 17, 2025
40e019d
update
JPryce-Aklundh Apr 17, 2025
11b09df
remove inexplicable underscores
JPryce-Aklundh Apr 17, 2025
4e1bf7d
config setting underscores
JPryce-Aklundh Apr 17, 2025
d463f0d
rewrite
JPryce-Aklundh May 16, 2025
2de872d
restructure
JPryce-Aklundh May 19, 2025
63d64d4
emphasis
JPryce-Aklundh May 19, 2025
e5c3eef
spelling
JPryce-Aklundh May 26, 2025
ee37101
Merge branch 'dev' into select_version
stefano-ottolenghi Jun 17, 2025
57907c5
reword
JPryce-Aklundh Jun 23, 2025
6985f5c
Merge branch 'select_version'
JPryce-Aklundh Jun 23, 2025
1d4701d
query fix
JPryce-Aklundh Jun 23, 2025
cb1a5f0
proper role
JPryce-Aklundh Jun 23, 2025
0de4ff5
Merge branch 'dev' into select_version
JPryce-Aklundh Jun 23, 2025
ca45c21
final
JPryce-Aklundh Jun 23, 2025
1bdf52d
Merge branch 'select_version' of https://github.com/JPryce-Aklundh/do…
JPryce-Aklundh Jun 23, 2025
5e533a9
Merge branch 'dev' into select_version
JPryce-Aklundh Jun 23, 2025
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
12 changes: 6 additions & 6 deletions modules/ROOT/pages/queries/select-version.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -31,7 +31,7 @@ For information about Cypher 5, see the link:https://neo4j.com/docs/cypher-manua
To select the Cypher version of a query, prepend it with `CYPHER <language version>`.

Selecting `CYPHER 5` ensures that the query will be executed using the language as it existed at the time of the Neo4j 5.26 long-term support release.
Any changes introduced in Neo4j 2025.03 or later will not affect the query.
Any changes introduced after 5.26 will not affect the query.

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.03 or later.

Expand All @@ -54,7 +54,7 @@ SET n = r
[source, cypher]
----
CYPHER 25
MATCH (n:Order)-[r:SHIPPED_TO]->(m:Address)
MATCH (n:Order)-[r:SHIPPED_TO]->(:Address)
SET n = properties(r)
----
======
Expand Down Expand Up @@ -92,7 +92,7 @@ SHOW CONSTRAINTS YIELD name, type
.Listing the constraint name and type values using Cypher 25
[source, cypher]
----
CYPHER 5
CYPHER 25
SHOW CONSTRAINTS YIELD name, type
----

Expand All @@ -116,7 +116,7 @@ For example, if a database is created with Cypher 5 as its default language, pre
=== Procedures and functions

link:{neo4j-docs-base-uri}/operations-manual/current/procedures[Procedures] and xref:functions/index.adoc[functions] (including built-in and link:{neo4j-docs-base-uri}/apoc/current/[APOC]) are tied to a specific Cypher language version.
Therefore, procedures and functions in Neo4j 2025.03+ and APOC 2025.03+ (both of which have Cypher 25 as their default language), may behave differently depending on what version of Cypher is used.
Therefore, procedures and functions in Neo4j 2025.03+ and APOC 2025.03+ (both of which have Cypher 25 as their default language) may behave differently depending on what version of Cypher is used.

For example, APOC 2025.03 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.03 if queries are prepended with `CYPHER 5`, or if the database’s default version is set to `CYPHER 5`.
Expand Down Expand Up @@ -156,7 +156,7 @@ This can be done on any Neo4j database.
Selecting a default Cypher version on a database requires the `SET DEFAULT LANGUAGE` privilege.

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 long-term support release.
Any changes introduced in Neo4j 2025.03 or later will not affect the semantics of the query.
Any changes introduced after 5.26 will not affect the semantics of the query.

.Create a database with Cypher 5 as the default language
[source, cypher]
Expand Down Expand Up @@ -197,7 +197,7 @@ ALTER DATABASE my_database SET DEFAULT LANGUAGE CYPHER 25

The Cypher version of a database can be seen using the link:{neo4j-docs-base-uri}/operations-manual/current/database-administration/standard-databases/listing-databases/[`SHOW DATABASES`] command as follows:

.Set Cypher 25 as the default language on an existing database
.Retrieve the default language on existing databases
[source, cypher]
----
SHOW DATABASES YIELD name, defaultLanguage
Expand Down