Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

cip-190 deprecations #1084

Merged
merged 4 commits into from
Nov 5, 2024
Merged

cip-190 deprecations #1084

Changes from 3 commits
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
245bf18
cip-190 deprecations
hvub Oct 29, 2024
36993c4
editorial update
JPryce-Aklundh Oct 30, 2024
e3cb5ef
Update modules/ROOT/pages/deprecations-additions-removals-compatibili…
JPryce-Aklundh Oct 30, 2024
510a277
conflict fix
JPryce-Aklundh Nov 5, 2024
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
87 changes: 87 additions & 0 deletions modules/ROOT/pages/deprecations-additions-removals-compatibility.adoc
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -16,6 +16,93 @@ New features are added to the language continuously, and occasionally, some feat
This section lists all of the features that have been removed, deprecated, added, or extended in different Cypher versions.
Replacement syntax for deprecated and removed features are also indicated.

[[cypher-deprecations-additions-removals-5.26]]
== Neo4j 5.26

=== Deprecated features

[cols="2", options="header"]
|===
| Feature
| Details

a|
label:functionality[]
label:deprecated[]
[source, cypher, role="noheader"]
----
MATCH (where {...})
----
----
MATCH (...)-[where {...}]->()
----
a| The unescaped variable named `where` (or any casing variant, like `WHERE`) used in a node or relationship pattern followed directly by a property key-value expression is deprecated.
To continue using variables with this name, use backticks to escape the variable name:

* Node patterns: `MATCH (++`where`++ { ... })`
* Relationship patterns: `MATCH (...)-[++`where`++ { ... }]->()`

a|
label:functionality[]
label:deprecated[]
[source, cypher, role="noheader"]
----
... + n:A
----
----
... + n:A&B
----
----
... + n:A&B\|C
----
a| Using an unparenthesized label expression predicate as the right-hand side operand of `+` is deprecated.
Parenthesize the label expression predicate on the right-hand side of `+`: `... + (n:A)`.

a|
label:functionality[]
label:deprecated[]
[source, cypher, role="noheader"]
----
CASE x ... WHEN is :: STRING THEN ... END
----
a| Using an unescaped variable named `is` (or any casing variant, like `IS`) as a `WHEN` operand in a xref:queries/case.adoc#case-simple[simple `CASE`] expression is deprecated.
To continue using variables with this name in simple `CASE` expressions, use backticks to escape the variable name: `CASE x ... WHEN ++`is`++ :: STRING THEN ... END`

a|
label:functionality[]
label:deprecated[]
[source, cypher, role="noheader"]
----
CASE x ... WHEN contains + 1 THEN ... END
----
----
CASE x ... WHEN contains - 1 THEN ... END
----
a| Using an unescaped variable named `contains` (or any casing variant, like `CONTAINS`) in addition or subtraction operations within a `WHEN` operand of a xref:queries/case.adoc#case-simple[simple `CASE`] expression is deprecated.
To continue using variables with this name, use backticks to escape the variable name:

* Additions: `CASE x ... WHEN ++`contains`++ + 1 THEN ... END`
* Subtractions: `CASE x ... WHEN ++`contains`++ - 1 THEN ... END`

a|
label:functionality[]
label:deprecated[]
[source, cypher, role="noheader"]
----
CASE x ... WHEN in[1] THEN ... END
----
----
CASE x ... WHEN in["abc"] THEN ... END
----
a| Using the `[]` operator on an unescaped variable named `in` (or any casing variant, like `IN`) within a `WHEN` operand of a xref:queries/case.adoc#case-simple[simple `CASE`] expression is deprecated.
To continue using variables with this name, use backticks to escape the variable name:

* `CASE x ... WHEN ++`in`++[1] THEN ... END`
* `CASE x ... WHEN ++`in`++["abc"] THEN ... END`

|===


[[cypher-deprecations-additions-removals-5.25]]
== Neo4j 5.25

Expand Down