How influxdata/influxdb works
InfluxDB 3 Core is a time-series database for ingesting, transforming, storing, and querying event data. Its principal workflow accepts HTTP writes, buffers and persists data as Parquet, then serves SQL, InfluxQL, and FlightSQL queries. The README documents these product capabilities; the sampled excerpts and source index establish several internal modules and references, but do not expose the full write/query wiring. Dashed edges mark those unverified connections rather than asserting a call sequence.
Main entry points: query_executor.rs Query Executor · queryable_buffer.rs Queryable Write Buffer · http.rs HTTP Server · write Write APIs
Components 23
Client APIs
- HTTP Server
influxdb3_server/src/http.rs - Write APIs
core/iox_http/src/write - Query APIs
core/iox_v1_query_api/src/handler.rs - FlightSQL
core/flightsql/src/lib.rs
Write and Storage
- Line Protocol
core/influxdb_line_protocol/src/lib.rs - Queryable Write Buffer
influxdb3_write/src/write_buffer/queryable_buffer.rs - Table Buffer
influxdb3_write/src/write_buffer/table_buffer.rs - Write-Ahead Log
influxdb3_wal/src/lib.rs - Parquet Persister
influxdb3_write/src/persister.rs - Parquet Storage
core/parquet_file/src/storage.rs - Object Storage
Query Engine
- Query Executor
influxdb3_internal_api/src/query_executor.rs - Query Planner
influxdb3_query_executor/src/query_planner.rs - InfluxQL Planner
core/iox_query_influxql/src/frontend/planner.rs - Query Execution
core/iox_query/src/exec.rs - Physical Optimizers
core/iox_query/src/physical_optimizer/mod.rs - Chunk Deduplication
core/iox_query/src/provider/deduplicate.rs
Catalog and State
- Catalog
influxdb3_catalog/src/catalog/versions/v3/schema/storage.rs - Catalog Cache API
core/catalog_cache/src/api/server.rs
Plugins and Operations
- Python Processing Engine
influxdb3_processing_engine/src/manager.rs - System Tables
influxdb3_system_tables/src/lib.rs - Query Log
core/iox_query/src/query_log.rs
Other components
- Client
Connections 23
- Client → HTTP Server: sends requests
README.md - HTTP Server → Write APIs: routes writes
- Write APIs → Line Protocol: accepts line protocol
README.md - Write APIs → Queryable Write Buffer: submits writes
- Queryable Write Buffer → Table Buffer: uses buffers
influxdb3_write/src/write_buffer/queryable_buffer.rs - Queryable Write Buffer → Parquet Persister: persists chunks
influxdb3_write/src/write_buffer/queryable_buffer.rs - Queryable Write Buffer → Write-Ahead Log: records writes
- Parquet Persister → Parquet Storage: uploads Parquet
- Parquet Storage → Object Storage: reads and writes
core/parquet_file/src/storage.rs - Client → Query APIs: queries over HTTP
README.md - HTTP Server → Query APIs: routes queries
- Query APIs → Query Executor: dispatches queries
- Query Executor → Query Planner: plans queries
- Query Executor → InfluxQL Planner: handles InfluxQL
- Query Executor → Query Execution: executes plans
- Query Execution → Physical Optimizers: optimizes plans
core/iox_query/src/exec.rs - Query Execution → Chunk Deduplication: uses providers
- Client → FlightSQL: queries with FlightSQL
README.md - Query Executor → Query Log: tracks queries
core/iox_query/src/query_log.rs - Client → Catalog Cache API: uses cache API
- Python Processing Engine → Catalog: uses catalog state
- Client → Python Processing Engine: invokes plugins
README.md - Client → System Tables: queries system tables