Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
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
6 changes: 6 additions & 0 deletions src/main/asciidoc/reference/grpc-api.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -466,6 +466,12 @@ are streamed in batches of `batch_size`, in the order the query returns them. Ea
stream now carries the facets of a `FACETS` query on its last batch, `_skip` and `_limit` are ordinary parameter names,
and a query with no `ORDER BY` is no longer sorted by `@rid`: add an `ORDER BY` when you need an order.

NOTE: `StreamQuery` sends the rows the query projects, in every retrieval mode, the same rows `ExecuteQuery` and HTTP
return: `SELECT *, !secret` leaves `secret` out, `SELECT *, name AS alias` carries `alias`, and a row whose statement
excludes `@rid`, `@type`, `@cat`, `@in` or `@out` (`SELECT *, !@rid`) does not carry them, nested rows included
_(since v26.12.1)_. Earlier versions streamed the whole record behind each row, so excluded properties came back and
computed aliases were missing (issue #11942).

[[grpc-projection-settings]]
===== Projected records

Expand Down
7 changes: 7 additions & 0 deletions src/main/asciidoc/reference/sql/sql-functions.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -49,6 +49,13 @@ SELECT first(out('friends').name, NULL) AS firstFriend FROM Profiles

In the above example, the `first()` function doesn't aggregate everything in only one record, but rather returns one record per `Profile`, where the `firstFriend` is the first item of the collection received as the parameter.

===== Argument count

Every function accepts a fixed range of arguments. A call outside that range is refused when the statement is parsed,
with a `CommandSemanticException` such as `Function 'duration' expects 1-2 arguments but got 3`. Extra arguments are never
silently ignored. _(Since v26.12.1: before, about 46 geo, graph, math, time, time series and vector functions checked
the count only when they ran, each with its own exception, and some ignored extra arguments, issue #11944.)_

===== Function Reference

[[abs]]
Expand Down
Loading