From fd188c7b6ea057c47295b4c2028c8b9c5e3aecfd Mon Sep 17 00:00:00 2001 From: Natalia Ivakina Date: Mon, 25 Nov 2024 13:03:10 +0100 Subject: [PATCH 1/4] Clarify situation around the UNION reordering deprecation --- .../notifications/all-notifications.adoc | 31 +++++-------------- 1 file changed, 8 insertions(+), 23 deletions(-) diff --git a/modules/ROOT/pages/notifications/all-notifications.adoc b/modules/ROOT/pages/notifications/all-notifications.adoc index f7c0a2f2..918e17e0 100644 --- a/modules/ROOT/pages/notifications/all-notifications.adoc +++ b/modules/ROOT/pages/notifications/all-notifications.adoc @@ -38,7 +38,7 @@ a|This query builds a cartesian product between disconnected patterns. |Category m|PERFORMANCE |GQLSTATUS code -m|03N90 +m|1n003N90 |Status description a|info: cartesian product. The disconnected patterns `{ $pat }` build a cartesian product. @@ -1373,7 +1373,7 @@ a| To continue using it, escape the identifier by adding backticks around the identifier `%s`. - The character with the Unicode representation `%s` is deprecated for unescaped identifiers and will not be supported in the future. To continue using it, escape the identifier by adding backticks around the identifier `%s`. -- All subqueries in a UNION [ALL] should have the same ordering for the return columns. +- label:new[Valid for Neo4j 5.5-5.25] All subqueries in a UNION [ALL] should have the same ordering for the return columns. Using differently ordered return items in a UNION [ALL] clause is deprecated and will be removed in a future version. - Databases and aliases with unescaped `.` are deprecated unless to indicate that they belong to a composite database. Names containing `.` should be escaped. (`%s`) @@ -1458,17 +1458,6 @@ Description of the returned code:: All subqueries in a UNION [ALL] should have the same ordering for the return columns. Using differently ordered return items in a UNION [ALL] clause is deprecated and will be removed in a future version. -Suggestions for improvement:: -Use the same order for the return columns in all subqueries combined by a `UNION` clause. - -+ -[source,cypher] ----- -RETURN 'val' as one, 'val' as two -UNION -RETURN 'val' as one, 'val' as two ----- - ====== [.include-with-GQLSTATUS-code] ====== @@ -1489,19 +1478,15 @@ warn: feature deprecated. All subqueries in a UNION [ALL] should have the same ordering for the return columns. Using differently ordered return items in a UNION [ALL] clause is deprecated and will be removed in a future version. -Suggestions for improvement:: -Use the same order for the return columns in all subqueries combined by a `UNION` clause. - -+ -[source,cypher] ----- -RETURN 'val' as one, 'val' as two -UNION -RETURN 'val' as one, 'val' as two ----- ====== ===== +[NOTE] +==== +Using differently ordered return items in a UNION [ALL] clause was deprecated in versions 5.5 to 5.25. +However, after cost/benefit analysis and user conversations, it was decided to withdraw the deprecation and continue supporting this feature. +==== + .Using the Unicode \u0085 in an unescaped identifier [.tabbed-example] ===== From 3b112fbdda36ef7da37200be8c501224b6c0ccc5 Mon Sep 17 00:00:00 2001 From: NataliaIvakina <82437520+NataliaIvakina@users.noreply.github.com> Date: Mon, 25 Nov 2024 13:04:47 +0100 Subject: [PATCH 2/4] Update modules/ROOT/pages/notifications/all-notifications.adoc --- modules/ROOT/pages/notifications/all-notifications.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/modules/ROOT/pages/notifications/all-notifications.adoc b/modules/ROOT/pages/notifications/all-notifications.adoc index 918e17e0..3dd89f1d 100644 --- a/modules/ROOT/pages/notifications/all-notifications.adoc +++ b/modules/ROOT/pages/notifications/all-notifications.adoc @@ -38,7 +38,7 @@ a|This query builds a cartesian product between disconnected patterns. |Category m|PERFORMANCE |GQLSTATUS code -m|1n003N90 +m|03N90 |Status description a|info: cartesian product. The disconnected patterns `{ $pat }` build a cartesian product. From 6523f9d0340d59084fe862039fede07a74d2e1b1 Mon Sep 17 00:00:00 2001 From: NataliaIvakina <82437520+NataliaIvakina@users.noreply.github.com> Date: Tue, 26 Nov 2024 14:51:05 +0100 Subject: [PATCH 3/4] Update modules/ROOT/pages/notifications/all-notifications.adoc Co-authored-by: Reneta Popova --- modules/ROOT/pages/notifications/all-notifications.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/modules/ROOT/pages/notifications/all-notifications.adoc b/modules/ROOT/pages/notifications/all-notifications.adoc index 3dd89f1d..9f9b1db1 100644 --- a/modules/ROOT/pages/notifications/all-notifications.adoc +++ b/modules/ROOT/pages/notifications/all-notifications.adoc @@ -1483,7 +1483,7 @@ Using differently ordered return items in a UNION [ALL] clause is deprecated and [NOTE] ==== -Using differently ordered return items in a UNION [ALL] clause was deprecated in versions 5.5 to 5.25. +Using differently ordered return items in a UNION [ALL] clause is deprecated in versions 5.5 to 5.25. However, after cost/benefit analysis and user conversations, it was decided to withdraw the deprecation and continue supporting this feature. ==== From 9d9d494ab4700eb729f4cc0693a778bc4a5777e6 Mon Sep 17 00:00:00 2001 From: NataliaIvakina <82437520+NataliaIvakina@users.noreply.github.com> Date: Tue, 26 Nov 2024 14:51:11 +0100 Subject: [PATCH 4/4] Update modules/ROOT/pages/notifications/all-notifications.adoc Co-authored-by: Reneta Popova --- modules/ROOT/pages/notifications/all-notifications.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/modules/ROOT/pages/notifications/all-notifications.adoc b/modules/ROOT/pages/notifications/all-notifications.adoc index 9f9b1db1..46315143 100644 --- a/modules/ROOT/pages/notifications/all-notifications.adoc +++ b/modules/ROOT/pages/notifications/all-notifications.adoc @@ -1484,7 +1484,7 @@ Using differently ordered return items in a UNION [ALL] clause is deprecated and [NOTE] ==== Using differently ordered return items in a UNION [ALL] clause is deprecated in versions 5.5 to 5.25. -However, after cost/benefit analysis and user conversations, it was decided to withdraw the deprecation and continue supporting this feature. +However, starting from version 5.26, the deprecation has been withdrawn following cost-benefit analysis and valuable user feedback. ==== .Using the Unicode \u0085 in an unescaped identifier