Error codes¶

This topic describes the details of the error codes that may be returned when accessing NebulaGraph using a client.

Note

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_ZONE_NOT_FOUND`	`-14`	The current zone 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_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_BALANCER_RUNNING`	`-2006`	The load balancing task is running
`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_LISTENER_CONFLICT`	`-2011`	Listener conflicts
`E_ZONE_NOT_ENOUGH`	`-2012`	Insufficient number of hosts
`E_ZONE_IS_EMPTY`	`-2013`	No hosts in zone
`E_HISTORY_CONFLICT`	`-2018`	Conflict with former names
`E_STORE_FAILURE`	`-2021`	Failed to store data
`E_STORE_SEGMENT_ILLEGAL`	`-2022`	Illegal storage segment
`E_BAD_BALANCE_PLAN`	`-2023`	Invalid load balancing plan
`E_BALANCED`	`-2024`	The cluster is already in the load balancing status
`E_NO_RUNNING_BALANCE_PLAN`	`-2025`	No load balancing plan is running.
`E_NO_VALID_HOST`	`-2026`	Lack of valid hosts
`E_CORRUPTED_BALANCE_PLAN`	`-2027`	Corrupted load balancing plan
`E_NO_INVALID_BALANCE_PLAN`	`-2028`	No invalid load balancing plan
`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_PRIVILEGE_ALL_TAG_EDGE_SETTLED`	`-2036`	All tag or edge types need to be deleted before granting or revoking privileges
`E_PRIVILEGE_NOT_EXIST`	`-2037`	Privilege does not exist
`E_PRIVILEGE_NEED_BASIC_ROLE`	`-2038`	Basic role privileges required
`E_PRIVILEGE_ACTION_INVALID`	`-2039`	Invalid privilege action
`E_SNAPSHOT_FAILURE`	`-2040`	Failed to generate a snapshot
`E_BLOCK_WRITE_FAILURE`	`-2041`	Failed to write block data
`E_REBUILD_INDEX_FAILURE`	`-2042`	Failed to rebuild index
`E_INDEX_WITH_TTL`	`-2043`	Failed to set TTL because the index already exists
`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`	Load 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_NOT_STOPPABLE`	`-2052`	Task already failed or completed
`E_JOB_SUBMITTED`	`-2053`	Task default status
`E_SNAPSHOT_RUNNING_JOBS`	`-2056`	The snapshot task is running
`E_SNAPSHOT_NOT_FOUND`	`-2057`	No snapshot found
`E_INVALID_JOB`	`-2065`	Invalid task
`E_BACKUP_RUNNING_JOBS`	`-2066`	Backup task is running
`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_ATOMIC_OP_FAILED`	`-3009`	Atomic operation failure
`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_CLIENT_SERVER_INCOMPATIBLE`	`-3061`	Client and server versions are not compatible
`E_UNKNOWN`	`-8000`	Unknown error

Last update: April 1, 2024