pluggable registry for input/export arrow kernels#7824
Open
a10y wants to merge 28 commits into
Open
Conversation
Closed
Merging this PR will degrade performance by 11.25%
|
| Mode | Benchmark | BASE |
HEAD |
Efficiency | |
|---|---|---|---|---|---|
| ❌ | Simulation | canonicalize_compare[(1000, 4, 4)] |
121.4 µs | 136.8 µs | -11.25% |
Tip
Investigate this regression by commenting @codspeedbot fix this regression on this PR, or directly use the CodSpeed MCP with your agent.
Comparing aduffy/arrow-vtable (91454da) with develop (1f6fb0a)
Footnotes
-
523 benchmarks were skipped, so the baseline results were used instead. If they were deleted from the codebase, click here and archive them to remove them from the performance reports. ↩
joseph-isaacs
changed the title
github-actions
Bot
removed
the
action/benchmark-sql
Contributor
Polar Signals Profiling ResultsLatest Run
Previous Runs (3)
Powered by Polar Signals Cloud |
Contributor
Benchmarks: PolarSignals ProfilingVortex (geomean): 0.997x ➖ datafusion / vortex-file-compressed (0.997x ➖, 1↑ 1↓)
|
Contributor
File Sizes: PolarSignals ProfilingNo file size changes detected. |
Contributor
Benchmarks: FineWeb NVMeVerdict: No clear signal (low confidence) datafusion / vortex-file-compressed (1.008x ➖, 0↑ 1↓)
datafusion / vortex-compact (0.980x ➖, 0↑ 0↓)
datafusion / parquet (0.989x ➖, 0↑ 0↓)
duckdb / vortex-file-compressed (0.988x ➖, 0↑ 0↓)
duckdb / vortex-compact (0.990x ➖, 0↑ 0↓)
duckdb / parquet (0.974x ➖, 1↑ 0↓)
Full attributed analysis
|
Contributor
File Sizes: FineWeb NVMeNo file size changes detected. |
Contributor
Benchmarks: TPC-H SF=1 on NVMEVerdict: No clear signal (low confidence) datafusion / vortex-file-compressed (0.955x ➖, 0↑ 0↓)
datafusion / vortex-compact (0.938x ➖, 3↑ 0↓)
datafusion / parquet (0.928x ➖, 3↑ 0↓)
datafusion / arrow (0.823x ✅, 20↑ 0↓)
duckdb / vortex-file-compressed (0.895x ✅, 13↑ 0↓)
duckdb / vortex-compact (0.902x ➖, 13↑ 0↓)
duckdb / parquet (0.968x ➖, 0↑ 0↓)
duckdb / duckdb (0.947x ➖, 3↑ 0↓)
Full attributed analysis
|
Contributor
File Sizes: TPC-H SF=1 on NVMEFile Size Changes (195 files changed, -98.4% overall, 0↑ 195↓)
Totals:
|
Contributor
Benchmarks: TPC-DS SF=1 on NVMEVerdict: No clear signal (low confidence) datafusion / vortex-file-compressed (0.952x ➖, 8↑ 1↓)
datafusion / vortex-compact (0.962x ➖, 6↑ 1↓)
datafusion / parquet (0.951x ➖, 5↑ 0↓)
duckdb / vortex-file-compressed (0.950x ➖, 8↑ 0↓)
duckdb / vortex-compact (0.956x ➖, 6↑ 1↓)
duckdb / parquet (0.968x ➖, 2↑ 0↓)
duckdb / duckdb (0.946x ➖, 11↑ 0↓)
Full attributed analysis
|
Contributor
File Sizes: TPC-DS SF=1 on NVMENo file size changes detected. |
Contributor
Benchmarks: FineWeb S3Verdict: No clear signal (environment too noisy confidence) datafusion / vortex-file-compressed (0.807x ➖, 1↑ 0↓)
datafusion / vortex-compact (0.932x ➖, 0↑ 0↓)
datafusion / parquet (1.020x ➖, 0↑ 0↓)
duckdb / vortex-file-compressed (0.954x ➖, 0↑ 0↓)
duckdb / vortex-compact (0.907x ➖, 0↑ 0↓)
duckdb / parquet (0.949x ➖, 0↑ 0↓)
Full attributed analysis
|
Contributor
Benchmarks: Statistical and Population GeneticsVerdict: No clear signal (low confidence) duckdb / vortex-file-compressed (0.987x ➖, 0↑ 0↓)
duckdb / vortex-compact (0.964x ➖, 1↑ 0↓)
duckdb / parquet (0.977x ➖, 0↑ 0↓)
Full attributed analysis
|
Contributor
File Sizes: Statistical and Population GeneticsNo file size changes detected. |
Contributor
Benchmarks: TPC-H SF=10 on NVMEVerdict: No clear signal (low confidence) datafusion / vortex-file-compressed (1.061x ➖, 0↑ 7↓)
datafusion / vortex-compact (1.011x ➖, 0↑ 0↓)
datafusion / parquet (0.998x ➖, 0↑ 0↓)
datafusion / arrow (1.015x ➖, 0↑ 0↓)
duckdb / vortex-file-compressed (1.050x ➖, 0↑ 2↓)
duckdb / vortex-compact (1.047x ➖, 0↑ 1↓)
duckdb / parquet (1.032x ➖, 0↑ 1↓)
duckdb / duckdb (1.044x ➖, 0↑ 0↓)
Full attributed analysis
|
Contributor
File Sizes: TPC-H SF=10 on NVMENo file size changes detected. |
Contributor
Benchmarks: Clickbench on NVMEVerdict: No clear signal (low confidence) datafusion / vortex-file-compressed (1.032x ➖, 1↑ 2↓)
datafusion / parquet (1.028x ➖, 0↑ 1↓)
duckdb / vortex-file-compressed (1.056x ➖, 0↑ 9↓)
duckdb / parquet (1.018x ➖, 1↑ 0↓)
duckdb / duckdb (0.993x ➖, 2↑ 0↓)
Full attributed analysis
|
Contributor
File Sizes: Clickbench on NVMEFile Size Changes (1 files changed, -0.0% overall, 0↑ 1↓)
Totals:
|
Contributor
Benchmarks: TPC-H SF=1 on S3Verdict: No clear signal (environment too noisy confidence) datafusion / vortex-file-compressed (1.015x ➖, 0↑ 3↓)
datafusion / vortex-compact (0.804x ➖, 5↑ 1↓)
datafusion / parquet (0.972x ➖, 2↑ 1↓)
duckdb / vortex-file-compressed (0.913x ➖, 0↑ 0↓)
duckdb / vortex-compact (0.921x ➖, 0↑ 0↓)
duckdb / parquet (0.950x ➖, 0↑ 0↓)
Full attributed analysis
|
Contributor
Benchmarks: TPC-H SF=10 on S3Verdict: No clear signal (environment too noisy confidence) datafusion / vortex-file-compressed (0.918x ➖, 3↑ 0↓)
datafusion / vortex-compact (0.865x ➖, 3↑ 0↓)
datafusion / parquet (0.880x ➖, 1↑ 0↓)
duckdb / vortex-file-compressed (0.935x ➖, 0↑ 0↓)
duckdb / vortex-compact (0.925x ➖, 1↑ 0↓)
duckdb / parquet (0.879x ➖, 0↑ 0↓)
Full attributed analysis
|
Signed-off-by: Andrew Duffy <andrew@a10y.dev>
Signed-off-by: Andrew Duffy <andrew@a10y.dev>
Signed-off-by: Andrew Duffy <andrew@a10y.dev>
Signed-off-by: Andrew Duffy <andrew@a10y.dev>
Signed-off-by: Andrew Duffy <andrew@a10y.dev>
Signed-off-by: Andrew Duffy <andrew@a10y.dev>
Signed-off-by: Andrew Duffy <andrew@a10y.dev>
Signed-off-by: Andrew Duffy <andrew@a10y.dev>
Signed-off-by: Andrew Duffy <andrew@a10y.dev>
Register `Vector` as an Arrow import/export plugin on the new `ArrowSession`, so a Vortex Vector extension array can go to Arrow and back without losing its identity. Note: If the plugin is not registered, imports fall back to the plain FSL (no error, but the Vector identity is dropped). --------- Signed-off-by: Baris Palaska <barispalaska@gmail.com>
Signed-off-by: Andrew Duffy <andrew@a10y.dev>
Signed-off-by: Andrew Duffy <andrew@a10y.dev>
Signed-off-by: Andrew Duffy <andrew@a10y.dev>
Signed-off-by: Andrew Duffy <andrew@a10y.dev>
Signed-off-by: Andrew Duffy <andrew@a10y.dev>
Signed-off-by: Andrew Duffy <andrew@a10y.dev>
Signed-off-by: Andrew Duffy <andrew@a10y.dev>
robert3005
force-pushed
the
aduffy/arrow-vtable
branch
from
f7ea15d to
e0648f3
Compare
This reverts commit 0cbfe1e. Signed-off-by: Andrew Duffy <andrew@a10y.dev>
Signed-off-by: Andrew Duffy <andrew@a10y.dev>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
4 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Adds a pluggable
ArrowSessionregistry onVortexSessionfor round-tripping Vortex extension types in and out of Arrow extension types. Unblocks Arrow round-trip forarrow.uuidtoday, witharrow.parquet.variant, GeoArrow, and tensor types as the next consumers.Part of #7686.
API changes
The session exposes two trait-driven plugin slots:
ArrowExportVTable— dispatched by target Arrow extension name (ARROW:extension:name). Implementations turn a VortexArrayRefinto an ArrowArrayRefshaped to the requestedField. Also providesto_arrow_fieldfor schema inference when only a VortexDTypeis inhand.
ArrowImportVTable— dispatched by source Arrow extension name carried on the incomingField. Implementations turn an ArrowArrayRefback into a VortexArrayRef, including any storage re-encoding (e.g.FixedSizeBinary[16]→FixedSizeList<u8; 16>for UUID).Both traits return
Unsupported(input)to defer to the next plugin or to the canonical fallback, so multiple plugins can register against the same key and probe in order.New session entry points (
vortex-array/src/arrow/session.rs):ArrowSession::to_arrow_field/to_arrow_schema— VortexDType→ ArrowField/Schema, recursing into containers so nested extension fields go through the registered plugin.ArrowSession::from_arrow_field/from_arrow_schema— inverse direction, plugin-aware.ArrowSession::from_arrow_record_batch/execute_record_batch—RecordBatchround-trip.ArrowSessionExtextension trait so anySessionExtcan callsession.arrow().….The default session pre-registers the builtin UUID plugin (
vortex-array/src/extension/uuid/arrow.rs).What's not in the plugin layer
Date,Time, andTimestampare Vortex builtin extensions that map directly to native Arrow temporal types, so they continue to go through the canonical executor (vortex-array/src/arrow/executor/temporal.rs) rather than the plugin registry. The plugin layer is reserved for Arrow extension types that the canonical path can't express.DataFusion wiring
vortex-datafusionnow goes through the session for schema/array conversion:convert/schema.rs::calculate_physical_schemausesArrowSession::to_arrow_fieldso extension metadata survives projection.persistent/format.rsandpersistent/opener.rsroute schema inference through the session.persistent/sink.rsusesfrom_arrow_record_batch, passing the original schema separately fromRecordBatch::schema()to preserveARROW:extension:namemetadata that DataFusion strips at runtime.Tests
Two new end-to-end tests in
vortex-datafusion/src/persistent/tests.rs:arrow_uuid_extension_roundtrip— write Arrow UUID column to a Vortex file via the session,SELECT *it back, assert the field still carries theUuidextension type and the values match.arrow_uuid_extension_roundtrip_nested_struct— same flow with the UUID nested in a top-levelStruct, exercising recursive session-aware schema inference.