Enum iceberg_rust::spec::values::Value

pub enum Value {
    Boolean(bool),
    Int(i32),
    LongInt(i64),
    Float(OrderedFloat<f32>),
    Double(OrderedFloat<f64>),
    Date(i32),
    Time(i64),
    Timestamp(i64),
    TimestampTZ(i64),
    String(String),
    UUID(Uuid),
    Fixed(usize, Vec<u8>),
    Binary(Vec<u8>),
    Decimal(Decimal),
    Struct(Struct),
    List(Vec<Option<Value>>),
    Map(BTreeMap<Value, Option<Value>>),
}

Values present in iceberg type

Variants

Boolean(bool)

0x00 for false, non-zero byte for true

Int(i32)

Stored as 4-byte little-endian

LongInt(i64)

Stored as 8-byte little-endian

Float(OrderedFloat<f32>)

Stored as 4-byte little-endian

Double(OrderedFloat<f64>)

Stored as 8-byte little-endian

Date(i32)

Stores days from the 1970-01-01 in an 4-byte little-endian int

Time(i64)

Stores microseconds from midnight in an 8-byte little-endian long

Timestamp(i64)

Stores microseconds from 1970-01-01 00:00:00.000000 in an 8-byte little-endian long

TimestampTZ(i64)

Stores microseconds from 1970-01-01 00:00:00.000000 in an 8-byte little-endian long

String(String)

UTF-8 bytes (without length)

UUID(Uuid)

16-byte big-endian value

Fixed(usize, Vec<u8>)

Binary value

Binary(Vec<u8>)

Binary value (without length)

Decimal(Decimal)

Stores unscaled value as two’s-complement big-endian binary, using the minimum number of bytes for the value

Struct(Struct)

A struct is a tuple of typed values. Each field in the tuple is named and has an integer id that is unique in the table schema. Each field can be either optional or required, meaning that values can (or cannot) be null. Fields may be any type. Fields may have an optional comment or doc string. Fields can have default values.

List(Vec<Option<Value>>)

A list is a collection of values with some element type. The element field has an integer id that is unique in the table schema. Elements can be either optional or required. Element types may be any type.

Map(BTreeMap<Value, Option<Value>>)

A map is a collection of key-value pairs with a key type and a value type. Both the key field and value field each have an integer id that is unique in the table schema. Map keys are required and map values can be either optional or required. Both map keys and map values may be any type, including nested types.

Implementations

impl Value

pub fn tranform(&self, transform: &Transform) -> Result<Value, Error>

Perform a partition transformation for the given value

pub fn try_from_bytes(bytes: &[u8], data_type: &Type) -> Result<Value, Error>

Create iceberg value from bytes

pub fn try_from_json( value: Value, data_type: &Type ) -> Result<Option<Value>, Error>

Create iceberg value from a json value

pub fn datatype(&self) -> Type

Get datatype of value

pub fn into_any(self) -> Box<dyn Any>

Convert Value to the any type

pub fn cast(self, data_type: &Type) -> Result<Value, Error>

Cast value to different type

Trait Implementations

impl Clone for Value

fn clone(&self) -> Value

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Value

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Value

fn deserialize<__D>( __deserializer: __D ) -> Result<Value, <__D as Deserializer<'de>>::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for Value

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

Formats the value using the given formatter.

impl Hash for Value

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

where __H: Hasher,

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 Ord for Value

fn cmp(&self, other: &Value) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized + PartialOrd,

Restrict a value to a certain interval.

impl PartialEq for Value

fn eq(&self, other: &Value) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl PartialOrd for Value

fn partial_cmp(&self, other: &Value) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

fn lt(&self, other: &Rhs) -> bool

This method tests less than (for self and other) and is used by the < operator.

fn le(&self, other: &Rhs) -> bool

This method tests less than or equal to (for self and other) and is used by the <= operator.

fn gt(&self, other: &Rhs) -> bool

This method tests greater than (for self and other) and is used by the > operator.

fn ge(&self, other: &Rhs) -> bool

This method tests greater than or equal to (for self and other) and is used by the >= operator.

impl Serialize for Value

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Eq for Value

impl StructuralPartialEq for Value