Skip to content

Commit 3b8732a

Browse files
hvubJPryce-Aklundh
andcommitted
cip-190 deprecations (#1084)
Deprecation message related to - neo-technology/neo4j#27564 - neo4j/docs-status-codes#202 - cf. [CIP-190](https://docs.google.com/document/d/1AONjI-SpSEla-bHPJ6ghXBfF9alN5mGiOHOTEyfBtRc/edit) --------- Co-authored-by: Jens Pryce-Åklundh <[email protected]>
1 parent eeb8ba4 commit 3b8732a

File tree

1 file changed

+75
-1
lines changed

1 file changed

+75
-1
lines changed

modules/ROOT/pages/deprecations-additions-removals-compatibility.adoc

Lines changed: 75 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -117,6 +117,81 @@ For all available Cypher types, see the section on xref::values-and-types/proper
117117
| Feature
118118
| Details
119119

120+
a|
121+
label:functionality[]
122+
label:deprecated[]
123+
[source, cypher, role="noheader"]
124+
----
125+
MATCH (where {...})
126+
----
127+
----
128+
MATCH (...)-[where {...}]->()
129+
----
130+
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.
131+
To continue using variables with this name, use backticks to escape the variable name:
132+
133+
* Node patterns: `MATCH (++`where`++ { ... })`
134+
* Relationship patterns: `MATCH (...)-[++`where`++ { ... }]->()`
135+
136+
a|
137+
label:functionality[]
138+
label:deprecated[]
139+
[source, cypher, role="noheader"]
140+
----
141+
... + n:A
142+
----
143+
----
144+
... + n:A&B
145+
----
146+
----
147+
... + n:A&B\|C
148+
----
149+
a| Using an unparenthesized label expression predicate as the right-hand side operand of `+` is deprecated.
150+
Parenthesize the label expression predicate on the right-hand side of `+`: `... + (n:A)`.
151+
152+
a|
153+
label:functionality[]
154+
label:deprecated[]
155+
[source, cypher, role="noheader"]
156+
----
157+
CASE x ... WHEN is :: STRING THEN ... END
158+
----
159+
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.
160+
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`
161+
162+
a|
163+
label:functionality[]
164+
label:deprecated[]
165+
[source, cypher, role="noheader"]
166+
----
167+
CASE x ... WHEN contains + 1 THEN ... END
168+
----
169+
----
170+
CASE x ... WHEN contains - 1 THEN ... END
171+
----
172+
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.
173+
To continue using variables with this name, use backticks to escape the variable name:
174+
175+
* Additions: `CASE x ... WHEN ++`contains`++ + 1 THEN ... END`
176+
* Subtractions: `CASE x ... WHEN ++`contains`++ - 1 THEN ... END`
177+
178+
a|
179+
label:functionality[]
180+
label:deprecated[]
181+
[source, cypher, role="noheader"]
182+
----
183+
CASE x ... WHEN in[1] THEN ... END
184+
----
185+
----
186+
CASE x ... WHEN in["abc"] THEN ... END
187+
----
188+
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.
189+
To continue using variables with this name, use backticks to escape the variable name:
190+
191+
* `CASE x ... WHEN ++`in`++[1] THEN ... END`
192+
* `CASE x ... WHEN ++`in`++["abc"] THEN ... END`
193+
194+
120195
a|
121196
label:functionality[]
122197
label:deprecated[]
@@ -160,7 +235,6 @@ label:updated[]
160235
GRANT READ {*} ON GRAPH * FOR (n) WHERE n.createdAt > date('2024-10-25') TO regularUsers
161236
----
162237
| link:{neo4j-docs-base-uri}/operations-manual/{page-version}/authentication-authorization/property-based-access-control/[Property-based access control] now supports xref:values-and-types/spatial.adoc[spatial] and xref:values-and-types/temporal.adoc[temporal] values.
163-
164238
|===
165239

166240

0 commit comments

Comments
 (0)