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 |
Codes within the LDB-1xxx through LDB-3xxx ranges are defined in
laminar-sql::error::codes (the SQL layer) and are re-exported here
for reference. This module is the canonical registry for all other ranges.
Enums§
- HotPath
Error - Ring 0 error — no heap allocation, no formatting on construction.
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.
- 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.
- 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 (canonical:
laminar_sql::error::codes::UNSUPPORTED_SQL). - 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.