# developer-advocacy-dremio/definitive-guide-to-apache-iceberg architecture

> Architecture diagram of the GitHub repository developer-advocacy-dremio/definitive-guide-to-apache-iceberg, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-27). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/developer-advocacy-dremio/definitive-guide-to-apache-iceberg
- Repository: https://github.com/developer-advocacy-dremio/definitive-guide-to-apache-iceberg

## Overview

This repository provides supporting materials for The Definitive Guide to Apache Iceberg, not an Iceberg runtime. Readers use the README’s resource index to find chapter-specific files. Available materials include notebooks, Markdown, and JSON examples; the sampled Chapter 8 script also demonstrates fetching weather data and publishing it to Kinesis. The chapter folders are grouped by range for clarity; the README describes their contents only generally, so chapter topics are not inferred from folder numbers.

Main entry points: [`README.md`](https://github.com/developer-advocacy-dremio/definitive-guide-to-apache-iceberg/blob/main/README.md) (Resource index), [`Resources/Chapter_8/ProducerKinesis.py`](https://github.com/developer-advocacy-dremio/definitive-guide-to-apache-iceberg/blob/main/Resources/Chapter_8/ProducerKinesis.py) (Weather producer), [`Resources/Chapter_1`](https://github.com/developer-advocacy-dremio/definitive-guide-to-apache-iceberg/tree/main/Resources/Chapter_1) (Chapter 1), [`Resources/Chapter_2`](https://github.com/developer-advocacy-dremio/definitive-guide-to-apache-iceberg/tree/main/Resources/Chapter_2) (Chapter 2)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_early["Chapters 1–5"]
  node_ch1["Chapter 1"]
  node_ch2["Chapter 2"]
  node_ch3["Chapter 3"]
  node_ch4["Chapter 4"]
  node_ch5["Chapter 5"]
end

subgraph group_middle["Chapters 6–10"]
  node_ch6["Chapter 6"]
  node_ch7["Chapter 7"]
  node_ch8["Chapter 8"]
  node_ch9["Chapter 9"]
  node_ch10["Chapter 10"]
  node_producer["Weather producer<br/>[ProducerKinesis.py]"]
end

subgraph group_late["Chapters 11–15 and Misc"]
  node_ch11["Chapter 11"]
  node_ch12["Chapter 12"]
  node_ch13["Chapter 13"]
  node_ch14["Chapter 14"]
  node_ch15["Chapter 15"]
  node_misc["Misc resources"]
end

node_reader(("Reader"))
node_index["Resource index<br/>[README.md]"]
node_weather{{"Weather API"}}
node_kinesis["Kinesis stream"]

node_reader -->|"opens"| node_index
node_index -->|"links to"| node_ch1
node_index -->|"links to"| node_ch2
node_index -->|"links to"| node_ch3
node_index -->|"links to"| node_ch4
node_index -->|"links to"| node_ch5
node_index -->|"links to"| node_ch6
node_index -->|"links to"| node_ch7
node_index -->|"links to"| node_ch8
node_index -->|"links to"| node_ch9
node_index -->|"links to"| node_ch10
node_index -->|"links to"| node_ch11
node_index -->|"links to"| node_ch12
node_index -->|"links to"| node_ch13
node_index -->|"links to"| node_ch14
node_index -->|"links to"| node_ch15
node_index -->|"links to"| node_misc
node_weather -->|"provides data"| node_producer
node_producer -->|"publishes records"| node_kinesis

click node_index "https://github.com/developer-advocacy-dremio/definitive-guide-to-apache-iceberg/blob/main/README.md"
click node_ch1 "https://github.com/developer-advocacy-dremio/definitive-guide-to-apache-iceberg/tree/main/Resources/Chapter_1"
click node_ch2 "https://github.com/developer-advocacy-dremio/definitive-guide-to-apache-iceberg/tree/main/Resources/Chapter_2"
click node_ch3 "https://github.com/developer-advocacy-dremio/definitive-guide-to-apache-iceberg/tree/main/Resources/Chapter_3"
click node_ch4 "https://github.com/developer-advocacy-dremio/definitive-guide-to-apache-iceberg/tree/main/Resources/Chapter_4"
click node_ch5 "https://github.com/developer-advocacy-dremio/definitive-guide-to-apache-iceberg/tree/main/Resources/Chapter_5"
click node_ch6 "https://github.com/developer-advocacy-dremio/definitive-guide-to-apache-iceberg/tree/main/Resources/Chapter_6"
click node_ch7 "https://github.com/developer-advocacy-dremio/definitive-guide-to-apache-iceberg/tree/main/Resources/Chapter_7"
click node_ch8 "https://github.com/developer-advocacy-dremio/definitive-guide-to-apache-iceberg/tree/main/Resources/Chapter_8"
click node_ch9 "https://github.com/developer-advocacy-dremio/definitive-guide-to-apache-iceberg/tree/main/Resources/Chapter_9"
click node_ch10 "https://github.com/developer-advocacy-dremio/definitive-guide-to-apache-iceberg/tree/main/Resources/Chapter_10"
click node_ch11 "https://github.com/developer-advocacy-dremio/definitive-guide-to-apache-iceberg/tree/main/Resources/Chapter_11"
click node_ch12 "https://github.com/developer-advocacy-dremio/definitive-guide-to-apache-iceberg/tree/main/Resources/Chapter_12"
click node_ch13 "https://github.com/developer-advocacy-dremio/definitive-guide-to-apache-iceberg/tree/main/Resources/Chapter_13"
click node_ch14 "https://github.com/developer-advocacy-dremio/definitive-guide-to-apache-iceberg/tree/main/Resources/Chapter_14"
click node_ch15 "https://github.com/developer-advocacy-dremio/definitive-guide-to-apache-iceberg/tree/main/Resources/Chapter_15"
click node_misc "https://github.com/developer-advocacy-dremio/definitive-guide-to-apache-iceberg/tree/main/Resources/Misc"
click node_producer "https://github.com/developer-advocacy-dremio/definitive-guide-to-apache-iceberg/blob/main/Resources/Chapter_8/ProducerKinesis.py"

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_ch1,node_ch2,node_ch3,node_ch4,node_ch5 toneBlue
class node_ch6,node_ch7,node_ch8,node_ch9,node_ch10,node_producer toneAmber
class node_ch11,node_ch12,node_ch13,node_ch14,node_ch15,node_misc,node_weather toneMint
class node_reader,node_kinesis toneIndigo
class node_index toneTeal
```

## Components

### Chapters 1–5

- [Chapter 1](https://github.com/developer-advocacy-dremio/definitive-guide-to-apache-iceberg/tree/main/Resources/Chapter_1): `Resources/Chapter_1`
- [Chapter 2](https://github.com/developer-advocacy-dremio/definitive-guide-to-apache-iceberg/tree/main/Resources/Chapter_2): `Resources/Chapter_2`
- [Chapter 3](https://github.com/developer-advocacy-dremio/definitive-guide-to-apache-iceberg/tree/main/Resources/Chapter_3): `Resources/Chapter_3`
- [Chapter 4](https://github.com/developer-advocacy-dremio/definitive-guide-to-apache-iceberg/tree/main/Resources/Chapter_4): `Resources/Chapter_4`
- [Chapter 5](https://github.com/developer-advocacy-dremio/definitive-guide-to-apache-iceberg/tree/main/Resources/Chapter_5): `Resources/Chapter_5`

### Chapters 6–10

- [Chapter 6](https://github.com/developer-advocacy-dremio/definitive-guide-to-apache-iceberg/tree/main/Resources/Chapter_6): `Resources/Chapter_6`
- [Chapter 7](https://github.com/developer-advocacy-dremio/definitive-guide-to-apache-iceberg/tree/main/Resources/Chapter_7): `Resources/Chapter_7`
- [Chapter 8](https://github.com/developer-advocacy-dremio/definitive-guide-to-apache-iceberg/tree/main/Resources/Chapter_8): `Resources/Chapter_8`
- [Chapter 9](https://github.com/developer-advocacy-dremio/definitive-guide-to-apache-iceberg/tree/main/Resources/Chapter_9): `Resources/Chapter_9`
- [Chapter 10](https://github.com/developer-advocacy-dremio/definitive-guide-to-apache-iceberg/tree/main/Resources/Chapter_10): `Resources/Chapter_10`
- [Weather producer](https://github.com/developer-advocacy-dremio/definitive-guide-to-apache-iceberg/blob/main/Resources/Chapter_8/ProducerKinesis.py): `Resources/Chapter_8/ProducerKinesis.py`

### Chapters 11–15 and Misc

- [Chapter 11](https://github.com/developer-advocacy-dremio/definitive-guide-to-apache-iceberg/tree/main/Resources/Chapter_11): `Resources/Chapter_11`
- [Chapter 12](https://github.com/developer-advocacy-dremio/definitive-guide-to-apache-iceberg/tree/main/Resources/Chapter_12): `Resources/Chapter_12`
- [Chapter 13](https://github.com/developer-advocacy-dremio/definitive-guide-to-apache-iceberg/tree/main/Resources/Chapter_13): `Resources/Chapter_13`
- [Chapter 14](https://github.com/developer-advocacy-dremio/definitive-guide-to-apache-iceberg/tree/main/Resources/Chapter_14): `Resources/Chapter_14`
- [Chapter 15](https://github.com/developer-advocacy-dremio/definitive-guide-to-apache-iceberg/tree/main/Resources/Chapter_15): `Resources/Chapter_15`
- [Misc resources](https://github.com/developer-advocacy-dremio/definitive-guide-to-apache-iceberg/tree/main/Resources/Misc): `Resources/Misc`

### Other components

- **Reader**
- [Resource index](https://github.com/developer-advocacy-dremio/definitive-guide-to-apache-iceberg/blob/main/README.md): `README.md`
- **Weather API**
- **Kinesis stream**

## Connections

- Reader → Resource index: opens
- Resource index → Chapter 1: links to
- Resource index → Chapter 2: links to
- Resource index → Chapter 3: links to
- Resource index → Chapter 4: links to
- Resource index → Chapter 5: links to
- Resource index → Chapter 6: links to
- Resource index → Chapter 7: links to
- Resource index → Chapter 8: links to
- Resource index → Chapter 9: links to
- Resource index → Chapter 10: links to
- Resource index → Chapter 11: links to
- Resource index → Chapter 12: links to
- Resource index → Chapter 13: links to
- Resource index → Chapter 14: links to
- Resource index → Chapter 15: links to
- Resource index → Misc resources: links to
- Weather API → Weather producer: provides data
- Weather producer → Kinesis stream: publishes records