Skip to content

Error code

NebulaGraph returns an error code when an error occurs. This topic describes the details of the error code returned.


  • If an error occurs but no error code is returned, or if the error code description is unclear, we welcome your feedback or suggestions on the forum or GitHub.
  • When the code returned is 0, it means that the operation is successful.
Error name Error Code Description
E_DISCONNECTED -1 Lost connection
E_FAIL_TO_CONNECT -2 Unable to establish connection
E_RPC_FAILURE -3 RPC failure
E_LEADER_CHANGED -4 Raft leader has been changed
E_SPACE_NOT_FOUND -5 Graph space does not exist
E_TAG_NOT_FOUND -6 Tag does not exist
E_EDGE_NOT_FOUND -7 Edge type does not exist
E_INDEX_NOT_FOUND -8 Index does not exist
E_EDGE_PROP_NOT_FOUND -9 Edge type property does not exist
E_TAG_PROP_NOT_FOUND -10 Tag property does not exist
E_ROLE_NOT_FOUND -11 The current role does not exist
E_CONFIG_NOT_FOUND -12 The current configuration does not exist
E_MACHINE_NOT_FOUND -13 The current host does not exist
E_LISTENER_NOT_FOUND -15 Listener does not exist
E_PART_NOT_FOUND -16 The current partition does not exist
E_KEY_NOT_FOUND -17 Key does not exist
E_USER_NOT_FOUND -18 User does not exist
E_STATS_NOT_FOUND -19 Statistics do not exist
E_SERVICE_NOT_FOUND -20 No current service found
E_BACKUP_FAILED -24 Backup failed
E_BACKUP_EMPTY_TABLE -25 The backed-up table is empty
E_BACKUP_TABLE_FAILED -26 Table backup failure
E_PARTIAL_RESULT -27 MultiGet could not get all data
E_REBUILD_INDEX_FAILED -28 Index rebuild failed
E_INVALID_PASSWORD -29 Password is invalid
E_FAILED_GET_ABS_PATH -30 Unable to get absolute path
E_BAD_USERNAME_PASSWORD -1001 Authentication failed
E_SESSION_INVALID -1002 Invalid session
E_SESSION_TIMEOUT -1003 Session timeout
E_SYNTAX_ERROR -1004 Syntax error
E_EXECUTION_ERROR -1005 Execution error
E_STATEMENT_EMPTY -1006 Statement is empty
E_BAD_PERMISSION -1008 Permission denied
E_SEMANTIC_ERROR -1009 Semantic error
E_TOO_MANY_CONNECTIONS -1010 Maximum number of connections exceeded
E_PARTIAL_SUCCEEDED -1011 Access to storage failed (only some requests succeeded)
E_NO_HOSTS -2001 Host does not exist
E_EXISTED -2002 Host already exists
E_INVALID_HOST -2003 Invalid host
E_UNSUPPORTED -2004 The current command, statement, or function is not supported
E_NOT_DROP -2005 Not allowed to drop
E_CONFIG_IMMUTABLE -2007 Configuration items cannot be changed
E_CONFLICT -2008 Parameters conflict with meta data
E_INVALID_PARM -2009 Invalid parameter
E_WRONGCLUSTER -2010 Wrong cluster
E_ZONE_NOT_ENOUGH -2011 Listener conflicts
E_ZONE_IS_EMPTY -2012 Host not exist
E_SCHEMA_NAME_EXISTS -2013 Schema name already exists
E_RELATED_INDEX_EXISTS -2014 There are still indexes related to tag or edge, cannot drop it
E_RELATED_SPACE_EXISTS -2015 There are still some space on the host, cannot drop it
E_STORE_FAILURE -2021 Failed to store data
E_STORE_SEGMENT_ILLEGAL -2022 Illegal storage segment
E_BAD_BALANCE_PLAN -2023 Invalid data balancing plan
E_BALANCED -2024 The cluster is already in the data balancing status
E_NO_RUNNING_BALANCE_PLAN -2025 There is no running data balancing plan
E_NO_VALID_HOST -2026 Lack of valid hosts
E_CORRUPTED_BALANCE_PLAN -2027 A data balancing plan that has been corrupted
E_IMPROPER_ROLE -2030 Failed to recover user role
E_INVALID_PARTITION_NUM -2031 Number of invalid partitions
E_INVALID_REPLICA_FACTOR -2032 Invalid replica factor
E_INVALID_CHARSET -2033 Invalid character set
E_INVALID_COLLATE -2034 Invalid character sorting rules
E_CHARSET_COLLATE_NOT_MATCH -2035 Character set and character sorting rule mismatch
E_SNAPSHOT_FAILURE -2040 Failed to generate a snapshot
E_BLOCK_WRITE_FAILURE -2041 Failed to write block data
E_ADD_JOB_FAILURE -2044 Failed to add new task
E_STOP_JOB_FAILURE -2045 Failed to stop task
E_SAVE_JOB_FAILURE -2046 Failed to save task information
E_BALANCER_FAILURE -2047 Data balancing failed
E_JOB_NOT_FINISHED -2048 The current task has not been completed
E_TASK_REPORT_OUT_DATE -2049 Task report failed
E_JOB_NOT_IN_SPACE -2050 The current task is not in the graph space
E_JOB_NEED_RECOVER -2051 The current task needs to be resumed
E_JOB_ALREADY_FINISH -2052 The job status has already been failed or finished
E_JOB_SUBMITTED -2053 Job default status
E_JOB_NOT_STOPPABLE -2054 The given job do not support stop
E_JOB_HAS_NO_TARGET_STORAGE -2055 The leader distribution has not been reported, so can't send task to storage
E_INVALID_JOB -2065 Invalid task
E_BACKUP_BUILDING_INDEX -2066 Backup terminated (index being created)
E_BACKUP_SPACE_NOT_FOUND -2067 Graph space does not exist at the time of backup
E_RESTORE_FAILURE -2068 Backup recovery failed
E_SESSION_NOT_FOUND -2069 Session does not exist
E_LIST_CLUSTER_FAILURE -2070 Failed to get cluster information
E_LIST_CLUSTER_GET_ABS_PATH_FAILURE -2071 Failed to get absolute path when getting cluster information
E_LIST_CLUSTER_NO_AGENT_FAILURE -2072 Unable to get an agent when getting cluster information
E_QUERY_NOT_FOUND -2073 Query not found
E_AGENT_HB_FAILUE -2074 Failed to receive heartbeat from agent
E_CONSENSUS_ERROR -3001 Consensus cannot be reached during an election
E_KEY_HAS_EXISTS -3002 Key already exists
E_DATA_TYPE_MISMATCH -3003 Data type mismatch
E_INVALID_FIELD_VALUE -3004 Invalid field value
E_INVALID_OPERATION -3005 Invalid operation
E_NOT_NULLABLE -3006 Current value is not allowed to be empty
E_FIELD_UNSET -3007 Field value must be set if the field value is NOT NULL or has no default value
E_OUT_OF_RANGE -3008 The value is out of the range of the current type
E_DATA_CONFLICT_ERROR -3010 Data conflict
E_WRITE_STALLED -3011 Writes are delayed
E_IMPROPER_DATA_TYPE -3021 Incorrect data type
E_INVALID_SPACEVIDLEN -3022 Invalid VID length
E_INVALID_FILTER -3031 Invalid filter
E_INVALID_UPDATER -3032 Invalid field update
E_INVALID_STORE -3033 Invalid KV storage
E_INVALID_PEER -3034 Peer invalid
E_RETRY_EXHAUSTED -3035 Out of retries
E_TRANSFER_LEADER_FAILED -3036 Leader change failed
E_INVALID_STAT_TYPE -3037 Invalid stat type
E_INVALID_VID -3038 VID is invalid
E_LOAD_META_FAILED -3040 Failed to load meta information
E_FAILED_TO_CHECKPOINT -3041 Failed to generate checkpoint
E_CHECKPOINT_BLOCKED -3042 Generating checkpoint is blocked
E_FILTER_OUT -3043 Data is filtered
E_INVALID_DATA -3044 Invalid data
E_MUTATE_EDGE_CONFLICT -3045 Concurrent write conflicts on the same edge
E_MUTATE_TAG_CONFLICT -3046 Concurrent write conflict on the same vertex
E_OUTDATED_LOCK -3047 Lock is invalid
E_INVALID_TASK_PARA -3051 Invalid task parameter
E_USER_CANCEL -3052 The user canceled the task
E_TASK_EXECUTION_FAILED -3053 Task execution failed
E_PLAN_IS_KILLED -3060 Execution plan was cleared
E_NO_TERM -3070 The heartbeat process was not completed when the request was received
E_OUTDATED_TERM -3071 Out-of-date heartbeat received from the old leader (the new leader has been elected)
E_WRITE_WRITE_CONFLICT -3073 Concurrent write conflicts with later requests
E_RAFT_UNKNOWN_PART -3500 Unknown partition
E_RAFT_LOG_GAP -3501 Raft logs lag behind
E_RAFT_LOG_STALE -3502 Raft logs are out of date
E_RAFT_TERM_OUT_OF_DATE -3503 Heartbeat messages are out of date
E_RAFT_UNKNOWN_APPEND_LOG -3504 Unknown additional logs
E_RAFT_WAITING_SNAPSHOT -3511 Waiting for the snapshot to complete
E_RAFT_SENDING_SNAPSHOT -3512 There was an error sending the snapshot
E_RAFT_INVALID_PEER -3513 Invalid receiver
E_RAFT_NOT_READY -3514 Raft did not start
E_RAFT_STOPPED -3515 Raft has stopped
E_RAFT_BAD_ROLE -3516 Wrong role
E_RAFT_WAL_FAIL -3521 Write to a WAL failed
E_RAFT_HOST_STOPPED -3522 The host has stopped
E_RAFT_TOO_MANY_REQUESTS -3523 Too many requests
E_RAFT_PERSIST_SNAPSHOT_FAILED -3524 Persistent snapshot failed
E_RAFT_RPC_EXCEPTION -3525 RPC exception
E_RAFT_NO_WAL_FOUND -3526 No WAL logs found
E_RAFT_HOST_PAUSED -3527 Host suspended
E_RAFT_WRITE_BLOCKED -3528 Writes are blocked
E_RAFT_BUFFER_OVERFLOW -3529 Cache overflow
E_RAFT_ATOMIC_OP_FAILED -3530 Atomic operation failed
E_LEADER_LEASE_FAILED -3531 Leader lease expired
E_RAFT_CAUGHT_UP -3532 Data has been synchronized on Raft

Last update: December 8, 2022