Enum DatumType

pub enum DatumType {
    Other(i32),
    Int16(i32),
    Int32(i32),
    Int64(i64),
    Float32(f32),
    Float64(f64),
    Bytes(Bytes),
    String(String),
    Date(ProtoDate),
    Time(ProtoNaiveTime),
    Timestamp(ProtoNaiveDateTime),
    TimestampTz(ProtoNaiveDateTime),
    Interval(ProtoInterval),
    Array(ProtoArray),
    List(ProtoRow),
    Dict(ProtoDict),
    Numeric(ProtoNumeric),
    Uuid(Vec<u8>),
    Uint32(u32),
    Uint8(u32),
    Uint16(u32),
    Uint64(u64),
    MzTimestamp(u64),
    Range(Box<ProtoRange>),
    MzAclItem(ProtoMzAclItem),
    AclItem(ProtoAclItem),
}

NB: Proto oneof ids 1..=15 get encoded in 1 byte and so we should reserve them for the datum types we expect to be most popular.

Null, False, and True are all likely to be frequent, but the encoded length is exactly the same if they’re here or in ProtoDatumOther. In general, anything that can be encoded purely as a proto enum variant (i.e. doesn’t have a payload) is better off that way. If we run out of 1-byte encodings of ProtoDatumOther, we can always add ProtoDatumOther2.

Variants

Other(i32)

Int16(i32)

Int32(i32)

Int64(i64)

Float32(f32)

Float64(f64)

Bytes(Bytes)

String(String)

Don’t use 9-15 without truly understanding the NB above.

Date(ProtoDate)

These get encoded with 2 bytes for the oneof id. It’s a pretty easy and low-debt migration to “bless” one of these into having a 1-byte id (fill in the new field on write, but check if either field is set on read). However, once a 1-byte id is used, it’s gone forever, so we’re conservative in handing them out.

Of these, I’d guess Timestamp and UUID are probably the first ones we’d bless followed by Date and Time.

Time(ProtoNaiveTime)

Timestamp(ProtoNaiveDateTime)

TimestampTz(ProtoNaiveDateTime)

Interval(ProtoInterval)

Array(ProtoArray)

List(ProtoRow)

Dict(ProtoDict)

Numeric(ProtoNumeric)

Uuid(Vec<u8>)

Uint32(u32)

Uint8(u32)

Uint16(u32)

Uint64(u64)

MzTimestamp(u64)

Range(Box<ProtoRange>)

MzAclItem(ProtoMzAclItem)

AclItem(ProtoAclItem)

Implementations

impl DatumType

pub fn encode(&self, buf: &mut impl BufMut)

Encodes the message to a buffer.

pub fn merge( field: &mut Option<DatumType>, tag: u32, wire_type: WireType, buf: &mut impl Buf, ctx: DecodeContext, ) -> Result<(), DecodeError>

Decodes an instance of the message from a buffer, and merges it into self.

pub fn encoded_len(&self) -> usize

Returns the encoded length of the message without a length delimiter.

Trait Implementations

impl Clone for DatumType

fn clone(&self) -> DatumType

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for DatumType

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

Formats the value using the given formatter.

impl PartialEq for DatumType

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