diff --git a/modules/ROOT/content-nav.adoc b/modules/ROOT/content-nav.adoc index eac6faf5..d38c0e1e 100644 --- a/modules/ROOT/content-nav.adoc +++ b/modules/ROOT/content-nav.adoc @@ -370,6 +370,7 @@ **** xref:errors/gql-errors/42NA8.adoc[] **** xref:errors/gql-errors/42NA9.adoc[] **** xref:errors/gql-errors/42NAA.adoc[] +**** xref:errors/gql-errors/42NAB.adoc[] **** xref:errors/gql-errors/42NFC.adoc[] **** xref:errors/gql-errors/42NFD.adoc[] **** xref:errors/gql-errors/42NFE.adoc[] diff --git a/modules/ROOT/pages/errors/gql-errors/42NAB.adoc b/modules/ROOT/pages/errors/gql-errors/42NAB.adoc new file mode 100644 index 00000000..e55cd2c5 --- /dev/null +++ b/modules/ROOT/pages/errors/gql-errors/42NAB.adoc @@ -0,0 +1,48 @@ +:page-role: new-2025.11 += 42NAB + +== Status description +error: syntax error or access rule violation - not supported standalone call. `WHERE` is not supported in a standalone call. Use `CALL ... YIELD ... WHERE ... RETURN ...` instead. + +== Explanation +A standalone call of a procedure does not support a `WHERE` clause, i.e., it does not support the filtering of the procedure result. +Either remove the `WHERE` clause or add a `RETURN` clause after the call to turn it into an in-query call. + +== Example scenario +For example, trying to filter the result of the procedure `db.labels()` in a standalone call: + +[source,cypher] +---- +CALL db.labels() YIELD label WHERE label <> 'A' +---- + +An error will be thrown with GQLSTATUS 42NAB and the following status description: + +[source] +---- +error: syntax error or access rule violation - not supported standalone call. WHERE is not supported in a standalone call. Use `CALL ... YIELD ... WHERE ... RETURN ...` instead. +---- + +== Possible solutions + +You can abstain from filtering to get a valid query: + +[source,cypher] +---- +CALL db.labels() YIELD label +---- + +However, if you still want to filter the result of the procedure `db.labels()`, you can add a `RETURN` clause: + +.Query +[source, cypher] +---- +CALL db.labels() YIELD label WHERE label <> 'A' RETURN label +---- + +ifndef::backend-pdf[] +[discrete.glossary] +== Glossary + +include::partial$glossary.adoc[] +endif::[] diff --git a/modules/ROOT/pages/errors/gql-errors/index.adoc b/modules/ROOT/pages/errors/gql-errors/index.adoc index 462c1af5..7cfc4625 100644 --- a/modules/ROOT/pages/errors/gql-errors/index.adoc +++ b/modules/ROOT/pages/errors/gql-errors/index.adoc @@ -1513,6 +1513,11 @@ Status description:: error: syntax error or access rule violation - system datab Status description:: error: syntax error or access rule violation - incorrectly formatted graph reference. Incorrectly formatted graph reference `{ <> }`. Expected a single quoted or unquoted identifier. Separate name parts should not be quoted individually. +[role=label--new-2025.11] +=== xref:errors/gql-errors/42NAB.adoc[42NAB] + +Status description:: error: syntax error or access rule violation - not supported standalone call. `WHERE` is not supported in a standalone call. Use `CALL ... YIELD ... WHERE ... RETURN ...` instead. + === xref:errors/gql-errors/42NFC.adoc[42NFC] Status description:: error: syntax error or access rule violation - auth info validation error. Authentication and/or authorization could not be validated. See security logs for details.