Skip to content

Commit cec0a14

Browse files
authored
Merge branch 'dev' into dev-clauseComposition_WriteReadConflicts
2 parents 2f4454f + bd97e08 commit cec0a14

File tree

7 files changed

+121
-10
lines changed

7 files changed

+121
-10
lines changed

antora.yml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -7,4 +7,4 @@ nav:
77
- modules/ROOT/content-nav.adoc
88
asciidoc:
99
attributes:
10-
neo4j-version: '2025.06'
10+
neo4j-version: '2025.07'

modules/ROOT/pages/appendix/gql-conformance/supported-optional.adoc

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -106,7 +106,7 @@ These codes order the features in the table below.
106106

107107
| GD01
108108
| Updatable graphs
109-
| xref:clauses/clause-composition.adoc#writing-clauses[Cypher clauses -> Writing clauses]
109+
| xref:clauses/index.adoc#writing-clauses[Cypher clauses -> Writing clauses]
110110
| * Feature GD01 implies compliance with GQL feature GT01, "Explicit transaction commands", which states that conforming languages shall contain the following transaction control commands: `START TRANSACTION`, `ROLLBACK`, and `COMMIT`.
111111
These are not present in Cypher.
112112
However, Neo4j offers transaction management through the link:{neo4j-docs-base-uri}/create-applications[driver] transaction API.

modules/ROOT/pages/deprecations-additions-removals-compatibility.adoc

Lines changed: 106 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -341,6 +341,112 @@ a|
341341
label:functionality[]
342342
label:new[]
343343

344+
[source, cypher, role="noheader"]
345+
----
346+
CREATE [COMPOSITE] DATABASE actors SET DEFAULT LANGUAGE CYPHER 25
347+
----
348+
349+
a| Set the default Cypher version for a standard or composite database when creating it.
350+
The available versions are `CYPHER 25` and `CYPHER 5`.
351+
If not specified, the default language for the database is set to the default language of the DBMS.
352+
For more information, see the following sections in the Operations Manual:
353+
354+
* link:{neo4j-docs-base-uri}/operations-manual/current/database-administration/standard-databases/create-databases/#_set_a_default_cypher_version_for_a_standard_database[Set a default Cypher version for a standard database].
355+
* link:{neo4j-docs-base-uri}/operations-manual/current/database-administration/composite-databases/create-composite-databases/#composite-databases-default-language[Set the default Cypher version for a composite database].
356+
357+
a|
358+
label:functionality[]
359+
label:new[]
360+
361+
[source, cypher, role="noheader"]
362+
----
363+
CREATE ALIAS `remote-with-default-language`
364+
FOR DATABASE `northwind-graph-2020`
365+
AT "neo4j+s://location:7687"
366+
USER alice
367+
PASSWORD 'example_secret'
368+
DEFAULT LANGUAGE CYPHER 25
369+
----
370+
371+
a| Set the default Cypher version for a remote database alias when creating it.
372+
The available versions are `CYPHER 5` and `CYPHER 25`.
373+
Local database aliases and database aliases in composite databases cannot be assigned a default Cypher version.
374+
Local database aliases always have the Cypher version of their target database and database aliases in composite databases always have the Cypher version of the composite database they belong to.
375+
For more information, see the link:{neo4j-docs-base-uri}/operations-manual/current/database-administration/aliases/manage-aliases-standard-databases/#_set_a_default_cypher_version_for_remote_database_aliases[Operations Manual -> Set a default Cypher version for remote database aliases].
376+
377+
a|
378+
label:functionality[]
379+
label:new[]
380+
[source, cypher, role="noheader"]
381+
----
382+
ALTER DATABASE movies SET DEFAULT LANGUAGE CYPHER 25
383+
----
384+
385+
a| Alter the default Cypher version of an existing standard or composite database.
386+
The available versions are `CYPHER 25` and `CYPHER 5`.
387+
For more information, see the link:{neo4j-docs-base-uri}/operations-manual/current/database-administration/standard-databases/alter-databases/#alter-database-default-language[Operations Manual -> Alter the default Cypher version of an existing database].
388+
389+
a|
390+
label:functionality[]
391+
label:new[]
392+
393+
[source, cypher, role="noheader"]
394+
----
395+
ALTER ALIAS `remote-with-default-language` SET DATABASE DEFAULT LANGUAGE CYPHER 25
396+
----
397+
398+
a| Alter the default Cypher version of a remote database alias.
399+
The available versions are `CYPHER 25` and `CYPHER 5`.
400+
It is not possible to alter the default Cypher version of a local database alias or an alias belonging to a composite database.
401+
Local database aliases always have the Cypher version of their target database and aliases belonging to composite databases always have the Cypher version of the composite database.
402+
For more information, see the link:{neo4j-docs-base-uri}/operations-manual/current/database-administration/aliases/manage-aliases-standard-databases/#alter-default-language-remote-database-alias[Operations Manual -> Alter the default Cypher version of a remote database alias].
403+
404+
a|
405+
label:functionality[]
406+
label:new[]
407+
408+
[source, cypher, role="noheader"]
409+
----
410+
SHOW DATABASES YIELD name, defaultLanguage
411+
----
412+
413+
a| The new return column `defaultLanguage` for the `SHOW DATABASE` command returns the default language of a database.
414+
This column is not returned by default; it can only be returned using `YIELD`.
415+
For more information, see the link:{neo4j-docs-base-uri}/operations-manual/current/database-administration/standard-databases/listing-databases/#_show_the_default_cypher_version_of_a_database[Operations Manual -> Show the default Cypher version of a database].
416+
417+
a|
418+
label:functionality[]
419+
label:new[]
420+
421+
[source, cypher, role="noheader"]
422+
----
423+
SHOW ALIAS `remote-with-default-language` FOR DATABASE YIELD name, defaultLanguage
424+
----
425+
426+
a| The new return column `defaultLanguage` for the `SHOW ALIAS` command returns the default language of a database alias.
427+
This column is not returned by default; it can only be returned using `YIELD`.
428+
For more information, see the link:{neo4j-docs-base-uri}/operations-manual/current/database-administration/aliases/manage-aliases-standard-databases/#manage-aliases-list[Operations Manual -> List database aliases].
429+
430+
a|
431+
label:functionality[]
432+
label:new[]
433+
434+
[source, cypher, role="noheader"]
435+
----
436+
CYPHER 25
437+
MATCH (n:Person)
438+
FILTER n.age < 35
439+
RETURN n.name AS name
440+
----
441+
442+
a| New query option: `CYPHER 25`.
443+
Prepending a query with `CYPHER 25` ensures that a query is run with Cypher 25, regardless of the default language of a database.
444+
(The ability to select `CYPHER 5` was introduced in Neo4j 5.21).
445+
446+
a|
447+
label:functionality[]
448+
label:new[]
449+
344450
[source, cypher, role="noheader"]
345451
----
346452
RETURN 1 AS a

modules/ROOT/pages/expressions/predicates/type-predicate-expressions.adoc

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -64,8 +64,8 @@ RETURN val, val IS NOT :: STRING AS notString
6464
|===
6565

6666

67-
[[type-predicate-NULL]]
68-
== Type predicate expressions for NULL
67+
[[type-predicate-null]]
68+
== Type predicate expressions for null
6969

7070
All Cypher types includes the `null` value.
7171
Type predicate expressions can be appended with `NOT NULL`.

modules/ROOT/pages/patterns/match-modes.adoc

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -95,7 +95,7 @@ RETURN pathCount,
9595
[r IN relationships(samplePath) | r.id] AS samplePathBridges
9696
----
9797

98-
<1> The xref:functions/list.adoc#functions-collect[`collect()`] function collects all paths and `[0]` takes the first entry as the `samplePath`.
98+
<1> The xref:functions/aggregating.adoc#functions-collect[`collect()`] function collects all paths and `[0]` takes the first entry as the `samplePath`.
9999

100100
.Result
101101
[role="queryresult",options="header,footer",cols="3*<m"]

modules/ROOT/pages/queries/index.adoc

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ It also explains how to select the version of Cypher in which queries are run, a
66

77
* xref:queries/concepts.adoc[]
88
* xref:queries/basic.adoc[]
9-
* xref:queries/select-version.adoc[]
9+
* xref:queries/select-version.adoc[] label:new[Introduced in Neo4j 2025.06]
1010
* xref:queries/composed-queries/index.adoc[]
1111
** xref:queries/composed-queries/combined-queries.adoc[]
1212
** xref:queries/composed-queries/conditional-queries.adoc[] label:new[Introduced in Neo4j 2025.06]

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

Lines changed: 9 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,5 @@
11
:description: Information about how to select Cypher version for queries or databases.
2+
:page-role: new-2025.06
23

34
= Select Cypher version
45

@@ -98,9 +99,9 @@ ALTER DATABASE actors SET DEFAULT LANGUAGE CYPHER 5
9899
======
99100
=====
100101

101-
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 xref:selection-query-cypher-version[`CYPHER 5`], which overrides this default).
102+
Selecting `CYPHER 25` ensures that all queries run on that database will be executed using Cypher 25 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 xref:selection-query-cypher-version[`CYPHER 5`], which overrides this default).
102103

103-
Selecting `CYPHER 5` as the default database language ensures that all queries run on that database uses the language as it existed at the time of the Neo4j 2025.06 release (unless a query is prepended with xref:selection-query-cypher-version[`CYPHER 25`], which overrides this default).
104+
Selecting `CYPHER 5` as the default database language ensures that all queries run on that database uses Cypher 5 as it existed at the time of the Neo4j 2025.06 release (unless a query is prepended with xref:selection-query-cypher-version[`CYPHER 25`], which overrides this default).
104105
Any changes introduced after the 2025.06 release will not affect the semantics of the query.
105106

106107
[[config-database-upgrades]]
@@ -182,32 +183,36 @@ It is, therefore, recommended to set the default language to Cypher 25 and migra
182183
======
183184

184185
.Cypher 25 query on a Neo4j 2025.06+ database with Cypher 5 as default language
186+
// tag::queries_select_version_cypher_25[]
185187
[source,cypher]
186188
----
187189
CYPHER 25
188190
MATCH (n:Order)-[r:SHIPPED_TO]->(:Address)
189191
SET n = properties(r)
190192
----
193+
// end::queries_select_version_cypher_25[]
191194

192195
======
193196
194197
[.include-with-Cypher-5]
195198
======
196199

197200
.Cypher 5 query on a Neo4j 2025.06+ database with Cypher 25 as default language
201+
// tag::queries_select_version_cypher_5[]
198202
[source,cypher]
199203
----
200204
CYPHER 5
201205
MATCH (n:Order)-[r:SHIPPED_TO]->(:Address)
202206
SET n = r
203207
----
208+
// end::queries_select_version_cypher_5[]
204209

205210
======
206211
=====
207212

208-
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.
213+
Selecting `CYPHER 25` ensures that the query will be executed using Cypher 25 as it exists in the version of Neo4j that the database is currently running, provided it is on Neo4j 2025.06 or later.
209214

210-
Selecting `CYPHER 5` ensures that the query will be executed using the language as it existed at the time of the Neo4j 2025.06 release.
215+
Selecting `CYPHER 5` ensures that the query will be executed using Cypher 5 as it existed at the time of the Neo4j 2025.06 release.
211216
Any changes introduced after the 2025.06 release will not affect the query.
212217

213218
[[procedures-and-functions]]

0 commit comments

Comments
 (0)