Skip to content
RelationalAI Docs

exceptions

relationalai.client.errors

Client-level exception taxonomy.

These exceptions represent stable, backend-agnostic failure meanings surfaced by the SDK. Gateways and service layers should raise these (or subclasses) so callers can handle errors consistently across:

  • Snowflake SQL (Snowpark)
  • Direct Access HTTP

Classes

Classes exposed by this module.

ClientErrorBase error for client execution.
ClientAuthErrorRaised when authentication or authorization fails.
ClientNotFoundErrorRaised when the requested resource does not exist.
ClientNotReadyErrorRaised when the requested resource exists but is not ready yet.
ClientConflictErrorRaised when the request conflicts with the current backend state.
ClientInvalidRequestErrorRaised when the request is invalid before execution can proceed.
ClientSqlCompilationErrorSQL compilation failed (syntax error, invalid SQL, etc.).
ClientTimeoutErrorRaised when a request exceeds the configured wait time.
ClientServerErrorRaised when the backend fails while processing a request.
ClientUnknownErrorRaised when a failure cannot be classified more precisely.
DuoSecurityFailedConnection failed due to Duo security.
SnowflakeDatabaseExceptionGeneric Snowflake database error wrapper.
SnowflakeConnectionFailedSnowflake connection/auth failed before we could run any SQL (network/SSO/timeout/retry exhaustion).
SnowflakeAppMissingExceptionThe RelationalAI native app isn't installed/authorized under the configured name.
SnowflakeRaiAppNotStartedThe RelationalAI native app exists, but its service isn't started/active.
AbortedTransactionErrorTransaction aborted error with optional problem details.