[robfrank]

Documents the SQL UNWIND changes shipping in 26.12.1, in reference/sql/sql-select.adoc:

• UNWIND of anything but a bare top-level field name is silently dropped at parse: a nested path unwinds the wrong field, an input parameter becomes a no-op clause, and the render is unparseable arcadedb#11442 (PR fix(#11442): UNWIND keeps its operand and alias instead of dropping anything but a bare field arcadedb#11535): UNWIND accepts any expression with an alias (nested path, input parameter, function call, collection literal, CASE), several comma-separated items, optional AS. A non-bare operand without an alias is a syntax error. Before, the parser kept only a bare field.
• SQL UNWIND <operand> AS x under a narrowing projection: an operand that needs the record itself (@rid, out()) or reads a field only inside a method/index argument or CASE sees null arcadedb#11537 (PR fix(#11537): an UNWIND operand that reads nothing the projection writes is evaluated against the record arcadedb#11564): the operand is evaluated against the record, so @rid, out('E'), m[k] or a CASE work under a narrowing projection. An operand that reads a renamed/computed column or an earlier UNWIND alias reads the projected row.
• Known gap SQL UNWIND <operand> AS x: an operand that reads a projection or UNWIND alias AND needs the record (@rid, out()) still sees null under a narrowing projection arcadedb#11563 (an operand reading both an alias and the record) is stated with its workaround.

The syntax line moves from UNWIND <Field>* to UNWIND <Field> | <Expression> [AS] <Alias> [, ...]. Examples are taken from the regression tests (Issue11442UnwindOperandTest, Issue11537UnwindOperandUnderNarrowingProjectionTest).

🤖 Generated with Claude Code

[mergify]

Tick the box to add this pull request to the merge queue (same as @mergifyio queue). If it does not match the queue conditions yet, it enters the queue once it does.

• Queue this pull request