Skip to content

Commit 231967d

Browse files
committed
update the changelog
1 parent 04b3b7f commit 231967d

File tree

2 files changed

+20
-55
lines changed

2 files changed

+20
-55
lines changed

modules/ROOT/pages/changelogs.adoc

Lines changed: 19 additions & 54 deletions
Original file line numberDiff line numberDiff line change
@@ -2,61 +2,26 @@
22

33
= Changes and deprecations
44

5-
Starting from 2025.04, using the error messages programmatically is deprecated.
5+
6+
== 2025.04
7+
8+
Using the error messages programmatically is deprecated.
69
Because error messages might change in a future release, please parse or use GQLSTATUS error codes in your application code.
710
For details, see xref:errors/gql-errors/index.adoc[GQLSTATUS error codes].
811

912

10-
== Deprecated notifications
11-
12-
The following notifications have been deprecated:
13-
14-
.Notification details
15-
[cols="<1s,<4"]
16-
|===
17-
|Neo4j code
18-
m|Neo.ClientNotification.Statement.FeatureDeprecationWarning
19-
|Title
20-
a|This feature is deprecated and will be removed in future versions.
21-
|Descriptions
22-
a|
23-
- The procedure has a deprecated field. (`%s`)
24-
- The function has a deprecated field. (`%s`)
25-
- Creating an entity (`%s`) and referencing that entity in a property definition in the same CREATE is deprecated.
26-
- Merging an entity (`%s`) and referencing that entity in a property definition in the same MERGE is deprecated.
27-
- The Unicode character `%s` is deprecated for unescaped identifiers and will be considered as a whitespace character in the future.
28-
To continue using it, escape the identifier by adding backticks around the identifier `%s`.
29-
- The character with the Unicode representation `%s` is deprecated for unescaped identifiers and will not be supported in the future.
30-
To continue using it, escape the identifier by adding backticks around the identifier `%s`.
31-
- All subqueries in a `UNION [ALL]` should have the same ordering for the return columns.
32-
[NOTE]
33-
In versions 5.5 to 5.25, using differently ordered return items in a `UNION [ALL]` clause is deprecated.
34-
However, starting from version 5.26, the deprecation has been withdrawn following cost-benefit analysis and valuable user feedback.
35-
- label:deprecated[Deprecated from 5.26 to 2025.05] Databases and aliases with unescaped `.` are deprecated unless the dots indicate that they belong to a composite database.
36-
Names containing `.` should be escaped. (`%s`)
37-
[NOTE]
38-
Databases and aliases with unescaped `.` are deprecated in versions 5.26 to 2025.05.
39-
However, starting from version 2025.06, this deprecation has been withdrawn, and replaced by two new deprecations.
40-
The reason for this change is that the previous quoting rules have been found inconsistent and ambiguous, and will be improved starting from Cypher 25.
41-
For more information, see:
42-
43-
* xref:notifications/all-notifications.adoc#_graph_reference_deprecation[Using separately backticked name parts in graph references]
44-
* xref:notifications/all-notifications.adoc#_graph_reference_deprecation_use[Using separately backticked name parts in graph references in USE clause]
45-
* link:https://neo4j.com/docs/cypher-manual/25/values-and-types/graph-references[Cypher manual -> Graph references].
46-
- label:deprecated[Deprecated in 2025.06] Graph references with separately backticked name parts (`%s`) are deprecated. In future Cypher versions, use parameters or backtick the entire name (`%s`).
47-
- label:deprecated[Deprecated in 2025.06] Graph references with separately backticked name parts (`%s`) are deprecated. In future Cypher versions, remove the backticks (`%s`).
48-
- label:deprecated[Deprecated in 2025.11] The namespace of the invoked user-defined function is deprecated. (`%s`).
49-
- label:deprecated[Deprecated in 2025.11] The namespace of the invoked user-defined procedure is deprecated. (`%s`).
50-
- label:deprecated[Deprecated in 2025.11] The namespace of the invoked user-defined function is deprecated and the function is shadowing an internal function. (`%s`).
51-
52-
|Category
53-
m|DEPRECATION
54-
|GQLSTATUS code
55-
m|01N00
56-
|Status description
57-
a|warn: feature deprecated. `{ <<item>> }`
58-
|Classification
59-
m|DEPRECATION
60-
|SeverityLevel
61-
m|WARNING
62-
|===
13+
== 2025.01
14+
15+
* The diagnostic record also contains a `_status_parameters` field, which represents a map that contains all variable parts of the status description, such as labels, database names, Cypher clauses, etc.
16+
This field is used to provide more detailed information about the error.
17+
18+
* A new JSON template is available for the query log, which is the default set in _server_log.xml_.
19+
It contains the `errorInfo` entry, but not the `failureReason` entry, which is switched off by default.
20+
21+
22+
ifndef::backend-pdf[]
23+
[discrete.glossary]
24+
== Glossary
25+
26+
include::partial$glossary.adoc[]
27+
endif::[]

modules/ROOT/pages/errors/index.adoc

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -185,7 +185,7 @@ On the driver side, the Neo4jException is extended with the corresponding method
185185
The driver receives the Failure Bolt message and extracts the status code and the error message.
186186
Then, it constructs an exception with the status code, error message, and other relevant information, and sends it to the client.
187187

188-
// Starting from 2025.01, the diagnostic record also contains a `_status_parameters` field, which represens a map that contains all variable parts of the status description, such as labels, database names, Cypher clauses, etc.
188+
// Starting from 2025.01, the diagnostic record also contains a `_status_parameters` field, which represents a map that contains all variable parts of the status description, such as labels, database names, Cypher clauses, etc.
189189
// This field is used to provide more detailed information about the error.
190190

191191
== Query logging

0 commit comments

Comments
 (0)