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
Section titled “Classes”Classes exposed by this module.
ClientError Base error for client execution.
ClientAuthError Raised when authentication or authorization fails.
ClientNotFoundError Raised when the requested resource does not exist.
ClientNotReadyError Raised when the requested resource exists but is not ready yet.
ClientConflictError Raised when the request conflicts with the current backend state.
ClientInvalidRequestError Raised when the request is invalid before execution can proceed.
ClientSqlCompilationError SQL compilation failed (syntax error, invalid SQL, etc.).
ClientTimeoutError Raised when a request exceeds the configured wait time.
ClientServerError Raised when the backend fails while processing a request.
ClientUnknownError Raised when a failure cannot be classified more precisely.
DuoSecurityFailed Connection failed due to Duo security.
SnowflakeDatabaseException Generic Snowflake database error wrapper.
SnowflakeConnectionFailed Snowflake connection/auth failed before we could run any SQL (network/SSO/timeout/retry exhaustion).
SnowflakeAppMissingException The RelationalAI native app isn't installed/authorized under the configured name.
SnowflakeRaiAppNotStarted The RelationalAI native app exists, but its service isn't started/active.
AbortedTransactionError Transaction aborted error with optional problem details.