Expand description
Apache Arrow interoperability for Vortex.
This crate owns every conversion between Vortex and Arrow. The authoritative entry point is
the ArrowSession: importing Arrow schemas, fields, and data types into Vortex
(ArrowSession::from_arrow_schema, ArrowSession::from_arrow_field,
ArrowSession::from_arrow_datatype), importing Arrow arrays and record batches
(ArrowSession::from_arrow_array, ArrowSession::from_arrow_record_batch),
exporting Vortex dtypes to Arrow
(ArrowSession::to_arrow_schema, ArrowSession::to_arrow_field,
ArrowSession::to_arrow_datatype), and executing Vortex arrays into Arrow
(ArrowSession::execute_arrow and the ArrowArrayExecutor convenience trait).
The ArrowSession session variable is created lazily on first use of
ArrowSessionExt::arrow, so no explicit registration is required for plain conversions.
Re-exports§
pub use convert::IntoVortexArray;pub use dtype::FromArrowType;Deprecated pub use dtype::ToArrowType;Deprecated pub use dtype::TryFromArrowType;Deprecated
Modules§
- bool
- byte_
view - convert
- Canonical (non-plugin) conversions of Arrow arrays into Vortex arrays.
- dtype
- Convert between Vortex
vortex_array::dtype::DTypeand Apache Arrowarrow_schema::DataType. - null
- primitive
Structs§
- Arrow
Array Stream Adapter - An adapter for converting an
ArrowArrayStreamReaderinto a VortexArrayIterator. - Arrow
Session - Session-scoped registry of Arrow extension plugins.
- Datum
- A wrapper around a generic Arrow array that can be used as a Datum in Arrow compute.
Enums§
- Arrow
Export - Outcome of a successful call to
ArrowExportVTable::execute_arrow. - Arrow
Import - Outcome of a successful call to
ArrowImportVTable::from_arrow_array.
Traits§
- Arrow
Array Executor Deprecated - Trait for executing a Vortex array to produce an Arrow array.
- Arrow
ExportV Table - Plugin layer for exporting a Vortex array to an Arrow extension type.
- Arrow
ImportV Table - Plugin layer for importing an Arrow extension-typed array into a Vortex array.
- Arrow
Session Ext - Extension trait for accessing the
ArrowSessionon a Vortex session. - From
Arrow Array Deprecated - Construct a Vortex array from an Arrow array (or other Arrow container) of type
A. - Into
Arrow Array Deprecated - Into
Arrow Field - The Arrow type description of an array being imported by
ArrowSession::from_arrow_array. - ToArrow
Datum - Convert a Vortex
Scalarinto an ArrowDatum(a single-element Arrow array).
Functions§
- from_
arrow_ array_ with_ len Deprecated - Convert an Arrow array to an Array with a specific length. This is useful for compute functions that delegate to Arrow using Datum, which will return a scalar (length 1 Arrow array) if the input array is constant.
- from_
arrow_ columnar - Convert an Arrow array to an Array with a specific length, using the provided
ExecutionCtx. - initialize
- Register vortex-arrow’s session extensions into
session. - to_
arrow_ null_ buffer - Converts a
Validityto an ArrowNullBuffer, executing the validity array if needed. - to_
null_ buffer - Converts a mask to a null buffer.