From 27ff62c56bd7e4cef924ca18041823dce4db5bcc Mon Sep 17 00:00:00 2001 From: Andrew Lamb Date: Tue, 10 Nov 2026 12:50:44 -0500 Subject: [PATCH 01/11] Draft blog post for DataFusion 56.0.0 release Co-Authored-By: Claude Fable 5.2 --- content/blog/2026-11-10-datafusion-56.0.0.md | 615 +++++++++++++++++++ 1 file changed, 615 insertions(+) create mode 100644 content/blog/2026-11-10-datafusion-56.0.0.md diff --git a/content/blog/2026-11-10-datafusion-56.0.0.md b/content/blog/2026-11-10-datafusion-56.0.0.md new file mode 100644 index 00000000..fb84adbd --- /dev/null +++ b/content/blog/2026-11-10-datafusion-56.0.0.md @@ -0,0 +1,615 @@ +--- +layout: post +title: Apache DataFusion 56.0.0 Released +date: 2026-11-10 +author: pmc +categories: [release] +--- + + + +[TOC] + + + +We are proud to announce the release of [DataFusion 56.0.0]. This post +highlights some of the many improvements since [DataFusion 55.0.0], such as +`ASOF` joins, SQL registration of external catalogs, Avro and ALP write support, +better support for extension types such as `UUID`, Variant, and geospatial +types, and many performance and stability improvements. The complete list of +changes is available in the [changelog]. This release represents roughly 11 +weeks of development and 1200 commits. Thanks to the [247 contributors] (another +new record!) for making it possible. + +[DataFusion 56.0.0]: https://crates.io/crates/datafusion/56.0.0 +[DataFusion 55.0.0]: https://datafusion.apache.org/blog/2026/08/25/datafusion-55.0.0/ +[changelog]: https://github.com/apache/datafusion/blob/branch-56/dev/changelog/56.0.0.md +[247 contributors]: https://github.com/apache/datafusion/blob/branch-56/dev/changelog/56.0.0.md#credits + + + +## New Features โœจ + +### `ASOF` Joins + +DataFusion 56 adds `ASOF JOIN`, closing [#318], one of the oldest open feature +requests in the project. An `ASOF` join matches each row on the left with the +*closest* row on the right rather than requiring an exact match. Such joins are +ubiquitous in time-series workloads: finding the most recent quote for each +trade, or aligning two sensors that sample at different rates. + +DataFusion follows the [Snowflake `ASOF JOIN` syntax]. For example, to find the +most recent price at or before each trade: + +```sql +SELECT t.symbol, t.ts, t.quantity, p.price +FROM trades AS t +ASOF JOIN prices AS p +MATCH_CONDITION (t.ts >= p.ts) +ON t.symbol = p.symbol; +``` + + + +The `MATCH_CONDITION` selects which row is "closest" and supports `>=`, `>`, +`<=`, and `<`, so you can look backwards or forwards in time. The optional `ON` +(or `USING`) clause restricts matches to rows with equal keys, such as the same +`symbol`. Every left row is preserved, and the right columns are `NULL` when no +match is found. `ASOF` joins are also available in the DataFrame API ([#23831]). + +This first version requires the right input to fit in memory; see the +[`ASOF JOIN` documentation] for the full semantics and current limitations. +Thanks to [@Xuanwo] for driving this long-awaited feature from design through +implementation, and to [@jayzhan211] and [@Kristofferjoha] for follow-on +improvements. + +[Snowflake `ASOF JOIN` syntax]: https://docs.snowflake.com/en/sql-reference/constructs/asof-join +[`ASOF JOIN` documentation]: https://datafusion.apache.org/user-guide/sql/select.html#asof-join + +### Extension Types: `UUID`, `JSON`, and More + +[Arrow extension types] let systems attach a logical type, such as UUID, JSON, +Variant, or a geometry, to a column stored using one of the standard Arrow +physical types. Building on the foundations described in +[Implementing User Defined Types and Custom Metadata in DataFusion], DataFusion +56 makes extension types work far better end to end: + +- **`UUID` and `JSON` SQL types**: the SQL types `UUID` and `JSON` now map to + the Arrow [canonical extension types] `arrow.uuid` and `arrow.json` + ([#21714]). +- **Readable type names**: `DESCRIBE`, `SHOW COLUMNS`, and + `information_schema.columns` show the extension type name rather than the + storage type ([#26893]). +- **Parquet files keep their types**: columns with extension types in Parquet + files are now read as that extension type with the default settings + ([#26854]). +- **Types survive queries**: extension types are now preserved through casts + ([#23169]), `min` / `max` ([#26939]), `coalesce` ([#24865]), scalar + subqueries ([#24939]), and `INSERT` ([#24971]). + +For example, a `UUID` column now looks like a `UUID`, rather than a 16 byte +binary column: + +```sql +> CREATE TABLE users (id UUID, name VARCHAR); +> DESCRIBE users; ++-------------+-----------+-------------+ +| column_name | data_type | is_nullable | ++-------------+-----------+-------------+ +| id | UUID | YES | +| name | Utf8View | YES | ++-------------+-----------+-------------+ +``` + + + +Thanks to [@cblp], [@cyberbeam524], [@paleolimbot], [@james-willis], +[@M-Tesla], and [@osipovartem] for this work. + +The more important consequence is that the DataFusion ecosystem can now add +entirely new data types *without* changes to the DataFusion core, as the next +two sections show. + +[Arrow extension types]: https://arrow.apache.org/docs/format/Columnar.html#extension-types +[canonical extension types]: https://arrow.apache.org/docs/format/CanonicalExtensions.html +[Implementing User Defined Types and Custom Metadata in DataFusion]: https://datafusion.apache.org/blog/2025/09/21/custom-types-using-metadata + +### Semi-Structured Data with `datafusion-variant` + + + +[Variant] is a type for storing semi-structured data, similar to JSON, where each +value can hold objects, arrays, and primitive values, with different fields and +types in each row. Variant values use an efficient binary encoding and are part +of the Parquet, Iceberg, Delta Lake, and Spark ecosystems (see +[Variant Type in Apache Parquet for Semi-Structured Data] for background). + +The [datafusion-variant] crate adds a `VARIANT` SQL type and Spark-compatible +functions to DataFusion 56. Register it on a `SessionContext`: + +```rust +let mut ctx = SessionContext::new(); +datafusion_variant::register_all(&mut ctx)?; +``` + +and you can then load, query, and store semi-structured data using SQL: + +```sql +CREATE TABLE events AS +SELECT parse_json(json_data) AS event +FROM (VALUES + ('{"service":"api","status":200,"latency_ms":12,"tags":["cached"]}'), + ('{"service":"api","status":500,"latency_ms":85,"error":null}'), + ('{"service":"api","status":504,"error":"Somethings not working"}') +) AS input(json_data); + +-- Extract fields with the Spark-style `:` operator +SELECT event:service::VARCHAR, + event:latency_ms::BIGINT +FROM events +WHERE event:status::BIGINT >= 400; +``` + +```text ++----------------------+-------------------------+ +| events.event:service | events.event:latency_ms | ++----------------------+-------------------------+ +| api | 85 | +| api | NULL | ++----------------------+-------------------------+ +``` + +Variant columns can be written to and read from Parquet files with the normal +`COPY` and `SELECT` statements, including *shredding* commonly used fields into +typed Parquet columns for faster queries: + +```sql +COPY events TO 'shredded_events.parquet' STORED AS PARQUET +OPTIONS ('variant.shredding' '{"event": "STRUCT"}'); +``` + +The crate is under active development and aims to match Apache Spark's Variant +behavior; see the [datafusion-variant roadmap] and the DataFusion +[Variant epic][#26517] for what is planned next. + + + +[Variant]: https://parquet.apache.org/docs/file-format/types/variantencoding/ +[Variant Type in Apache Parquet for Semi-Structured Data]: https://parquet.apache.org/blog/2026/02/27/variant-type-in-apache-parquet-for-semi-structured-data/ +[datafusion-variant]: https://github.com/datafusion-contrib/datafusion-variant +[datafusion-variant roadmap]: https://github.com/datafusion-contrib/datafusion-variant/issues/69 + +### Geospatial Data with `geodatafusion` + + + +[geodatafusion] provides spatial extensions for DataFusion, built on the +[GeoArrow] extension types and modeled after the [PostGIS] SQL API. It includes +more than a hundred `ST_*` functions, readers and writers for formats such as +[GeoParquet], [FlatGeobuf], and GeoJSON, and Python bindings. + +As with Variant, a single call registers the spatial functions: + +```rust +let ctx = SessionContext::new(); +geodatafusion::register(&ctx); +``` + +and geometries can then be queried using familiar PostGIS-style SQL: + +```sql +SELECT ST_Distance(ST_Point(0, 0), ST_Point(3, 4)) AS dist; + +SELECT ST_Area(ST_GeomFromText('POLYGON((0 0, 4 0, 4 4, 0 4, 0 0))')); +``` + + + +Together, `datafusion-variant` and `geodatafusion` illustrate what the extension +type work makes possible: sophisticated new data types, with their own SQL +syntax, functions, and file format integrations, built and released +independently by the community. If you need a type that DataFusion does not +have, you can now build it. + +[geodatafusion]: https://github.com/datafusion-contrib/geodatafusion +[GeoArrow]: https://geoarrow.org/ +[PostGIS]: https://postgis.net/docs/reference.html +[GeoParquet]: https://geoparquet.org/ +[FlatGeobuf]: https://flatgeobuf.org/ + +### External Catalogs in SQL + +Connecting DataFusion to an external catalog, such as an Iceberg REST catalog, +previously required writing Rust code. DataFusion 56 adds +`CREATE EXTERNAL CATALOG` and `DROP CATALOG` statements ([#25112]), so catalogs +can be attached with SQL in the same way as external tables: + +```sql +CREATE EXTERNAL CATALOG my_catalog +STORED AS ICEBERG +LOCATION 's3://bucket/warehouse' +OPTIONS ('catalog.uri' 'http://rest-catalog:8181', 'warehouse' 'my_catalog'); + +SELECT * FROM my_catalog.sales.orders LIMIT 10; +``` + +DataFusion does not include catalog implementations itself. Instead, libraries +such as table format integrations register a [`CatalogProviderFactory`] for +each `STORED AS` type, and users can then attach catalogs without any +additional code; see the [`CREATE EXTERNAL CATALOG` documentation] for details. + +To make working with multiple catalogs more practical, `information_schema` +queries are now scoped to a single catalog, as the SQL standard specifies +([#25887]): `my_catalog.information_schema.tables` lists only the tables in +`my_catalog`, and an unqualified `information_schema` refers to the default +catalog. + +Thanks to [@pepijnve] and [@TTyChud] for this work. + +[`CatalogProviderFactory`]: https://docs.rs/datafusion/56.0.0/datafusion/catalog/trait.CatalogProviderFactory.html +[`CREATE EXTERNAL CATALOG` documentation]: https://datafusion.apache.org/user-guide/sql/ddl.html#create-external-catalog + +### File Format Improvements + +**Writing Avro**: DataFusion has been able to read [Apache Avro] files for a +long time, and DataFusion 56 can now write them too ([#24925]): + +```sql +COPY (SELECT * FROM orders) TO 'orders.avro' STORED AS AVRO; +``` + +**ALP Encoding for Parquet**: [ALP] (Adaptive Lossless floating-Point) is a new +Parquet encoding that often stores `FLOAT` and `DOUBLE` columns much more +compactly. DataFusion 56 reads ALP-encoded files and can write them +([#27036]): + +```sql +SET datafusion.execution.parquet.encoding = 'alp'; +COPY measurements TO 'measurements.parquet' STORED AS PARQUET; +``` + + + +**Hive Null Partitions**: Hive-compatible writers such as Spark store rows with +a null partition value in a directory named `__HIVE_DEFAULT_PARTITION__`. +DataFusion previously failed to read such tables, or returned the directory +name as a string. DataFusion 56 reads these values as `NULL`, as Hive, Spark +and Impala do ([#26310]). + +**Other Improvements**: New options control the target size of output files in +bytes (`datafusion.execution.soft_max_bytes_per_output_file`, [#24924]) and +write distinct value counts to Parquet statistics ([#25576]), and Arrow IPC +files gain format options ([#26155]). + +Thanks to [@pepijnve], [@Surajsuthar], [@xanderbailey], [@Tpt], and +[@Rich-T-kid] for this work. + +[Apache Avro]: https://avro.apache.org/ +[ALP]: https://github.com/apache/parquet-format/blob/master/Encodings.md + +### More SQL + +**`MATERIALIZED` CTEs**: By default, DataFusion inlines Common Table +Expressions (CTEs), so a CTE that is referenced several times is evaluated +several times. DataFusion 56 supports the Postgres +`WITH ... AS [NOT] MATERIALIZED` syntax to evaluate a CTE once and reuse the +result ([#25580]): + +```sql +WITH r AS MATERIALIZED (SELECT random() AS v) +SELECT a.v = b.v FROM r a, r b; +-- true: the CTE runs once and both references see the same value +``` + +**Other SQL Improvements**: DataFusion 56 also supports the `MAP` type in SQL +statements such as `CREATE TABLE` ([#24397]), multi-column `NOT IN` subqueries +with correct `NULL` semantics ([#19857]), column references as the percentile +argument of percentile functions ([#25337]), decimal inputs to +`percentile_cont` and `median` ([#24419]), `timezone`, `timezone_hour`, and +`timezone_minute` in `date_part` ([#25163]), and shows `MERGE INTO` details in +`EXPLAIN` ([#26038]). + +Thanks to [@adriangb], [@nuno-faria], [@viirya], [@dd-annarose], [@theirix], +and [@wirybeaver] for this work. + +### `datafusion-cli` Improvements + +`datafusion-cli` adds `parquet_file_metadata` and `parquet_page_index` table +functions for inspecting Parquet files ([#25640]), and can optionally register +the Spark-compatible functions from the [datafusion-spark crate] ([#24179]). +Thanks to [@jay-dee7] and [@goutamadwant]. + + + +### Versioned Documentation + +The [DataFusion documentation] previously described only the unreleased `main` +branch, which made it hard to tell which features were available in the version +you were actually using. The site now has a version picker and publishes a +snapshot of the documentation for each release ([#17071], [#24792]). Thanks to +[@yiaany] for this work and [@Omega359] for the original request. + +[DataFusion documentation]: https://datafusion.apache.org/ + +## Performance Improvements ๐Ÿš€ + +DataFusion 56 continues to get faster across the board. Here is a +representative sample of the improvements in this release. + + + +| Improvement | Representative Result | Area | +|-----------------------------------------------------|--------------------------------------------------------------------|-------------| +| `IN` / `NOT IN` subqueries in the `SELECT` list | [533 ms โ†’ 2 ms][#25338] | Subqueries | +| Ordered `ARRAY_AGG` and `STRING_AGG` | [10.5x faster, 59% less memory][#24392] | Aggregation | +| `GROUP BY` on fully sorted keys | [2.8x - 5x faster][#25150] *(micro)* | Aggregation | +| `array_agg(DISTINCT ...)` with many groups | [up to 36x faster][#26357] *(micro)* | Aggregation | +| Dynamic filters across join keys | [up to 2.3x faster on Join Order Benchmark queries][#25255] | Joins | +| Sort-merge joins with many matches per key | [~35% faster][#26277] *(micro)* | Joins | +| Nested loop join memory | [2x lower peak memory][#25371] | Joins | +| `LAST_VALUE ... IGNORE NULLS` | [13.15 ms โ†’ 111 ยตs][#26533] *(micro)* | Window | +| Planning `SELECT`s with many aggregates | [5.9x faster for 1000 aggregates][#25739] | Planning | +| Compiling the `datafusion` crate | [~10x faster][#24329] | Build | + +### Faster TopK and `LIMIT` Queries + +Queries that return only a few rows keep getting faster. DataFusion 56 can +evaluate `ORDER BY ... LIMIT` *before* an outer join when the sort columns come +from the preserved side, so far fewer rows are joined ([#21621]). For example, +this query now joins only three orders rather than every order: + +```sql +SELECT o.id, o.total, c.name +FROM orders AS o LEFT JOIN customers AS c ON o.customer_id = c.id +ORDER BY o.total DESC +LIMIT 3; +``` + +Parquet scans can also now stop after reading only the *pages* that are +guaranteed to satisfy a `LIMIT` query's filter ([#25000]), and custom table +providers can implement `OFFSET` pushdown, which is useful for paging through +results ([#25404]). Thanks to [@SubhamSinghal], [@peterxcli], and [@martin-g]. + +### Faster Joins + +Dynamic filters created by a join are now applied to *other* tables that are +joined on the same key, and pushed through nested loop joins, skipping more +data at the scan ([#25255], [#25030]). Other join improvements include faster +sort-merge joins ([#26277]), a nested loop join that needs half the memory +([#25371]), faster range joins ([#24579]), and rewriting joins against a single +constant row into filters ([#26404]). Thanks to [@jayzhan211], [@yashrb24], +[@andygrove], [@2010YOUY01], and [@xudong963]. + +### Faster Aggregations and Subqueries + +Aggregations over already sorted inputs now avoid hashing entirely +([#25150], [#26370]), and ordered `ARRAY_AGG` and `STRING_AGG` are over 10x +faster while using less than half the memory ([#24392]). `IN` and `NOT IN` +subqueries used as expressions (for example in the `SELECT` list) are now +planned as a single join, which makes some queries hundreds of times faster +([#25338]). Thanks to [@QinXi-ai], [@geoffreyclaude], [@lyne7-sc], +[@zhuqi-lucas], and [@adriangb]. + +### Faster Functions and Expressions + +As in previous releases, many functions are faster, including `upper`, `lower`, +`translate`, `replace`, `left`, `right`, `levenshtein`, and many array +functions, and `IN` list evaluation improved further with specializations for +more types (epic [#19241]). Thanks to [@neilconway], [@geoffreyclaude], +[@andygrove], [@Rich-T-kid], and [@comphead]. + +### Faster Builds + +It is not only queries that are faster: a series of changes reduced the time to +compile the core `datafusion` crate by ~10x, with similar improvements for +several other crates ([#24329], [#24325], [#24330], [#24326]). Thanks to +[@Dandandan]. + +## Stability Improvements ๐Ÿ›ก๏ธ + +**Correctness**: As a foundational piece of technology, it is important that +DataFusion's results can be relied on. During this release cycle the community +systematically collected and fixed bugs that produced incorrect results (see +epic [#26672]), and agreed to slow down new features in order to stabilize the +release ([#26865]). DataFusion 56 also verifies the final physical plan and +reports which optimizer rule produced an invalid plan ([#26461]). + + + +**Larger-Than-Memory Queries**: Queries that spill to disk when memory runs out +are more robust. Aggregations with very large groups (such as `array_agg` over +a few keys) no longer fail after spilling ([#25853]), spill files for string +and dictionary data are smaller ([#23565], [#27015]), and memory accounting is +more accurate in several operators ([#24744], [#25188], [#26074]). Thanks to +[@andygrove], [@cetra3], [@brancz], and [@kosiew]. + +## Upgrade Guide and Changelog ๐Ÿ“– + +DataFusion 56 upgrades to Arrow and Parquet 60 and `object_store` 0.14, and the +minimum supported Rust version is now 1.95.0. Upgrading should be +straightforward for most users, though there are some breaking changes and a +few changes in query behavior, such as how the session time zone applies to +timestamp operations and how `information_schema` queries are scoped. See the +[Upgrade Guide] for details and migration snippets, and the [changelog] for the +full list of changes. + +## About DataFusion + +[Apache DataFusion] is an extensible query engine, written in [Rust], that uses +[Apache Arrow] as its in-memory format. DataFusion is used by developers to +create new, fast, data-centric systems such as databases, dataframe libraries, +and machine learning and streaming applications. While [DataFusion's primary +design goal] is to accelerate the creation of other data-centric systems, it +provides a reasonable experience directly out of the box as a [dataframe +library], [Python library], and [command-line SQL tool]. + +DataFusion's core thesis is that, as a community, together we can build much +more advanced technology than any of us as individuals or companies could build +alone. Without DataFusion, highly performant vectorized query engines would +remain the domain of a few large companies and world-class research +institutions. With DataFusion, we can all build on top of a shared foundation +and focus on what makes our projects unique. + +## How to Get Involved + +DataFusion is not a project built or driven by a single person, company, or +foundation. Rather, our community of users and contributors works together to +build a shared technology that none of us could have built alone. + +If you are interested in joining us, we would love to have you. You can try out +DataFusion on some of your own data and projects and let us know how it goes, +contribute suggestions, documentation, bug reports, or a PR with documentation, +tests, or code. A list of open issues suitable for beginners is [here], and you +can find out how to reach us on the [communication doc]. + +[Apache DataFusion]: https://datafusion.apache.org/ +[Rust]: https://www.rust-lang.org/ +[Apache Arrow]: https://arrow.apache.org +[DataFusion's primary design goal]: https://datafusion.apache.org/user-guide/introduction.html#project-goals +[dataframe library]: https://datafusion.apache.org/user-guide/dataframe.html +[Python library]: https://datafusion.apache.org/python/ +[command-line SQL tool]: https://datafusion.apache.org/user-guide/cli/ +[Upgrade Guide]: https://datafusion.apache.org/library-user-guide/upgrading/56.0.0.html +[here]: https://github.com/apache/datafusion/issues?q=is%3Aissue+is%3Aopen+label%3A%22good+first+issue%22 +[communication doc]: https://datafusion.apache.org/contributor-guide/communication.html +[datafusion-spark crate]: https://docs.rs/datafusion-spark/latest/datafusion_spark/index.html + +[@2010YOUY01]: https://github.com/2010YOUY01 +[@adriangb]: https://github.com/adriangb +[@andygrove]: https://github.com/andygrove +[@brancz]: https://github.com/brancz +[@cblp]: https://github.com/cblp +[@cetra3]: https://github.com/cetra3 +[@comphead]: https://github.com/comphead +[@cyberbeam524]: https://github.com/cyberbeam524 +[@Dandandan]: https://github.com/Dandandan +[@dd-annarose]: https://github.com/dd-annarose +[@geoffreyclaude]: https://github.com/geoffreyclaude +[@goutamadwant]: https://github.com/goutamadwant +[@james-willis]: https://github.com/james-willis +[@jay-dee7]: https://github.com/jay-dee7 +[@jayzhan211]: https://github.com/jayzhan211 +[@kosiew]: https://github.com/kosiew +[@Kristofferjoha]: https://github.com/Kristofferjoha +[@lyne7-sc]: https://github.com/lyne7-sc +[@M-Tesla]: https://github.com/M-Tesla +[@martin-g]: https://github.com/martin-g +[@neilconway]: https://github.com/neilconway +[@nuno-faria]: https://github.com/nuno-faria +[@Omega359]: https://github.com/Omega359 +[@osipovartem]: https://github.com/osipovartem +[@paleolimbot]: https://github.com/paleolimbot +[@pepijnve]: https://github.com/pepijnve +[@peterxcli]: https://github.com/peterxcli +[@QinXi-ai]: https://github.com/QinXi-ai +[@Rich-T-kid]: https://github.com/Rich-T-kid +[@SubhamSinghal]: https://github.com/SubhamSinghal +[@Surajsuthar]: https://github.com/Surajsuthar +[@theirix]: https://github.com/theirix +[@Tpt]: https://github.com/Tpt +[@TTyChud]: https://github.com/TTyChud +[@viirya]: https://github.com/viirya +[@wirybeaver]: https://github.com/wirybeaver +[@xanderbailey]: https://github.com/xanderbailey +[@Xuanwo]: https://github.com/Xuanwo +[@xudong963]: https://github.com/xudong963 +[@yashrb24]: https://github.com/yashrb24 +[@yiaany]: https://github.com/yiaany +[@zhuqi-lucas]: https://github.com/zhuqi-lucas + +[#318]: https://github.com/apache/datafusion/issues/318 +[#17071]: https://github.com/apache/datafusion/issues/17071 +[#19241]: https://github.com/apache/datafusion/issues/19241 +[#19857]: https://github.com/apache/datafusion/pull/19857 +[#21621]: https://github.com/apache/datafusion/pull/21621 +[#21714]: https://github.com/apache/datafusion/pull/21714 +[#23169]: https://github.com/apache/datafusion/pull/23169 +[#23565]: https://github.com/apache/datafusion/pull/23565 +[#23831]: https://github.com/apache/datafusion/pull/23831 +[#24179]: https://github.com/apache/datafusion/pull/24179 +[#24325]: https://github.com/apache/datafusion/pull/24325 +[#24326]: https://github.com/apache/datafusion/pull/24326 +[#24329]: https://github.com/apache/datafusion/pull/24329 +[#24330]: https://github.com/apache/datafusion/pull/24330 +[#24392]: https://github.com/apache/datafusion/pull/24392 +[#24397]: https://github.com/apache/datafusion/pull/24397 +[#24419]: https://github.com/apache/datafusion/pull/24419 +[#24579]: https://github.com/apache/datafusion/pull/24579 +[#24744]: https://github.com/apache/datafusion/pull/24744 +[#24792]: https://github.com/apache/datafusion/pull/24792 +[#24865]: https://github.com/apache/datafusion/pull/24865 +[#24924]: https://github.com/apache/datafusion/pull/24924 +[#24925]: https://github.com/apache/datafusion/pull/24925 +[#24939]: https://github.com/apache/datafusion/pull/24939 +[#24971]: https://github.com/apache/datafusion/pull/24971 +[#25000]: https://github.com/apache/datafusion/pull/25000 +[#25030]: https://github.com/apache/datafusion/pull/25030 +[#25112]: https://github.com/apache/datafusion/pull/25112 +[#25150]: https://github.com/apache/datafusion/pull/25150 +[#25163]: https://github.com/apache/datafusion/pull/25163 +[#25188]: https://github.com/apache/datafusion/pull/25188 +[#25255]: https://github.com/apache/datafusion/pull/25255 +[#25337]: https://github.com/apache/datafusion/pull/25337 +[#25338]: https://github.com/apache/datafusion/pull/25338 +[#25371]: https://github.com/apache/datafusion/pull/25371 +[#25404]: https://github.com/apache/datafusion/pull/25404 +[#25576]: https://github.com/apache/datafusion/pull/25576 +[#25580]: https://github.com/apache/datafusion/pull/25580 +[#25640]: https://github.com/apache/datafusion/pull/25640 +[#25739]: https://github.com/apache/datafusion/pull/25739 +[#25853]: https://github.com/apache/datafusion/pull/25853 +[#25887]: https://github.com/apache/datafusion/pull/25887 +[#26038]: https://github.com/apache/datafusion/pull/26038 +[#26074]: https://github.com/apache/datafusion/pull/26074 +[#26155]: https://github.com/apache/datafusion/pull/26155 +[#26277]: https://github.com/apache/datafusion/pull/26277 +[#26310]: https://github.com/apache/datafusion/pull/26310 +[#26357]: https://github.com/apache/datafusion/pull/26357 +[#26370]: https://github.com/apache/datafusion/pull/26370 +[#26404]: https://github.com/apache/datafusion/pull/26404 +[#26461]: https://github.com/apache/datafusion/pull/26461 +[#26517]: https://github.com/apache/datafusion/issues/26517 +[#26533]: https://github.com/apache/datafusion/pull/26533 +[#26672]: https://github.com/apache/datafusion/issues/26672 +[#26854]: https://github.com/apache/datafusion/pull/26854 +[#26865]: https://github.com/apache/datafusion/issues/26865 +[#26893]: https://github.com/apache/datafusion/pull/26893 +[#26939]: https://github.com/apache/datafusion/pull/26939 +[#27015]: https://github.com/apache/datafusion/pull/27015 +[#27036]: https://github.com/apache/datafusion/pull/27036 From bc0ef6e826a56cfb64272b020fd872bd614b8d76 Mon Sep 17 00:00:00 2001 From: Andrew Lamb Date: Fri, 20 Nov 2026 14:32:21 -0500 Subject: [PATCH 02/11] Update post date to 2026-11-20 Co-Authored-By: Claude Fable 5.2 --- ...0-datafusion-56.0.0.md => 2026-11-20-datafusion-56.0.0.md} | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) rename content/blog/{2026-11-10-datafusion-56.0.0.md => 2026-11-20-datafusion-56.0.0.md} (99%) diff --git a/content/blog/2026-11-10-datafusion-56.0.0.md b/content/blog/2026-11-20-datafusion-56.0.0.md similarity index 99% rename from content/blog/2026-11-10-datafusion-56.0.0.md rename to content/blog/2026-11-20-datafusion-56.0.0.md index fb84adbd..b1ff058b 100644 --- a/content/blog/2026-11-10-datafusion-56.0.0.md +++ b/content/blog/2026-11-20-datafusion-56.0.0.md @@ -1,7 +1,7 @@ --- layout: post title: Apache DataFusion 56.0.0 Released -date: 2026-11-10 +date: 2026-11-20 author: pmc categories: [release] --- @@ -34,7 +34,7 @@ highlights some of the many improvements since [DataFusion 55.0.0], such as `ASOF` joins, SQL registration of external catalogs, Avro and ALP write support, better support for extension types such as `UUID`, Variant, and geospatial types, and many performance and stability improvements. The complete list of -changes is available in the [changelog]. This release represents roughly 11 +changes is available in the [changelog]. This release represents roughly 12 weeks of development and 1200 commits. Thanks to the [247 contributors] (another new record!) for making it possible. From bf5a5da996d32ad4e97482ff65301290b91137b9 Mon Sep 17 00:00:00 2001 From: Andrew Lamb Date: Fri, 20 Nov 2026 15:20:12 -0500 Subject: [PATCH 03/11] update --- content/blog/2026-11-20-datafusion-56.0.0.md | 205 ++++++++++--------- 1 file changed, 105 insertions(+), 100 deletions(-) diff --git a/content/blog/2026-11-20-datafusion-56.0.0.md b/content/blog/2026-11-20-datafusion-56.0.0.md index b1ff058b..ddc37e5a 100644 --- a/content/blog/2026-11-20-datafusion-56.0.0.md +++ b/content/blog/2026-11-20-datafusion-56.0.0.md @@ -29,122 +29,134 @@ limitations under the License. -We are proud to announce the release of [DataFusion 56.0.0]. This post -highlights some of the many improvements since [DataFusion 55.0.0], such as +We are proud to announce the release of [DataFusion 56.0.0], which includes many new features, including `ASOF` joins, SQL registration of external catalogs, Avro and ALP write support, -better support for extension types such as `UUID`, Variant, and geospatial -types, and many performance and stability improvements. The complete list of +better support for extension types, and many performance and stability improvements. The complete list of changes is available in the [changelog]. This release represents roughly 12 -weeks of development and 1200 commits. Thanks to the [247 contributors] (another -new record!) for making it possible. +weeks of development and 1200 commits. Thanks to the [247 contributors]. [DataFusion 56.0.0]: https://crates.io/crates/datafusion/56.0.0 [DataFusion 55.0.0]: https://datafusion.apache.org/blog/2026/08/25/datafusion-55.0.0/ [changelog]: https://github.com/apache/datafusion/blob/branch-56/dev/changelog/56.0.0.md [247 contributors]: https://github.com/apache/datafusion/blob/branch-56/dev/changelog/56.0.0.md#credits - - ## New Features โœจ ### `ASOF` Joins -DataFusion 56 adds `ASOF JOIN`, closing [#318], one of the oldest open feature -requests in the project. An `ASOF` join matches each row on the left with the +DataFusion 56 adds `ASOF JOIN`, a long-standing feature request ([#318]). +An `ASOF` join matches each row on the left with the *closest* row on the right rather than requiring an exact match. Such joins are -ubiquitous in time-series workloads: finding the most recent quote for each +common in time-series workloads such as finding the most recent quote for each trade, or aligning two sensors that sample at different rates. -DataFusion follows the [Snowflake `ASOF JOIN` syntax]. For example, to find the -most recent price at or before each trade: +For example, given tables of `trades` and `prices` + +| id | symbol | ts | quantity | +|----|--------|---------------------|----------| +| T1 | AAPL | 2026-11-20T09:30:05 | 100 | +| T2 | AAPL | 2026-11-20T09:30:12 | 250 | +| T3 | MSFT | 2026-11-20T09:30:07 | 75 | +| T4 | MSFT | 2026-11-20T09:30:20 | 300 | +| T5 | NVDA | 2026-11-20T09:30:10 | 50 | + +| id | symbol | ts | price | +|----|--------|---------------------|--------| +| P1 | AAPL | 2026-11-20T09:30:00 | 228.10 | +| P2 | AAPL | 2026-11-20T09:30:10 | 228.35 | +| P3 | AAPL | 2026-11-20T09:30:15 | 228.20 | +| P4 | MSFT | 2026-11-20T09:30:00 | 415.50 | +| P5 | MSFT | 2026-11-20T09:30:15 | 415.75 | + +Since no trade has the exact same timestamp as any price, a regular equality +join on `symbol` and `ts` would match nothing. Instead, an `ASOF` join +efficiently pairs each trade with the most recent price at or before it: ```sql -SELECT t.symbol, t.ts, t.quantity, p.price -FROM trades AS t -ASOF JOIN prices AS p +SELECT t.id AS trade_id, p.id AS price_id, t.symbol, t.ts, t.quantity, p.price +FROM trades AS t ASOF JOIN prices AS p MATCH_CONDITION (t.ts >= p.ts) -ON t.symbol = p.symbol; +ON t.symbol = p.symbol +ORDER BY t.id; ``` - +```text ++----------+----------+--------+---------------------+----------+--------+ +| trade_id | price_id | symbol | ts | quantity | price | ++----------+----------+--------+---------------------+----------+--------+ +| T1 | P1 | AAPL | 2026-11-20T09:30:05 | 100 | 228.10 | +| T2 | P2 | AAPL | 2026-11-20T09:30:12 | 250 | 228.35 | +| T3 | P4 | MSFT | 2026-11-20T09:30:07 | 75 | 415.50 | +| T4 | P5 | MSFT | 2026-11-20T09:30:20 | 300 | 415.75 | +| T5 | NULL | NVDA | 2026-11-20T09:30:10 | 50 | NULL | ++----------+----------+--------+---------------------+----------+--------+ +``` -The `MATCH_CONDITION` selects which row is "closest" and supports `>=`, `>`, -`<=`, and `<`, so you can look backwards or forwards in time. The optional `ON` -(or `USING`) clause restricts matches to rows with equal keys, such as the same -`symbol`. Every left row is preserved, and the right columns are `NULL` when no -match is found. `ASOF` joins are also available in the DataFrame API ([#23831]). +
+Full Example -This first version requires the right input to fit in memory; see the -[`ASOF JOIN` documentation] for the full semantics and current limitations. -Thanks to [@Xuanwo] for driving this long-awaited feature from design through -implementation, and to [@jayzhan211] and [@Kristofferjoha] for follow-on -improvements. +```sql +CREATE TABLE trades (id VARCHAR, symbol VARCHAR, ts TIMESTAMP, quantity INT) AS VALUES + ('T1', 'AAPL', '2026-11-20T09:30:05', 100), + ('T2', 'AAPL', '2026-11-20T09:30:12', 250), + ('T3', 'MSFT', '2026-11-20T09:30:07', 75), + ('T4', 'MSFT', '2026-11-20T09:30:20', 300), + ('T5', 'NVDA', '2026-11-20T09:30:10', 50); + +CREATE TABLE prices (id VARCHAR, symbol VARCHAR, ts TIMESTAMP, price DECIMAL(10, 2)) AS VALUES + ('P1', 'AAPL', '2026-11-20T09:30:00', 228.10), + ('P2', 'AAPL', '2026-11-20T09:30:10', 228.35), + ('P3', 'AAPL', '2026-11-20T09:30:15', 228.20), + ('P4', 'MSFT', '2026-11-20T09:30:00', 415.50), + ('P5', 'MSFT', '2026-11-20T09:30:15', 415.75); + +SELECT t.id AS trade_id, p.id AS price_id, t.symbol, t.ts, t.quantity, p.price +FROM trades AS t ASOF JOIN prices AS p +MATCH_CONDITION (t.ts >= p.ts) +ON t.symbol = p.symbol +ORDER BY t.id; +``` -[Snowflake `ASOF JOIN` syntax]: https://docs.snowflake.com/en/sql-reference/constructs/asof-join -[`ASOF JOIN` documentation]: https://datafusion.apache.org/user-guide/sql/select.html#asof-join +
-### Extension Types: `UUID`, `JSON`, and More +DataFusion implements the [Snowflake `ASOF JOIN` syntax][Snowflake ASOF JOIN syntax]. +See the [`ASOF JOIN` documentation][ASOF JOIN documentation] for more details. +Thanks to [@Xuanwo] for +contributing this feature and +to [@jayzhan211], [@Kristofferjoha] and [@2010YOUY01], [@xudong963], [@alamb], +and [@jonathanc-n] for reviews and improvements.. -[Arrow extension types] let systems attach a logical type, such as UUID, JSON, -Variant, or a geometry, to a column stored using one of the standard Arrow -physical types. Building on the foundations described in -[Implementing User Defined Types and Custom Metadata in DataFusion], DataFusion -56 makes extension types work far better end to end: +[Snowflake ASOF JOIN syntax]: https://docs.snowflake.com/en/sql-reference/constructs/asof-join +[ASOF JOIN documentation]: https://datafusion.apache.org/user-guide/sql/select.html#asof-join -- **`UUID` and `JSON` SQL types**: the SQL types `UUID` and `JSON` now map to - the Arrow [canonical extension types] `arrow.uuid` and `arrow.json` - ([#21714]). -- **Readable type names**: `DESCRIBE`, `SHOW COLUMNS`, and - `information_schema.columns` show the extension type name rather than the - storage type ([#26893]). -- **Parquet files keep their types**: columns with extension types in Parquet - files are now read as that extension type with the default settings - ([#26854]). -- **Types survive queries**: extension types are now preserved through casts - ([#23169]), `min` / `max` ([#26939]), `coalesce` ([#24865]), scalar - subqueries ([#24939]), and `INSERT` ([#24971]). +### Improved support for Extension Types -For example, a `UUID` column now looks like a `UUID`, rather than a 16 byte -binary column: +As described in [the User Defined Types blog], DataFusion allows users to extend +the types using [Arrow extension types] to attach a logical type to a standard +arrow physical type. Extension types permit the DataFusion ecosystem to add +entirely new data types *without* changes to the DataFusion core (see the next +two sections) -```sql -> CREATE TABLE users (id UUID, name VARCHAR); -> DESCRIBE users; -+-------------+-----------+-------------+ -| column_name | data_type | is_nullable | -+-------------+-----------+-------------+ -| id | UUID | YES | -| name | Utf8View | YES | -+-------------+-----------+-------------+ -``` +DataFusion 56 improves this support in several ways: - +- The SQL types `UUID` and `JSON` now map to + the Arrow [canonical extension types] `arrow.uuid` and `arrow.json`. +- `DESCRIBE`, `SHOW COLUMNS`, and + `information_schema.columns` show the extension type name rather than the + storage type. +- Extension types are preserved when reading Parquet + files with the default settings. +- Extension types are preserved through more operators such as + casts, `min` / `max`, `coalesce`, scalar subqueries, and `INSERT`. Thanks to [@cblp], [@cyberbeam524], [@paleolimbot], [@james-willis], [@M-Tesla], and [@osipovartem] for this work. -The more important consequence is that the DataFusion ecosystem can now add -entirely new data types *without* changes to the DataFusion core, as the next -two sections show. [Arrow extension types]: https://arrow.apache.org/docs/format/Columnar.html#extension-types [canonical extension types]: https://arrow.apache.org/docs/format/CanonicalExtensions.html [Implementing User Defined Types and Custom Metadata in DataFusion]: https://datafusion.apache.org/blog/2025/09/21/custom-types-using-metadata +[the User Defined Types blog]: https://datafusion.apache.org/blog/2025/09/21/custom-types-using-metadata ### Semi-Structured Data with `datafusion-variant` @@ -270,9 +282,9 @@ SELECT * FROM my_catalog.sales.orders LIMIT 10; ``` DataFusion does not include catalog implementations itself. Instead, libraries -such as table format integrations register a [`CatalogProviderFactory`] for +such as table format integrations register a [`CatalogProviderFactory`][CatalogProviderFactory] for each `STORED AS` type, and users can then attach catalogs without any -additional code; see the [`CREATE EXTERNAL CATALOG` documentation] for details. +additional code; see the [`CREATE EXTERNAL CATALOG` documentation][CREATE EXTERNAL CATALOG documentation] for details. To make working with multiple catalogs more practical, `information_schema` queries are now scoped to a single catalog, as the SQL standard specifies @@ -282,8 +294,8 @@ catalog. Thanks to [@pepijnve] and [@TTyChud] for this work. -[`CatalogProviderFactory`]: https://docs.rs/datafusion/56.0.0/datafusion/catalog/trait.CatalogProviderFactory.html -[`CREATE EXTERNAL CATALOG` documentation]: https://datafusion.apache.org/user-guide/sql/ddl.html#create-external-catalog +[CatalogProviderFactory]: https://docs.rs/datafusion/56.0.0/datafusion/catalog/trait.CatalogProviderFactory.html +[CREATE EXTERNAL CATALOG documentation]: https://datafusion.apache.org/user-guide/sql/ddl.html#create-external-catalog ### File Format Improvements @@ -463,11 +475,8 @@ more accurate in several operators ([#24744], [#25188], [#26074]). Thanks to DataFusion 56 upgrades to Arrow and Parquet 60 and `object_store` 0.14, and the minimum supported Rust version is now 1.95.0. Upgrading should be -straightforward for most users, though there are some breaking changes and a -few changes in query behavior, such as how the session time zone applies to -timestamp operations and how `information_schema` queries are scoped. See the -[Upgrade Guide] for details and migration snippets, and the [changelog] for the -full list of changes. +straightforward for most users. See the [Upgrade Guide] for details and +migration snippets, and the [changelog] for the full list of changes. ## About DataFusion @@ -493,10 +502,11 @@ foundation. Rather, our community of users and contributors works together to build a shared technology that none of us could have built alone. If you are interested in joining us, we would love to have you. You can try out -DataFusion on some of your own data and projects and let us know how it goes, -contribute suggestions, documentation, bug reports, or a PR with documentation, -tests, or code. A list of open issues suitable for beginners is [here], and you -can find out how to reach us on the [communication doc]. +DataFusion on some of your own projects and let us know how it goes, contribute +suggestions, documentation, bug reports, or a PR with documentation, tests, or +code. [Please don't dump unreviewed AI output on us] ๐Ÿ™. A list of open issues +suitable for beginners is [here], and you can find out how to reach us on the +[communication doc]. [Apache DataFusion]: https://datafusion.apache.org/ [Rust]: https://www.rust-lang.org/ @@ -508,6 +518,7 @@ can find out how to reach us on the [communication doc]. [Upgrade Guide]: https://datafusion.apache.org/library-user-guide/upgrading/56.0.0.html [here]: https://github.com/apache/datafusion/issues?q=is%3Aissue+is%3Aopen+label%3A%22good+first+issue%22 [communication doc]: https://datafusion.apache.org/contributor-guide/communication.html +[Please don't dump unreviewed AI output on us]: https://datafusion.apache.org/contributor-guide/ai-policy.html#what-is-an-ai-dump-and-why-it-is-not-helpful [datafusion-spark crate]: https://docs.rs/datafusion-spark/latest/datafusion_spark/index.html [@2010YOUY01]: https://github.com/2010YOUY01 @@ -558,8 +569,6 @@ can find out how to reach us on the [communication doc]. [#19241]: https://github.com/apache/datafusion/issues/19241 [#19857]: https://github.com/apache/datafusion/pull/19857 [#21621]: https://github.com/apache/datafusion/pull/21621 -[#21714]: https://github.com/apache/datafusion/pull/21714 -[#23169]: https://github.com/apache/datafusion/pull/23169 [#23565]: https://github.com/apache/datafusion/pull/23565 [#23831]: https://github.com/apache/datafusion/pull/23831 [#24179]: https://github.com/apache/datafusion/pull/24179 @@ -573,11 +582,8 @@ can find out how to reach us on the [communication doc]. [#24579]: https://github.com/apache/datafusion/pull/24579 [#24744]: https://github.com/apache/datafusion/pull/24744 [#24792]: https://github.com/apache/datafusion/pull/24792 -[#24865]: https://github.com/apache/datafusion/pull/24865 [#24924]: https://github.com/apache/datafusion/pull/24924 [#24925]: https://github.com/apache/datafusion/pull/24925 -[#24939]: https://github.com/apache/datafusion/pull/24939 -[#24971]: https://github.com/apache/datafusion/pull/24971 [#25000]: https://github.com/apache/datafusion/pull/25000 [#25030]: https://github.com/apache/datafusion/pull/25030 [#25112]: https://github.com/apache/datafusion/pull/25112 @@ -607,9 +613,8 @@ can find out how to reach us on the [communication doc]. [#26517]: https://github.com/apache/datafusion/issues/26517 [#26533]: https://github.com/apache/datafusion/pull/26533 [#26672]: https://github.com/apache/datafusion/issues/26672 -[#26854]: https://github.com/apache/datafusion/pull/26854 [#26865]: https://github.com/apache/datafusion/issues/26865 -[#26893]: https://github.com/apache/datafusion/pull/26893 -[#26939]: https://github.com/apache/datafusion/pull/26939 [#27015]: https://github.com/apache/datafusion/pull/27015 [#27036]: https://github.com/apache/datafusion/pull/27036 +[@alamb]: https://github.com/alamb +[@jonathanc-n]: https://github.com/jonathanc-n From 08c9d78bd199b885b373abf8487c12213cab4803 Mon Sep 17 00:00:00 2001 From: Andrew Lamb Date: Fri, 20 Nov 2026 15:28:15 -0500 Subject: [PATCH 04/11] update variant --- content/blog/2026-11-20-datafusion-56.0.0.md | 61 +++++++++++--------- 1 file changed, 34 insertions(+), 27 deletions(-) diff --git a/content/blog/2026-11-20-datafusion-56.0.0.md b/content/blog/2026-11-20-datafusion-56.0.0.md index ddc37e5a..cc6d9255 100644 --- a/content/blog/2026-11-20-datafusion-56.0.0.md +++ b/content/blog/2026-11-20-datafusion-56.0.0.md @@ -135,9 +135,7 @@ As described in [the User Defined Types blog], DataFusion allows users to extend the types using [Arrow extension types] to attach a logical type to a standard arrow physical type. Extension types permit the DataFusion ecosystem to add entirely new data types *without* changes to the DataFusion core (see the next -two sections) - -DataFusion 56 improves this support in several ways: +two sections). DataFusion 56 improves this support in several ways: - The SQL types `UUID` and `JSON` now map to the Arrow [canonical extension types] `arrow.uuid` and `arrow.json`. @@ -147,38 +145,49 @@ DataFusion 56 improves this support in several ways: - Extension types are preserved when reading Parquet files with the default settings. - Extension types are preserved through more operators such as - casts, `min` / `max`, `coalesce`, scalar subqueries, and `INSERT`. + casts, `min` / `max`, scalar subqueries, and `INSERT`. + +For example, a column declared with the SQL `JSON` type is stored as a standard +Arrow string and tagged with the `arrow.json` extension type: -Thanks to [@cblp], [@cyberbeam524], [@paleolimbot], [@james-willis], -[@M-Tesla], and [@osipovartem] for this work. +```sql +CREATE TABLE events (doc JSON); +INSERT INTO events VALUES ('{"a":1}'); +SELECT doc, + arrow_typeof(doc) AS doc_type, + arrow_metadata(doc)['ARROW:extension:name'] AS doc_extension +FROM events; ++---------+----------+---------------+ +| doc | doc_type | doc_extension | ++---------+----------+---------------+ +| {"a":1} | Utf8 | arrow.json | ++---------+----------+---------------+ +``` +Thanks to [@cblp], [@cyberbeam524], [@paleolimbot], [@M-Tesla], and +[@osipovartem] for this work. [Arrow extension types]: https://arrow.apache.org/docs/format/Columnar.html#extension-types [canonical extension types]: https://arrow.apache.org/docs/format/CanonicalExtensions.html -[Implementing User Defined Types and Custom Metadata in DataFusion]: https://datafusion.apache.org/blog/2025/09/21/custom-types-using-metadata [the User Defined Types blog]: https://datafusion.apache.org/blog/2025/09/21/custom-types-using-metadata ### Semi-Structured Data with `datafusion-variant` - - -[Variant] is a type for storing semi-structured data, similar to JSON, where each -value can hold objects, arrays, and primitive values, with different fields and -types in each row. Variant values use an efficient binary encoding and are part -of the Parquet, Iceberg, Delta Lake, and Spark ecosystems (see -[Variant Type in Apache Parquet for Semi-Structured Data] for background). - -The [datafusion-variant] crate adds a `VARIANT` SQL type and Spark-compatible -functions to DataFusion 56. Register it on a `SessionContext`: +Parquet [Variant] is a type for storing semi-structured data, similar to JSON +with an efficient binary encoding and is part of Apache Parquet and Apache +Iceberg (see the [blog on the Parquet site] for background). The +[datafusion-variant] crate adds a `VARIANT` SQL type and Spark-compatible +functions. Register it on a `SessionContext`: ```rust let mut ctx = SessionContext::new(); datafusion_variant::register_all(&mut ctx)?; ``` -and you can then load, query, and store semi-structured data using SQL: +Then you can load, query, and store semi-structured data using SQL: ```sql +-- Load JSON data into a VARIANT column CREATE TABLE events AS SELECT parse_json(json_data) AS event FROM (VALUES @@ -203,24 +212,23 @@ WHERE event:status::BIGINT >= 400; +----------------------+-------------------------+ ``` -Variant columns can be written to and read from Parquet files with the normal -`COPY` and `SELECT` statements, including *shredding* commonly used fields into -typed Parquet columns for faster queries: +Variant columns can be written to Parquet files with `COPY` statements, +including optionally *shredding* commonly used fields into typed Parquet columns +for faster queries: ```sql COPY events TO 'shredded_events.parquet' STORED AS PARQUET OPTIONS ('variant.shredding' '{"event": "STRUCT"}'); ``` -The crate is under active development and aims to match Apache Spark's Variant -behavior; see the [datafusion-variant roadmap] and the DataFusion -[Variant epic][#26517] for what is planned next. +The `datafusion-variant` crate is under active development, refer to the project +documentation for more details. [Variant]: https://parquet.apache.org/docs/file-format/types/variantencoding/ -[Variant Type in Apache Parquet for Semi-Structured Data]: https://parquet.apache.org/blog/2026/02/27/variant-type-in-apache-parquet-for-semi-structured-data/ -[datafusion-variant]: https://github.com/datafusion-contrib/datafusion-variant +[blog on the Parquet site]: https://parquet.apache.org/blog/2026/02/27/variant-type-in-apache-parquet-for-semi-structured-data/ +[datafusion-variant]: https://datafusion-contrib.github.io/datafusion-variant/ [datafusion-variant roadmap]: https://github.com/datafusion-contrib/datafusion-variant/issues/69 ### Geospatial Data with `geodatafusion` @@ -533,7 +541,6 @@ suitable for beginners is [here], and you can find out how to reach us on the [@dd-annarose]: https://github.com/dd-annarose [@geoffreyclaude]: https://github.com/geoffreyclaude [@goutamadwant]: https://github.com/goutamadwant -[@james-willis]: https://github.com/james-willis [@jay-dee7]: https://github.com/jay-dee7 [@jayzhan211]: https://github.com/jayzhan211 [@kosiew]: https://github.com/kosiew From 30d151b00397cc621e05b1f390fca43e6b1f7ff2 Mon Sep 17 00:00:00 2001 From: Andrew Lamb Date: Fri, 20 Nov 2026 15:34:37 -0500 Subject: [PATCH 05/11] updates --- content/blog/2026-11-20-datafusion-56.0.0.md | 34 ++++++++++++-------- 1 file changed, 20 insertions(+), 14 deletions(-) diff --git a/content/blog/2026-11-20-datafusion-56.0.0.md b/content/blog/2026-11-20-datafusion-56.0.0.md index cc6d9255..8d7f3585 100644 --- a/content/blog/2026-11-20-datafusion-56.0.0.md +++ b/content/blog/2026-11-20-datafusion-56.0.0.md @@ -171,13 +171,14 @@ Thanks to [@cblp], [@cyberbeam524], [@paleolimbot], [@M-Tesla], and [canonical extension types]: https://arrow.apache.org/docs/format/CanonicalExtensions.html [the User Defined Types blog]: https://datafusion.apache.org/blog/2025/09/21/custom-types-using-metadata -### Semi-Structured Data with `datafusion-variant` +### Semi-Structured Data (e.g. JSON) Parquet [Variant] is a type for storing semi-structured data, similar to JSON with an efficient binary encoding and is part of Apache Parquet and Apache Iceberg (see the [blog on the Parquet site] for background). The -[datafusion-variant] crate adds a `VARIANT` SQL type and Spark-compatible -functions. Register it on a `SessionContext`: +[datafusion-variant] crate extends DataFusion via its extension APIs to add the +`VARIANT` SQL type and Spark-compatible functions. Register it on a +`SessionContext`: ```rust let mut ctx = SessionContext::new(); @@ -213,7 +214,7 @@ WHERE event:status::BIGINT >= 400; ``` Variant columns can be written to Parquet files with `COPY` statements, -including optionally *shredding* commonly used fields into typed Parquet columns +including optionally [*shredding* commonly used fields][Variant shredding] into typed Parquet columns for faster queries: ```sql @@ -229,20 +230,24 @@ documentation for more details. [Variant]: https://parquet.apache.org/docs/file-format/types/variantencoding/ [blog on the Parquet site]: https://parquet.apache.org/blog/2026/02/27/variant-type-in-apache-parquet-for-semi-structured-data/ [datafusion-variant]: https://datafusion-contrib.github.io/datafusion-variant/ +[Variant shredding]: https://parquet.apache.org/docs/file-format/types/variantshredding/ [datafusion-variant roadmap]: https://github.com/datafusion-contrib/datafusion-variant/issues/69 -### Geospatial Data with `geodatafusion` +### Geospatial Data [geodatafusion] provides spatial extensions for DataFusion, built on the [GeoArrow] extension types and modeled after the [PostGIS] SQL API. It includes -more than a hundred `ST_*` functions, readers and writers for formats such as -[GeoParquet], [FlatGeobuf], and GeoJSON, and Python bindings. +around 90 spatial functions such as [`ST_Distance`][ST_Distance] and [`ST_Intersects`][ST_Intersects], support +for reading [GeoParquet], reading and writing [FlatGeobuf], and writing GeoJSON +files, and Python bindings. As with Variant, a single call registers the spatial functions: @@ -272,6 +277,8 @@ have, you can now build it. [PostGIS]: https://postgis.net/docs/reference.html [GeoParquet]: https://geoparquet.org/ [FlatGeobuf]: https://flatgeobuf.org/ +[ST_Distance]: https://docs.rs/geodatafusion/latest/geodatafusion/udf/geo/measurement/struct.Distance.html +[ST_Intersects]: https://docs.rs/geodatafusion/latest/geodatafusion/udf/geo/relationships/struct.Intersects.html ### External Catalogs in SQL @@ -308,16 +315,15 @@ Thanks to [@pepijnve] and [@TTyChud] for this work. ### File Format Improvements **Writing Avro**: DataFusion has been able to read [Apache Avro] files for a -long time, and DataFusion 56 can now write them too ([#24925]): +long time, and DataFusion 56 adds support for writing them: ```sql COPY (SELECT * FROM orders) TO 'orders.avro' STORED AS AVRO; ``` -**ALP Encoding for Parquet**: [ALP] (Adaptive Lossless floating-Point) is a new +**Parquet ALP Encoding**: [ALP] (Adaptive Lossless floating-Point) is a new Parquet encoding that often stores `FLOAT` and `DOUBLE` columns much more -compactly. DataFusion 56 reads ALP-encoded files and can write them -([#27036]): +compactly. DataFusion 56 can read and write ALP-encoded files ```sql SET datafusion.execution.parquet.encoding = 'alp'; From 0e8962f7eff82596f04a4232fa095b87295dd94c Mon Sep 17 00:00:00 2001 From: Andrew Lamb Date: Fri, 20 Nov 2026 15:39:23 -0500 Subject: [PATCH 06/11] updates --- content/blog/2026-11-20-datafusion-56.0.0.md | 154 ++++++++++++------- 1 file changed, 98 insertions(+), 56 deletions(-) diff --git a/content/blog/2026-11-20-datafusion-56.0.0.md b/content/blog/2026-11-20-datafusion-56.0.0.md index 8d7f3585..e5d609e1 100644 --- a/content/blog/2026-11-20-datafusion-56.0.0.md +++ b/content/blog/2026-11-20-datafusion-56.0.0.md @@ -318,38 +318,80 @@ Thanks to [@pepijnve] and [@TTyChud] for this work. long time, and DataFusion 56 adds support for writing them: ```sql -COPY (SELECT * FROM orders) TO 'orders.avro' STORED AS AVRO; +CREATE TABLE orders (id INT, customer VARCHAR, total DOUBLE) AS VALUES + (1, 'alice', 42.50), + (2, 'bob', 17.25), + (3, 'carol', 99.99); + +-- Write the table to an Avro file +COPY orders TO 'orders.avro' STORED AS AVRO; + +-- Read it back +SELECT * FROM 'orders.avro'; ++----+----------+-------+ +| id | customer | total | ++----+----------+-------+ +| 1 | alice | 42.5 | +| 2 | bob | 17.25 | +| 3 | carol | 99.99 | ++----+----------+-------+ ``` **Parquet ALP Encoding**: [ALP] (Adaptive Lossless floating-Point) is a new Parquet encoding that often stores `FLOAT` and `DOUBLE` columns much more -compactly. DataFusion 56 can read and write ALP-encoded files +compactly. DataFusion 56 can read and write ALP-encoded files. To write a +column using ALP, select the encoding and turn off dictionary encoding for that +column (dictionary encoding otherwise takes precedence): ```sql -SET datafusion.execution.parquet.encoding = 'alp'; -COPY measurements TO 'measurements.parquet' STORED AS PARQUET; +COPY measurements TO 'measurements.parquet' STORED AS PARQUET +OPTIONS ( + 'format.encoding::price' 'alp', + 'format.dictionary_enabled::price' 'false' +); ``` - +
+Full Example + +```sql +-- One million prices with two decimal places +CREATE TABLE measurements AS +SELECT i AS id, round(100000 * random(), 2) AS price +FROM generate_series(1, 1000000) AS t(i); + +-- Write with the default settings, and with ALP for the price column +COPY measurements TO 'alp.parquet' STORED AS PARQUET +OPTIONS ( + 'format.encoding::price' 'alp', + 'format.dictionary_enabled::price' 'false' +); + +-- Compare the size of the price column in the two files +SELECT 'alp', encodings, total_compressed_size +FROM parquet_metadata('alp.parquet') WHERE path_in_schema = '"price"'; ++---------+------------------------------+-----------------------+ +| file | encodings | total_compressed_size | ++---------+------------------------------+-----------------------+ +| default | [PLAIN, RLE, RLE_DICTIONARY] | 4481181 | +| alp | [RLE, ALP] | 3018657 | ++---------+------------------------------+-----------------------+ +``` -**Hive Null Partitions**: Hive-compatible writers such as Spark store rows with -a null partition value in a directory named `__HIVE_DEFAULT_PARTITION__`. -DataFusion previously failed to read such tables, or returned the directory -name as a string. DataFusion 56 reads these values as `NULL`, as Hive, Spark -and Impala do ([#26310]). +
+ +In this example the ALP-encoded column is about a third smaller than with the +default settings. ALP is a recent addition to Parquet, so check that the other +systems that read your files support it before using it. -**Other Improvements**: New options control the target size of output files in -bytes (`datafusion.execution.soft_max_bytes_per_output_file`, [#24924]) and -write distinct value counts to Parquet statistics ([#25576]), and Arrow IPC -files gain format options ([#26155]). + -Thanks to [@pepijnve], [@Surajsuthar], [@xanderbailey], [@Tpt], and -[@Rich-T-kid] for this work. +Thanks to [@pepijnve] and [@Surajsuthar] for this work. [Apache Avro]: https://avro.apache.org/ [ALP]: https://github.com/apache/parquet-format/blob/master/Encodings.md -### More SQL +### More SQL Support **`MATERIALIZED` CTEs**: By default, DataFusion inlines Common Table Expressions (CTEs), so a CTE that is referenced several times is evaluated @@ -363,25 +405,50 @@ SELECT a.v = b.v FROM r a, r b; -- true: the CTE runs once and both references see the same value ``` -**Other SQL Improvements**: DataFusion 56 also supports the `MAP` type in SQL -statements such as `CREATE TABLE` ([#24397]), multi-column `NOT IN` subqueries -with correct `NULL` semantics ([#19857]), column references as the percentile -argument of percentile functions ([#25337]), decimal inputs to -`percentile_cont` and `median` ([#24419]), `timezone`, `timezone_hour`, and -`timezone_minute` in `date_part` ([#25163]), and shows `MERGE INTO` details in -`EXPLAIN` ([#26038]). - -Thanks to [@adriangb], [@nuno-faria], [@viirya], [@dd-annarose], [@theirix], -and [@wirybeaver] for this work. +Thanks to [@adriangb] for this work. ### `datafusion-cli` Improvements `datafusion-cli` adds `parquet_file_metadata` and `parquet_page_index` table -functions for inspecting Parquet files ([#25640]), and can optionally register -the Spark-compatible functions from the [datafusion-spark crate] ([#24179]). -Thanks to [@jay-dee7] and [@goutamadwant]. +functions for inspecting Parquet files ([#25640]). - +For example, `parquet_file_metadata` shows file-level information from the +Parquet footer, and `parquet_page_index` shows the statistics stored for each +page of each column: + +
+Setup + +```sql +CREATE TABLE orders (id INT, customer VARCHAR, total DOUBLE) AS VALUES + (1, 'alice', 42.50), + (2, 'bob', 17.25), + (3, 'carol', 99.99); + +COPY orders TO 'orders.parquet' STORED AS PARQUET; +``` + +
+ +```sql +SELECT filename, num_rows, num_row_groups, footer_length +FROM parquet_file_metadata('orders.parquet'); ++----------------+----------+----------------+---------------+ +| filename | num_rows | num_row_groups | footer_length | ++----------------+----------+----------------+---------------+ +| orders.parquet | 3 | 1 | 770 | ++----------------+----------+----------------+---------------+ + +SELECT column_id, page_ordinal, first_row_index, min_value, max_value, null_count +FROM parquet_page_index('orders.parquet'); ++-----------+--------------+-----------------+-----------+-----------+------------+ +| column_id | page_ordinal | first_row_index | min_value | max_value | null_count | ++-----------+--------------+-----------------+-----------+-----------+------------+ +| 0 | 0 | 0 | 1 | 3 | 0 | +| 1 | 0 | 0 | alice | carol | 0 | +| 2 | 0 | 0 | 17.25 | 99.99 | 0 | ++-----------+--------------+-----------------+-----------+-----------+------------+ +``` ### Versioned Documentation @@ -533,7 +600,6 @@ suitable for beginners is [here], and you can find out how to reach us on the [here]: https://github.com/apache/datafusion/issues?q=is%3Aissue+is%3Aopen+label%3A%22good+first+issue%22 [communication doc]: https://datafusion.apache.org/contributor-guide/communication.html [Please don't dump unreviewed AI output on us]: https://datafusion.apache.org/contributor-guide/ai-policy.html#what-is-an-ai-dump-and-why-it-is-not-helpful -[datafusion-spark crate]: https://docs.rs/datafusion-spark/latest/datafusion_spark/index.html [@2010YOUY01]: https://github.com/2010YOUY01 [@adriangb]: https://github.com/adriangb @@ -544,10 +610,7 @@ suitable for beginners is [here], and you can find out how to reach us on the [@comphead]: https://github.com/comphead [@cyberbeam524]: https://github.com/cyberbeam524 [@Dandandan]: https://github.com/Dandandan -[@dd-annarose]: https://github.com/dd-annarose [@geoffreyclaude]: https://github.com/geoffreyclaude -[@goutamadwant]: https://github.com/goutamadwant -[@jay-dee7]: https://github.com/jay-dee7 [@jayzhan211]: https://github.com/jayzhan211 [@kosiew]: https://github.com/kosiew [@Kristofferjoha]: https://github.com/Kristofferjoha @@ -555,7 +618,6 @@ suitable for beginners is [here], and you can find out how to reach us on the [@M-Tesla]: https://github.com/M-Tesla [@martin-g]: https://github.com/martin-g [@neilconway]: https://github.com/neilconway -[@nuno-faria]: https://github.com/nuno-faria [@Omega359]: https://github.com/Omega359 [@osipovartem]: https://github.com/osipovartem [@paleolimbot]: https://github.com/paleolimbot @@ -565,12 +627,7 @@ suitable for beginners is [here], and you can find out how to reach us on the [@Rich-T-kid]: https://github.com/Rich-T-kid [@SubhamSinghal]: https://github.com/SubhamSinghal [@Surajsuthar]: https://github.com/Surajsuthar -[@theirix]: https://github.com/theirix -[@Tpt]: https://github.com/Tpt [@TTyChud]: https://github.com/TTyChud -[@viirya]: https://github.com/viirya -[@wirybeaver]: https://github.com/wirybeaver -[@xanderbailey]: https://github.com/xanderbailey [@Xuanwo]: https://github.com/Xuanwo [@xudong963]: https://github.com/xudong963 [@yashrb24]: https://github.com/yashrb24 @@ -580,54 +637,39 @@ suitable for beginners is [here], and you can find out how to reach us on the [#318]: https://github.com/apache/datafusion/issues/318 [#17071]: https://github.com/apache/datafusion/issues/17071 [#19241]: https://github.com/apache/datafusion/issues/19241 -[#19857]: https://github.com/apache/datafusion/pull/19857 [#21621]: https://github.com/apache/datafusion/pull/21621 [#23565]: https://github.com/apache/datafusion/pull/23565 -[#23831]: https://github.com/apache/datafusion/pull/23831 -[#24179]: https://github.com/apache/datafusion/pull/24179 [#24325]: https://github.com/apache/datafusion/pull/24325 [#24326]: https://github.com/apache/datafusion/pull/24326 [#24329]: https://github.com/apache/datafusion/pull/24329 [#24330]: https://github.com/apache/datafusion/pull/24330 [#24392]: https://github.com/apache/datafusion/pull/24392 -[#24397]: https://github.com/apache/datafusion/pull/24397 -[#24419]: https://github.com/apache/datafusion/pull/24419 [#24579]: https://github.com/apache/datafusion/pull/24579 [#24744]: https://github.com/apache/datafusion/pull/24744 [#24792]: https://github.com/apache/datafusion/pull/24792 -[#24924]: https://github.com/apache/datafusion/pull/24924 -[#24925]: https://github.com/apache/datafusion/pull/24925 [#25000]: https://github.com/apache/datafusion/pull/25000 [#25030]: https://github.com/apache/datafusion/pull/25030 [#25112]: https://github.com/apache/datafusion/pull/25112 [#25150]: https://github.com/apache/datafusion/pull/25150 -[#25163]: https://github.com/apache/datafusion/pull/25163 [#25188]: https://github.com/apache/datafusion/pull/25188 [#25255]: https://github.com/apache/datafusion/pull/25255 -[#25337]: https://github.com/apache/datafusion/pull/25337 [#25338]: https://github.com/apache/datafusion/pull/25338 [#25371]: https://github.com/apache/datafusion/pull/25371 [#25404]: https://github.com/apache/datafusion/pull/25404 -[#25576]: https://github.com/apache/datafusion/pull/25576 [#25580]: https://github.com/apache/datafusion/pull/25580 [#25640]: https://github.com/apache/datafusion/pull/25640 [#25739]: https://github.com/apache/datafusion/pull/25739 [#25853]: https://github.com/apache/datafusion/pull/25853 [#25887]: https://github.com/apache/datafusion/pull/25887 -[#26038]: https://github.com/apache/datafusion/pull/26038 [#26074]: https://github.com/apache/datafusion/pull/26074 -[#26155]: https://github.com/apache/datafusion/pull/26155 [#26277]: https://github.com/apache/datafusion/pull/26277 -[#26310]: https://github.com/apache/datafusion/pull/26310 [#26357]: https://github.com/apache/datafusion/pull/26357 [#26370]: https://github.com/apache/datafusion/pull/26370 [#26404]: https://github.com/apache/datafusion/pull/26404 [#26461]: https://github.com/apache/datafusion/pull/26461 -[#26517]: https://github.com/apache/datafusion/issues/26517 [#26533]: https://github.com/apache/datafusion/pull/26533 [#26672]: https://github.com/apache/datafusion/issues/26672 [#26865]: https://github.com/apache/datafusion/issues/26865 [#27015]: https://github.com/apache/datafusion/pull/27015 -[#27036]: https://github.com/apache/datafusion/pull/27036 [@alamb]: https://github.com/alamb [@jonathanc-n]: https://github.com/jonathanc-n From 64d2344759a1efd1f7e27f5827c488c62064c544 Mon Sep 17 00:00:00 2001 From: Andrew Lamb Date: Fri, 20 Nov 2026 15:55:40 -0500 Subject: [PATCH 07/11] Updates + version docs --- content/blog/2026-11-20-datafusion-56.0.0.md | 505 +++++++++--------- .../datafusion-56.0.0/versioned_docs.png | Bin 0 -> 211537 bytes 2 files changed, 242 insertions(+), 263 deletions(-) create mode 100644 content/images/datafusion-56.0.0/versioned_docs.png diff --git a/content/blog/2026-11-20-datafusion-56.0.0.md b/content/blog/2026-11-20-datafusion-56.0.0.md index e5d609e1..ae53154f 100644 --- a/content/blog/2026-11-20-datafusion-56.0.0.md +++ b/content/blog/2026-11-20-datafusion-56.0.0.md @@ -44,76 +44,68 @@ weeks of development and 1200 commits. Thanks to the [247 contributors]. ### `ASOF` Joins -DataFusion 56 adds `ASOF JOIN`, a long-standing feature request ([#318]). -An `ASOF` join matches each row on the left with the -*closest* row on the right rather than requiring an exact match. Such joins are +DataFusion 56 adds `ASOF JOIN`, a long-standing feature request ([#318]) +that matches each row on the left with the +*closest* row on the right rather than an exact match. Such joins are common in time-series workloads such as finding the most recent quote for each trade, or aligning two sensors that sample at different rates. -For example, given tables of `trades` and `prices` +For example, given tables of `temperature` and `humidity` readings from two +sensors that report at different times: -| id | symbol | ts | quantity | -|----|--------|---------------------|----------| -| T1 | AAPL | 2026-11-20T09:30:05 | 100 | -| T2 | AAPL | 2026-11-20T09:30:12 | 250 | -| T3 | MSFT | 2026-11-20T09:30:07 | 75 | -| T4 | MSFT | 2026-11-20T09:30:20 | 300 | -| T5 | NVDA | 2026-11-20T09:30:10 | 50 | +| id | location | ts | temp | +|----|----------|---------------------|------| +| T1 | roof | 2026-11-20T09:30:05 | 11.5 | +| T2 | roof | 2026-11-20T09:30:12 | 11.7 | +| T3 | lobby | 2026-11-20T09:30:07 | 20.1 | -| id | symbol | ts | price | -|----|--------|---------------------|--------| -| P1 | AAPL | 2026-11-20T09:30:00 | 228.10 | -| P2 | AAPL | 2026-11-20T09:30:10 | 228.35 | -| P3 | AAPL | 2026-11-20T09:30:15 | 228.20 | -| P4 | MSFT | 2026-11-20T09:30:00 | 415.50 | -| P5 | MSFT | 2026-11-20T09:30:15 | 415.75 | +| id | location | ts | humidity | +|----|----------|---------------------|----------| +| H1 | roof | 2026-11-20T09:30:00 | 71.0 | +| H2 | roof | 2026-11-20T09:30:10 | 70.5 | +| H3 | lobby | 2026-11-20T09:30:10 | 45.2 | -Since no trade has the exact same timestamp as any price, a regular equality -join on `symbol` and `ts` would match nothing. Instead, an `ASOF` join -efficiently pairs each trade with the most recent price at or before it: +Since no temperature reading has the exact same timestamp as any humidity +reading, a regular equality join on `location` and `ts` would match nothing. +Instead, an `ASOF` join efficiently pairs each temperature reading with the most +recent humidity reading at or before it: ```sql -SELECT t.id AS trade_id, p.id AS price_id, t.symbol, t.ts, t.quantity, p.price -FROM trades AS t ASOF JOIN prices AS p -MATCH_CONDITION (t.ts >= p.ts) -ON t.symbol = p.symbol +SELECT t.id AS temp_id, h.id AS humidity_id, t.location, t.ts, t.temp, h.humidity +FROM temperature AS t ASOF JOIN humidity AS h +MATCH_CONDITION (t.ts >= h.ts) +ON t.location = h.location ORDER BY t.id; ``` ```text -+----------+----------+--------+---------------------+----------+--------+ -| trade_id | price_id | symbol | ts | quantity | price | -+----------+----------+--------+---------------------+----------+--------+ -| T1 | P1 | AAPL | 2026-11-20T09:30:05 | 100 | 228.10 | -| T2 | P2 | AAPL | 2026-11-20T09:30:12 | 250 | 228.35 | -| T3 | P4 | MSFT | 2026-11-20T09:30:07 | 75 | 415.50 | -| T4 | P5 | MSFT | 2026-11-20T09:30:20 | 300 | 415.75 | -| T5 | NULL | NVDA | 2026-11-20T09:30:10 | 50 | NULL | -+----------+----------+--------+---------------------+----------+--------+ ++---------+-------------+----------+---------------------+------+----------+ +| temp_id | humidity_id | location | ts | temp | humidity | ++---------+-------------+----------+---------------------+------+----------+ +| T1 | H1 | roof | 2026-11-20T09:30:05 | 11.5 | 71.0 | +| T2 | H2 | roof | 2026-11-20T09:30:12 | 11.7 | 70.5 | +| T3 | NULL | lobby | 2026-11-20T09:30:07 | 20.1 | NULL | ++---------+-------------+----------+---------------------+------+----------+ ```
Full Example ```sql -CREATE TABLE trades (id VARCHAR, symbol VARCHAR, ts TIMESTAMP, quantity INT) AS VALUES - ('T1', 'AAPL', '2026-11-20T09:30:05', 100), - ('T2', 'AAPL', '2026-11-20T09:30:12', 250), - ('T3', 'MSFT', '2026-11-20T09:30:07', 75), - ('T4', 'MSFT', '2026-11-20T09:30:20', 300), - ('T5', 'NVDA', '2026-11-20T09:30:10', 50); - -CREATE TABLE prices (id VARCHAR, symbol VARCHAR, ts TIMESTAMP, price DECIMAL(10, 2)) AS VALUES - ('P1', 'AAPL', '2026-11-20T09:30:00', 228.10), - ('P2', 'AAPL', '2026-11-20T09:30:10', 228.35), - ('P3', 'AAPL', '2026-11-20T09:30:15', 228.20), - ('P4', 'MSFT', '2026-11-20T09:30:00', 415.50), - ('P5', 'MSFT', '2026-11-20T09:30:15', 415.75); - -SELECT t.id AS trade_id, p.id AS price_id, t.symbol, t.ts, t.quantity, p.price -FROM trades AS t ASOF JOIN prices AS p -MATCH_CONDITION (t.ts >= p.ts) -ON t.symbol = p.symbol +CREATE TABLE temperature (id VARCHAR, location VARCHAR, ts TIMESTAMP, temp DOUBLE) AS VALUES + ('T1', 'roof', '2026-11-20T09:30:05', 11.5), + ('T2', 'roof', '2026-11-20T09:30:12', 11.7), + ('T3', 'lobby', '2026-11-20T09:30:07', 20.1); + +CREATE TABLE humidity (id VARCHAR, location VARCHAR, ts TIMESTAMP, humidity DOUBLE) AS VALUES + ('H1', 'roof', '2026-11-20T09:30:00', 71.0), + ('H2', 'roof', '2026-11-20T09:30:10', 70.5), + ('H3', 'lobby', '2026-11-20T09:30:10', 45.2); + +SELECT t.id AS temp_id, h.id AS humidity_id, t.location, t.ts, t.temp, h.humidity +FROM temperature AS t ASOF JOIN humidity AS h +MATCH_CONDITION (t.ts >= h.ts) +ON t.location = h.location ORDER BY t.id; ``` @@ -129,13 +121,166 @@ and [@jonathanc-n] for reviews and improvements.. [Snowflake ASOF JOIN syntax]: https://docs.snowflake.com/en/sql-reference/constructs/asof-join [ASOF JOIN documentation]: https://datafusion.apache.org/user-guide/sql/select.html#asof-join +### External Catalogs in SQL + +Connecting DataFusion to an external catalog, such as an Iceberg REST catalog, +previously required writing Rust code. DataFusion 56 adds +`CREATE EXTERNAL CATALOG` and `DROP CATALOG` statements ([#25112]), so catalogs +can be attached with SQL in the same way as external tables: + +```sql +CREATE EXTERNAL CATALOG my_catalog +STORED AS ICEBERG +LOCATION 's3://bucket/warehouse' +OPTIONS ('catalog.uri' 'http://rest-catalog:8181', 'warehouse' 'my_catalog'); + +SELECT * FROM my_catalog.sales.orders LIMIT 10; +``` + +DataFusion does not include catalog implementations itself. Instead, libraries +such as table format integrations register a [`CatalogProviderFactory`][CatalogProviderFactory] for +each `STORED AS` type, and users can then attach catalogs without any +additional code; see the [`CREATE EXTERNAL CATALOG` documentation][CREATE EXTERNAL CATALOG documentation] for details. + +To make working with multiple catalogs more practical, `information_schema` +queries are now scoped to a single catalog, as the SQL standard specifies +([#25887]): `my_catalog.information_schema.tables` lists only the tables in +`my_catalog`, and an unqualified `information_schema` refers to the default +catalog. + +Thanks to [@pepijnve] and [@TTyChud] for this work. + +[CatalogProviderFactory]: https://docs.rs/datafusion/56.0.0/datafusion/catalog/trait.CatalogProviderFactory.html +[CREATE EXTERNAL CATALOG documentation]: https://datafusion.apache.org/user-guide/sql/ddl.html#create-external-catalog + +### File Format Improvements + +**Writing Avro**: DataFusion has been able to read [Apache Avro] files for a +long time, and DataFusion 56 adds support for writing them: + +```sql +CREATE TABLE orders (id INT, customer VARCHAR, total DOUBLE) AS VALUES + (1, 'alice', 42.50), + (2, 'bob', 17.25), + (3, 'carol', 99.99); + +-- Write the table to an Avro file +COPY orders TO 'orders.avro' STORED AS AVRO; + +-- Read it back +SELECT * FROM 'orders.avro'; ++----+----------+-------+ +| id | customer | total | ++----+----------+-------+ +| 1 | alice | 42.5 | +| 2 | bob | 17.25 | +| 3 | carol | 99.99 | ++----+----------+-------+ +``` + +**Parquet ALP Encoding**: [ALP] (Adaptive Lossless floating-Point) is a new +Parquet encoding that often stores `FLOAT` and `DOUBLE` columns much more +compactly. DataFusion 56 can read and write ALP-encoded files. To write a +column using ALP, select the encoding and turn off dictionary encoding for that +column (dictionary encoding otherwise takes precedence): + +```sql +COPY measurements TO 'measurements.parquet' STORED AS PARQUET +OPTIONS ( + 'format.encoding::price' 'alp', + 'format.dictionary_enabled::price' 'false' +); +``` + +
+Full Example + +```sql +-- One million prices with two decimal places +CREATE TABLE measurements AS +SELECT i AS id, round(100000 * random(), 2) AS price +FROM generate_series(1, 1000000) AS t(i); + +-- Write with the default settings, and with ALP for the price column +COPY measurements TO 'alp.parquet' STORED AS PARQUET +OPTIONS ( + 'format.encoding::price' 'alp', + 'format.dictionary_enabled::price' 'false' +); + +-- Compare the size of the price column in the two files +SELECT 'alp', encodings, total_compressed_size +FROM parquet_metadata('alp.parquet') WHERE path_in_schema = '"price"'; ++---------+------------------------------+-----------------------+ +| file | encodings | total_compressed_size | ++---------+------------------------------+-----------------------+ +| default | [PLAIN, RLE, RLE_DICTIONARY] | 4481181 | +| alp | [RLE, ALP] | 3018657 | ++---------+------------------------------+-----------------------+ +``` + +
+ +In this example the ALP-encoded column is about a third smaller than with the +default settings. ALP is a recent addition to Parquet, so check that the other +systems that read your files support it before using it. + + + +Thanks to [@pepijnve] and [@Surajsuthar] for this work. + +[Apache Avro]: https://avro.apache.org/ +[ALP]: https://github.com/apache/parquet-format/blob/master/Encodings.md + +### More SQL Support + +**`MATERIALIZED` CTEs**: By default, DataFusion inlines Common Table +Expressions (CTEs), so a CTE that is referenced several times is evaluated +several times. DataFusion 56 supports the Postgres +`WITH ... AS [NOT] MATERIALIZED` syntax to evaluate a CTE once and reuse the +result ([#25580]): + +```sql +WITH r AS MATERIALIZED (SELECT random() AS v) +SELECT a.v = b.v FROM r a, r b; +-- true: the CTE runs once and both references see the same value +``` + +Thanks to [@adriangb] for this work. + +### `datafusion-cli` Improvements + +`datafusion-cli` adds `parquet_file_metadata` and `parquet_page_index` table +functions for inspecting Parquet files. + +### Versioned Documentation + +The [DataFusion documentation] previously described only the unreleased `main` +branch, which made it hard to tell which features were available in the version +you were actually using. The site now has a version picker and publishes a +snapshot of the documentation for each release. Thanks to [@yiaany] for this +work and [@Omega359] for the original request. + + + +**Figure 2**: The new version picker on the [DataFusion documentation] site, +which selects between the documentation for the development version (`main`) +and for previous releases. + +[DataFusion documentation]: https://datafusion.apache.org/ + ### Improved support for Extension Types As described in [the User Defined Types blog], DataFusion allows users to extend the types using [Arrow extension types] to attach a logical type to a standard arrow physical type. Extension types permit the DataFusion ecosystem to add -entirely new data types *without* changes to the DataFusion core (see the next -two sections). DataFusion 56 improves this support in several ways: +entirely new data types *without* changes to the DataFusion core (see +[Ecosystem Highlights] below). DataFusion 56 improves this support in several ways: - The SQL types `UUID` and `JSON` now map to the Arrow [canonical extension types] `arrow.uuid` and `arrow.json`. @@ -169,8 +314,15 @@ Thanks to [@cblp], [@cyberbeam524], [@paleolimbot], [@M-Tesla], and [Arrow extension types]: https://arrow.apache.org/docs/format/Columnar.html#extension-types [canonical extension types]: https://arrow.apache.org/docs/format/CanonicalExtensions.html +[Ecosystem Highlights]: #ecosystem-highlights [the User Defined Types blog]: https://datafusion.apache.org/blog/2025/09/21/custom-types-using-metadata +## Ecosystem Highlights ๐ŸŒฑ + +DataFusion is designed to be extended, and some of the most exciting new +features are built by the community on top of it rather than added to the +core. This section highlights two such projects. + ### Semi-Structured Data (e.g. JSON) Parquet [Variant] is a type for storing semi-structured data, similar to JSON @@ -280,186 +432,6 @@ have, you can now build it. [ST_Distance]: https://docs.rs/geodatafusion/latest/geodatafusion/udf/geo/measurement/struct.Distance.html [ST_Intersects]: https://docs.rs/geodatafusion/latest/geodatafusion/udf/geo/relationships/struct.Intersects.html -### External Catalogs in SQL - -Connecting DataFusion to an external catalog, such as an Iceberg REST catalog, -previously required writing Rust code. DataFusion 56 adds -`CREATE EXTERNAL CATALOG` and `DROP CATALOG` statements ([#25112]), so catalogs -can be attached with SQL in the same way as external tables: - -```sql -CREATE EXTERNAL CATALOG my_catalog -STORED AS ICEBERG -LOCATION 's3://bucket/warehouse' -OPTIONS ('catalog.uri' 'http://rest-catalog:8181', 'warehouse' 'my_catalog'); - -SELECT * FROM my_catalog.sales.orders LIMIT 10; -``` - -DataFusion does not include catalog implementations itself. Instead, libraries -such as table format integrations register a [`CatalogProviderFactory`][CatalogProviderFactory] for -each `STORED AS` type, and users can then attach catalogs without any -additional code; see the [`CREATE EXTERNAL CATALOG` documentation][CREATE EXTERNAL CATALOG documentation] for details. - -To make working with multiple catalogs more practical, `information_schema` -queries are now scoped to a single catalog, as the SQL standard specifies -([#25887]): `my_catalog.information_schema.tables` lists only the tables in -`my_catalog`, and an unqualified `information_schema` refers to the default -catalog. - -Thanks to [@pepijnve] and [@TTyChud] for this work. - -[CatalogProviderFactory]: https://docs.rs/datafusion/56.0.0/datafusion/catalog/trait.CatalogProviderFactory.html -[CREATE EXTERNAL CATALOG documentation]: https://datafusion.apache.org/user-guide/sql/ddl.html#create-external-catalog - -### File Format Improvements - -**Writing Avro**: DataFusion has been able to read [Apache Avro] files for a -long time, and DataFusion 56 adds support for writing them: - -```sql -CREATE TABLE orders (id INT, customer VARCHAR, total DOUBLE) AS VALUES - (1, 'alice', 42.50), - (2, 'bob', 17.25), - (3, 'carol', 99.99); - --- Write the table to an Avro file -COPY orders TO 'orders.avro' STORED AS AVRO; - --- Read it back -SELECT * FROM 'orders.avro'; -+----+----------+-------+ -| id | customer | total | -+----+----------+-------+ -| 1 | alice | 42.5 | -| 2 | bob | 17.25 | -| 3 | carol | 99.99 | -+----+----------+-------+ -``` - -**Parquet ALP Encoding**: [ALP] (Adaptive Lossless floating-Point) is a new -Parquet encoding that often stores `FLOAT` and `DOUBLE` columns much more -compactly. DataFusion 56 can read and write ALP-encoded files. To write a -column using ALP, select the encoding and turn off dictionary encoding for that -column (dictionary encoding otherwise takes precedence): - -```sql -COPY measurements TO 'measurements.parquet' STORED AS PARQUET -OPTIONS ( - 'format.encoding::price' 'alp', - 'format.dictionary_enabled::price' 'false' -); -``` - -
-Full Example - -```sql --- One million prices with two decimal places -CREATE TABLE measurements AS -SELECT i AS id, round(100000 * random(), 2) AS price -FROM generate_series(1, 1000000) AS t(i); - --- Write with the default settings, and with ALP for the price column -COPY measurements TO 'alp.parquet' STORED AS PARQUET -OPTIONS ( - 'format.encoding::price' 'alp', - 'format.dictionary_enabled::price' 'false' -); - --- Compare the size of the price column in the two files -SELECT 'alp', encodings, total_compressed_size -FROM parquet_metadata('alp.parquet') WHERE path_in_schema = '"price"'; -+---------+------------------------------+-----------------------+ -| file | encodings | total_compressed_size | -+---------+------------------------------+-----------------------+ -| default | [PLAIN, RLE, RLE_DICTIONARY] | 4481181 | -| alp | [RLE, ALP] | 3018657 | -+---------+------------------------------+-----------------------+ -``` - -
- -In this example the ALP-encoded column is about a third smaller than with the -default settings. ALP is a recent addition to Parquet, so check that the other -systems that read your files support it before using it. - - - -Thanks to [@pepijnve] and [@Surajsuthar] for this work. - -[Apache Avro]: https://avro.apache.org/ -[ALP]: https://github.com/apache/parquet-format/blob/master/Encodings.md - -### More SQL Support - -**`MATERIALIZED` CTEs**: By default, DataFusion inlines Common Table -Expressions (CTEs), so a CTE that is referenced several times is evaluated -several times. DataFusion 56 supports the Postgres -`WITH ... AS [NOT] MATERIALIZED` syntax to evaluate a CTE once and reuse the -result ([#25580]): - -```sql -WITH r AS MATERIALIZED (SELECT random() AS v) -SELECT a.v = b.v FROM r a, r b; --- true: the CTE runs once and both references see the same value -``` - -Thanks to [@adriangb] for this work. - -### `datafusion-cli` Improvements - -`datafusion-cli` adds `parquet_file_metadata` and `parquet_page_index` table -functions for inspecting Parquet files ([#25640]). - -For example, `parquet_file_metadata` shows file-level information from the -Parquet footer, and `parquet_page_index` shows the statistics stored for each -page of each column: - -
-Setup - -```sql -CREATE TABLE orders (id INT, customer VARCHAR, total DOUBLE) AS VALUES - (1, 'alice', 42.50), - (2, 'bob', 17.25), - (3, 'carol', 99.99); - -COPY orders TO 'orders.parquet' STORED AS PARQUET; -``` - -
- -```sql -SELECT filename, num_rows, num_row_groups, footer_length -FROM parquet_file_metadata('orders.parquet'); -+----------------+----------+----------------+---------------+ -| filename | num_rows | num_row_groups | footer_length | -+----------------+----------+----------------+---------------+ -| orders.parquet | 3 | 1 | 770 | -+----------------+----------+----------------+---------------+ - -SELECT column_id, page_ordinal, first_row_index, min_value, max_value, null_count -FROM parquet_page_index('orders.parquet'); -+-----------+--------------+-----------------+-----------+-----------+------------+ -| column_id | page_ordinal | first_row_index | min_value | max_value | null_count | -+-----------+--------------+-----------------+-----------+-----------+------------+ -| 0 | 0 | 0 | 1 | 3 | 0 | -| 1 | 0 | 0 | alice | carol | 0 | -| 2 | 0 | 0 | 17.25 | 99.99 | 0 | -+-----------+--------------+-----------------+-----------+-----------+------------+ -``` - -### Versioned Documentation - -The [DataFusion documentation] previously described only the unreleased `main` -branch, which made it hard to tell which features were available in the version -you were actually using. The site now has a version picker and publishes a -snapshot of the documentation for each release ([#17071], [#24792]). Thanks to -[@yiaany] for this work and [@Omega359] for the original request. - -[DataFusion documentation]: https://datafusion.apache.org/ - ## Performance Improvements ๐Ÿš€ DataFusion 56 continues to get faster across the board. Here is a @@ -478,7 +450,14 @@ representative sample of the improvements in this release. | Nested loop join memory | [2x lower peak memory][#25371] | Joins | | `LAST_VALUE ... IGNORE NULLS` | [13.15 ms โ†’ 111 ยตs][#26533] *(micro)* | Window | | Planning `SELECT`s with many aggregates | [5.9x faster for 1000 aggregates][#25739] | Planning | -| Compiling the `datafusion` crate | [~10x faster][#24329] | Build | +| Building `datafusion` from scratch | [~3x faster end to end, some crates up to 10x][#24329] | Build | + +### Faster Builds + +Building the `datafusion` crate and its dependencies from scratch is now about +3x faster end to end, and some individual crates, including the core +`datafusion` crate, compile up to 10x faster ([#24329], [#24325], [#24330], +[#24326]). Thanks to [@Dandandan]. ### Faster TopK and `LIMIT` Queries @@ -494,7 +473,7 @@ ORDER BY o.total DESC LIMIT 3; ``` -Parquet scans can also now stop after reading only the *pages* that are +Parquet scans now stop after reading only the *pages* that are guaranteed to satisfy a `LIMIT` query's filter ([#25000]), and custom table providers can implement `OFFSET` pushdown, which is useful for paging through results ([#25404]). Thanks to [@SubhamSinghal], [@peterxcli], and [@martin-g]. @@ -522,42 +501,35 @@ planned as a single join, which makes some queries hundreds of times faster ### Faster Functions and Expressions As in previous releases, many functions are faster, including `upper`, `lower`, -`translate`, `replace`, `left`, `right`, `levenshtein`, and many array -functions, and `IN` list evaluation improved further with specializations for -more types (epic [#19241]). Thanks to [@neilconway], [@geoffreyclaude], -[@andygrove], [@Rich-T-kid], and [@comphead]. - -### Faster Builds - -It is not only queries that are faster: a series of changes reduced the time to -compile the core `datafusion` crate by ~10x, with similar improvements for -several other crates ([#24329], [#24325], [#24330], [#24326]). Thanks to -[@Dandandan]. +`translate`, `replace`, `left`, `right`, `levenshtein`, along with `IN` list +evaluation. Thanks to [@neilconway], [@geoffreyclaude], [@andygrove], +[@Rich-T-kid], and [@comphead] for making this happen. ## Stability Improvements ๐Ÿ›ก๏ธ **Correctness**: As a foundational piece of technology, it is important that DataFusion's results can be relied on. During this release cycle the community -systematically collected and fixed bugs that produced incorrect results (see -epic [#26672]), and agreed to slow down new features in order to stabilize the -release ([#26865]). DataFusion 56 also verifies the final physical plan and -reports which optimizer rule produced an invalid plan ([#26461]). - - - -**Larger-Than-Memory Queries**: Queries that spill to disk when memory runs out -are more robust. Aggregations with very large groups (such as `array_agg` over -a few keys) no longer fail after spilling ([#25853]), spill files for string -and dictionary data are smaller ([#23565], [#27015]), and memory accounting is -more accurate in several operators ([#24744], [#25188], [#26074]). Thanks to +systematically focused on finding and fixing bugs that produced incorrect +results. The tracking epic ([#26672]) lists more than 60 such bugs that are +fixed in DataFusion 56, along with the ones we are still working on. Thanks to +[@haohuaijin], [@adriangb], [@AdamGS], [@matthewmturner], [@viirya], +[@mbutrovich], and the many others who reported, fixed, and reviewed these +issues. + +**More Robust Larger-Than-Memory Queries**: Queries that spill to disk when +memory runs out are more robust. Aggregations with very large groups (such as +`array_agg` over a few keys) no longer fail after spilling ([#25853]), spill +files for string and dictionary data are smaller ([#23565], [#27015]), and +memory accounting is more accurate ([#24744], [#25188], [#26074]). Thanks to [@andygrove], [@cetra3], [@brancz], and [@kosiew]. ## Upgrade Guide and Changelog ๐Ÿ“– -DataFusion 56 upgrades to Arrow and Parquet 60 and `object_store` 0.14, and the -minimum supported Rust version is now 1.95.0. Upgrading should be -straightforward for most users. See the [Upgrade Guide] for details and -migration snippets, and the [changelog] for the full list of changes. +DataFusion 56 upgrades to [Arrow and Parquet 60] and +[`object_store` 0.14][object_store 0.14], and the minimum supported Rust +version is now 1.95.0. Upgrading should be straightforward for most users. See +the [Upgrade Guide] for details and migration snippets, and the [changelog] for +the full list of changes. ## About DataFusion @@ -596,6 +568,8 @@ suitable for beginners is [here], and you can find out how to reach us on the [dataframe library]: https://datafusion.apache.org/user-guide/dataframe.html [Python library]: https://datafusion.apache.org/python/ [command-line SQL tool]: https://datafusion.apache.org/user-guide/cli/ +[Arrow and Parquet 60]: https://arrow.apache.org/blog/2026/09/29/arrow-rs-60.0.0/ +[object_store 0.14]: https://github.com/apache/arrow-rs-object-store/releases/tag/v0.14.0 [Upgrade Guide]: https://datafusion.apache.org/library-user-guide/upgrading/56.0.0.html [here]: https://github.com/apache/datafusion/issues?q=is%3Aissue+is%3Aopen+label%3A%22good+first+issue%22 [communication doc]: https://datafusion.apache.org/contributor-guide/communication.html @@ -673,3 +647,8 @@ suitable for beginners is [here], and you can find out how to reach us on the [#27015]: https://github.com/apache/datafusion/pull/27015 [@alamb]: https://github.com/alamb [@jonathanc-n]: https://github.com/jonathanc-n +[@haohuaijin]: https://github.com/haohuaijin +[@AdamGS]: https://github.com/AdamGS +[@matthewmturner]: https://github.com/matthewmturner +[@viirya]: https://github.com/viirya +[@mbutrovich]: https://github.com/mbutrovich diff --git a/content/images/datafusion-56.0.0/versioned_docs.png b/content/images/datafusion-56.0.0/versioned_docs.png new file mode 100644 index 0000000000000000000000000000000000000000..41b8d2d95661b40d69a4d06d214c6d9012e4e702 GIT binary patch literal 211537 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

>TLt97C^@vs(_z=tUApu|U{6a7w6`=9BGl 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

bMi$&ISJ}AhL~&b}Mz+=7 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�`greCm+VdYD_qS0 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 Date: Fri, 20 Nov 2026 16:24:14 -0500 Subject: [PATCH 08/11] clenups --- content/blog/2026-11-20-datafusion-56.0.0.md | 111 +++++++++++-------- 1 file changed, 66 insertions(+), 45 deletions(-) diff --git a/content/blog/2026-11-20-datafusion-56.0.0.md b/content/blog/2026-11-20-datafusion-56.0.0.md index ae53154f..b0e6df3f 100644 --- a/content/blog/2026-11-20-datafusion-56.0.0.md +++ b/content/blog/2026-11-20-datafusion-56.0.0.md @@ -111,12 +111,11 @@ ORDER BY t.id;
-DataFusion implements the [Snowflake `ASOF JOIN` syntax][Snowflake ASOF JOIN syntax]. -See the [`ASOF JOIN` documentation][ASOF JOIN documentation] for more details. -Thanks to [@Xuanwo] for -contributing this feature and -to [@jayzhan211], [@Kristofferjoha] and [@2010YOUY01], [@xudong963], [@alamb], -and [@jonathanc-n] for reviews and improvements.. +DataFusion supports the [Snowflake `ASOF JOIN` syntax][Snowflake ASOF JOIN +syntax], please see the [`ASOF JOIN` documentation][ASOF JOIN documentation] for +more details. Thanks to [@Xuanwo] for contributing this feature and to +[@jayzhan211], [@Kristofferjoha] and [@2010YOUY01], [@xudong963], [@alamb], +and [@jonathanc-n] for reviews and improvements. [Snowflake ASOF JOIN syntax]: https://docs.snowflake.com/en/sql-reference/constructs/asof-join [ASOF JOIN documentation]: https://datafusion.apache.org/user-guide/sql/select.html#asof-join @@ -124,9 +123,9 @@ and [@jonathanc-n] for reviews and improvements.. ### External Catalogs in SQL Connecting DataFusion to an external catalog, such as an Iceberg REST catalog, -previously required writing Rust code. DataFusion 56 adds -`CREATE EXTERNAL CATALOG` and `DROP CATALOG` statements ([#25112]), so catalogs -can be attached with SQL in the same way as external tables: +previously required writing Rust code. DataFusion 56 adds support for +`CREATE EXTERNAL CATALOG` and `DROP CATALOG` statements ([#25112]), to +attach catalogs with SQL in the same way as external tables: ```sql CREATE EXTERNAL CATALOG my_catalog @@ -137,16 +136,11 @@ OPTIONS ('catalog.uri' 'http://rest-catalog:8181', 'warehouse' 'my_catalog'); SELECT * FROM my_catalog.sales.orders LIMIT 10; ``` -DataFusion does not include catalog implementations itself. Instead, libraries -such as table format integrations register a [`CatalogProviderFactory`][CatalogProviderFactory] for -each `STORED AS` type, and users can then attach catalogs without any -additional code; see the [`CREATE EXTERNAL CATALOG` documentation][CREATE EXTERNAL CATALOG documentation] for details. - -To make working with multiple catalogs more practical, `information_schema` -queries are now scoped to a single catalog, as the SQL standard specifies -([#25887]): `my_catalog.information_schema.tables` lists only the tables in -`my_catalog`, and an unqualified `information_schema` refers to the default -catalog. +Note that DataFusion does not include any catalog implementations itself. +Instead users register a [`CatalogProviderFactory`][CatalogProviderFactory] for +each `STORED AS` type, an then attach catalogs with SQL; see the [`CREATE +EXTERNAL CATALOG` documentation][CREATE EXTERNAL CATALOG documentation] for more +details. Thanks to [@pepijnve] and [@TTyChud] for this work. @@ -158,6 +152,13 @@ Thanks to [@pepijnve] and [@TTyChud] for this work. **Writing Avro**: DataFusion has been able to read [Apache Avro] files for a long time, and DataFusion 56 adds support for writing them: +```sql +COPY orders TO 'orders.avro' STORED AS AVRO; +``` + +
+Full Example + ```sql CREATE TABLE orders (id INT, customer VARCHAR, total DOUBLE) AS VALUES (1, 'alice', 42.50), @@ -178,11 +179,11 @@ SELECT * FROM 'orders.avro'; +----+----------+-------+ ``` +
+ **Parquet ALP Encoding**: [ALP] (Adaptive Lossless floating-Point) is a new Parquet encoding that often stores `FLOAT` and `DOUBLE` columns much more -compactly. DataFusion 56 can read and write ALP-encoded files. To write a -column using ALP, select the encoding and turn off dictionary encoding for that -column (dictionary encoding otherwise takes precedence): +compactly. DataFusion 56 can read and write ALP-encoded files: ```sql COPY measurements TO 'measurements.parquet' STORED AS PARQUET @@ -202,6 +203,7 @@ SELECT i AS id, round(100000 * random(), 2) AS price FROM generate_series(1, 1000000) AS t(i); -- Write with the default settings, and with ALP for the price column +COPY measurements TO 'default.parquet' STORED AS PARQUET; COPY measurements TO 'alp.parquet' STORED AS PARQUET OPTIONS ( 'format.encoding::price' 'alp', @@ -209,6 +211,11 @@ OPTIONS ( ); -- Compare the size of the price column in the two files +-- note that the ALP-encoded column is about a third smaller than with +-- the default setting. +SELECT 'default' AS file, encodings, total_compressed_size +FROM parquet_metadata('default.parquet') WHERE path_in_schema = '"price"' +UNION ALL SELECT 'alp', encodings, total_compressed_size FROM parquet_metadata('alp.parquet') WHERE path_in_schema = '"price"'; +---------+------------------------------+-----------------------+ @@ -221,12 +228,6 @@ FROM parquet_metadata('alp.parquet') WHERE path_in_schema = '"price"'; -In this example the ALP-encoded column is about a third smaller than with the -default settings. ALP is a recent addition to Parquet, so check that the other -systems that read your files support it before using it. - - - Thanks to [@pepijnve] and [@Surajsuthar] for this work. [Apache Avro]: https://avro.apache.org/ @@ -234,32 +235,52 @@ Thanks to [@pepijnve] and [@Surajsuthar] for this work. ### More SQL Support -**`MATERIALIZED` CTEs**: By default, DataFusion inlines Common Table -Expressions (CTEs), so a CTE that is referenced several times is evaluated -several times. DataFusion 56 supports the Postgres -`WITH ... AS [NOT] MATERIALIZED` syntax to evaluate a CTE once and reuse the -result ([#25580]): +**`MATERIALIZED` CTEs**: By default, DataFusion inlines Common Table Expressions +*(CTEs), so a CTE that is referenced multiple times is evaluated multiple times. +*DataFusion 56 supports the Postgres `WITH ... AS [NOT] MATERIALIZED` syntax to +*evaluate a CTE once and reuse the result ([#25580]). The syntax is currently +*only recognized by the `postgres` SQL dialect: ```sql +SET datafusion.sql_parser.dialect = 'postgres'; + +-- The CTE runs once, so both references see the same random value WITH r AS MATERIALIZED (SELECT random() AS v) -SELECT a.v = b.v FROM r a, r b; --- true: the CTE runs once and both references see the same value +SELECT a.v = b.v AS same FROM r AS a, r AS b; ++------+ +| same | ++------+ +| true | ++------+ + +-- Without MATERIALIZED, each reference evaluates random() separately +WITH r AS (SELECT random() AS v) +SELECT a.v = b.v AS same FROM r AS a, r AS b; ++-------+ +| same | ++-------+ +| false | ++-------+ ``` Thanks to [@adriangb] for this work. ### `datafusion-cli` Improvements -`datafusion-cli` adds `parquet_file_metadata` and `parquet_page_index` table -functions for inspecting Parquet files. +`datafusion-cli` adds [`parquet_file_metadata`][parquet_file_metadata] and +[`parquet_page_index`][parquet_page_index] table functions for inspecting +Parquet files. + +[parquet_file_metadata]: https://datafusion.apache.org/user-guide/cli/functions.html#parquet-file-metadata +[parquet_page_index]: https://datafusion.apache.org/user-guide/cli/functions.html#parquet-page-index ### Versioned Documentation -The [DataFusion documentation] previously described only the unreleased `main` -branch, which made it hard to tell which features were available in the version -you were actually using. The site now has a version picker and publishes a -snapshot of the documentation for each release. Thanks to [@yiaany] for this -work and [@Omega359] for the original request. +The [DataFusion documentation] site previously always reflected the latest +`main` branch, making it hard to tell which features were available in what +version. The site now has a version picker and publishes a snapshot of the +documentation for each release. Thanks to [@yiaany] for this work and +[@Omega359] for the original request. Date: Fri, 20 Nov 2026 16:32:16 -0500 Subject: [PATCH 09/11] updates --- content/blog/2026-11-20-datafusion-56.0.0.md | 47 +++++++++----------- 1 file changed, 20 insertions(+), 27 deletions(-) diff --git a/content/blog/2026-11-20-datafusion-56.0.0.md b/content/blog/2026-11-20-datafusion-56.0.0.md index b0e6df3f..ead7bed8 100644 --- a/content/blog/2026-11-20-datafusion-56.0.0.md +++ b/content/blog/2026-11-20-datafusion-56.0.0.md @@ -340,18 +340,18 @@ Thanks to [@cblp], [@cyberbeam524], [@paleolimbot], [@M-Tesla], and ## Ecosystem Highlights ๐ŸŒฑ -DataFusion is designed to be extended, and some of the most exciting new -features are built by the community on top of it rather than added to the -core. This section highlights two such projects. +DataFusion is designed to be extended, and this section highlights two +projects in the DataFusion ecosystem that are made possible by the +extension points in DataFusion 56. ### Semi-Structured Data (e.g. JSON) Parquet [Variant] is a type for storing semi-structured data, similar to JSON -with an efficient binary encoding and is part of Apache Parquet and Apache -Iceberg (see the [blog on the Parquet site] for background). The -[datafusion-variant] crate extends DataFusion via its extension APIs to add the -`VARIANT` SQL type and Spark-compatible functions. Register it on a -`SessionContext`: +with an efficient binary encoding recently added to Apache Parquet and Apache +Iceberg (see the [blog on the Parquet site] for more details). The +[datafusion-variant] crate extends DataFusion to add the `VARIANT` SQL type and +Spark-compatible functions. Register it with a single call to `register_all` on +a `SessionContext`: ```rust let mut ctx = SessionContext::new(); @@ -371,8 +371,7 @@ FROM (VALUES ) AS input(json_data); -- Extract fields with the Spark-style `:` operator -SELECT event:service::VARCHAR, - event:latency_ms::BIGINT +SELECT event:service::VARCHAR, event:latency_ms::BIGINT FROM events WHERE event:status::BIGINT >= 400; ``` @@ -386,7 +385,7 @@ WHERE event:status::BIGINT >= 400; +----------------------+-------------------------+ ``` -Variant columns can be written to Parquet files with `COPY` statements, +Variant columns can be written to Parquet files with `COPY` statements, including optionally [*shredding* commonly used fields][Variant shredding] into typed Parquet columns for faster queries: @@ -418,18 +417,18 @@ is coming. [geodatafusion] provides spatial extensions for DataFusion, built on the [GeoArrow] extension types and modeled after the [PostGIS] SQL API. It includes -around 90 spatial functions such as [`ST_Distance`][ST_Distance] and [`ST_Intersects`][ST_Intersects], support -for reading [GeoParquet], reading and writing [FlatGeobuf], and writing GeoJSON -files, and Python bindings. +around 90 spatial functions such as [`ST_Distance`][ST_Distance] and +[`ST_Intersects`][ST_Intersects], support for reading [GeoParquet], reading and +writing [FlatGeobuf], and writing GeoJSON files, and Python bindings. -As with Variant, a single call registers the spatial functions: +Install it with a single call: ```rust let ctx = SessionContext::new(); geodatafusion::register(&ctx); ``` -and geometries can then be queried using familiar PostGIS-style SQL: +And then you can query geometries using familiar PostGIS-style SQL: ```sql SELECT ST_Distance(ST_Point(0, 0), ST_Point(3, 4)) AS dist; @@ -439,12 +438,6 @@ SELECT ST_Area(ST_GeomFromText('POLYGON((0 0, 4 0, 4 4, 0 4, 0 0))')); -Together, `datafusion-variant` and `geodatafusion` illustrate what the extension -type work makes possible: sophisticated new data types, with their own SQL -syntax, functions, and file format integrations, built and released -independently by the community. If you need a type that DataFusion does not -have, you can now build it. - [geodatafusion]: https://github.com/datafusion-contrib/geodatafusion [GeoArrow]: https://geoarrow.org/ [PostGIS]: https://postgis.net/docs/reference.html @@ -471,14 +464,14 @@ representative sample of the improvements in this release. | Nested loop join memory | [2x lower peak memory][#25371] | Joins | | `LAST_VALUE ... IGNORE NULLS` | [13.15 ms โ†’ 111 ยตs][#26533] *(micro)* | Window | | Planning `SELECT`s with many aggregates | [5.9x faster for 1000 aggregates][#25739] | Planning | -| Building `datafusion` from scratch | [~3x faster end to end, some crates up to 10x][#24329] | Build | +| Debug build of `datafusion` from scratch | [~3x faster end to end, some crates up to 10x][#24329] | Build | ### Faster Builds -Building the `datafusion` crate and its dependencies from scratch is now about -3x faster end to end, and some individual crates, including the core -`datafusion` crate, compile up to 10x faster ([#24329], [#24325], [#24330], -[#24326]). Thanks to [@Dandandan]. +A debug build of the `datafusion` crate and its dependencies from scratch is +now about 3x faster end to end, and some individual crates, including the core +`datafusion` crate, compile up to 10x faster (see [#24329], [#24325], [#24330], +[#24326]). Thanks [@Dandandan]. ### Faster TopK and `LIMIT` Queries From 97021ac51c4b95cb7a7a9a3e055a30d0970662d8 Mon Sep 17 00:00:00 2001 From: Andrew Lamb Date: Fri, 20 Nov 2026 16:43:38 -0500 Subject: [PATCH 10/11] updates --- content/blog/2026-11-20-datafusion-56.0.0.md | 198 +++++++++++-------- 1 file changed, 120 insertions(+), 78 deletions(-) diff --git a/content/blog/2026-11-20-datafusion-56.0.0.md b/content/blog/2026-11-20-datafusion-56.0.0.md index ead7bed8..2f1ff976 100644 --- a/content/blog/2026-11-20-datafusion-56.0.0.md +++ b/content/blog/2026-11-20-datafusion-56.0.0.md @@ -29,14 +29,14 @@ limitations under the License. -We are proud to announce the release of [DataFusion 56.0.0], which includes many new features, including -`ASOF` joins, SQL registration of external catalogs, Avro and ALP write support, -better support for extension types, and many performance and stability improvements. The complete list of -changes is available in the [changelog]. This release represents roughly 12 -weeks of development and 1200 commits. Thanks to the [247 contributors]. +We are proud to announce the release of [DataFusion 56.0.0], which includes many +new features such as `ASOF` joins, SQL registration of external catalogs, Avro +and ALP write support, better support for extension types, and many performance +and stability improvements. The complete list of changes is available in the +[changelog]. This release represents roughly 12 weeks of development and 1200 +commits. Thanks to the [247 contributors] who made it possible. [DataFusion 56.0.0]: https://crates.io/crates/datafusion/56.0.0 -[DataFusion 55.0.0]: https://datafusion.apache.org/blog/2026/08/25/datafusion-55.0.0/ [changelog]: https://github.com/apache/datafusion/blob/branch-56/dev/changelog/56.0.0.md [247 contributors]: https://github.com/apache/datafusion/blob/branch-56/dev/changelog/56.0.0.md#credits @@ -44,11 +44,11 @@ weeks of development and 1200 commits. Thanks to the [247 contributors]. ### `ASOF` Joins -DataFusion 56 adds `ASOF JOIN`, a long-standing feature request ([#318]) -that matches each row on the left with the -*closest* row on the right rather than an exact match. Such joins are -common in time-series workloads such as finding the most recent quote for each -trade, or aligning two sensors that sample at different rates. +DataFusion 56 adds `ASOF JOIN`, a long-standing feature request ([#318]) that +matches each row on the left with the *closest* row on the right rather than an +exact match. Such joins are common in time-series workloads such as finding the +most recent quote for each trade, or aligning two sensors that sample at +different rates. For example, given tables of `temperature` and `humidity` readings from two sensors that report at different times: @@ -111,11 +111,11 @@ ORDER BY t.id; -DataFusion supports the [Snowflake `ASOF JOIN` syntax][Snowflake ASOF JOIN -syntax], please see the [`ASOF JOIN` documentation][ASOF JOIN documentation] for -more details. Thanks to [@Xuanwo] for contributing this feature and to -[@jayzhan211], [@Kristofferjoha] and [@2010YOUY01], [@xudong963], [@alamb], -and [@jonathanc-n] for reviews and improvements. +DataFusion supports the [Snowflake syntax][Snowflake ASOF JOIN syntax]; please +see the [documentation][ASOF JOIN documentation] for more details. Thanks to +[@Xuanwo] for contributing this feature and to [@jayzhan211], +[@Kristofferjoha], [@2010YOUY01], [@xudong963], [@alamb], and [@jonathanc-n] +for reviews and improvements. [Snowflake ASOF JOIN syntax]: https://docs.snowflake.com/en/sql-reference/constructs/asof-join [ASOF JOIN documentation]: https://datafusion.apache.org/user-guide/sql/select.html#asof-join @@ -124,8 +124,8 @@ and [@jonathanc-n] for reviews and improvements. Connecting DataFusion to an external catalog, such as an Iceberg REST catalog, previously required writing Rust code. DataFusion 56 adds support for -`CREATE EXTERNAL CATALOG` and `DROP CATALOG` statements ([#25112]), to -attach catalogs with SQL in the same way as external tables: +`CREATE EXTERNAL CATALOG` and `DROP CATALOG` statements ([#25112]) to attach +catalogs with SQL in the same way as external tables: ```sql CREATE EXTERNAL CATALOG my_catalog @@ -137,10 +137,10 @@ SELECT * FROM my_catalog.sales.orders LIMIT 10; ``` Note that DataFusion does not include any catalog implementations itself. -Instead users register a [`CatalogProviderFactory`][CatalogProviderFactory] for -each `STORED AS` type, an then attach catalogs with SQL; see the [`CREATE -EXTERNAL CATALOG` documentation][CREATE EXTERNAL CATALOG documentation] for more -details. +Instead, users register a [`CatalogProviderFactory`][CatalogProviderFactory] +for each `STORED AS` type, and then attach catalogs with SQL; see the +[`CREATE EXTERNAL CATALOG` documentation][CREATE EXTERNAL CATALOG documentation] +for more details. Thanks to [@pepijnve] and [@TTyChud] for this work. @@ -210,9 +210,9 @@ OPTIONS ( 'format.dictionary_enabled::price' 'false' ); --- Compare the size of the price column in the two files --- note that the ALP-encoded column is about a third smaller than with --- the default setting. +-- Compare the size of the price column in the two files. +-- Note that the ALP-encoded column is about a third smaller than with +-- the default settings. SELECT 'default' AS file, encodings, total_compressed_size FROM parquet_metadata('default.parquet') WHERE path_in_schema = '"price"' UNION ALL @@ -236,10 +236,10 @@ Thanks to [@pepijnve] and [@Surajsuthar] for this work. ### More SQL Support **`MATERIALIZED` CTEs**: By default, DataFusion inlines Common Table Expressions -*(CTEs), so a CTE that is referenced multiple times is evaluated multiple times. -*DataFusion 56 supports the Postgres `WITH ... AS [NOT] MATERIALIZED` syntax to -*evaluate a CTE once and reuse the result ([#25580]). The syntax is currently -*only recognized by the `postgres` SQL dialect: +(CTEs), so a CTE that is referenced multiple times is evaluated multiple times. +DataFusion 56 supports the Postgres `WITH ... AS [NOT] MATERIALIZED` syntax to +evaluate a CTE once and reuse the result ([#25580]). The syntax is currently +only recognized by the `postgres` SQL dialect: ```sql SET datafusion.sql_parser.dialect = 'postgres'; @@ -289,29 +289,27 @@ class="img-fluid" alt="Screenshot of the DataFusion documentation site showing the new version picker, a drop-down menu listing Development (main) and releases 55.2.0, 54.1.0, 53.0.0, 52.0.0, 51.0.0, and 50.0.0." /> -**Figure 2**: The new version picker on the [DataFusion documentation] site, -which selects between the documentation for the development version (`main`) -and for previous releases. +**Figure 1**: The new version picker on the [DataFusion documentation] site. [DataFusion documentation]: https://datafusion.apache.org/ -### Improved support for Extension Types +### Improved Support for Extension Types -As described in [the User Defined Types blog], DataFusion's type system can be extended -using [Arrow extension types] to attach a logical type to an -Arrow physical type. This technique allows the DataFusion ecosystem to add -entirely new data types *without* changes to the DataFusion core (see -[Ecosystem Highlights] below). DataFusion 56 improves this support in several ways: +As described in [the User Defined Types blog], DataFusion's type system can be +extended using [Arrow extension types] to attach a logical type to an Arrow +physical type. This technique allows the DataFusion ecosystem to add entirely +new data types *without* changes to the DataFusion core (see +[Ecosystem Highlights] below). DataFusion 56 improves this support in several +ways: -- The SQL types `UUID` and `JSON` now map to - the Arrow [canonical extension types] `arrow.uuid` and `arrow.json`. -- `DESCRIBE`, `SHOW COLUMNS`, and - `information_schema.columns` show the extension type name rather than the - storage type. -- Extension types are preserved when reading Parquet - files with the default settings. -- Extension types are preserved through more operators such as - casts, `min` / `max`, scalar subqueries, and `INSERT`. +- The SQL types `UUID` and `JSON` now map to the Arrow + [canonical extension types] `arrow.uuid` and `arrow.json`. +- `DESCRIBE`, `SHOW COLUMNS`, and `information_schema.columns` show the + extension type name rather than the storage type. +- Extension types are preserved when reading Parquet files with the default + settings. +- Extension types are preserved through more operators such as casts, + `min` / `max`, scalar subqueries, and `INSERT`. For example, a column declared with the SQL `JSON` type is stored as a standard Arrow string and tagged with the `arrow.json` extension type: @@ -340,15 +338,15 @@ Thanks to [@cblp], [@cyberbeam524], [@paleolimbot], [@M-Tesla], and ## Ecosystem Highlights ๐ŸŒฑ -DataFusion is designed to be extended, and this section highlights two -projects in the DataFusion ecosystem that are made possible by the -extension points in DataFusion 56. +DataFusion is designed to be extended, and this section highlights two projects +in the DataFusion ecosystem that are made possible by the extension points in +DataFusion 56. ### Semi-Structured Data (e.g. JSON) Parquet [Variant] is a type for storing semi-structured data, similar to JSON -with an efficient binary encoding recently added to Apache Parquet and Apache -Iceberg (see the [blog on the Parquet site] for more details). The +but with an efficient binary encoding, that was recently added to Apache Parquet +and Apache Iceberg (see the [blog on the Parquet site] for more details). The [datafusion-variant] crate extends DataFusion to add the `VARIANT` SQL type and Spark-compatible functions. Register it with a single call to `register_all` on a `SessionContext`: @@ -386,29 +384,28 @@ WHERE event:status::BIGINT >= 400; ``` Variant columns can be written to Parquet files with `COPY` statements, -including optionally [*shredding* commonly used fields][Variant shredding] into typed Parquet columns -for faster queries: +optionally [*shredding* commonly used fields][Variant shredding] into typed +Parquet columns for faster queries: ```sql COPY events TO 'shredded_events.parquet' STORED AS PARQUET OPTIONS ('variant.shredding' '{"event": "STRUCT"}'); ``` -The `datafusion-variant` crate is under active development, refer to the project -documentation for more details. - - +The `datafusion-variant` crate is under active development; refer to the +[project documentation][datafusion-variant] for more details. Thanks to +[@sdf-jkl], [@friendlymatthew], [@alamb], [@raghuvanshraj], [@getChan], and the +other contributors for making it possible. [Variant]: https://parquet.apache.org/docs/file-format/types/variantencoding/ [blog on the Parquet site]: https://parquet.apache.org/blog/2026/02/27/variant-type-in-apache-parquet-for-semi-structured-data/ [datafusion-variant]: https://datafusion-contrib.github.io/datafusion-variant/ [Variant shredding]: https://parquet.apache.org/docs/file-format/types/variantshredding/ -[datafusion-variant roadmap]: https://github.com/datafusion-contrib/datafusion-variant/issues/69 -### Geospatial Data +### Geospatial Data +
+Full Example + +```sql +-- A table of named places +CREATE TABLE places (name VARCHAR, x DOUBLE, y DOUBLE) AS VALUES + ('cafe', 1.0, 1.0), + ('library', 3.0, 4.0), + ('airport', 9.0, 9.0); + +-- The distance of each place from the origin, and whether it is inside +-- the 5 x 5 "downtown" square +SELECT name, + ST_AsText(ST_Point(x, y)) AS location, + round(ST_Distance(ST_Point(x, y), ST_Point(0, 0)), 2) AS distance, + ST_Intersects( + ST_Point(x, y), + ST_GeomFromText('POLYGON((0 0, 5 0, 5 5, 0 5, 0 0))') + ) AS downtown +FROM places +ORDER BY distance; ++---------+------------+----------+----------+ +| name | location | distance | downtown | ++---------+------------+----------+----------+ +| cafe | POINT(1 1) | 1.41 | true | +| library | POINT(3 4) | 5.0 | true | +| airport | POINT(9 9) | 12.73 | false | ++---------+------------+----------+----------+ +``` + +
+ +Thanks to [@kylebarron] for creating `geodatafusion`, and to [@Xuanwo], +[@gadomski], [@ianthetechie], [@sharkinsspatial], and the other contributors +for their work on it. [geodatafusion]: https://github.com/datafusion-contrib/geodatafusion [GeoArrow]: https://geoarrow.org/ @@ -471,7 +512,7 @@ representative sample of the improvements in this release. A debug build of the `datafusion` crate and its dependencies from scratch is now about 3x faster end to end, and some individual crates, including the core `datafusion` crate, compile up to 10x faster (see [#24329], [#24325], [#24330], -[#24326]). Thanks [@Dandandan]. +[#24326]). Thanks to [@Dandandan]. ### Faster TopK and `LIMIT` Queries @@ -487,10 +528,10 @@ ORDER BY o.total DESC LIMIT 3; ``` -Parquet scans now stop after reading only the *pages* that are -guaranteed to satisfy a `LIMIT` query's filter ([#25000]), and custom table -providers can implement `OFFSET` pushdown, which is useful for paging through -results ([#25404]). Thanks to [@SubhamSinghal], [@peterxcli], and [@martin-g]. +Parquet scans now stop after reading only the *pages* that are guaranteed to +satisfy a `LIMIT` query's filter ([#25000]), and custom table providers can +implement `OFFSET` pushdown, which is useful for paging through results +([#25404]). Thanks to [@SubhamSinghal], [@peterxcli], and [@martin-g]. ### Faster Joins @@ -515,9 +556,9 @@ planned as a single join, which makes some queries hundreds of times faster ### Faster Functions and Expressions As in previous releases, many functions are faster, including `upper`, `lower`, -`translate`, `replace`, `left`, `right`, `levenshtein`, along with `IN` list -evaluation. Thanks to [@neilconway], [@geoffreyclaude], [@andygrove], -[@Rich-T-kid], and [@comphead] for making this happen. +`translate`, `replace`, `left`, `right`, and `levenshtein`, along with `IN` +list evaluation. Thanks to [@neilconway], [@geoffreyclaude], [@andygrove], +[@Rich-T-kid], and [@comphead] for making this happen. ## Stability Improvements ๐Ÿ›ก๏ธ @@ -623,8 +664,6 @@ suitable for beginners is [here], and you can find out how to reach us on the [@zhuqi-lucas]: https://github.com/zhuqi-lucas [#318]: https://github.com/apache/datafusion/issues/318 -[#17071]: https://github.com/apache/datafusion/issues/17071 -[#19241]: https://github.com/apache/datafusion/issues/19241 [#21621]: https://github.com/apache/datafusion/pull/21621 [#23565]: https://github.com/apache/datafusion/pull/23565 [#24325]: https://github.com/apache/datafusion/pull/24325 @@ -634,7 +673,6 @@ suitable for beginners is [here], and you can find out how to reach us on the [#24392]: https://github.com/apache/datafusion/pull/24392 [#24579]: https://github.com/apache/datafusion/pull/24579 [#24744]: https://github.com/apache/datafusion/pull/24744 -[#24792]: https://github.com/apache/datafusion/pull/24792 [#25000]: https://github.com/apache/datafusion/pull/25000 [#25030]: https://github.com/apache/datafusion/pull/25030 [#25112]: https://github.com/apache/datafusion/pull/25112 @@ -645,19 +683,15 @@ suitable for beginners is [here], and you can find out how to reach us on the [#25371]: https://github.com/apache/datafusion/pull/25371 [#25404]: https://github.com/apache/datafusion/pull/25404 [#25580]: https://github.com/apache/datafusion/pull/25580 -[#25640]: https://github.com/apache/datafusion/pull/25640 [#25739]: https://github.com/apache/datafusion/pull/25739 [#25853]: https://github.com/apache/datafusion/pull/25853 -[#25887]: https://github.com/apache/datafusion/pull/25887 [#26074]: https://github.com/apache/datafusion/pull/26074 [#26277]: https://github.com/apache/datafusion/pull/26277 [#26357]: https://github.com/apache/datafusion/pull/26357 [#26370]: https://github.com/apache/datafusion/pull/26370 [#26404]: https://github.com/apache/datafusion/pull/26404 -[#26461]: https://github.com/apache/datafusion/pull/26461 [#26533]: https://github.com/apache/datafusion/pull/26533 [#26672]: https://github.com/apache/datafusion/issues/26672 -[#26865]: https://github.com/apache/datafusion/issues/26865 [#27015]: https://github.com/apache/datafusion/pull/27015 [@alamb]: https://github.com/alamb [@jonathanc-n]: https://github.com/jonathanc-n @@ -666,3 +700,11 @@ suitable for beginners is [here], and you can find out how to reach us on the [@matthewmturner]: https://github.com/matthewmturner [@viirya]: https://github.com/viirya [@mbutrovich]: https://github.com/mbutrovich +[@sdf-jkl]: https://github.com/sdf-jkl +[@friendlymatthew]: https://github.com/friendlymatthew +[@raghuvanshraj]: https://github.com/raghuvanshraj +[@getChan]: https://github.com/getChan +[@kylebarron]: https://github.com/kylebarron +[@gadomski]: https://github.com/gadomski +[@ianthetechie]: https://github.com/ianthetechie +[@sharkinsspatial]: https://github.com/sharkinsspatial From 3da4fefb7088d6005183659b41601b31c61a7ef2 Mon Sep 17 00:00:00 2001 From: Andrew Lamb Date: Fri, 20 Nov 2026 16:50:12 -0500 Subject: [PATCH 11/11] more --- content/blog/2026-11-20-datafusion-56.0.0.md | 60 ++++++++++++++++---- 1 file changed, 49 insertions(+), 11 deletions(-) diff --git a/content/blog/2026-11-20-datafusion-56.0.0.md b/content/blog/2026-11-20-datafusion-56.0.0.md index 2f1ff976..7ca99207 100644 --- a/content/blog/2026-11-20-datafusion-56.0.0.md +++ b/content/blog/2026-11-20-datafusion-56.0.0.md @@ -239,7 +239,10 @@ Thanks to [@pepijnve] and [@Surajsuthar] for this work. (CTEs), so a CTE that is referenced multiple times is evaluated multiple times. DataFusion 56 supports the Postgres `WITH ... AS [NOT] MATERIALIZED` syntax to evaluate a CTE once and reuse the result ([#25580]). The syntax is currently -only recognized by the `postgres` SQL dialect: +only recognized by the `postgres` SQL dialect. + +
+Example ```sql SET datafusion.sql_parser.dialect = 'postgres'; @@ -263,13 +266,16 @@ SELECT a.v = b.v AS same FROM r AS a, r AS b; +-------+ ``` +
+ Thanks to [@adriangb] for this work. ### `datafusion-cli` Improvements `datafusion-cli` adds [`parquet_file_metadata`][parquet_file_metadata] and [`parquet_page_index`][parquet_page_index] table functions for inspecting -Parquet files. +Parquet files. Thanks to [@jay-dee7] for this work, with reviews from +[@kumarUjjawal]. [parquet_file_metadata]: https://datafusion.apache.org/user-guide/cli/functions.html#parquet-file-metadata [parquet_page_index]: https://datafusion.apache.org/user-guide/cli/functions.html#parquet-page-index @@ -356,7 +362,37 @@ let mut ctx = SessionContext::new(); datafusion_variant::register_all(&mut ctx)?; ``` -Then you can load, query, and store semi-structured data using SQL: +Then you can load, query, and store semi-structured data using SQL. For +example, given an `events` table with a `VARIANT` column: + +```sql +SELECT * FROM events; ++------------------------------------------------------------------+ +| event | ++------------------------------------------------------------------+ +| {"latency_ms":12,"service":"api","status":200,"tags":["cached"]} | +| {"error":null,"latency_ms":85,"service":"api","status":500} | +| {"error":"Somethings not working","service":"api","status":504} | ++------------------------------------------------------------------+ +``` + +you can extract and filter on individual fields: + +```sql +-- Extract fields with the Spark-style `:` operator +SELECT event:service::VARCHAR, event:latency_ms::BIGINT +FROM events +WHERE event:status::BIGINT >= 400; ++----------------------+-------------------------+ +| events.event:service | events.event:latency_ms | ++----------------------+-------------------------+ +| api | 85 | +| api | NULL | ++----------------------+-------------------------+ +``` + +
+Full Example ```sql -- Load JSON data into a VARIANT column @@ -368,20 +404,16 @@ FROM (VALUES ('{"service":"api","status":504,"error":"Somethings not working"}') ) AS input(json_data); +-- Show the contents of the table +SELECT * FROM events; + -- Extract fields with the Spark-style `:` operator SELECT event:service::VARCHAR, event:latency_ms::BIGINT FROM events WHERE event:status::BIGINT >= 400; ``` -```text -+----------------------+-------------------------+ -| events.event:service | events.event:latency_ms | -+----------------------+-------------------------+ -| api | 85 | -| api | NULL | -+----------------------+-------------------------+ -``` +
Variant columns can be written to Parquet files with `COPY` statements, optionally [*shredding* commonly used fields][Variant shredding] into typed @@ -616,6 +648,10 @@ code. [Please don't dump unreviewed AI output on us] ๐Ÿ™. A list of open issues suitable for beginners is [here], and you can find out how to reach us on the [communication doc]. +If you want to know what we are planning to work on next, or to suggest what you +think is important, please join the [2026 Q4 Roadmap discussion]. + +[2026 Q4 Roadmap discussion]: https://github.com/apache/datafusion/issues/26684 [Apache DataFusion]: https://datafusion.apache.org/ [Rust]: https://www.rust-lang.org/ [Apache Arrow]: https://arrow.apache.org @@ -708,3 +744,5 @@ suitable for beginners is [here], and you can find out how to reach us on the [@gadomski]: https://github.com/gadomski [@ianthetechie]: https://github.com/ianthetechie [@sharkinsspatial]: https://github.com/sharkinsspatial +[@jay-dee7]: https://github.com/jay-dee7 +[@kumarUjjawal]: https://github.com/kumarUjjawal