# dbt-labs/dbt-core architecture

> Architecture diagram of the GitHub repository dbt-labs/dbt-core, 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/dbt-labs/dbt-core
- Repository: https://github.com/dbt-labs/dbt-core

## Overview

dbt v2 is a Rust data-transformation product: analysts define SQL models, dbt parses and compiles projects, schedules and runs transformations against warehouses, and supports testing, lineage, and scalable project artifacts for local documentation. The graph includes the adapter execution path, warehouse metadata and relation handling, and time-machine recording/replay as an internal capability. README statements support the broad product workflow; source-index references and excerpts support only selected internal links, so unsampled subsystem connections are omitted.

Main entry points: [`crates/dbt-adapter/src/engine/adapter_engine.rs`](https://github.com/dbt-labs/dbt-core/blob/main/crates/dbt-adapter/src/engine/adapter_engine.rs) (SQL execution engine), [`crates/dbt-adapter/src/time_machine/engine.rs`](https://github.com/dbt-labs/dbt-core/blob/main/crates/dbt-adapter/src/time_machine/engine.rs) (Recording engine), [`crates/dbt-adapter/src/adapter/adapter_impl.rs`](https://github.com/dbt-labs/dbt-core/blob/main/crates/dbt-adapter/src/adapter/adapter_impl.rs) (Adapter implementation), [`crates/dbt-parser/src`](https://github.com/dbt-labs/dbt-core/tree/main/crates/dbt-parser/src) (Project parsing)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_project["Project workflow"]
  node_models["SQL models"]
  node_parser["Project parsing"]
  node_compiler["Compilation pipeline"]
  node_scheduler["Model scheduling<br/>[schedule.rs]"]
  node_quality["Transformation tests"]
  node_state["State service<br/>[service_client.rs]"]
  node_debug["Task debugging<br/>[debug.rs]"]
end

subgraph group_execution["Warehouse execution"]
  node_adapter["Adapter implementation<br/>[adapter_impl.rs]"]
  node_engine["SQL execution engine<br/>[adapter_engine.rs]"]
  node_warehouse[("Data warehouse")]
  node_metadata["Warehouse metadata"]
end

subgraph group_artifacts["Project insights"]
  node_artifacts["Project artifacts"]
  node_docs["Local documentation<br/>[server.rs]"]
end

subgraph group_adapter_internals["Adapter internals"]
  node_relations["Relations and configs"]
  node_sql_types["SQL type conversion<br/>[sql_types.rs]"]
  node_record_batches["Record batches<br/>[record_batch.rs]"]
  node_query_cache["Query cache<br/>[cache.rs]"]
end

subgraph group_replay["Time machine"]
  node_time_machine["Recording engine<br/>[engine.rs]"]
  node_events["Call events<br/>[event.rs]"]
  node_recorder["Event recorder<br/>[event_recorder.rs]"]
  node_replayer["Event replay<br/>[event_replay.rs]"]
  node_semantics["Event semantics<br/>[semantic.rs]"]
  node_serialization["Event serialization"]
  node_validation["Replay validation<br/>[validation.rs]"]
end

node_analyst(("Analyst"))

node_analyst -->|"writes"| node_models
node_models -->|"defines project"| node_parser
node_parser -.->|"feeds compilation"| node_compiler
node_compiler -.->|"schedules models"| node_scheduler
node_scheduler -.->|"runs transformations"| node_adapter
node_adapter -.->|"executes SQL"| node_engine
node_engine -->|"queries"| node_warehouse
node_metadata -->|"executes probes"| node_engine
node_adapter -.->|"uses relations"| node_relations
node_engine -->|"processes batches"| node_record_batches
node_engine -->|"uses cache"| node_query_cache
node_engine -->|"uses type mappings"| node_sql_types
node_models -->|"assures quality"| node_quality
node_parser -.->|"produces artifacts"| node_artifacts
node_artifacts -->|"powers documentation"| node_docs
node_adapter -.->|"records or replays"| node_time_machine
node_time_machine -->|"records calls"| node_recorder
node_time_machine -->|"replays calls"| node_replayer
node_recorder -->|"creates events"| node_events
node_replayer -->|"matches events"| node_events
node_events -->|"uses semantics"| node_semantics
node_recorder -->|"uses semantics"| node_semantics
node_time_machine -->|"validates replay"| node_validation
node_time_machine -->|"serializes arguments"| node_serialization
node_scheduler -.->|"uses prior state"| node_state
node_compiler -->|"uses debugging"| node_debug

click node_parser "https://github.com/dbt-labs/dbt-core/tree/main/crates/dbt-parser/src"
click node_compiler "https://github.com/dbt-labs/dbt-core/blob/main/crates/dbt-tasks-sa/src/compilation_pipeline.rs"
click node_scheduler "https://github.com/dbt-labs/dbt-core/blob/main/crates/dbt-compilation/src/schedule.rs"
click node_quality "https://github.com/dbt-labs/dbt-core/tree/main/crates/dbt-tasks-core/src"
click node_adapter "https://github.com/dbt-labs/dbt-core/blob/main/crates/dbt-adapter/src/adapter/adapter_impl.rs"
click node_engine "https://github.com/dbt-labs/dbt-core/blob/main/crates/dbt-adapter/src/engine/adapter_engine.rs"
click node_metadata "https://github.com/dbt-labs/dbt-core/tree/main/crates/dbt-adapter/src/metadata"
click node_relations "https://github.com/dbt-labs/dbt-core/tree/main/crates/dbt-adapter/src/relation"
click node_sql_types "https://github.com/dbt-labs/dbt-core/blob/main/crates/dbt-adapter/src/sql_types.rs"
click node_record_batches "https://github.com/dbt-labs/dbt-core/blob/main/crates/dbt-adapter/src/record_batch.rs"
click node_query_cache "https://github.com/dbt-labs/dbt-core/blob/main/crates/dbt-adapter/src/cache.rs"
click node_artifacts "https://github.com/dbt-labs/dbt-core/tree/main/crates/dbt-schemas/src/schemas"
click node_docs "https://github.com/dbt-labs/dbt-core/blob/main/crates/dbt-docs-server/src/server.rs"
click node_time_machine "https://github.com/dbt-labs/dbt-core/blob/main/crates/dbt-adapter/src/time_machine/engine.rs"
click node_events "https://github.com/dbt-labs/dbt-core/blob/main/crates/dbt-adapter/src/time_machine/event.rs"
click node_recorder "https://github.com/dbt-labs/dbt-core/blob/main/crates/dbt-adapter/src/time_machine/event_recorder.rs"
click node_replayer "https://github.com/dbt-labs/dbt-core/blob/main/crates/dbt-adapter/src/time_machine/event_replay.rs"
click node_semantics "https://github.com/dbt-labs/dbt-core/blob/main/crates/dbt-adapter/src/time_machine/semantic.rs"
click node_serialization "https://github.com/dbt-labs/dbt-core/blob/main/crates/dbt-adapter/src/time_machine/serializable_impls.rs"
click node_validation "https://github.com/dbt-labs/dbt-core/blob/main/crates/dbt-adapter/src/time_machine/validation.rs"
click node_state "https://github.com/dbt-labs/dbt-core/blob/main/crates/dbt-state/src/service_client.rs"
click node_debug "https://github.com/dbt-labs/dbt-core/blob/main/crates/dbt-tasks-sa/src/debug.rs"

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_models,node_parser,node_compiler,node_scheduler,node_quality,node_state,node_debug toneBlue
class node_adapter,node_engine,node_warehouse,node_metadata toneAmber
class node_artifacts,node_docs toneMint
class node_relations,node_sql_types,node_record_batches,node_query_cache toneRose
class node_time_machine,node_events,node_recorder,node_replayer,node_semantics,node_serialization,node_validation,node_analyst toneIndigo
```

## Components

### Project workflow

- **SQL models**
- [Project parsing](https://github.com/dbt-labs/dbt-core/tree/main/crates/dbt-parser/src): `crates/dbt-parser/src`
- [Compilation pipeline](https://github.com/dbt-labs/dbt-core/blob/main/crates/dbt-tasks-sa/src/compilation_pipeline.rs): `crates/dbt-tasks-sa/src/compilation_pipeline.rs`
- [Model scheduling](https://github.com/dbt-labs/dbt-core/blob/main/crates/dbt-compilation/src/schedule.rs): `crates/dbt-compilation/src/schedule.rs`
- [Transformation tests](https://github.com/dbt-labs/dbt-core/tree/main/crates/dbt-tasks-core/src): `crates/dbt-tasks-core/src`
- [State service](https://github.com/dbt-labs/dbt-core/blob/main/crates/dbt-state/src/service_client.rs): `crates/dbt-state/src/service_client.rs`
- [Task debugging](https://github.com/dbt-labs/dbt-core/blob/main/crates/dbt-tasks-sa/src/debug.rs): `crates/dbt-tasks-sa/src/debug.rs`

### Warehouse execution

- [Adapter implementation](https://github.com/dbt-labs/dbt-core/blob/main/crates/dbt-adapter/src/adapter/adapter_impl.rs): `crates/dbt-adapter/src/adapter/adapter_impl.rs`
- [SQL execution engine](https://github.com/dbt-labs/dbt-core/blob/main/crates/dbt-adapter/src/engine/adapter_engine.rs): `crates/dbt-adapter/src/engine/adapter_engine.rs`
- **Data warehouse**
- [Warehouse metadata](https://github.com/dbt-labs/dbt-core/tree/main/crates/dbt-adapter/src/metadata): `crates/dbt-adapter/src/metadata`

### Project insights

- [Project artifacts](https://github.com/dbt-labs/dbt-core/tree/main/crates/dbt-schemas/src/schemas): `crates/dbt-schemas/src/schemas`
- [Local documentation](https://github.com/dbt-labs/dbt-core/blob/main/crates/dbt-docs-server/src/server.rs): `crates/dbt-docs-server/src/server.rs`

### Adapter internals

- [Relations and configs](https://github.com/dbt-labs/dbt-core/tree/main/crates/dbt-adapter/src/relation): `crates/dbt-adapter/src/relation`
- [SQL type conversion](https://github.com/dbt-labs/dbt-core/blob/main/crates/dbt-adapter/src/sql_types.rs): `crates/dbt-adapter/src/sql_types.rs`
- [Record batches](https://github.com/dbt-labs/dbt-core/blob/main/crates/dbt-adapter/src/record_batch.rs): `crates/dbt-adapter/src/record_batch.rs`
- [Query cache](https://github.com/dbt-labs/dbt-core/blob/main/crates/dbt-adapter/src/cache.rs): `crates/dbt-adapter/src/cache.rs`

### Time machine

- [Recording engine](https://github.com/dbt-labs/dbt-core/blob/main/crates/dbt-adapter/src/time_machine/engine.rs): `crates/dbt-adapter/src/time_machine/engine.rs`
- [Call events](https://github.com/dbt-labs/dbt-core/blob/main/crates/dbt-adapter/src/time_machine/event.rs): `crates/dbt-adapter/src/time_machine/event.rs`
- [Event recorder](https://github.com/dbt-labs/dbt-core/blob/main/crates/dbt-adapter/src/time_machine/event_recorder.rs): `crates/dbt-adapter/src/time_machine/event_recorder.rs`
- [Event replay](https://github.com/dbt-labs/dbt-core/blob/main/crates/dbt-adapter/src/time_machine/event_replay.rs): `crates/dbt-adapter/src/time_machine/event_replay.rs`
- [Event semantics](https://github.com/dbt-labs/dbt-core/blob/main/crates/dbt-adapter/src/time_machine/semantic.rs): `crates/dbt-adapter/src/time_machine/semantic.rs`
- [Event serialization](https://github.com/dbt-labs/dbt-core/blob/main/crates/dbt-adapter/src/time_machine/serializable_impls.rs): `crates/dbt-adapter/src/time_machine/serializable_impls.rs`
- [Replay validation](https://github.com/dbt-labs/dbt-core/blob/main/crates/dbt-adapter/src/time_machine/validation.rs): `crates/dbt-adapter/src/time_machine/validation.rs`

### Other components

- **Analyst**

## Connections

- Analyst → SQL models: writes (evidence: `README.md`)
- SQL models → Project parsing: defines project (evidence: `README.md`)
- Project parsing → Compilation pipeline: feeds compilation
- Compilation pipeline → Model scheduling: schedules models
- Model scheduling → Adapter implementation: runs transformations
- Adapter implementation → SQL execution engine: executes SQL
- SQL execution engine → Data warehouse: queries (evidence: `crates/dbt-adapter/src/engine/adapter_engine.rs`)
- Warehouse metadata → SQL execution engine: executes probes (evidence: `crates/dbt-adapter/src/metadata/clickhouse/mod.rs`)
- Adapter implementation → Relations and configs: uses relations
- SQL execution engine → Record batches: processes batches (evidence: `crates/dbt-adapter/src/engine/adapter_engine.rs`)
- SQL execution engine → Query cache: uses cache (evidence: `crates/dbt-adapter/src/engine/adapter_engine.rs`)
- SQL execution engine → SQL type conversion: uses type mappings (evidence: `crates/dbt-adapter/src/engine/adapter_engine.rs`)
- SQL models → Transformation tests: assures quality (evidence: `README.md`)
- Project parsing → Project artifacts: produces artifacts
- Project artifacts → Local documentation: powers documentation (evidence: `README.md`)
- Adapter implementation → Recording engine: records or replays
- Recording engine → Event recorder: records calls (evidence: `crates/dbt-adapter/src/time_machine/engine.rs`)
- Recording engine → Event replay: replays calls (evidence: `crates/dbt-adapter/src/time_machine/engine.rs`)
- Event recorder → Call events: creates events (evidence: `crates/dbt-adapter/src/time_machine/event_recorder.rs`)
- Event replay → Call events: matches events
- Call events → Event semantics: uses semantics (evidence: `crates/dbt-adapter/src/time_machine/event.rs`)
- Event recorder → Event semantics: uses semantics (evidence: `crates/dbt-adapter/src/time_machine/event_recorder.rs`)
- Recording engine → Replay validation: validates replay (evidence: `crates/dbt-adapter/src/time_machine/engine.rs`)
- Recording engine → Event serialization: serializes arguments (evidence: `crates/dbt-adapter/src/time_machine/engine.rs`)
- Model scheduling → State service: uses prior state
- Compilation pipeline → Task debugging: uses debugging (evidence: `crates/dbt-tasks-sa/src/compilation_pipeline.rs`)
