Skip to content

Commit bae50e0

Browse files
JPryce-Aklundhrsill-neo4jHunterness
committed
Update Select Cypher versions guide with relevant links to Operations Manual and Upgrade and migration guide (#1327)
Co-authored-by: Richard Sill <[email protected]> Co-authored-by: Therese Magnusson <[email protected]>
1 parent 6f4aae6 commit bae50e0

File tree

1 file changed

+13
-45
lines changed

1 file changed

+13
-45
lines changed

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

Lines changed: 13 additions & 45 deletions
Original file line numberDiff line numberDiff line change
@@ -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
=====
@@ -51,11 +48,10 @@ Setting the default language requires the link:{neo4j-docs-base-uri}/operations-
5148
.Cypher 25
5249
[source,cypher]
5350
----
54-
CREATE DATABASE actors DEFAULT LANGUAGE CYPHER 25
51+
CREATE DATABASE actors SET 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

@@ -104,44 +96,20 @@ Selecting `CYPHER 25` ensures that all queries run on that database will be exec
10496
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 the new privileges related to changing the default language, 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-alter-composite-database[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)