[ARROW-15269] [C++][Docs] Clarify that not all compute functions are invocable via CallFunction

• Type: Improvement
• Status: Resolved
• Priority: Minor
• Resolution: Fixed
• Fix Version/s: 7.0.0
• Component/s: C++, Documentation
• Labels: good-first-issue pull-request-available
• External issue URL: https://github.com/apache/arrow/issues/30761
• Assignee: Sanjiban Sengupta
• Reporter: Eduardo Ponce
• Created: 06/Jan/22 07:12
• Updated: 11/Jan/23 11:35
• Resolved: 11/Jan/22 13:30

Description

It has been noted by users that the Compute Functions documentation ("Invoking functions" section) states that functions are invoked via CallFunction, but there exist functions (specifically "Grouped aggregations") 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.

Issue Links

• links to: GitHub Pull Request #12103
• links to: GitHub Pull Request #12104