Struct QueryOptions 

pub struct QueryOptions {
    pub parallelism: usize,
    pub allow_query_fallback: bool,
    pub memory_pool_size: MemoryLimit,
    pub enable_per_region_metrics: bool,
    pub experimental_spill_mode: QuerySpillMode,
    pub experimental_spill_path: Option<PathBuf>,
    pub experimental_spill_max_temp_directory_size: ReadableSize,
    pub experimental_spill_compression: QuerySpillCompression,
    pub experimental_memory_pool_policy: QueryMemoryPoolPolicy,
}

Query engine config

Fields

parallelism: usize

Parallelism of query engine. Default to 0, which implies the number of logical CPUs.

allow_query_fallback: bool

Whether to allow query fallback when push down fails.

memory_pool_size: MemoryLimit

Memory pool size for query execution. Setting it to 0 disables the limit (unbounded). Supports absolute size (e.g., “2GB”) or percentage (e.g., “50%”). When this limit is reached, queries will fail with ResourceExhausted error.

enable_per_region_metrics: bool

Whether to expose per-region query load metrics.

experimental_spill_mode: QuerySpillMode

Experimental: spill-to-disk mode.

• default: preserve DataFusion built-in OS temp directory behavior.
• custom: explicitly configure spill path, max directory size, and compression.
• disabled: explicitly disable disk spilling.

experimental_spill_path: Option<PathBuf>

Experimental: spill directory path. Ignored unless experimental_spill_mode is "custom". When set, spill files are written into this directory.

experimental_spill_max_temp_directory_size: ReadableSize

Experimental: maximum total size of the spill directory (data written to spill files). Ignored unless experimental_spill_mode is "custom". Default: 1GiB.

experimental_spill_compression: QuerySpillCompression

Experimental: compression algorithm applied to spilled data. Ignored unless experimental_spill_mode is "custom". Default: uncompressed.

experimental_memory_pool_policy: QueryMemoryPoolPolicy

Experimental: memory pool allocation policy.

• greedy: Greedy first-come-first-served (default).
• fair: Fair divides memory available after unspillable reservations evenly among spillable reservations and may trigger earlier spills.

Trait Implementations

impl Clone for QueryOptions

fn clone(&self) -> QueryOptions

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for QueryOptions

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

Formats the value using the given formatter.

impl Default for QueryOptions

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for QueryOptions

where QueryOptions: Default,

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for QueryOptions

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for QueryOptions

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Eq for QueryOptions

impl StructuralPartialEq for QueryOptions