|
2 | 2 |
|
3 | 3 | = Changes and deprecations |
4 | 4 |
|
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. |
6 | 9 | Because error messages might change in a future release, please parse or use GQLSTATUS error codes in your application code. |
7 | 10 | For details, see xref:errors/gql-errors/index.adoc[GQLSTATUS error codes]. |
8 | 11 |
|
9 | 12 |
|
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::[] |
0 commit comments