[ARROW-15534] [C++] Add convenience function to substrait consumer to create plan instead of declaration

• Type: Improvement
• Status: Resolved
• Priority: Major
• Resolution: Fixed
• Fix Version/s: 9.0.0
• Component/s: C++
• Labels: pull-request-available substrait
• External issue URL: https://github.com/apache/arrow/issues/20097
• Assignee: Sanjiban Sengupta
• Reporter: Weston Pace
• Created: 02/Feb/22 18:54
• Updated: 11/Jan/23 11:37
• Resolved: 20/May/22 17:02

Description

This is a follow-up to ARROW-15238

The current API for Substrait is:

Result<std::vector<compute::Declaration>> DeserializePlan(
    const Buffer&, const ConsumerFactory&, ExtensionSet* ext_set = NULLPTR)

This converts a plan into a vector of declarations (one per root-relation in the Substrait plan)
These declarations then have to be added to an exec plan to run.

As a convenience we could alter the API:

Result<std::vector<compute::Declaration>> DeserializePlans(
    const Buffer&, const ConsumerFactory&, ExtensionSet* ext_set = NULLPTR)
result<compute::ExecPlan> DeserializePlan(const Buffer&, const ConsumerFactory&, ExtensionSet* ext_set = NULLPTR)

This would save the user from needing to create an empty exec plan (and it could return an error if the substrait plan had multiple root relations).

Issue Links

• links to: GitHub Pull Request #13181