Skip to content

Commit 524e678

Browse files
ops manual links
1 parent 3720e75 commit 524e678

File tree

1 file changed

+15
-47
lines changed

1 file changed

+15
-47
lines changed

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

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

55
As of Neo4j 2025.06, users can specify the version of Cypher in which they want to run their queries, choosing between Cypher 5 and Cypher 25.
@@ -39,9 +39,6 @@ However, it is possible to set a different default language on both new and exis
3939

4040
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.
4141

42-
[NOTE]
43-
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].
44-
4542
.Select default Cypher version when creating a database
4643
[.tabbed-example]
4744
=====
@@ -55,7 +52,6 @@ CREATE DATABASE actors DEFAULT LANGUAGE CYPHER 25
5552
----
5653

5754
======
58-
5955
[.include-with-Cypher-5]
6056
======
6157

@@ -70,9 +66,6 @@ CREATE DATABASE movies DEFAULT LANGUAGE CYPHER 5
7066

7167
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.
7268

73-
[NOTE]
74-
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].
75-
7669
.Alter the default Cypher version on an existing database
7770
[.tabbed-example]
7871
=====
@@ -86,7 +79,6 @@ ALTER DATABASE movies SET DEFAULT LANGUAGE CYPHER 25
8679
----
8780

8881
======
89-
9082
[.include-with-Cypher-5]
9183
======
9284

@@ -99,49 +91,25 @@ ALTER DATABASE actors SET DEFAULT LANGUAGE CYPHER 5
9991
======
10092
=====
10193

102-
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).
94+
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).
10395

104-
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).
96+
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).
10597
Any changes introduced after the 2025.06 release will not affect the semantics of the query.
10698

107-
[[config-database-upgrades]]
108-
== Cypher versions, configuration settings, and DBMS upgrades
109-
110-
Changing the Cypher version of new databases in a DBMS can also be done with the setting link:{neo4j-docs-base-uri}/operations-manual/current/configuration/configuration-settings/#config_db.query.default_language[`db.query.default_language`] (default value: `CYPHER_5`).
111-
This setting determines the default language for new databases where it has not been specified as part of a `CREATE` or `ALTER` database command.
112-
For example, `config_db.query.default_language=CYPHER_25` will set Cypher 25 as the default language for a DBMS.
113-
For more information about using configuration settings, see the link:{neo4j-docs-base-uri}/operations-manual/current/configuration/[Operations Manual -> Configuration].
114-
115-
The table below outlines which Cypher version is assigned to databases in different upgrade or installation scenarios:
116-
117-
[cols="3", options="header"]
118-
|===
119-
| Scenario | `db.query.default_language` | Databases
120-
121-
122-
| *Standard DBMS upgrade to Neo4j 2025.06+*
123-
| Unset
124-
| *Existing system database:* `CYPHER 5` +
125-
*Existing user databases:* `CYPHER 5` +
126-
*New user databases default:* `CYPHER 5`
127-
128-
129-
| *Custom DBMS upgrade to Neo4j 2025.06+*
130-
| Manually set to `CYPHER_25` by administrator
131-
| *Existing system database:* `CYPHER 5` +
132-
*Existing user databases:* `CYPHER 5` +
133-
*New user databases default:* `CYPHER 25`
134-
135-
136-
| *New installation of Neo4j 2025.06+*
137-
| Set to `CYPHER_5`
138-
| *New system database:* `CYPHER 5` +
139-
*New user databases default:* `CYPHER 5`
140-
99+
For more information about how to change and view the default language of new and existing databases and remote database aliases, and for how to set the necessary privileges to change the default language of a database, see the following links in the Operations Manual:
141100

142-
|===
101+
* link:{neo4j-docs-base-uri}/operations-manual/current/configuration/cypher-version-configuration/[Configure the Cypher default version]
102+
* 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]
103+
* link:{neo4j-docs-base-uri}/operations-manual/current/database-administration/composite-databases/create-composite-databases/#composite-databases-default-language[Set a default Cypher version for a composite database]
104+
* link:{neo4j-docs-base-uri}/operations-manual/current/database-administration/aliases/manage-aliases-standard-databases/#set-default-language-for-remote-database-aliases[Set a default Cypher version for remote database aliases]
105+
* link:{neo4j-docs-base-uri}/operations-manual/current/database-administration/standard-databases/alter-databases/#alter-database-default-language[Alter the default Cypher version of an existing database]
106+
* link:{neo4j-docs-base-uri}/operations-manual/current/database-administration/composite-databases/alter-composite-databases/#alter-default-language-composite-database[Alter the default Cypher version of a composite database]
107+
* link:{neo4j-docs-base-uri}/operations-manual/current/database-administration/aliases/manage-aliases-standard-databases/#alter-default-language-remote-database-alias[Alter the default Cypher version of a remote database alias]
108+
* link:{neo4j-docs-base-uri}/operations-manual/current/database-administration/standard-databases/listing-databases/#_show_the_default_cypher_version_of_a_database[Show the default Cypher version of a database]
109+
* link:{neo4j-docs-base-uri}/operations-manual/authentication-authorization/dbms-administration/#_grant_privilege_to_modify_the_default_language_of_standard_databases[Grant privilege to modify the default language of standard databases]
110+
* link:{neo4j-docs-base-uri}/operations-manual/authentication-authorization/dbms-administration/#_grant_privilege_to_modify_composite_databases[Grant privilege to modify composite databases] (required in order to alter the default language of a composite database)
143111

144-
For more information about upgrading and migrating Neo4j databases, see the link:{neo4j-docs-base-uri}/upgrade-migration-guide/current/[Upgrade and migration guide].
112+
For information about Cypher versions and DBMS upgrades, see the link:{neo4j-docs-base-uri}/upgrade-migration-guide/current/_cypher_versions[Upgrade and migration guide -> Cypher versions].
145113

146114
[[migrate-queries-from-5-to-25]]
147115
== Migrating queries from Cypher 5 to Cypher 25

0 commit comments

Comments
 (0)