Struct TableStatistics 

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

Snapshot of the per-table statistics MySQL stores in ha_statistics.

Returned from Handlerton::get_table_statistics; the shim copies each field into the matching ha_statistics slot before handing control back to the optimizer. Engines build instances through Self::new and the chained with_* setters; missing fields stay zero, which matches MySQL’s ha_statistics() default constructor.

Implementations

impl TableStatistics

pub const fn new() -> Self

Construct a statistics snapshot with every field zeroed — the same initial state ha_statistics() produces on the C++ side.

pub const fn with_records(self, value: u64) -> Self

Number of live rows in the table.

pub const fn with_data_file_length(self, value: u64) -> Self

Size of the data segment in bytes.

pub const fn with_max_data_file_length(self, value: u64) -> Self

Hard cap MySQL should believe for data_file_length.

pub const fn with_index_file_length(self, value: u64) -> Self

Size of the index segment in bytes.

pub const fn with_max_index_file_length(self, value: u64) -> Self

Hard cap MySQL should believe for index_file_length.

pub const fn with_delete_length(self, value: u64) -> Self

Bytes reclaimable by compacting deleted rows.

pub const fn with_auto_increment_value(self, value: u64) -> Self

Next auto-increment value the engine intends to hand out.

pub const fn with_deleted(self, value: u64) -> Self

Number of tombstoned rows still occupying space.

pub const fn with_mean_rec_length(self, value: u64) -> Self

Physical record length (stats.mean_rec_length on the C++ side).

pub const fn with_create_time(self, value: i64) -> Self

UNIX timestamp the table was created at; mirrors C++ time_t.

pub const fn with_check_time(self, value: u64) -> Self

UNIX timestamp of the last CHECK TABLE run.

pub const fn with_update_time(self, value: u64) -> Self

UNIX timestamp of the last data modification.

pub const fn with_block_size(self, value: u32) -> Self

Index block size in bytes.

pub const fn records(&self) -> u64

Raw record count (read by the shim when copying into ha_statistics).

pub const fn data_file_length(&self) -> u64

Data segment length in bytes.

pub const fn max_data_file_length(&self) -> u64

Hard cap for data_file_length.

pub const fn index_file_length(&self) -> u64

Index segment length in bytes.

pub const fn max_index_file_length(&self) -> u64

Hard cap for index_file_length.

pub const fn delete_length(&self) -> u64

Reclaimable byte count.

pub const fn auto_increment_value(&self) -> u64

Next auto-increment value.

pub const fn deleted(&self) -> u64

Tombstoned row count.

pub const fn mean_rec_length(&self) -> u64

Mean record length.

pub const fn create_time(&self) -> i64

Create-time UNIX timestamp.

pub const fn check_time(&self) -> u64

Last-check UNIX timestamp.

pub const fn update_time(&self) -> u64

Last-update UNIX timestamp.

pub const fn block_size(&self) -> u32

Index block size in bytes.

Trait Implementations

impl Clone for TableStatistics

fn clone(&self) -> TableStatistics

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for TableStatistics

impl Debug for TableStatistics

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

Formats the value using the given formatter.

impl Default for TableStatistics

fn default() -> Self

Returns the “default value” for a type.

impl Eq for TableStatistics

impl PartialEq for TableStatistics

fn eq(&self, other: &TableStatistics) -> 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 StructuralPartialEq for TableStatistics