From fe24183ed3347eca0a265444587acfec594a9245 Mon Sep 17 00:00:00 2001 From: GW Date: Tue, 14 Oct 2025 09:43:06 +0100 Subject: [PATCH 1/3] Add notification warning for vector on incompatible client --- .../notifications/all-notifications.adoc | 67 +++++++++++++++++++ 1 file changed, 67 insertions(+) diff --git a/modules/ROOT/pages/notifications/all-notifications.adoc b/modules/ROOT/pages/notifications/all-notifications.adoc index 2fc0d13e..bb4123d0 100644 --- a/modules/ROOT/pages/notifications/all-notifications.adoc +++ b/modules/ROOT/pages/notifications/all-notifications.adoc @@ -8,6 +8,7 @@ The following page provides an overview of all notifications in Neo4j, including * <<_performance_notifications, `PERFORMANCE` notifications>> * <<_hint_notifications, `HINT` notifications>> * <<_unrecognized_notifications, `UNRECOGNIZED` notifications>> +* <<_unsupported_notifications, `UNSUPPORTED` notifications>> * <<_deprecated_notifications, `DEPRECATION` notifications>> * <<_security_notifications, `SECURITY` notifications>> * <<_topology_notifications, `TOPOLOGY` notifications>> @@ -1217,6 +1218,72 @@ The query contains an aggregation function that skips null values. ====== ===== +[#_unsupported_notifications] +== `UNSUPPORTED` notifications + +Unsupported notifications contain information about a feature which is not supported in the current context that has been used to access the feature. + +[#_neo_clientnotification_request_UnsupportedType] +=== Client does not support type + +.Notification details +[cols="<1s,<4"] +|=== +|Neo4j code +m|Neo.ClientNotification.Request.UnsupportedType +|Title +a|Client does not support this type. +|Description +|One or more values returned could not be handled by this version of the client and were replaced with placeholder map values. Please upgrade your client. +|Category +m|UNSUPPORTED +|GQLSTATUS code +m|01N83 +|Status description +a|warn: Client does not support this type. Client does not support type +`{ <> }`. Please upgrade your client. +|Classification +m|UNSUPPORTED +|SeverityLevel +m|WARNING +|=== + +.Accessing a Vector with unsupported driver (e.g. 5.x driver) +[.tabbed-example] +===== +[.include-with-GQLSTATUS-code] +====== +Query:: ++ +[source,cypher] +---- +RETURN VECTOR([1, 2, 3], 3, INTEGER32) +---- + +Returned GQLSTATUS code:: +01N83 + +Returned status description:: +warn: Client does not support this type. Client does not support type `VECTOR`. Please upgrade your client. +Suggestions for improvement:: +Upgrade to a supported client for the type. +====== +[.include-with-neo4j-code] +====== +Query:: + +[source,cypher] +---- +RETURN VECTOR([1, 2, 3], 3, INTEGER32) +---- +Description of the returned code:: +One or more values returned could not be handled by this version of the client and were replaced with placeholder map values. Please upgrade your client. +Suggestions for improvement:: +Upgrade to a supported client for the type. +====== +===== + + [#_deprecated_notifications] == `DEPRECATION` notifications From 6e3f5501aee229daf25c10d89f58d9f584d4dcc9 Mon Sep 17 00:00:00 2001 From: Greg Woods <42248895+gjmwoods@users.noreply.github.com> Date: Tue, 14 Oct 2025 11:15:32 +0100 Subject: [PATCH 2/3] Apply suggestions from code review Co-authored-by: Reneta Popova --- .../pages/notifications/all-notifications.adoc | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/modules/ROOT/pages/notifications/all-notifications.adoc b/modules/ROOT/pages/notifications/all-notifications.adoc index bb4123d0..7d805692 100644 --- a/modules/ROOT/pages/notifications/all-notifications.adoc +++ b/modules/ROOT/pages/notifications/all-notifications.adoc @@ -1221,10 +1221,10 @@ The query contains an aggregation function that skips null values. [#_unsupported_notifications] == `UNSUPPORTED` notifications -Unsupported notifications contain information about a feature which is not supported in the current context that has been used to access the feature. +Unsupported notifications contain information about features not supported in the current context used to access them. [#_neo_clientnotification_request_UnsupportedType] -=== Client does not support type +=== Unsupported value type .Notification details [cols="<1s,<4"] @@ -1240,15 +1240,15 @@ m|UNSUPPORTED |GQLSTATUS code m|01N83 |Status description -a|warn: Client does not support this type. Client does not support type -`{ <> }`. Please upgrade your client. +a|warn: Client does not support this type. Client does not support type `{ <> }`. +Please upgrade your client. |Classification m|UNSUPPORTED |SeverityLevel m|WARNING |=== -.Accessing a Vector with unsupported driver (e.g. 5.x driver) +.Accessing a vector with an unsupported driver (e.g., 5.x driver) [.tabbed-example] ===== [.include-with-GQLSTATUS-code] @@ -1266,7 +1266,7 @@ Returned GQLSTATUS code:: Returned status description:: warn: Client does not support this type. Client does not support type `VECTOR`. Please upgrade your client. Suggestions for improvement:: -Upgrade to a supported client for the type. +Upgrade your client to a version that supports this type. ====== [.include-with-neo4j-code] ====== @@ -1279,7 +1279,7 @@ RETURN VECTOR([1, 2, 3], 3, INTEGER32) Description of the returned code:: One or more values returned could not be handled by this version of the client and were replaced with placeholder map values. Please upgrade your client. Suggestions for improvement:: -Upgrade to a supported client for the type. +Upgrade your client to a version that supports this type. ====== ===== From fd86a6feafee3a3c0a6b75c7068a568815141e43 Mon Sep 17 00:00:00 2001 From: GW Date: Tue, 14 Oct 2025 13:05:06 +0100 Subject: [PATCH 3/3] Add 01N83 to changelog --- modules/ROOT/pages/changelogs.adoc | 12 ++++++++++++ 1 file changed, 12 insertions(+) diff --git a/modules/ROOT/pages/changelogs.adoc b/modules/ROOT/pages/changelogs.adoc index 3f37fee2..dbdd0237 100644 --- a/modules/ROOT/pages/changelogs.adoc +++ b/modules/ROOT/pages/changelogs.adoc @@ -1,6 +1,18 @@ :description: This page lists all changes to status codes per Neo4j version. = Changes to status codes per Neo4j version +== Neo4j 2025.11 +**New:** +[options="header", cols="<1m,<1"] +|=== +| GQLSTATUS +| Neo4j code + +| 01N83 +| Neo.ClientNotification.Request.UnsupportedType + +|=== + == Neo4j 2025.01 **New:** [options="header", cols="<1m,<1"]