neo4j

Neo4j Status Codes

Hierarchical status codes returned by the Neo4j Bolt protocol and Cypher engine. Each code follows the format Neo.{Classification}.{Category}.{Title}, where Classification indicates severity (ClientError, ClientNotification, DatabaseError, TransientError), Category groups related conditions, and Title identifies the specific condition.

68 codes

references neo4j.com/docs/status-codes/current/

· All codes 68 codes

Neo.ClientError.Database.DatabaseNotFound DatabaseNotFound The specified database does not exist. Check the database name and ensure it has been created before connecting to it.
Neo.ClientError.Database.ExistingDatabaseFound ExistingDatabaseFound A database with the specified name already exists. Use a different name or drop the existing database first.
Neo.ClientError.Procedure.ProcedureCallFailed ProcedureCallFailed The stored procedure threw an exception during execution. The error message contains details from the procedure implementation.
Neo.ClientError.Procedure.ProcedureNotFound ProcedureNotFound The specified stored procedure does not exist or is not registered. Verify the procedure name and ensure any required plugins are installed.
Neo.ClientError.Procedure.ProcedureRegistrationFailed ProcedureRegistrationFailed The procedure could not be registered with the database, typically because of a naming conflict or an invalid procedure definition.
Neo.ClientError.Procedure.TypeError TypeError A procedure was called with an argument of an incompatible type, or the procedure returned a value of an unexpected type.
Neo.ClientError.Schema.ConstraintAlreadyExists ConstraintAlreadyExists The constraint being created already exists in the schema. Drop the existing constraint or use a different name before creating a new one.
Neo.ClientError.Schema.ConstraintNotFound ConstraintNotFound The referenced constraint does not exist. Verify the constraint name or schema definition before attempting to drop or reference it.
Neo.ClientError.Schema.ConstraintValidationFailed ConstraintValidationFailed A constraint defined in the schema was violated during a write operation. The transaction has been rolled back.
Neo.ClientError.Schema.IndexAlreadyExists IndexAlreadyExists The index being created already exists in the schema. Drop the existing index or choose a different name before creating a new one.
Neo.ClientError.Schema.IndexNotFound IndexNotFound The referenced index does not exist. Verify the index name or schema definition before attempting to drop or reference it.
Neo.ClientError.Schema.TokenNameError TokenNameError A label, relationship type, or property key name is invalid. Token names must be non-empty strings and may not contain null bytes.
Neo.ClientError.Security.AuthenticationRateLimit AuthenticationRateLimit Too many failed authentication attempts have occurred. Further attempts are temporarily blocked to prevent brute-force attacks.
Neo.ClientError.Security.AuthProviderFailed AuthProviderFailed An external authentication provider (such as LDAP) failed to respond or returned an error, preventing authentication from completing.
Neo.ClientError.Security.AuthProviderTimeout AuthProviderTimeout The external authentication provider did not respond within the configured timeout period.
Neo.ClientError.Security.CredentialsExpired CredentialsExpired The user's credentials have expired. The user must change their password before performing further operations.
Neo.ClientError.Security.Forbidden Forbidden The authenticated user does not have the privileges required to perform the requested operation.
Neo.ClientError.Security.ModeViolation ModeViolation The operation attempted a write against a read-only server or a read-only transaction. Direct write operations to a write-capable server or transaction.
Neo.ClientError.Security.Unauthorized Unauthorized The request was not authenticated. Provide valid credentials to access the database.
Neo.ClientError.Statement.ArgumentError ArgumentError A function or procedure was called with an argument of an unexpected type or value, such as a negative limit or an out-of-range index.
Neo.ClientError.Statement.ArithmeticError ArithmeticError An arithmetic operation produced an invalid result, such as division by zero or numeric overflow.
Neo.ClientError.Statement.EntityNotFound EntityNotFound An operation referenced a node or relationship by ID that no longer exists, typically because it was deleted in a concurrent transaction.
Neo.ClientError.Statement.NotSystemDatabaseError NotSystemDatabaseError The statement can only be executed against the system database, but was run against a different database.
Neo.ClientError.Statement.ParameterMissing ParameterMissing The Cypher statement references a parameter that was not provided in the parameter map supplied with the request.
Neo.ClientError.Statement.SemanticError SemanticError The Cypher statement is syntactically valid but semantically incorrect, such as referring to an undefined variable or using incompatible types.
Neo.ClientError.Statement.SyntaxError SyntaxError The Cypher statement contains invalid syntax. The error message includes the position of the first syntax violation.
Neo.ClientError.Statement.TypeError TypeError The Cypher statement used a value in a context where its type is not supported, such as passing a non-numeric value to an arithmetic operator.
Neo.ClientError.Transaction.TransactionAccessedConcurrently TransactionAccessedConcurrently The transaction was accessed by more than one thread or connection simultaneously, which is not permitted.
Neo.ClientError.Transaction.TransactionEventHandlerFailed TransactionEventHandlerFailed A registered transaction event handler threw an exception during the before-commit or after-commit phase, causing the transaction to be rolled back.
Neo.ClientError.Transaction.TransactionHookFailed TransactionHookFailed A transaction hook failed during commit, preventing the transaction from completing successfully.
Neo.ClientError.Transaction.TransactionMarkedAsFailed TransactionMarkedAsFailed The transaction was explicitly marked as failed by the client or a procedure, and cannot be committed.
Neo.ClientError.Transaction.TransactionNotFound TransactionNotFound The referenced transaction does not exist or has already been committed or rolled back.
Neo.ClientError.Transaction.TransactionTimedOut TransactionTimedOut The transaction exceeded the configured timeout and was automatically terminated. Retry with a shorter-running query or increase the transaction timeout.
Neo.ClientError.Transaction.TransactionValidationFailed TransactionValidationFailed The transaction could not be committed because it failed validation checks, such as constraint verification at commit time.
Neo.ClientNotification.Statement.CartesianProductWarning CartesianProductWarning The query contains a Cartesian product between disconnected patterns, which may produce a very large number of rows. Consider adding a relationship or predicate to connect the patterns.
Neo.ClientNotification.Statement.DeprecatedFeatureWarning DeprecatedFeatureWarning The query uses a Cypher feature that is deprecated and will be removed in a future version of Neo4j. Update the query to use the recommended alternative.
Neo.ClientNotification.Statement.DynamicPropertyWarning DynamicPropertyWarning The query uses a dynamic property lookup (e.g. n[key]), which prevents the planner from using indexes efficiently. Consider rewriting with a static property name if possible.
Neo.ClientNotification.Statement.EagerOperatorWarning EagerOperatorWarning The query plan includes an eager operator that requires all input rows to be buffered before producing output. This can cause high memory usage for large datasets.
Neo.ClientNotification.Statement.ExhaustiveShortestPathWarning ExhaustiveShortestPathWarning The shortest path query cannot be solved with the available index and will use an exhaustive search, which may be slow on large graphs.
Neo.ClientNotification.Statement.JoinHintUnfulfillableWarning JoinHintUnfulfillableWarning A JOIN hint specified in the query could not be fulfilled by the query planner. The query was still planned but the hint was ignored.
Neo.ClientNotification.Statement.NoApplicableIndexWarning NoApplicableIndexWarning No index exists that can be used to satisfy a predicate in the query. A full label scan will be performed, which may be slow on large graphs.
Neo.ClientNotification.Statement.SuboptimalIndexForWildcardQuery SuboptimalIndexForWildcardQuery The query uses a wildcard or prefix pattern that cannot fully exploit the available index, resulting in a potentially slower scan.
Neo.ClientNotification.Statement.UnknownLabelWarning UnknownLabelWarning The query references a node label that does not exist in the database. This is a warning; the query still executes but may return no results.
Neo.ClientNotification.Statement.UnknownPropertyKeyWarning UnknownPropertyKeyWarning The query references a property key that does not exist in the database. This is a warning; the query still executes but may return no results.
Neo.ClientNotification.Statement.UnknownRelationshipTypeWarning UnknownRelationshipTypeWarning The query references a relationship type that does not exist in the database. This is a warning; the query still executes but may return no results.
Neo.DatabaseError.General.OutOfMemoryError OutOfMemoryError The database ran out of memory while processing the request. The query may need to be optimised to reduce memory usage, or the server heap may need to be increased.
Neo.DatabaseError.General.StackOverFlowError StackOverFlowError The query caused a JVM stack overflow, typically due to deeply recursive patterns or an extremely complex query structure.
Neo.DatabaseError.General.UnknownError UnknownError An unexpected error occurred in the database engine that does not map to a more specific status code. This indicates a server-side fault.
Neo.DatabaseError.Schema.ConstraintCreationFailed ConstraintCreationFailed The database failed to create the constraint due to an internal error, not a client-side validation failure.
Neo.DatabaseError.Schema.ConstraintDropFailed ConstraintDropFailed The database failed to drop the constraint due to an internal error.
Neo.DatabaseError.Schema.IndexCreationFailed IndexCreationFailed The database failed to create the index due to an internal error. The index may be left in a failed state and should be dropped and recreated.
Neo.DatabaseError.Schema.IndexDropFailed IndexDropFailed The database failed to drop the index due to an internal error.
Neo.DatabaseError.Statement.ExecutionFailed ExecutionFailed The Cypher statement failed during execution due to an internal database error, not a problem with the statement itself.
Neo.DatabaseError.Transaction.TransactionCommitFailed TransactionCommitFailed The transaction failed to commit due to an internal database error. The transaction has been rolled back.
Neo.DatabaseError.Transaction.TransactionLogError TransactionLogError An error occurred while writing to the transaction log, which may indicate disk failure or filesystem issues.
Neo.DatabaseError.Transaction.TransactionRollbackFailed TransactionRollbackFailed The transaction failed to roll back due to an internal database error. The database may be in an inconsistent state.
Neo.DatabaseError.Transaction.TransactionStartFailed TransactionStartFailed The database could not start a new transaction due to an internal error.
Neo.TransientError.General.DatabaseUnavailable DatabaseUnavailable The database is temporarily unavailable, for example during startup, shutdown, or a leader election in a cluster. Retry the request after a short delay.
Neo.TransientError.General.OutOfMemoryError OutOfMemoryError The database temporarily ran out of memory. The operation may succeed if retried after the server has freed resources.
Neo.TransientError.General.StackOverFlowError StackOverFlowError The query caused a transient stack overflow. Retrying with a simplified query or after server resource recovery may succeed.
Neo.TransientError.Network.CommunicationError CommunicationError A network-level communication error occurred between cluster members or between the server and client. The operation may be retried.
Neo.TransientError.Transaction.ConstraintsChanged ConstraintsChanged The set of constraints changed while the transaction was running, preventing the transaction from being committed safely. Retry the transaction.
Neo.TransientError.Transaction.DeadlockDetected DeadlockDetected A deadlock was detected between two or more concurrent transactions. One transaction was chosen as the victim and rolled back. Retry the failed transaction.
Neo.TransientError.Transaction.LeaderChanged LeaderChanged The cluster leader changed while the transaction was being processed. The client should retry the transaction against the new leader.
Neo.TransientError.Transaction.LockAcquisitionTimeout LockAcquisitionTimeout The transaction could not acquire a required lock within the configured timeout. Retry the transaction or investigate long-running concurrent transactions.
Neo.TransientError.Transaction.MaximumTransactionLimitReached MaximumTransactionLimitReached The maximum number of concurrent transactions has been reached. Retry the request once existing transactions have completed.
Neo.TransientError.Transaction.Outdated Outdated The transaction is based on outdated data due to a schema or topology change. Retry the transaction to work against the current state.
Neo.TransientError.Transaction.Terminated Terminated The transaction was explicitly terminated, either by the server administrator, a timeout, or a client request. The transaction has been rolled back.