2.3.19.1 NdbError Types

2.3.19.1.1 The NdbError::Classification Type
2.3.19.1.2 The NdbError::Status Type

Abstract

This section discusses the Status and Classification data types defined by NdbError.

2.3.19.1.1 The NdbError::Classification Type

Description.  This type describes the type of error, or the logical group to which it belongs.

Enumeration values.  Possible values are shown, along with descriptions, in the following table:

ValueDescription
NoErrorIndicates success (no error occurred)
ApplicationErrorAn error occurred in an application program
NoDataFoundA read operation failed due to one or more missing records.
ConstraintViolationA constraint violation occurred, such as attempting to insert a tuple having a primary key value already in use in the target table.
SchemaErrorAn error took place when trying to create or use a table.
InsufficientSpaceThere was insufficient memory for data or indexes.
TemporaryResourceErrorThis type of error is typically encountered when there are too many active transactions.
NodeRecoveryErrorThis is a temporary failure which was likely caused by a node recovery in progress, some examples being when information sent between an application and NDB is lost, or when there is a distribution change.
OverloadErrorThis type of error is often caused when there is insufficient logfile space.
TimeoutExpiredA timeout, often caused by a deadlock.
UnknownResultErrorIt is not known whether a transaction was committed.
InternalErrorA serious error has occurred in NDB itself.
FunctionNotImplementedThe application attempted to use a function which is not yet implemented.
UnknownErrorCodeThis is seen where the NDB error handler cannot determine the correct error code to report.
NodeShutdownThis is caused by a node shutdown.
SchemaObjectExistsThe application attempted to create a schema object that already exists.
InternalTemporaryA request was sent to a node other than the master.
Note

Related information specific to certain error conditions may be found in Section 7.2.2, “NDB Error Codes and Messages”, and in Section 7.2.3, “NDB Error Classifications”.

2.3.19.1.2 The NdbError::Status Type

Description.  This type is used to describe an error's status.

Enumeration values.  Possible values are shown, along with descriptions, in the following table:

ValueDescription
SuccessNo error has occurred
TemporaryErrorA temporary and usually recoverable error; the application should retry the operation giving rise to the error
PermanentErrorPermanent error; not recoverable
UnknownResultThe operation's result or status is unknown
Note

Related information specific to certain error conditions may be found in Section 7.2.3, “NDB Error Classifications”.