Architecture
High-level server and client design.
less than a minute
Core Components
swanlake-server: binary crate that boots and serves Flight SQL.swanlake-core: shared runtime, config, SQL handlers, session management, metrics.swanlake-client: Rust client library and CLI.
Request Flow
- A Flight SQL client connects over gRPC.
- SwanLake resolves/creates a session.
- Statements execute through DuckDB with configured extensions.
- Results stream back as Arrow data.
Session Model
SwanLake sessions are connection-affine and own server-side state. For parallelism, clients use multiple gRPC connections via pool abstractions.
Operational Surface
- Metrics and status page for runtime visibility
- Config via environment variables and
.env - Optional background maintenance checkpointing for DuckLake databases
Feedback
Was this page helpful?
Thanks. Please open an issue with details.
Please open an issue so we can improve this page.