Struct DynamicFilterExecutionOptions 

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

Runtime and route-discovery thresholds for native dynamic filters.

These values are shared by the optimizer and compiled execution so a route admitted during planning is evaluated against the same skip and payload thresholds at runtime. Keep this as one policy object before exposing any subset through user-facing configuration. Fields are public and #[doc(hidden)], except max_range_reader_predicate_selectivity_ppm, which is crate-visible. Embedders should use the read-only accessors and with_* methods.

Implementations

impl DynamicFilterExecutionOptions

pub fn small_in_list_limit(&self) -> usize

Maximum exact keyset cardinality lowered into a reader IN (...) predicate.

pub fn max_build_rows(&self) -> usize

Runtime cap for producer rows when an exact host keyset would be materialized.

pub fn large_local_parquet_range_producer_rows(&self) -> usize

Producer row threshold where local-Parquet consumers switch from exact host keysets to range-only payloads.

pub fn dimension_sized_consumer_bytes(&self) -> u64

Local-Parquet consumer byte threshold below which large producer keysets are treated as unlikely to pay for themselves.

pub fn tiny_local_parquet_consumer_row_groups(&self) -> usize

Selected row-group count below which a dimension-sized local-Parquet consumer has too little independent source work to justify a large keyset.

pub fn max_range_reader_predicate_selectivity_ppm(&self) -> u64

Maximum range overlap ratio, in parts per million, for merging a runtime range payload into a reader predicate.

pub fn max_deferred_small_in_list_reader_values(&self) -> usize

Maximum small-IN-list cardinality that may be deferred from reader predicate application into a post-decode filter when another predicate remains.

pub fn max_unpruned_hash_set_post_decode_values(&self) -> usize

Maximum unpruned hash-set payload cardinality accepted for source post-decode filtering.

pub fn min_unpruned_hash_set_post_decode_source_rows(&self) -> u64

Minimum known source rows required before an unpruned hash-set payload is worth applying as a source post-decode filter.

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

Validates internal consistency for this dynamic-filter policy.

Zero-valued thresholds remain accepted because this is still an expert Rust surface and callers may use zero to disable narrow sub-behaviors. The checks here reject values outside their bounds and combinations that make planner and runtime contracts contradictory.

pub fn with_max_build_rows(self, rows: usize) -> DynamicFilterExecutionOptions

Sets the producer row cap for materializing an exact host keyset.

pub fn with_large_local_parquet_range_producer_rows( self, rows: usize, ) -> DynamicFilterExecutionOptions

Sets the producer row threshold for using range-only payloads with local Parquet consumers.

Trait Implementations

impl Clone for DynamicFilterExecutionOptions

fn clone(&self) -> DynamicFilterExecutionOptions

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for DynamicFilterExecutionOptions

impl Debug for DynamicFilterExecutionOptions

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

Formats the value using the given formatter.

impl Default for DynamicFilterExecutionOptions

fn default() -> DynamicFilterExecutionOptions

Returns the “default value” for a type.

impl Eq for DynamicFilterExecutionOptions

impl PartialEq for DynamicFilterExecutionOptions

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for DynamicFilterExecutionOptions