Skip to content

Commit fcb118c

Browse files
JPryce-AklundhJPryce-Aklundh
authored
Cypher version control commands (#1329)
1 parent ed65321 commit fcb118c

File tree

1 file changed

+116
-1
lines changed

1 file changed

+116
-1
lines changed

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

Lines changed: 116 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -31,7 +31,7 @@ For more information, see:
3131
[[cypher-deprecations-additions-removals-2025.06]]
3232
== Neo4j 2025.06
3333

34-
=== Deprecated features
34+
=== Deprecated in Cypher 5
3535

3636
[cols="2", options="header"]
3737
|===
@@ -62,6 +62,121 @@ In future Cypher versions, remove the backticks (`a.b.c`).
6262

6363
|===
6464

65+
66+
=== New in Cypher 5
67+
68+
[cols="2", options="header"]
69+
|===
70+
| Feature
71+
| Details
72+
a|
73+
label:functionality[]
74+
label:new[]
75+
76+
[source, cypher, role="noheader"]
77+
----
78+
CREATE [COMPOSITE] DATABASE actors DEFAULT LANGUAGE CYPHER 25
79+
----
80+
81+
a| Set the default Cypher version for a standard or composite database when creating it.
82+
The available versions are `CYPHER 25` and `CYPHER 5`.
83+
If not specified, the default language for the database is set to the default language of the DBMS.
84+
For more information, see the following sections in the Operations Manual:
85+
86+
* 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].
87+
* 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].
88+
89+
a|
90+
label:functionality[]
91+
label:new[]
92+
93+
[source, cypher, role="noheader"]
94+
----
95+
CREATE ALIAS `remote-with-default-language`
96+
FOR DATABASE `northwind-graph-2020`
97+
AT "neo4j+s://location:7687"
98+
USER alice
99+
PASSWORD 'example_secret'
100+
DEFAULT LANGUAGE CYPHER 25
101+
----
102+
103+
a| Set the default Cypher version for a remote database alias when creating it.
104+
The available versions are `CYPHER 5` and `CYPHER 25`.
105+
Local database aliases and database aliases in composite databases cannot be assigned a default Cypher version.
106+
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.
107+
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].
108+
109+
a|
110+
label:functionality[]
111+
label:new[]
112+
[source, cypher, role="noheader"]
113+
----
114+
ALTER DATABASE movies SET DEFAULT LANGUAGE CYPHER 25
115+
----
116+
117+
a| Alter the default Cypher version of an existing standard or composite database.
118+
The available versions are `CYPHER 25` and `CYPHER 5`.
119+
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].
120+
121+
a|
122+
label:functionality[]
123+
label:new[]
124+
125+
[source, cypher, role="noheader"]
126+
----
127+
ALTER ALIAS `remote-with-default-language` SET DATABASE DEFAULT LANGUAGE CYPHER 25
128+
----
129+
130+
a| Alter the default Cypher version of a remote database alias.
131+
The available versions are `CYPHER 25` and `CYPHER 5`.
132+
It is not possible to alter the default Cypher version of a local database alias or an alias belonging to a composite database.
133+
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.
134+
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].
135+
136+
a|
137+
label:functionality[]
138+
label:new[]
139+
140+
[source, cypher, role="noheader"]
141+
----
142+
SHOW DATABASES YIELD name, defaultLanguage
143+
----
144+
145+
a| The new return column `defaultLanguage` for the `SHOW DATABASE` command returns the default language of a database.
146+
This column is not returned by default; it can only be returned using `YIELD`.
147+
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].
148+
149+
a|
150+
label:functionality[]
151+
label:new[]
152+
153+
[source, cypher, role="noheader"]
154+
----
155+
SHOW ALIAS `remote-with-default-language` FOR DATABASE YIELD name, defaultLanguage
156+
----
157+
158+
a| The new return column `defaultLanguage` for the `SHOW ALIAS` command returns the default language of a database alias.
159+
This column is not returned by default; it can only be returned using `YIELD`.
160+
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].
161+
162+
a|
163+
label:functionality[]
164+
label:new[]
165+
166+
[source, cypher, role="noheader"]
167+
----
168+
CYPHER 25
169+
MATCH (n:Person)
170+
FILTER n.age < 35
171+
RETURN n.name AS name
172+
----
173+
174+
a| New query option: `CYPHER 25`.
175+
Prepending a query with `CYPHER 25` ensures that a query is run with Cypher 25, regardless of the default language of a database.
176+
(The ability to select `CYPHER 5` was introduced in Neo4j 5.21).
177+
178+
|===
179+
65180
[[cypher-deprecations-additions-removals-2025.04]]
66181
== Neo4j 2025.04
67182

0 commit comments

Comments
 (0)