Struct AggregateStrategyExecutionOptions 

#[non_exhaustive]
pub struct AggregateStrategyExecutionOptions { /* private fields */ }

Runtime threshold policy for grouped aggregate strategy selection.

These thresholds choose between the default libcudf groupby path, encoded key partial aggregation, prepared sort-backed groupby, and exact cardinality probes. This is an expert Rust surface only; keep it out of server/session/user-facing configuration until the tuning model has a reviewed production contract.

Thresholds suffixed _ppm are ratios of distinct groups to input rows in parts per million; _rows, _bytes, _row_groups, _fan_in and _key_columns are absolute bounds. Zero disables the branch a threshold guards, which is why Self::validate accepts it.

Implementations

impl AggregateStrategyExecutionOptions

pub const DEFAULT_SOURCE_ADJACENT_PREPARED_SORT_GROUPBY_MAX_ROW_GROUPS: u64 = 64

Default maximum selected row groups for source-adjacent prepared sort grouping.

pub const DEFAULT_SOURCE_ADJACENT_PREPARED_SORT_GROUPBY_MAX_SOURCE_READ_BYTES: u64

Default maximum source-read bytes for source-adjacent prepared sort grouping.

pub const DEFAULT_SOURCE_ADJACENT_PREPARED_SORT_GROUPBY_MAX_FAN_IN: u64 = 64

Default maximum chunk fan-in for source-adjacent prepared sort grouping.

pub fn encoded_key_partial_low_cardinality_threshold_ppm(&self) -> u64

Maximum distinct-group/input-row ratio, in parts per million, for the encoded-key partial aggregation strategy.

pub fn encoded_key_partial_min_input_rows(&self) -> u64

Minimum input row count for considering encoded-key partial aggregation.

pub fn exact_grouped_key_cardinality_probe_max_key_columns(&self) -> usize

Maximum number of grouping columns admitted to the exact cardinality probe.

pub fn exact_single_string_avg_cardinality_probe_min_input_rows(&self) -> u64

Minimum input row count for probing a single string key with AVG state.

pub fn exact_single_key_cardinality_probe_min_input_rows(&self) -> u64

Minimum input row count for the general single-key cardinality probe.

pub fn exact_grouped_key_cardinality_probe_min_input_rows(&self) -> u64

Minimum input row count for the multi-column grouping cardinality probe.

pub fn exact_single_string_key_prepared_max_groups(&self) -> u64

Maximum distinct string-key groups admitted to the prepared strategy.

pub fn exact_three_key_cardinality_probe_max_input_rows(&self) -> u64

Maximum input row count for an exact three-column grouping probe.

pub fn exact_five_key_cardinality_probe_max_input_rows(&self) -> u64

Maximum input row count for an exact five-column grouping probe.

pub fn prepared_sort_groupby_low_cardinality_threshold_ppm(&self) -> u64

Maximum distinct-group/input-row ratio, in parts per million, for prepared sort grouping.

pub fn source_adjacent_prepared_sort_groupby_max_row_groups(&self) -> u64

Maximum selected row groups for source-adjacent prepared sort grouping.

pub fn source_adjacent_prepared_sort_groupby_max_source_read_bytes(&self) -> u64

Maximum source-read bytes for source-adjacent prepared sort grouping.

pub fn source_adjacent_prepared_sort_groupby_max_fan_in(&self) -> u64

Maximum chunk fan-in for source-adjacent prepared sort grouping.

pub fn validate(&self) -> Result<(), QueryError>

Validates aggregate strategy policy values.

Zero-valued thresholds remain accepted because this is an expert Rust surface and callers may use zero to disable narrow strategy branches. The checks here reject ratios above one hundred percent and contradictory nonzero probe bounds so strategy facts remain interpretable.

pub fn with_encoded_key_partial_low_cardinality_threshold_ppm( self, threshold_ppm: u64, ) -> AggregateStrategyExecutionOptions

Sets the distinct-group/input-row ratio limit in parts per million. Self::validate rejects values above 1,000,000.

pub fn with_encoded_key_partial_min_input_rows( self, rows: u64, ) -> AggregateStrategyExecutionOptions

Sets the minimum input rows for encoded-key partial aggregation. This setter retains the supplied threshold without validation.

pub fn with_prepared_sort_groupby_low_cardinality_threshold_ppm( self, threshold_ppm: u64, ) -> AggregateStrategyExecutionOptions

Sets the distinct-group/input-row ratio limit for prepared sort grouping in parts per million. Self::validate rejects values above 1,000,000.

pub fn with_source_adjacent_prepared_sort_groupby_max_row_groups( self, row_groups: u64, ) -> AggregateStrategyExecutionOptions

Sets the selected-row-group bound for source-adjacent prepared sort grouping. Zero disables that strategy branch.

Trait Implementations

impl Clone for AggregateStrategyExecutionOptions

fn clone(&self) -> AggregateStrategyExecutionOptions

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Copy for AggregateStrategyExecutionOptions

impl Debug for AggregateStrategyExecutionOptions

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.

impl Default for AggregateStrategyExecutionOptions

fn default() -> AggregateStrategyExecutionOptions

Returns the “default value” for a type.

impl Eq for AggregateStrategyExecutionOptions

impl PartialEq for AggregateStrategyExecutionOptions

fn eq(&self, other: &AggregateStrategyExecutionOptions) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for AggregateStrategyExecutionOptions