Skip to content
HELP
ERROR MESSAGES
Error Reporting

Error Reporting

This guide describes how errors are reported in the RAI Console and the RelationalAI SDKs.

RAI Console

If you experience an error while using the RAI Console, the output returns the following fields:

FieldMeaning
CodeType of issue encountered. See the full list of errors.
MessageA short description of the problem.
Transaction-idTransaction ID. See Transactions.
ReportFull detailed information on the cause of error.

This is an example:

Error example from the RAI Console

RelationalAI SDKs

If you experience an error while using any of the RelationalAI SDKs, the output returns the following fields as a JSON string:

FieldMeaning
error_codeThe type of issue encountered. See the full list of errors.
is_errorWhether an error occurred or there was some other problem.
is_exceptionWhether an exception occurred or there was some other problem.
messageA short description of the problem.
pathA file path for the cases when such a path was used.
reportFull detailed information on the cause of error.
typeThe type of problem, for example, "ClientProblem".

This is an example using the RelationalAI SDK for Python:

{
    "is_error": true,
    "error_code": "PARSE_ERROR",
    "path": "",
    "report": "1| def output = {1;;2;3}\n                 ~~^~\n\nwhile parsing:\n    1. expr ::= expr \";\" expr\n    2. expr ::= expr \";\" expr\n    3. expr ::= \"{\" expr \"}\"\n\nUnexpected \";\" found.\n\n",
    "message": "parse error",
    "is_exception": false,
    "type": "ClientProblem"
}

See the Result Structure section in any of the RelationalAI SDKs for more details.

List of Error Codes

Error CodeDescription
ARITY_MISMATCHArity mismatch errors.
BASE_DERIVED_OVERLOADOverloading error of base and derived relations.
DATA_LOADData loading errors.
DATA_LOAD_CONFIGData loading configuration errors.
EXCEPTIONExecution errors.
EXCEPTION - Ungrounded VariableA variable has not been correctly instantiated.
INTEGRITY_CONSTRAINT_VIOLATIONIntegrity constraint violations.
NON_FORMULA_IC_BODYThe integrity constraint is not well defined.
PARSE_ERRORRel syntax errors.
PARSE_ERROR - Reserved KeywordReserved keyword errors.
SHADOWED_VARIABLESame naming for different variables.
UNBOUND_VARIABLEThe variable type cannot be inferred.
UNDEFINEDA variable has not been correctly defined.
VARARGSThe argument arity is not a finite number.
Was this doc helpful?