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
impl ArrowConvertedSchema
Sourcepub unsafe fn from_raw(
raw: duckdb_arrow_converted_schema,
schema: &ArrowSchema,
) -> Self
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
rawmust be a non-null handle the caller is responsible for destroying, and nobody else may destroy it.rawmust have been built fromschema(byduckdb_schema_from_arrow). A different schema defeats the bounds and layout checks indata_chunk_from_arrow.
Sourcepub const fn as_raw(&self) -> duckdb_arrow_converted_schema
pub const fn as_raw(&self) -> duckdb_arrow_converted_schema
The raw handle, still owned by this value.
Sourcepub const fn column_count(&self) -> usize
pub const fn column_count(&self) -> usize
How many columns this schema describes.