# delta-io/delta-examples architecture

> Architecture diagram of the GitHub repository delta-io/delta-examples, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-30). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/delta-io/delta-examples
- Repository: https://github.com/delta-io/delta-examples

## Overview

delta-examples is a learning repository: users run notebooks to explore Delta Lake across Spark, Python bindings, Rust, and other data tools. The principal workflow is launching a notebook in its corresponding runtime and following its Delta Lake example. The tree shows substantial topic collections for table operations, interoperability, and analytics. Only the README and one small utility source were sampled, so links between individual examples and underlying operations are not asserted.

Main entry points: [`notebooks/pyspark`](https://github.com/delta-io/delta-examples/tree/master/notebooks/pyspark) (PySpark notebooks), [`notebooks/scala`](https://github.com/delta-io/delta-examples/tree/master/notebooks/scala) (Scala notebooks), [`notebooks/python-deltalake`](https://github.com/delta-io/delta-examples/tree/master/notebooks/python-deltalake) (Python Delta Lake)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_spark["Spark examples"]
  node_pyspark["PySpark notebooks"]
  node_scala["Scala notebooks"]
  node_pyspark_ops["Table operations"]
  node_pyspark_changes["Change management"]
end

subgraph group_python["Python examples"]
  node_python_delta["Python Delta Lake"]
  node_tensor_utils["Tensor transform<br/>[utils.py]"]
  node_pandas["Pandas examples"]
  node_polars["Polars examples"]
  node_dask["Dask example"]
end

subgraph group_engines["Other engines"]
  node_duckdb["DuckDB examples"]
  node_iceberg["Iceberg example"]
  node_daft["Daft example"]
end

subgraph group_learning["Learning materials"]
  node_datasets[("Example datasets")]
end

node_learner(("Learner"))

node_learner -->|"runs notebooks"| node_pyspark
node_learner -->|"runs notebooks"| node_scala
node_learner -->|"runs notebooks"| node_python_delta

click node_pyspark "https://github.com/delta-io/delta-examples/tree/master/notebooks/pyspark"
click node_scala "https://github.com/delta-io/delta-examples/tree/master/notebooks/scala"
click node_pyspark_ops "https://github.com/delta-io/delta-examples/blob/master/notebooks/pyspark/delta-basic-operations.ipynb"
click node_pyspark_changes "https://github.com/delta-io/delta-examples/blob/master/notebooks/pyspark/change-data-feed.ipynb"
click node_python_delta "https://github.com/delta-io/delta-examples/tree/master/notebooks/python-deltalake"
click node_tensor_utils "https://github.com/delta-io/delta-examples/blob/master/notebooks/deltatorch/utils.py"
click node_pandas "https://github.com/delta-io/delta-examples/tree/master/notebooks/pandas"
click node_polars "https://github.com/delta-io/delta-examples/tree/master/notebooks/polars"
click node_dask "https://github.com/delta-io/delta-examples/blob/master/notebooks/python-deltalake/dask-deltalake.ipynb"
click node_duckdb "https://github.com/delta-io/delta-examples/tree/master/notebooks/duckdb"
click node_iceberg "https://github.com/delta-io/delta-examples/tree/master/notebooks/iceberg"
click node_daft "https://github.com/delta-io/delta-examples/tree/master/notebooks/daft"
click node_datasets "https://github.com/delta-io/delta-examples/tree/master/data"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_pyspark,node_scala,node_pyspark_ops,node_pyspark_changes toneBlue
class node_python_delta,node_tensor_utils,node_pandas,node_polars,node_dask toneAmber
class node_duckdb,node_iceberg,node_daft toneMint
class node_datasets toneRose
class node_learner toneIndigo
```

## Components

### Spark examples

- [PySpark notebooks](https://github.com/delta-io/delta-examples/tree/master/notebooks/pyspark): `notebooks/pyspark`
- [Scala notebooks](https://github.com/delta-io/delta-examples/tree/master/notebooks/scala): `notebooks/scala`
- [Table operations](https://github.com/delta-io/delta-examples/blob/master/notebooks/pyspark/delta-basic-operations.ipynb): `notebooks/pyspark/delta-basic-operations.ipynb`
- [Change management](https://github.com/delta-io/delta-examples/blob/master/notebooks/pyspark/change-data-feed.ipynb): `notebooks/pyspark/change-data-feed.ipynb`

### Python examples

- [Python Delta Lake](https://github.com/delta-io/delta-examples/tree/master/notebooks/python-deltalake): `notebooks/python-deltalake`
- [Tensor transform](https://github.com/delta-io/delta-examples/blob/master/notebooks/deltatorch/utils.py): `notebooks/deltatorch/utils.py`
- [Pandas examples](https://github.com/delta-io/delta-examples/tree/master/notebooks/pandas): `notebooks/pandas`
- [Polars examples](https://github.com/delta-io/delta-examples/tree/master/notebooks/polars): `notebooks/polars`
- [Dask example](https://github.com/delta-io/delta-examples/blob/master/notebooks/python-deltalake/dask-deltalake.ipynb): `notebooks/python-deltalake/dask-deltalake.ipynb`

### Other engines

- [DuckDB examples](https://github.com/delta-io/delta-examples/tree/master/notebooks/duckdb): `notebooks/duckdb`
- [Iceberg example](https://github.com/delta-io/delta-examples/tree/master/notebooks/iceberg): `notebooks/iceberg`
- [Daft example](https://github.com/delta-io/delta-examples/tree/master/notebooks/daft): `notebooks/daft`

### Learning materials

- [Example datasets](https://github.com/delta-io/delta-examples/tree/master/data): `data`

### Other components

- **Learner**

## Connections

- Learner → PySpark notebooks: runs notebooks (evidence: `README.md`)
- Learner → Scala notebooks: runs notebooks (evidence: `README.md`)
- Learner → Python Delta Lake: runs notebooks (evidence: `README.md`)