Struct ColumnStats 

pub struct ColumnStats {
    pub row_count: Option<u64>,
    pub null_count: Option<u64>,
    pub distinct_count: Option<u64>,
    pub min: Option<Bound>,
    pub max: Option<Bound>,
    pub upper_bound_rows: Option<u64>,
}

Canonical column statistics surface.

Intentionally a superset of DataFusion’s ColumnStatistics and DuckDB’s internal BaseStatistics so a single instance can satisfy either engine.

Examples

use samkhya_core::ColumnStats;

let stats = ColumnStats::new()
    .with_row_count(10_000)
    .with_distinct_count(8_421)
    .with_null_count(7)
    .with_upper_bound(10_000);
assert_eq!(stats.row_count, Some(10_000));
assert_eq!(stats.distinct_count, Some(8_421));
assert_eq!(stats.null_count, Some(7));
assert_eq!(stats.upper_bound_rows, Some(10_000));

Fields

row_count: Option<u64>

null_count: Option<u64>

distinct_count: Option<u64>

min: Option<Bound>

max: Option<Bound>

upper_bound_rows: Option<u64>

Inclusive ceiling derived from LpBound; correctors must not exceed this.

Implementations

impl ColumnStats

pub fn new() -> Self

Construct an empty stats record (all fields None).

Examples

use samkhya_core::ColumnStats;

let s = ColumnStats::new();
assert!(s.row_count.is_none());

pub fn with_row_count(self, n: u64) -> Self

Builder-style setter for row_count.

Examples

use samkhya_core::ColumnStats;

let s = ColumnStats::new().with_row_count(100);
assert_eq!(s.row_count, Some(100));

pub fn with_distinct_count(self, n: u64) -> Self

Builder-style setter for distinct_count.

Examples

use samkhya_core::ColumnStats;

let s = ColumnStats::new().with_distinct_count(42);
assert_eq!(s.distinct_count, Some(42));

pub fn with_null_count(self, n: u64) -> Self

Builder-style setter for null_count.

Examples

use samkhya_core::ColumnStats;

let s = ColumnStats::new().with_null_count(3);
assert_eq!(s.null_count, Some(3));

pub fn with_upper_bound(self, n: u64) -> Self

Builder-style setter for upper_bound_rows. The LpBound ceiling that downstream correctors must respect.

Examples

use samkhya_core::ColumnStats;

let s = ColumnStats::new().with_upper_bound(10_000);
assert_eq!(s.upper_bound_rows, Some(10_000));

Trait Implementations

impl Clone for ColumnStats

fn clone(&self) -> ColumnStats

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ColumnStats

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

Formats the value using the given formatter.

impl Default for ColumnStats

fn default() -> ColumnStats

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for ColumnStats

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for ColumnStats

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

where __S: Serializer,

Serialize this value into the given Serde serializer.