Return codes
This page documents the status codes and exit codes on the TigerGraph platform. Each status code follows the format: <component>-<code> , while exit codes are numeric values between 0 - 255.
If the system was handling a user request, the status code and message will be in the JSON response (see GSQL Query Output Format ). For internal errors, the error information may be in a log file.
The GSQL Client will exit with a non-zero code if there’s an error while handling a user request. To view the exit code of the GSQL client, run the command echo $? and the exit code of the most recent command will be printed to the terminal.
Return codes
REST
This section covers return codes from the REST++ server.
0000 - 0999
Codes in this range are success codes. When the conditions for multiple codes are true, the lowest code is returned.
| Code | Description |
|---|---|
|
General successful completion |
|
Successful vertex insertion or update |
|
Successful edge insertion or update |
|
Successful vertex and edge insertion or update |
|
Empty response |
1000 - 1999
RESTPP endpoint errors.
| Code | Description |
|---|---|
|
The endpoint does not exist. |
|
The query could not run because there is no graph schema. |
|
The graph cannot be found. |
2000 - 2999
Payload errors.
| Code | Description |
|---|---|
|
The JSON payload is invalid. |
|
The payload contains vertices of an invalid type. |
|
The payload contains edges of an invalid type. |
3000 - 3999
RESTPP general errors.
| Code | Description |
|---|---|
|
The query timed out from the timeout limit set by the request header. |
|
The query timed out from the timeout limit set by the built-in endpoint. |
|
The query timed out from the timeout limit set by the |
10000+
Other RESTPP errors.
| Code | Description |
|---|---|
|
The endpoint has been removed. |
|
There was an exception when starting a scheduler. |
|
There was an exception when processing results. |
|
The request is in an orphan state due to malfunction in user-defined schedulers. |
|
Access denied due to an invalid token. |
|
RESTPP failed to get a response from GSE or GPE in time. |
|
No running GSE or GPE instance detected. |
|
The query was aborted by the user. |
|
The query failed due to insufficient disk space. |
|
The payload is invalid (general error). |
|
The parameter for upserting data is invalid. |
|
The parameter for showing query performance is invalid. |
GSQL
0000 - 0999
Codes in this range are success codes. GSQL will return the smallest code when the conditions are met for multiple codes.
| Code | Description |
|---|---|
|
The query is successful. |
|
Vertices and edges were updated or inserted successfully. |
|
Vertices were updated or inserted successfully. |
|
Edges were updated or inserted successfully. |
1000 - 1999
Query parameter errors.
| Code | Description |
|---|---|
|
The query contains a parameter with a |
|
General parameter error. |
|
Invalid parameter type. |
|
Invalid parameters. |
2000 - 2499
JSON string related errors.
| Code | Description |
|---|---|
|
JSON object format error. |
|
JSON array format error. |
|
JSON object is missing a field. |
2500 - 2999
Operator errors.
| Code | Description |
|---|---|
|
Division by zero error. |
|
The query contains incorrectly formatted |
|
The query contains illegal patterns. |
|
The query contains invalid operators. |
|
The parameter provided is of the wrong primitive type. |
|
The query contains an invalid array index. |
|
The query contains an out-of-bounds array index. |
|
Global variable not found. |
|
ValuePtr holds null pointer. |
3000 - 3999
Dynamic expression errors and expression function errors.
| Code | Description |
|---|---|
|
The query references non-existent attributes. |
|
The query references non-existent vertex types. |
4500 - 4999
Vertex type, edge type, and ID translation errors
| Code | Description |
|---|---|
|
The query references a vertex type that does not exist. |
|
The query references an edge type that does not exist. |
|
The query references an invalid vertex ID. |
|
The query contains an invalid vertex attribute. |
|
The query contains an invalid edge attribute. |
|
The number of edge attributes is invalid. |
|
An edge points from an invalid source vertex. |
|
An edge points to an invalid target vertex. |
|
An edge has both invalid source and target vertices. |
5000 - 5499
Print, I/O, or file system errors.
| Code | Description |
|---|---|
|
File does not exist. |
|
A file referenced in the query cannot be opened. |
|
File is not a regular file. |
|
GSQL was denied access to a file referenced in the query. |
|
A file referenced in the query cannot be read. |
|
File input policy violation. |
|
Connection error writing to S3. |
6000 - 6499
Errors related to updating the graph.
| Code | Description |
|---|---|
|
The query inserts an edge with an unknown vertex. |
|
Unsupported type of attribute update. |
|
Graph update aborted. |
6500 - 6999
| Code | Description |
|---|---|
|
The query was aborted by the user. |
|
The query was aborted due to its memory usage exceeds the specified limit. |
7000 - 7999
Built-in query errors.
| Code | Description |
|---|---|
|
API not supported. |
|
The query timed out. |
SYS
This section covers engine-related errors.
| Code | Description |
|---|---|
|
The engine is not available. |
|
The query was rejected because the memory limit has been reached. |
|
The query is aborted. |
|
The endpoint has been removed. |
|
The request failed due to an invalid vertex ID. |
GSQL client exit codes
The GSQL client will exit with a non-zero code if it encounters an error while handling a user request.
To check the exit code, run the Linux command echo $? and the exit code of the most recent command will be printed in the console.
| Exit Code | Description |
|---|---|
0 |
No error |
41 |
Login or authentication error. The GSQL will also exit with this code if a graph with the supplied graph name cannot be found. |
201 |
Invalid argument error |
202 |
Connection error |
203 |
Compatibility error |
204 |
Session timeout |
211* |
Syntax error |
212 |
Runtime error |
213* |
No graph in use error |
255 |
Unknown error |
|
The exit codes marked with a star (*) are only applicable when a GSQL script is given as an argument. |