From fc13445d72a2f4d667ac4153f16513152fac6c45 Mon Sep 17 00:00:00 2001 From: claudespice Date: Tue, 19 May 2026 09:46:11 -0700 Subject: [PATCH] docs: Document Delta Lake column mapping support Adds a Column Mapping section to the Delta Lake data connector page covering `columnMapping.mode = name` and `id`. The connector resolves logical-to-physical names at read time, including nested Struct, List, and Map field renames, and partition and predicate-pushdown paths. Source: spiceai/spiceai#10134 --- website/docs/components/data-connectors/delta-lake/index.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/website/docs/components/data-connectors/delta-lake/index.md b/website/docs/components/data-connectors/delta-lake/index.md index a8a49a5ec..20ae7ee43 100644 --- a/website/docs/components/data-connectors/delta-lake/index.md +++ b/website/docs/components/data-connectors/delta-lake/index.md @@ -184,6 +184,10 @@ The table below shows the Delta Lake data types supported, along with the type m | `Variant` | `Struct` | | `Map` | `Map` | +## Column Mapping + +Delta Lake tables that use [column mapping](https://github.com/delta-io/delta/blob/master/PROTOCOL.md#column-mapping) with `columnMapping.mode = name` or `columnMapping.mode = id` are supported. Tables in either mode store data in Parquet files under opaque physical column names (e.g., `col-b70f7585-…`) that differ from the logical names exposed by the table schema. Spice resolves logical-to-physical names at read time, including for partitions, predicate pushdown, and nested `Struct`, `List`, and `Map` field renames. + ## Limitations - Delta Lake connector does not support reading Delta tables with the `V2Checkpoint` feature enabled. To use the Delta Lake connector with such tables, drop the `V2Checkpoint` feature by executing the following command: