Enum ColumnType 

#[non_exhaustive]
pub enum ColumnType {
    Int64,
    Float64,
    String,
    Bool,
    Bytes,
    Timestamp,
    Timestamptz,
    SystemTimestamp,
    Decimal {
        precision: u8,
        scale: u8,
    },
    Geometry,
    Vector(u32),
    Uuid,
    Json,
    Ulid,
    Duration,
    Array,
    Set,
    Regex,
    Range,
    Record,
}

Typed column definition for strict document and columnar collections.

#[non_exhaustive] — this enum grows with each type system expansion (e.g. future variants may add Decimal { precision, scale } or split Timestamp/TimestampTz). External exhaustive match arms must handle future variants via a typed error arm rather than _ => unreachable!().

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Int64

Float64

String

Bool

Bytes

Timestamp

Naive (no-timezone) timestamp with microsecond precision. OID 1114.

Timestamptz

UTC (timezone-aware) timestamp with microsecond precision. OID 1184.

SystemTimestamp

System-assigned timestamp (bitemporal system_from_ms). Same 8-byte layout as Timestamp, but tagged distinctly so the planner and DDL layer can reject user-supplied values — the column is populated by the engine from HLC at commit.

Decimal

Arbitrary-precision decimal with explicit precision and scale.

precision: total significant digits, 1–38. scale: digits after the decimal point, 0–precision. Default when unspecified: {38, 10}.

Fields

precision: u8

scale: u8

Geometry

Vector(u32)

Fixed-dimension float32 vector.

Uuid

Json

Arbitrary nested data stored as inline MessagePack. Variable-length. Accepts any Value type.

Ulid

ULID: 16-byte Crockford Base32-encoded sortable ID.

Duration

Duration: signed microsecond precision (i64 internally).

Array

Ordered array of values. Variable-length, inline MessagePack.

Set

Ordered set (auto-deduplicated). Variable-length, inline MessagePack.

Regex

Compiled regex pattern. Stored as string internally.

Range

Bounded range of values. Variable-length, inline MessagePack.

Record

Typed reference to another record (table:id). Variable-length, inline MessagePack.

Implementations

impl ColumnType

pub fn fixed_size(&self) -> Option<usize>

Whether this type has a fixed byte size in Binary Tuple layout.

pub fn is_variable_length(&self) -> bool

Whether this type is variable-length (requires offset table entry).

pub fn to_pg_oid(&self) -> u32

Return the canonical PostgreSQL type OID for this column type.

This is the single authoritative mapping between NodeDB ColumnType variants and PostgreSQL wire-protocol OIDs. All pgwire code must derive OIDs from this method — no local string-matching tables.

Choices for non-native types:

• Geometry → 25 (TEXT): no standard pg geometry OID; PostGIS uses its own extension OID which we cannot claim. TEXT lets clients at least see the WKT/WKB string.
• Vector(_) → 1021 (FLOAT4_ARRAY): closest built-in pg type for a fixed-dimension float32 vector; pgvector uses a custom OID, which we avoid to stay dependency-free.
• Array, Set, Range, Record, Regex → 114 (JSON): these are variable-length MessagePack-encoded structures; JSON is the safest generic text OID for clients that need to read the value as a string.

pub fn accepts(&self, value: &Value) -> bool

Whether a Value is compatible with this column type.

Accepts both native Value types (e.g., Value::DateTime for Timestamp) AND coercion sources from SQL input (e.g., Value::String for Timestamp). Null is accepted for any type — nullability is enforced at schema level.

Trait Implementations

impl Clone for ColumnType

fn clone(&self) -> ColumnType

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ColumnType

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ColumnType

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for ColumnType

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

Formats the value using the given formatter.

impl<'__msgpack_de> FromMessagePack<'__msgpack_de> for ColumnType

fn read<R: Read<'__msgpack_de>>(reader: &mut R) -> Result<Self, Error>

where Self: Sized,

Reads the MessagePack representation of this value from the provided reader.

impl FromStr for ColumnType

type Err = ColumnTypeParseError

The associated error which can be returned from parsing.

fn from_str(s: &str) -> Result<Self, Self::Err>

Parses a string s to return a value of this type.

impl Hash for ColumnType

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for ColumnType

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

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl ToMessagePack for ColumnType

fn write<W: Write>(&self, writer: &mut W) -> Result<(), Error>

Writes the MessagePack representation of this value into the provided writer.

impl Copy for ColumnType

impl Eq for ColumnType

impl StructuralPartialEq for ColumnType