Struct HypertableSpec 

pub struct HypertableSpec {
    pub name: String,
    pub time_column: String,
    pub chunk_interval_ns: u64,
    pub default_ttl_ns: Option<u64>,
}

Spec declared by CREATE HYPERTABLE.

Fields

name: String

time_column: String

Column name that carries the time axis (must be unix-ns BIGINT or parseable to one).

chunk_interval_ns: u64

Fixed width of a single chunk, in nanoseconds.

default_ttl_ns: Option<u64>

Default TTL applied to every new chunk when the DDL didn’t request an explicit override. None means “no TTL — chunks live until explicit drop_chunks / retention policy fires”.

The effective expiry of a chunk is max_ts_ns + ttl_ns, so a chunk is safely droppable once now_ns ≥ expiry. That matches the contract callers already learnt from the retention daemon — partition TTL is the declarative way to say the same thing at CREATE time without a separate add_retention_policy call.

Implementations

impl HypertableSpec

pub fn new( name: impl Into<String>, time_column: impl Into<String>, chunk_interval_ns: u64, ) -> Self

pub fn from_interval_string( name: impl Into<String>, time_column: impl Into<String>, interval: &str, ) -> Option<Self>

Convenience: construct from a Timescale-style duration string ("1d", "1h", "30m"…).

pub fn with_ttl(self, ttl: &str) -> Option<Self>

Builder-style: attach a default TTL. Uses the same duration grammar as chunk_interval ("90d", "30s", …).

pub fn with_ttl_ns(self, ttl_ns: u64) -> Self

Direct setter when the TTL is already computed in ns.

pub fn chunk_start(&self, timestamp_ns: u64) -> u64

Align timestamp_ns to the chunk’s floor — the chunk that row belongs to starts at this timestamp and covers [start, start + chunk_interval_ns).

pub fn chunk_end_exclusive(&self, timestamp_ns: u64) -> u64

Trait Implementations

impl Clone for HypertableSpec

fn clone(&self) -> HypertableSpec

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for HypertableSpec

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

Formats the value using the given formatter.