Module unshred_variant 

Module for unshredding VariantArray by folding typed_value columns back into the value column.

Macros

handle_unshredded_case 🔒

Macro that handles the unshredded case (typed_value is missing or NULL) and returns early if handled. If not handled (shredded case), validates and returns the extracted value.

impl_append_to_variant_builder 🔒

Structs

DecimalUnshredRowBuilder 🔒

Generic builder for decimal unshredding

ListUnshredVariantBuilder 🔒

Builder for unshredding list/array types with recursive element processing

NullUnshredVariantBuilder 🔒

Builder for arrays with neither typed_value nor value (all Variant::Null)

StructUnshredVariantBuilder 🔒

Builder for unshredding struct/object types with nested fields

TimestampUnshredRowBuilder 🔒

Generic builder for timestamp types that handles timezone-aware conversion

TopLevelRowSink 🔒

Wraps the sink that every top-level row is appended into. The row builders signal a missing value (value and typed_value both NULL) by calling append_null, and this wrapper gives that signal its top-level meaning: Variant::Null, because the non-nullable output value column cannot hold a physical NULL. Array-level NULL rows are appended before the sink is built, so they never reach it. Nested builders created via try_new_object/try_new_list are returned unwrapped, so nested missing values keep their own semantics, e.g. [ObjectFieldBuilder] omits the field.

UnshredPrimitiveRowBuilder 🔒

Generic unshred builder that works with any Array implementing AppendToVariantBuilder

ValueOnlyUnshredVariantBuilder 🔒

Builder for arrays that only have value column (already unshredded)

Enums

UnshredVariantRowBuilder 🔒

Row builder for converting shredded VariantArray rows back to unshredded form

Traits

AppendToVariantBuilder 🔒

Extension trait that directly adds row builder support for arrays that correspond to primitive variant types.

TimestampType 🔒

Trait for timestamp types to handle conversion to DateTime<Utc>

Functions

unshred_variant

Removes all (nested) typed_value columns from a VariantArray by converting them back to binary variant and merging the resulting values back into the value column.

value_field_is_non_nullable 🔒

value_nulls_are_masked 🔒

Returns true if every null in value is masked by a parent null, i.e. the column may be annotated non-nullable.