Client library (Tsubakuro) version: 1.7.0.
This document presents a comprehensive list of error codes that can be transmitted from each Tsurugi service to the client.
Each error code comprises a 3-character prefix denoting the service responsible for the error, followed by a 5-digit number that provides a unique identification of the specific error within the service (e.g., SCD-00401).
Additionally, error messages may contain explanatory text followed by the error code to provide more detailed information about the cause of the error.
For information, each error code also has a symbolic name (e.g., SERVICE_NOT_FOUND for SCD-00401).
This name is for programmatic use of various errors in the client library, and is represented as the constant name of the enum in Java.
Debugging service is designed to debug the database itself.
Note
Please consider disabling this service for regular database use.
symbolic name: UNKNOWN.
unknown error was occurred in the debugging service.
KVS (Key Value Store) service is designed to access the database directly without using SQL.
Note
This feature is able to use partially, but still under development.
symbolic name: NOT_FOUND.
the target element does not exist in the database.
symbolic name: ALREADY_EXISTS.
the target element attempted to create already exists in the database.
symbolic name: USER_ROLLBACK.
the requested transaction operation was rollbacked by user.
symbolic name: WAITING_FOR_OTHER_TRANSACTION.
the requested transaction operation is waiting for other transaction.
symbolic name: UNKNOWN.
unknown error was occurred in the kvs service.
symbolic name: IO_ERROR.
I/O error was occurred in the server.
symbolic name: INVALID_ARGUMENT.
the service received a request message with an invalid argument.
symbolic name: INVALID_STATE.
the operation was requested in illegal or inappropriate time.
symbolic name: UNSUPPORTED.
the requested operation is not supported.
symbolic name: USER_ERROR.
the transaction operation met an user-defined error.
symbolic name: ABORTED.
the transaction was aborted.
symbolic name: ABORT_RETRYABLE.
the transaction was aborted, but retry might resolve the situation.
symbolic name: TIME_OUT.
the request was timed out.
symbolic name: NOT_IMPLEMENTED.
the requested feature is not yet implemented.
symbolic name: ILLEGAL_OPERATION.
the requested operation is not valid.
symbolic name: CONFLICT_ON_WRITE_PRESERVE.
the requested operation conflicted with a write preserve.
symbolic name: WRITE_WITHOUT_WRITE_PRESERVE.
long transaction issued write operation without a write preserve.
symbolic name: INACTIVE_TRANSACTION.
the transaction is inactive.
Note
the transaction is inactive because it's already committed or aborted. The request is failed.
symbolic name: BLOCKED_BY_CONCURRENT_OPERATION.
the requested operation was blocked by concurrent operation.
Note
the request couldn't be fulfilled due to the operation concurrently executed by other transaction. After the blocking transaction completes, re-trying the request may lead to different result.
symbolic name: RESOURCE_LIMIT_REACHED.
the server reached resource limit and the request could not be accomplished.
symbolic name: INVALID_KEY_LENGTH.
key length passed to the API was invalid.
symbolic name: RESULT_TOO_LARGE.
the operation result data was too large.
symbolic name: NOT_AUTHORIZED.
target resource is not authorized to use.
symbolic name: WRITE_PROTECTED.
the transaction was aborted by writing out of write preservation, or writing in read only transaction.
symbolic name: TABLE_NOT_FOUND.
the specified table was not found.
symbolic name: COLUMN_NOT_FOUND.
the specified column was not found.
symbolic name: COLUMN_TYPE_MISMATCH.
the column type was inconsistent.
symbolic name: MISMATCH_KEY.
the search key was mismatch for the table or index.
symbolic name: INCOMPLETE_COLUMNS.
several columns were not specified in PUT operation.
symbolic name: INTEGRITY_CONSTRAINT_VIOLATION.
operations was failed by integrity constraint violation.
Authentication service is designed for external use of Tsurugi's authentication mechanism.
Note
This does not work correct because authentication is not yet available in Tsurugi.
symbolic name: UNKNOWN.
unknown error was occurred in the authentication service.
symbolic name: NOT_AUTHENTICATED.
authentication information is not found in this session.
Note
Credentials may be not specified when establishing a session.
Datastore service provides the capability to manage persistent data, including backup and restore.
symbolic name: UNKNOWN.
unknown error was occurred in the datastore service.
symbolic name: BACKUP_EXPIRED.
the current backup session has been expired.
symbolic name: TAG_ALREADY_EXISTS.
the tag attempted to create already exists in the database.
symbolic name: TAG_NAME_TOO_LONG.
the tag name is too long.
SQL service is designed to access the database with SQL.
symbolic name: TARGET_ALREADY_EXISTS_EXCEPTION.
target already exists for newly creation request
symbolic name: SQL_SERVICE_EXCEPTION.
generic error in SQL service
symbolic name: SQL_EXECUTION_EXCEPTION.
generic error in SQL execution
symbolic name: CONSTRAINT_VIOLATION_EXCEPTION.
constraint Violation
symbolic name: UNIQUE_CONSTRAINT_VIOLATION_EXCEPTION.
unique constraint violation
symbolic name: NOT_NULL_CONSTRAINT_VIOLATION_EXCEPTION.
not-null constraint violation
symbolic name: REFERENTIAL_INTEGRITY_CONSTRAINT_VIOLATION_EXCEPTION.
referential integrity constraint violation
symbolic name: CHECK_CONSTRAINT_VIOLATION_EXCEPTION.
check constraint violation
symbolic name: EVALUATION_EXCEPTION.
error in expression evaluation
symbolic name: VALUE_EVALUATION_EXCEPTION.
error in value evaluation
symbolic name: SCALAR_SUBQUERY_EVALUATION_EXCEPTION.
non-scalar results from scalar subquery
symbolic name: TARGET_NOT_FOUND_EXCEPTION.
SQL operation target is not found
symbolic name: INCONSISTENT_STATEMENT_EXCEPTION.
statement is inconsistent with the request
symbolic name: RESTRICTED_OPERATION_EXCEPTION.
restricted operation was requested
symbolic name: DEPENDENCIES_VIOLATION_EXCEPTION.
deletion was requested for the object with dependencies on others
symbolic name: WRITE_OPERATION_BY_RTX_EXCEPTION.
write operation was requested using RTX
symbolic name: LTX_WRITE_OPERATION_WITHOUT_WRITE_PRESERVE_EXCEPTION.
LTX write operation was requested outside of write preserve
symbolic name: READ_OPERATION_ON_RESTRICTED_READ_AREA_EXCEPTION.
read operation was requested on restricted read area
symbolic name: INACTIVE_TRANSACTION_EXCEPTION.
operation was requested using transaction that had already committed or aborted
symbolic name: PARAMETER_EXCEPTION.
error on parameters or placeholders
symbolic name: UNRESOLVED_PLACEHOLDER_EXCEPTION.
requested statement has unresolved placeholders
symbolic name: LOAD_FILE_EXCEPTION.
error on files for load
symbolic name: LOAD_FILE_NOT_FOUND_EXCEPTION.
target load file is not found
symbolic name: LOAD_FILE_FORMAT_EXCEPTION.
unexpected load file format
symbolic name: DUMP_FILE_EXCEPTION.
error on files for dump
symbolic name: DUMP_DIRECTORY_INACCESSIBLE_EXCEPTION.
dump directory is not accessible
symbolic name: SQL_LIMIT_REACHED_EXCEPTION.
the requested operation reached the SQL limit
symbolic name: TRANSACTION_EXCEEDED_LIMIT_EXCEPTION.
the number of running transactions exceeded the maximum limit allowed, and new transaction failed to start
symbolic name: SQL_REQUEST_TIMEOUT_EXCEPTION.
SQL request timed out
symbolic name: DATA_CORRUPTION_EXCEPTION.
detected data corruption
symbolic name: SECONDARY_INDEX_CORRUPTION_EXCEPTION.
detected secondary index data corruption
symbolic name: REQUEST_FAILURE_EXCEPTION.
request failed before starting processing (e.g. due to pre-condition not fulfilled)
symbolic name: TRANSACTION_NOT_FOUND_EXCEPTION.
requested transaction is not found (or already released)
symbolic name: STATEMENT_NOT_FOUND_EXCEPTION.
requested statement is not found (or already released)
symbolic name: INTERNAL_EXCEPTION.
detected internal error
symbolic name: UNSUPPORTED_RUNTIME_FEATURE_EXCEPTION.
unsupported runtime feature was requested
symbolic name: BLOCKED_BY_HIGH_PRIORITY_TRANSACTION_EXCEPTION.
tried to execute operations with priority to higher priority transactions
symbolic name: INVALID_RUNTIME_VALUE_EXCEPTION.
invalid value was used in runtime
symbolic name: VALUE_OUT_OF_RANGE_EXCEPTION.
value out of allowed range was used
symbolic name: VALUE_TOO_LONG_EXCEPTION.
variable length value was used exceeding the allowed maximum length
symbolic name: INVALID_DECIMAL_VALUE_EXCEPTION.
used value was not valid for the decimal type
symbolic name: COMPILE_EXCEPTION.
compile error
symbolic name: SYNTAX_EXCEPTION.
syntax error
symbolic name: ANALYZE_EXCEPTION.
analyze error
symbolic name: TYPE_ANALYZE_EXCEPTION.
error on types
symbolic name: SYMBOL_ANALYZE_EXCEPTION.
error on symbols
symbolic name: VALUE_ANALYZE_EXCEPTION.
error on values
symbolic name: UNSUPPORTED_COMPILER_FEATURE_EXCEPTION.
unsupported feature/syntax was requested
symbolic name: CC_EXCEPTION.
error in CC serialization
symbolic name: OCC_EXCEPTION.
OCC aborted
symbolic name: LTX_EXCEPTION.
LTX aborted
symbolic name: RTX_EXCEPTION.
RTX aborted
symbolic name: BLOCKED_BY_CONCURRENT_OPERATION_EXCEPTION.
request was blocked by the other operations executed concurrently
symbolic name: OCC_READ_EXCEPTION.
OCC aborted due to its read
symbolic name: OCC_WRITE_EXCEPTION.
OCC aborted due to its write
symbolic name: LTX_READ_EXCEPTION.
LTX aborted due to its read
symbolic name: LTX_WRITE_EXCEPTION.
LTX aborted due to its write
symbolic name: CONFLICT_ON_WRITE_PRESERVE_EXCEPTION.
OCC (early) aborted because it read other LTX's write preserve
diagnostics of the service infrastructure.
symbolic name: UNKNOWN.
unknown error was occurred in the server.
symbolic name: UNRECOGNIZED.
the server received an unrecognized message.
symbolic name: SYSTEM_ERROR.
the server system is something wrong.
symbolic name: UNSUPPORTED_OPERATION.
the requested operation is not supported.
symbolic name: ILLEGAL_STATE.
operation was requested in illegal or inappropriate time.
symbolic name: IO_ERROR.
I/O error was occurred in the server.
symbolic name: OUT_OF_MEMORY.
the server is out of memory.
symbolic name: RESOURCE_LIMIT_REACHED.
the server reached resource limit.
symbolic name: AUTHENTICATION_ERROR.
authentication was failed.
symbolic name: PERMISSION_ERROR.
request is not permitted.
symbolic name: ACCESS_EXPIRED.
access right has been expired.
symbolic name: REFRESH_EXPIRED.
refresh right has been expired.
symbolic name: BROKEN_CREDENTIAL.
credential information is broken.
symbolic name: SESSION_CLOSED.
the current session is already closed.
symbolic name: SESSION_EXPIRED.
the current session is expired.
symbolic name: SERVICE_NOT_FOUND.
the destination service was not found.
symbolic name: SERVICE_UNAVAILABLE.
the destination service was not found.
symbolic name: OPERATION_CANCELED.
operation was canceled by user or system.
symbolic name: INVALID_REQUEST.
the service received a request message with invalid payload.