Enum DbError 

#[non_exhaustive]
pub enum DbError {
    AlreadyExists,
    NotFound,
    WriterLockHeld,
    IdOverflow,
    TransactionIdOverflow,
    CommitSeqOverflow,
    DuplicateCatalogName,
    DuplicateId,
    UnknownElement {
        id: ElementId,
    },
    UnknownRelation {
        id: RelationId,
    },
    UnknownIncidence {
        id: IncidenceId,
    },
    UnknownRole {
        id: RoleId,
    },
    UnknownLabel {
        id: LabelId,
    },
    UnknownRelationType {
        id: RelationTypeId,
    },
    UnknownPropertyKey {
        id: PropertyKeyId,
    },
    UnknownProjection {
        id: ProjectionId,
    },
    UnknownIndex {
        id: IndexId,
    },
    PropertyTypeMismatch {
        expected: PropertyType,
        actual: PropertyType,
    },
    WrongPropertyFamily {
        expected: PropertyFamily,
        actual: PropertyFamily,
    },
    InvalidProjection {
        message: String,
    },
    EmptyQuery,
    UnsupportedQuery {
        message: String,
    },
    InvalidStore {
        message: String,
    },
    UnsupportedFormat {
        found: u32,
        expected: u32,
    },
    Io {
        operation: &'static str,
        source: Error,
    },
    Traversal {
        reason: &'static str,
    },
    LogCorrupt {
        lsn: u64,
        reason: &'static str,
    },
    BaseGenerationMismatch {
        expected: u64,
        found: u64,
    },
    UnknownName {
        kind: &'static str,
        name: String,
    },
    MissingProperty {
        key: PropertyKeyId,
    },
    SchemaConflict {
        name: String,
        reason: &'static str,
    },
    ValueOutOfRange,
    NoEqualityIndex {
        key: PropertyKeyId,
    },
}

Errors raised by the OxGraph database product.

Performance

Formatting is O(message length).

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

AlreadyExists

Db files already exist.

NotFound

Db files do not exist.

WriterLockHeld

The single-writer lock is already held by another writer.

IdOverflow

Canonical ID space is exhausted.

TransactionIdOverflow

Transaction ID space is exhausted.

CommitSeqOverflow

Commit sequence space is exhausted.

DuplicateCatalogName

Duplicate catalog name or ID.

DuplicateId

Duplicate canonical ID.

UnknownElement

Unknown element ID.

Fields

id: ElementId

Missing element ID.

UnknownRelation

Unknown relation ID.

Fields

id: RelationId

Missing relation ID.

UnknownIncidence

Unknown incidence ID.

Fields

id: IncidenceId

Missing incidence ID.

UnknownRole

Unknown role ID.

Fields

id: RoleId

Missing role ID.

UnknownLabel

Unknown label ID.

Fields

id: LabelId

Missing label ID.

UnknownRelationType

Unknown relation type ID.

Fields

id: RelationTypeId

Missing relation type ID.

UnknownPropertyKey

Unknown property key ID.

Fields

id: PropertyKeyId

Missing property key ID.

UnknownProjection

Unknown projection ID.

Fields

id: ProjectionId

Missing projection ID.

UnknownIndex

Unknown index ID.

Fields

id: IndexId

Missing index ID.

PropertyTypeMismatch

Property value type mismatched the catalog schema.

Fields

expected: PropertyType

Expected property type.

actual: PropertyType

Actual property type.

WrongPropertyFamily

Property subject family mismatched the catalog schema.

Fields

expected: PropertyFamily

Expected subject family.

actual: PropertyFamily

Actual subject family.

InvalidProjection

Projection cannot be materialized as requested.

Fields

message: String

Deterministic validation message.

EmptyQuery

Query text is empty.

UnsupportedQuery

Query text is outside the pinned profile.

Fields

message: String

Deterministic explanation.

InvalidStore

Storage bytes are invalid.

Fields

message: String

Deterministic validation message.

UnsupportedFormat

The store’s OXGDB format version is not supported by this build. A base written under an older format (for example one lacking the persisted SECTION_INDEX_* postings) is rejected here rather than silently rebuilt.

Fields

found: u32

Format version recorded in the store.

expected: u32

Format version this build requires.

Io

Wraps an IO error with operation context.

Fields

operation: &'static str

Operation that failed.

source: Error

Underlying IO error.

Traversal

A bounded traversal failed.

Fields

reason: &'static str

Deterministic reason the traversal failed.

LogCorrupt

A delta-log record is corrupt beyond the recoverable torn tail.

Fields

lsn: u64

Log sequence number of the offending record.

reason: &'static str

Deterministic reason the record was rejected.

BaseGenerationMismatch

A delta-log record names a different base generation than the superblock.

Fields

expected: u64

Base generation named by the superblock.

found: u64

Base generation found in the record.

UnknownName

A catalog name was not found in a bound schema.

Fields

kind: &'static str

The kind of catalog entry (for example "role" or "property key").

name: String

The name that was not found.

MissingProperty

A required property was absent from a subject.

Fields

key: PropertyKeyId

The property key that was required but absent.

SchemaConflict

A declared schema item conflicts with an existing catalog entry.

Fields

name: String

The conflicting catalog name.

reason: &'static str

Deterministic reason the declaration conflicts with the catalog.

ValueOutOfRange

A numeric value was outside the representable i64 range.

NoEqualityIndex

A property key has no associated equality index.

Fields

key: PropertyKeyId

The property key lacking an equality index.

Trait Implementations

impl Debug for DbError

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

Formats the value using the given formatter.

impl Display for DbError

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

Formats the value using the given formatter.

impl Error for DbError

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.