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.
- CLUSTER_
STATE_ LIFECYCLE_ UNSUPPORTED - A cluster query shape has no vnode-keyed checkpoint and rebalance lifecycle.
- 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.
- DELIVERY_
STATE_ DURABILITY_ MISMATCH - Delivery requires a stronger state/checkpoint durability scope.
- 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_ PROTOCOL_ INCOMPLETE - The configured exactly-once source/sink protocol is incomplete.
- EXACTLY_
ONCE_ SINK_ UNSUPPORTED - Exactly-once requires all sinks to support exactly-once semantics.
- EXACTLY_
ONCE_ SOURCE_ UNCERTIFIED - A replayable source has not passed production exactly-once certification.
- 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.
- MANAGED_
STATE_ BUDGET_ EXCEEDED - Managed operator state exceeded the configured pipeline working-state budget.
- 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.
- 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_
CHECKPOINT_ REQUIRED - A source requires checkpointing to release upstream progress or resources.
- SOURCE_
MUTATION_ NOT_ ADMITTED - A mutation source cannot yet enter the canonical changelog path.
- SOURCE_
NOT_ FOUND - Source not found.
- SOURCE_
PRIMARY_ KEY_ REQUIRED - A keyed-upsert source has no declared relational key.
- 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.
- SUBSCRIPTION_
ASSIGNMENT_ CHANGED - Assignment authority changed during a subscription operation.
- SUBSCRIPTION_
BACKEND_ UNAVAILABLE - The committed subscription backend is unavailable.
- SUBSCRIPTION_
CONFLICTING_ DUPLICATE - One frame identity names conflicting immutable content.
- SUBSCRIPTION_
EPOCH_ NOT_ COMMITTED - Requested subscription checkpoint has not committed.
- SUBSCRIPTION_
GENERATION_ MISMATCH - Subscription history belongs to another stream incarnation.
- SUBSCRIPTION_
LAGGED - A bounded subscriber queue was overrun.
- SUBSCRIPTION_
MANIFEST_ CORRUPT - Authoritative subscription manifest failed validation.
- SUBSCRIPTION_
PLAN_ UNSUPPORTED - The final operator has no planner-certified subscription distribution.
- SUBSCRIPTION_
PROTOCOL_ UNSUPPORTED - Subscription wire or segment protocol is unsupported.
- SUBSCRIPTION_
REPLAY_ PRUNED - Requested subscription checkpoint is older than retained history.
- SUBSCRIPTION_
RESUME_ TOKEN_ EXPIRED - A subscription resume token has expired.
- SUBSCRIPTION_
RESUME_ TOKEN_ INVALID - A subscription resume token is malformed or fails authentication.
- SUBSCRIPTION_
RETENTION_ LOST - Required committed history disappeared outside the retention contract.
- SUBSCRIPTION_
SCHEMA_ MISMATCH - Subscription output schema differs from its durable certificate.
- SUBSCRIPTION_
SEGMENT_ CORRUPT - A committed subscription segment failed integrity validation.
- SUBSCRIPTION_
SEGMENT_ MISSING - A committed subscription segment is unavailable.
- SUBSCRIPTION_
SEQUENCE_ GAP - A committed partition sequence has a gap.
- SUBSCRIPTION_
STALE_ WRITER - An output writer no longer owns its certified partition.
- 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.