Struct NodeDbError 

pub struct NodeDbError { /* private fields */ }

Public error type returned by all NodeDb trait methods.

Separates machine-readable data (ErrorCode + ErrorDetails) from the human-readable message. Optional cause preserves the error chain.

Implementations

impl NodeDbError

pub fn mirror_read_only(database: impl Into<String>) -> NodeDbError

Write was rejected because the target database is an un-promoted mirror.

The mirror is read-only until ALTER DATABASE <name> PROMOTE is issued.

pub fn stale_read_not_leader( database: impl Into<String>, source_cluster: impl Into<String>, ) -> NodeDbError

Strong-consistency read was requested on a mirror database.

Mirrors cannot serve strong reads; the client should redirect to source_cluster.

pub fn mirror_not_promoted(database: impl Into<String>) -> NodeDbError

Operation requires the database to already be a promoted mirror.

impl NodeDbError

pub fn move_tenant_drain_timeout( tenant: impl Into<String>, source_db: impl Into<String>, ) -> NodeDbError

Drain phase timed out; the tenant’s sessions on source could not be cleanly wound down within the bounded window. The source is left unmodified; no data was moved.

pub fn move_tenant_preflight_failed( tenant: impl Into<String>, detail: impl Into<String>, ) -> NodeDbError

Pre-flight schema-compatibility check failed. No state was mutated.

pub fn move_tenant_snapshot_failed( tenant: impl Into<String>, detail: impl Into<String>, ) -> NodeDbError

Snapshot phase failed; partial snapshot has been cleaned up. Source is unmodified.

pub fn move_tenant_cutover_failed( tenant: impl Into<String>, detail: impl Into<String>, ) -> NodeDbError

Cutover Raft proposal failed. The source database still holds the tenant’s data; no partial state was left.

pub fn move_tenant_already_at_target( tenant: impl Into<String>, target_db: impl Into<String>, ) -> NodeDbError

The tenant’s data is already in the target database; this is the idempotent response when a previously completed MOVE TENANT is re-issued.

impl NodeDbError

pub fn collection_not_found(collection: impl Into<String>) -> NodeDbError

pub fn collection_draining(collection: impl Into<String>) -> NodeDbError

Collection is mid-purge; new scans are refused until the purge ack. Distinct from collection_not_found so clients can differentiate “try again in a moment” from “does not exist”.

pub fn collection_deactivated( collection: impl Into<String>, retention_expires_at_ns: u64, ) -> NodeDbError

Collection is soft-deleted (retention window active). Distinct from collection_not_found so clients can surface the UNDROP COLLECTION <name> hint instead of “does not exist”.

pub fn document_not_found( collection: impl Into<String>, document_id: impl Into<String>, ) -> NodeDbError

pub fn plan_error(detail: impl Display) -> NodeDbError

pub fn plan_error_at( phase: impl Into<String>, detail: impl Into<String>, ) -> NodeDbError

pub fn fan_out_exceeded(shards_touched: u16, limit: u16) -> NodeDbError

pub fn sql_not_enabled() -> NodeDbError

pub fn authorization_denied(resource: impl Into<String>) -> NodeDbError

pub fn auth_expired(detail: impl Display) -> NodeDbError

pub fn tenant_vector_dim_exceeded(dim: u32, limit: u32) -> NodeDbError

Vector insert or index rejected: vector dim exceeds tenant’s max_vector_dim quota.

pub fn tenant_graph_depth_exceeded(depth: u32, limit: u32) -> NodeDbError

Graph traversal rejected: requested depth exceeds tenant’s max_graph_depth quota.

pub fn clone_depth_exceeded(depth: u32, limit: u32) -> NodeDbError

CLONE DATABASE rejected: the clone chain is already at depth levels, which equals or exceeds MAX_CLONE_DEPTH (8).

pub fn cannot_clone_mirror(database: impl Into<String>) -> NodeDbError

CLONE DATABASE rejected: the source database is a mirror and cannot be cloned until it is promoted to a writable primary.

pub fn clone_dependency( source: impl Into<String>, dependents: Vec<String>, ) -> NodeDbError

DROP DATABASE rejected: one or more databases are cloned from this source. dependents lists the dependent database names.

pub fn clone_predates_query_time( as_of_lsn: u64, created_at_lsn: u64, ) -> NodeDbError

Bitemporal AS OF query predates the clone’s creation LSN; the clone did not exist at that point in time.

impl NodeDbError

pub fn handshake_failed( code: HelloErrorCode, message: impl Display, ) -> NodeDbError

Build a HandshakeFailed error from a HelloErrorCode and the server’s diagnostic message.

pub fn sync_connection_failed(detail: impl Display) -> NodeDbError

pub fn sync_delta_rejected( reason: impl Display, compensation: Option<CompensationHint>, ) -> NodeDbError

pub fn shape_subscription_failed( shape_id: impl Into<String>, detail: impl Display, ) -> NodeDbError

pub fn storage(detail: impl Display) -> NodeDbError

pub fn storage_op( component: impl Into<String>, op: impl Into<String>, detail: impl Into<String>, ) -> NodeDbError

pub fn segment_corrupted(detail: impl Display) -> NodeDbError

pub fn segment_corrupted_at( segment_id: u64, corruption: impl Into<String>, detail: impl Into<String>, ) -> NodeDbError

pub fn cold_storage(detail: impl Display) -> NodeDbError

pub fn cold_storage_op( backend: impl Into<String>, op: impl Into<String>, detail: impl Into<String>, ) -> NodeDbError

pub fn wal(detail: impl Display) -> NodeDbError

pub fn wal_at( stage: impl Into<String>, detail: impl Into<String>, ) -> NodeDbError

pub fn serialization( format: impl Into<String>, detail: impl Display, ) -> NodeDbError

pub fn codec(detail: impl Display) -> NodeDbError

pub fn codec_at( codec: impl Into<String>, op: impl Into<String>, detail: impl Into<String>, ) -> NodeDbError

pub fn config(detail: impl Display) -> NodeDbError

pub fn bad_request(detail: impl Display) -> NodeDbError

pub fn no_leader(detail: impl Display) -> NodeDbError

pub fn not_leader(leader_addr: impl Into<String>) -> NodeDbError

pub fn migration_in_progress(detail: impl Display) -> NodeDbError

pub fn node_unreachable(detail: impl Display) -> NodeDbError

pub fn cluster(detail: impl Display) -> NodeDbError

pub fn memory_exhausted(engine: impl Into<String>) -> NodeDbError

pub fn encryption(detail: impl Display) -> NodeDbError

pub fn encryption_at( cipher: impl Into<String>, detail: impl Into<String>, ) -> NodeDbError

pub fn array(array: impl Into<String>, detail: impl Display) -> NodeDbError

pub fn quota_overcommit( field: impl Into<String>, detail: impl Display, ) -> NodeDbError

Sum of database or tenant quotas would exceed the configured ceiling.

pub fn quota_exceeded( scope: impl Into<String>, detail: impl Display, ) -> NodeDbError

Request rejected because a tenant or database quota is exhausted.

pub fn server_overload(detail: impl Display) -> NodeDbError

Global resource pressure; server cannot accept the request.

pub fn bridge(detail: impl Display) -> NodeDbError

pub fn bridge_op( plane: impl Into<String>, op: impl Into<String>, detail: impl Into<String>, ) -> NodeDbError

pub fn dispatch(detail: impl Display) -> NodeDbError

pub fn dispatch_at( stage: impl Into<String>, detail: impl Into<String>, ) -> NodeDbError

pub fn internal(detail: impl Display) -> NodeDbError

pub fn internal_at( component: impl Into<String>, detail: impl Into<String>, ) -> NodeDbError

impl NodeDbError

pub fn constraint_violation( collection: impl Into<String>, detail: impl Display, ) -> NodeDbError

pub fn write_conflict( collection: impl Into<String>, document_id: impl Into<String>, ) -> NodeDbError

pub fn deadline_exceeded() -> NodeDbError

pub fn prevalidation_rejected( constraint: impl Into<String>, reason: impl Display, ) -> NodeDbError

pub fn append_only_violation( collection: impl Into<String>, detail: impl Display, ) -> NodeDbError

pub fn balance_violation( collection: impl Into<String>, detail: impl Display, ) -> NodeDbError

pub fn period_locked( collection: impl Into<String>, detail: impl Display, ) -> NodeDbError

pub fn state_transition_violation( collection: impl Into<String>, detail: impl Display, ) -> NodeDbError

pub fn transition_check_violation( collection: impl Into<String>, detail: impl Display, ) -> NodeDbError

pub fn type_guard_violation( collection: impl Into<String>, detail: impl Display, ) -> NodeDbError

pub fn retention_violation( collection: impl Into<String>, detail: impl Display, ) -> NodeDbError

pub fn legal_hold_active( collection: impl Into<String>, detail: impl Display, ) -> NodeDbError

pub fn type_mismatch( collection: impl Into<String>, detail: impl Display, ) -> NodeDbError

pub fn overflow( collection: impl Into<String>, detail: impl Display, ) -> NodeDbError

pub fn insufficient_balance( collection: impl Into<String>, detail: impl Display, ) -> NodeDbError

pub fn rate_exceeded( gate: impl Into<String>, detail: impl Display, ) -> NodeDbError

impl NodeDbError

pub fn code(&self) -> ErrorCode

The stable numeric error code.

pub fn message(&self) -> &str

Human-readable error message.

pub fn details(&self) -> &ErrorDetails

Machine-matchable error details.

pub fn cause(&self) -> Option<&NodeDbError>

The chained cause, if any.

pub fn with_cause(self, cause: NodeDbError) -> NodeDbError

Attach a cause to this error.

pub fn is_retriable(&self) -> bool

Whether this error is retriable by the client.

pub fn is_client_error(&self) -> bool

Whether this error indicates the client sent invalid input.

impl NodeDbError

pub fn is_constraint_violation(&self) -> bool

pub fn is_not_found(&self) -> bool

pub fn is_auth_denied(&self) -> bool

pub fn is_storage(&self) -> bool

pub fn is_internal(&self) -> bool

pub fn is_type_mismatch(&self) -> bool

pub fn is_type_guard_violation(&self) -> bool

pub fn is_overflow(&self) -> bool

pub fn is_insufficient_balance(&self) -> bool

pub fn is_rate_exceeded(&self) -> bool

pub fn is_cluster(&self) -> bool

Trait Implementations

impl Clone for NodeDbError

fn clone(&self) -> NodeDbError

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for NodeDbError

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for NodeDbError

fn deserialize<__D>( __deserializer: __D, ) -> Result<NodeDbError, <__D as Deserializer<'de>>::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for NodeDbError

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.

impl Error for NodeDbError

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0:

use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type-based access to context intended for error reports.

impl From<Error> for NodeDbError

fn from(e: Error) -> NodeDbError

Converts to this type from the input type.

impl From<NdbDateTimeError> for NodeDbError

fn from(e: NdbDateTimeError) -> NodeDbError

Converts to this type from the input type.

impl Serialize for NodeDbError

fn serialize<__S>( &self, __serializer: __S, ) -> Result<<__S as Serializer>::Ok, <__S as Serializer>::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.