Skip to content

Commit 66afae4

Browse files
2025.03 to 2025.04
1 parent b8a9d64 commit 66afae4

File tree

1 file changed

+13
-13
lines changed

1 file changed

+13
-13
lines changed

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

Lines changed: 13 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -12,12 +12,12 @@ Starting in 2025, the Neo4j server transitioned to a calendar-based versioning s
1212
This means Neo4j will no longer use its previous semantic versioning and release pattern (e.g., 5.25, 5.26).
1313
Instead, releases from 2025 onwards will follow a *YYYY.MM* format, beginning with version 2025.01 released in January 2025, followed by 2025.02 released in February 2025, and so on.
1414

15-
Cypher 25 is introduced alongside Neo4j 2025.03 and is the default language for newly created databases running version 2025.03 or later.
16-
However, users running Neo4j version 2025.03 or later can choose to run their queries using the previous version of Cypher: Cypher 5.
15+
Cypher 25 is introduced alongside Neo4j 2025.04 and is the default language for newly created databases running version 2025.04 or later.
16+
However, users running Neo4j version 2025.04 or later can choose to run their queries using the previous version of Cypher: Cypher 5.
1717
If so, Neo4j will use Cypher as it existed at the time of the Neo4j 5.26 long-term support (LTS) release.
1818

1919
[NOTE]
20-
Databases migrating to Neo4j 2025.03+ from earlier versions will continue to use Cypher 5 as their default language.
20+
Databases migrating to Neo4j 2025.04+ from earlier versions will continue to use Cypher 5 as their default language.
2121
To change the default language on such databases, see xref:queries/select-version.adoc#alter-default-cypher-version[Alter the default Cypher version for a database].
2222
See also xref:queries/select-version.adoc#config-database-upgrades[Cypher versions, configuration settings, and DBMS upgrades] for information about what default Cypher version is used when upgrading a DBMS.
2323

@@ -32,7 +32,7 @@ To select the Cypher version of a query, prepend it with `CYPHER <language versi
3232
Selecting `CYPHER 5` ensures that the query will be executed using the language as it existed at the time of the Neo4j 5.26 LTS release.
3333
Any changes introduced after 5.26 will not affect the query.
3434

35-
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.
35+
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.04 or later.
3636

3737
Below are two examples showing the two versions of Cypher behaving differently.
3838

@@ -115,13 +115,13 @@ For example, if a database is created with Cypher 5 as its default language, pre
115115
=== Procedures and functions
116116

117117
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.
118-
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.
118+
Therefore, procedures and functions in Neo4j 2025.04+ and APOC 2025.04+ (both of which have Cypher 25 as their default language) may behave differently depending on what version of Cypher is used.
119119

120-
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.
121-
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`.
120+
For example, APOC 2025.04 removed Cypher 25 support of the procedure `apoc.create.uuids()`, meaning it is not available to queries running Cypher 25.
121+
However, it can still be used on APOC 2025.04 if queries are prepended with `CYPHER 5`, or if the database’s default version is set to `CYPHER 5`.
122122
In this case, Neo4j will use APOC and Cypher as they existed at the time of the 5.26 LTS release.
123123

124-
.Using a procedure removed in Cypher 25 with APOC 2025.03+
124+
.Using a procedure removed in Cypher 25 with APOC 2025.04+
125125
[source, cypher]
126126
----
127127
CYPHER 5
@@ -145,7 +145,7 @@ RETURN n.name
145145
[[select-default-cypher-version]]
146146
== Select the default Cypher version when creating a database
147147

148-
Databases created on Neo4j 2025.03 or later will have Cypher 25 as their default language (if {neo4j-docs-base-uri}/operations-manual/current/configuration/configuration-settings/#config_db.query.default_language[`config_db.query.default_language`] is set to `CYPHER_25` -- see xref:queries/select-version.adoc#config-database-upgrades[Cypher versions, configuration settings, and DBMS upgrades] below).
148+
Databases created on Neo4j 2025.04 or later will have Cypher 25 as their default language (if {neo4j-docs-base-uri}/operations-manual/current/configuration/configuration-settings/#config_db.query.default_language[`config_db.query.default_language`] is set to `CYPHER_25` -- see xref:queries/select-version.adoc#config-database-upgrades[Cypher versions, configuration settings, and DBMS upgrades] below).
149149
This is true for the link:{neo4j-docs-base-uri}/operations-manual/current/database-administration/#manage-database-systems[system, standard, and composite] Neo4j databases.
150150

151151
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.
@@ -160,7 +160,7 @@ Any changes introduced after 5.26 will not affect the semantics of the query.
160160
CREATE DATABASE my_database DEFAULT LANGUAGE CYPHER 5
161161
----
162162

163-
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 (unless a query is prepended with `CYPHER 5`, which overrides this default).
163+
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.04 or later (unless a query is prepended with `CYPHER 5`, which overrides this default).
164164

165165
.Create a database with Cypher 25 as the default language
166166
[source, cypher]
@@ -230,19 +230,19 @@ The table below outlines which Cypher version is assigned to databases in differ
230230
|===
231231
| Scenario | `db.query.default_language` | Databases
232232

233-
| *Standard DBMS upgrade to Neo4j 2025.03+*
233+
| *Standard DBMS upgrade to Neo4j 2025.04+*
234234
| Unset
235235
| *Existing system database:* `CYPHER 5` +
236236
*Existing user databases:* `CYPHER 5` +
237237
*New user databases default:* `CYPHER 5`
238238

239-
| *Custom DBMS upgrade to Neo4j 2025.03+*
239+
| *Custom DBMS upgrade to Neo4j 2025.04+*
240240
| Manually set to `CYPHER_25` by administrator
241241
| *Existing system database:* `CYPHER 5` +
242242
*Existing user databases:* `CYPHER 5` +
243243
*New user databases default:* `CYPHER 25`
244244

245-
| *New installation of Neo4j 2025.03+*
245+
| *New installation of Neo4j 2025.04+*
246246
| Set to `CYPHER_25`
247247
| *New system database:* `CYPHER 25` +
248248
*New user databases default:* `CYPHER 25`

0 commit comments

Comments
 (0)