[
https://issues.apache.org/jira/browse/ARROW-15269?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel
]
Eduardo Ponce updated ARROW-15269:
----------------------------------
Description:
It has been noted by users that the [Compute Functions documentation ("Invoking
functions" section) states that functions are invoked via
CallFunction|https://arrow.apache.org/docs/cpp/compute.html#invoking-functions],
but there exist functions (specifically ["Grouped
aggregations"|#grouped-aggregations-group-by]) that can't be invoked directly
via {{CallFunction}}. This is a bit misleading, although this is stated in the
description of "Grouped aggregations".
Grouped aggregations are stateful functions and at the moment stateful
functions are not invocable in such a way.
We should clarify in "Invoking functions" section that not all compute
functions are directly invocable via {{CallFunction}}.
was:
It has been noted by users that the [Compute Functions documentation ("Invoking
functions" section) states that functions are invoked via
CallFunction|https://arrow.apache.org/docs/cpp/compute.html#invoking-functions],
but there exist functions (specifically ["Grouped
aggregations"|#grouped-aggregations-group-by]) that can't be invoked directly
via {{CallFunction}}. This is a bit misleading, although this is stated in the
description of "Grouped aggregations".
Grouped aggregations are stateful functions and at the moment stateful
functions are invocable in such a way.
We should clarify in "Invoking functions" section that not all compute
functions are directly invocable via {{CallFunction}}.
> [C++][Docs] Clarify that not all compute functions are invocable via
> CallFunction
> ---------------------------------------------------------------------------------
>
> Key: ARROW-15269
> URL: https://issues.apache.org/jira/browse/ARROW-15269
> Project: Apache Arrow
> Issue Type: Improvement
> Components: C++, Documentation
> Reporter: Eduardo Ponce
> Priority: Minor
> Labels: good-first-issue
> Fix For: 8.0.0
>
>
> It has been noted by users that the [Compute Functions documentation
> ("Invoking functions" section) states that functions are invoked via
> CallFunction|https://arrow.apache.org/docs/cpp/compute.html#invoking-functions],
> but there exist functions (specifically ["Grouped
> aggregations"|#grouped-aggregations-group-by]) that can't be invoked directly
> via {{CallFunction}}. This is a bit misleading, although this is stated in
> the description of "Grouped aggregations".
> Grouped aggregations are stateful functions and at the moment stateful
> functions are not invocable in such a way.
> We should clarify in "Invoking functions" section that not all compute
> functions are directly invocable via {{CallFunction}}.
--
This message was sent by Atlassian Jira
(v8.20.1#820001)
