Expand description
Structured error code registry (LDB-NNNN) and Ring 0 hot path error type.
LaminarDB structured error code registry.
Every error in LaminarDB carries a stable LDB-NNNN code that is:
- Present in the error message (grep-able in logs)
- Present in the source code (grep-able in code)
- Stable across versions (codes are never reused)
§Code Ranges
| Range | Category |
|---|---|
LDB-0xxx | General / configuration |
LDB-1xxx | SQL parsing & validation |
LDB-2xxx | Window / watermark operations |
LDB-3xxx | Join operations |
LDB-4xxx | Serialization / state |
LDB-5xxx | Connector / I/O |
LDB-6xxx | Checkpoint / recovery |
LDB-7xxx | DataFusion / Arrow interop |
LDB-8xxx | Internal / should-not-happen |
This module is the canonical registry for all error code ranges.
Downstream crates (laminar-sql, laminar-db, etc.) re-export from here.
Enums§
- HotPath
Error - Ring 0 error — no heap allocation, no formatting on construction.
- Warning
Severity - Severity level for warnings (schema inference, recovery, etc.).
Constants§
- ARROW_
ERROR - Arrow schema or record batch error.
- BASE64_
DECODE_ ERROR - Base64 decode error (inline checkpoint state).
- CHECKPOINT_
FAILED - Checkpoint creation failed.
- CHECKPOINT_
NOT_ FOUND - Checkpoint not found.
- CHECKPOINT_
PRUNE_ FAILED - Checkpoint prune (old checkpoint cleanup) failed.
- CONNECTOR_
AUTH_ FAILED - Connector authentication failed.
- CONNECTOR_
CONFIG_ ERROR - Connector configuration error.
- CONNECTOR_
CONNECTION_ FAILED - Connector failed to establish a connection.
- CONNECTOR_
READ_ ERROR - Connector read error.
- CONNECTOR_
SCHEMA_ ERROR - Schema inference or compatibility error.
- CONNECTOR_
SERDE_ ERROR - Connector serde (serialization/deserialization) error.
- CONNECTOR_
WRITE_ ERROR - Connector write error.
- DESERIALIZATION_
FAILED - State deserialization failed for an operator.
- DURABILITY_
GATE_ BACKEND_ ERROR - State backend returned an error during the durability gate (backend unreachable, permission denied). Treated as a gate miss; sinks rolled back and the next checkpoint retries.
- DURABILITY_
GATE_ MISS - State durability gate returned false before sink commit. One or more vnodes had not persisted their partials for the epoch. The coordinator rolls back sinks and retries on the next checkpoint.
- DURABILITY_
GATE_ ROLLBACK_ FAILED - Sink rollback failed after a durability-gate miss. Sinks may be in an
inconsistent state; recovery uses
sink_commit_statusesto resolve. - DURABILITY_
GATE_ ROLLBACK_ ON_ ERROR_ FAILED - Sink rollback failed after a durability-gate backend error.
- EXACTLY_
ONCE_ NON_ REPLAYABLE - Exactly-once requires all sources to support replay.
- EXACTLY_
ONCE_ NO_ CHECKPOINT - Exactly-once requires checkpointing to be enabled.
- EXACTLY_
ONCE_ SINK_ UNSUPPORTED - Exactly-once requires all sinks to support exactly-once semantics.
- INTERNAL
- Internal error — this is a bug.
- INVALID_
CONFIG - Invalid configuration value.
- INVALID_
OPERATION - Invalid operation for the current state.
- JOIN_
KEY_ MISSING - Join key column not found or invalid.
- JOIN_
TIME_ BOUND_ MISSING - Time bound required for stream-stream join.
- JOIN_
TYPE_ UNSUPPORTED - Unsupported join type for streaming queries.
- JSON_
PARSE_ ERROR - JSON parse error (connector config, CDC payload, etc.).
- LATE_
DATA_ REJECTED - Late data rejected by window policy.
- MANIFEST_
PERSIST_ FAILED - Checkpoint manifest persistence failed.
- MATERIALIZED_
VIEW_ ERROR - Materialized view error.
- MISSING_
CONFIG - Missing required configuration key.
- MIXED_
DELIVERY_ CAPABILITIES - Mixed delivery capabilities — some sources are non-replayable.
- NO_
COMPILED_ PROJECTION - No compiled projection or cached plan for pre-aggregation query.
- OFFSET_
METADATA_ MISSING - Source offset metadata missing during recovery.
- PIPELINE_
ERROR - Pipeline error (start/shutdown lifecycle).
- PLAN_
OPTIMIZATION_ FAILED DataFusionplan optimization failed.- QUERY_
EXECUTION_ FAILED - Query execution failed (
DataFusionengine error). Note: the SQL layer usesLDB-9001for execution failures visible to users;LDB-7001is for internalDataFusioninterop issues. - QUERY_
PIPELINE_ ERROR - Query pipeline error (stream execution context).
- RECOVERY_
FAILED - Checkpoint recovery failed.
- SCHEMA_
MISMATCH - Schema mismatch between Rust type and SQL definition.
- SERIALIZATION_
FAILED - State serialization failed for an operator.
- SHUTDOWN
- Database is shut down.
- SIDECAR_
CORRUPTION - Sidecar state data missing or corrupted.
- SINK_
ALREADY_ EXISTS - Sink already exists.
- SINK_
NOT_ FOUND - Sink not found.
- SINK_
ROLLBACK_ FAILED - Sink rollback failed during checkpoint abort.
- SOURCE_
ALREADY_ EXISTS - Source already exists.
- SOURCE_
NOT_ FOUND - Source not found.
- SQL_
COLUMN_ NOT_ FOUND - Column not found.
- SQL_
PLANNING_ FAILED - Query planning failed.
- SQL_
TABLE_ NOT_ FOUND - Table or source not found.
- SQL_
TYPE_ MISMATCH - Type mismatch.
- SQL_
UNSUPPORTED - Unsupported SQL syntax.
- STATE_
CORRUPTION - State corruption detected (checksum mismatch, invalid data).
- STATE_
KEY_ MISSING - State store key not found.
- TEMPORAL_
JOIN_ NO_ PK - Temporal join requires a primary key on the right-side table.
- UNRESOLVED_
CONFIG_ VAR - Unresolved config variable (e.g.
${VAR}placeholder). - WAL_
CHECKSUM_ MISMATCH - WAL checksum mismatch.
- WAL_
ERROR - WAL (write-ahead log) error.
- WAL_
INVALID_ LENGTH - WAL entry has invalid length (possible corruption).
- WATERMARK_
REQUIRED - Watermark required for this operation.
- WINDOW_
INVALID - Invalid window specification.
- WINDOW_
SIZE_ INVALID - Window size must be positive.