Skip to main content

ArrowConvertedSchema

Struct ArrowConvertedSchema 

Source
pub struct ArrowConvertedSchema { /* private fields */ }
Expand description

An Arrow schema translated into DuckDB’s own type descriptors.

Produced by schema_from_arrow and consumed by data_chunk_from_arrow. Destroyed on drop (duckdb_destroy_arrow_converted_schema).

§Why it remembers a column count

The C API exposes no accessor for how many columns a converted schema describes, yet duckdb_data_chunk_from_arrow walks arrow_array->children[i] once per column with no bounds check. Recording the source schema’s n_children — which is exactly what PopulateArrowTableSchema iterates — lets data_chunk_from_arrow reject a mismatched array instead of reading past its children.

§Why it remembers the schema’s shape

duckdb_data_chunk_from_arrow imports some valid layouts wrongly (see data_chunk_from_arrow), and the array alone does not say which type each node has. The converted schema keeps the formats of the schema it was built from, so the array can be checked against them before the import.

Implementations§

Source§

impl ArrowConvertedSchema

Source

pub unsafe fn from_raw( raw: duckdb_arrow_converted_schema, schema: &ArrowSchema, ) -> Self

Takes ownership of a raw converted schema, recording the column count and the shape of schema, the Arrow schema it was built from.

§Safety
  • raw must be a non-null handle the caller is responsible for destroying, and nobody else may destroy it.
  • raw must have been built from schema (by duckdb_schema_from_arrow). A different schema defeats the bounds and layout checks in data_chunk_from_arrow.
Source

pub const fn as_raw(&self) -> duckdb_arrow_converted_schema

The raw handle, still owned by this value.

Source

pub const fn column_count(&self) -> usize

How many columns this schema describes.

Trait Implementations§

Source§

impl Debug for ArrowConvertedSchema

Source§

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

Formats the value using the given formatter. Read more
Source§

impl Drop for ArrowConvertedSchema

Source§

fn drop(&mut self)

Executes the destructor for this type. Read more
Source§

fn pin_drop(self: Pin<&mut Self>)

🔬This is a nightly-only experimental API. (pin_ergonomics)
Execute the destructor for this type, but different to Drop::drop, it requires self to be pinned. Read more

Auto Trait Implementations§

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = Infallible

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.