Error Index

This document provides an exhaustive listing of all the error codes that can be returned by the server. Do note that the handshake errors are only returned in the connection stage and are not the same as the query errors which occcur at the exchange stage.

Handshake errors

These errors occur before the connection is sucessfully established.

Code	Meaning	Likely explanation
0	Illegal packet	Client library bug because it sent an incorrect handshake packet to the server
1	Incompatible handshake version	Server does not support handshake version used by client
2	Incompatible protocol version	Server does not support protocol version used by client
3	Incompatible exchange mode	Server does not support the chosen data exchange mode
4	Incompatible query mode	Server does not support the chosen query mode
5	Invalid authentication data	Either an incorrect username or password (or both) or the client library generated an illegal authentication header

Query errors

These errors can occur when running a query.

Category	Code	Meaning	Likely explanation
System
	0	Server error	An error ocurred on the server side. Most likely a problem with I/O on the host
	1	OOM	The server is out of memory
	2	Unknown error	An unknown error occurred and the server did not provide any information on why
	3	Authentication error	Returned when a DCL query tries to do something invalid
	4	Transaction error	A transactional operation failed. Reasons could include an I/O error, too many retries, long running threshold timeout
	5	Permission denied	The query tried to do something that isn't allowed for the user
	6	Illegal client packet	The client sent a malformed query
BlueQL
	25	Invalid input	Returned when a literal (or parameter) is incorrectly encoded. This indicates a bug with the client library
	26	Unexpected byte	Illegal character in the query
	27	Unexpected end of statement	Expected more tokens for the statement
	28	Invalid syntax	Invalid syntax used in the query
	29	Invalid collection syntax	A collection was not correctly formatted
	30	Invalid type definition	Invalid DDL type definition
	31	Expected entity name	An entity name was expected (such as a model name) but was not found
	32	Expected statement	A statement was expected but was not found
	33	Unknown statement	Attempted to execute unrecognized statement
Database
	100	DDL object not found	The referenced DDL object (space or model or any other DDL object) was not found
	101	Unknown field	An unknown model field was referenced
	102	Invalid DDL properties	Invalid DDL properties were used
	103	DDL object already exists	Trying to create a duplicate DDL object returns this error
	104	DDL object not empty	A manipulation that requires the DDL object to be empty, was run on a nonempty DDL object
	105	DDL Illegal field declaration	The field declaration was not correct. Either because the type was invalid or because invalid properties were set.
	106	DDL illegal model definition	The model definition is incorrect
	107	DDL illegal alter model statement	The alter model statement (or any other related statement) is invalid (for example, trying to remove a primary key column)
	108	DML duplicate constraint violation	A row with the primary key already exists
	109	DML data validation error	Input data validation failed
	110	DML unindexed column	The column which was referenced as an index is not indexed
	111	DML row not found	The referenced row was not found
	112	DML needs lock	The operation needs a global lock