rustfs/rustfs · error · SelectError

UnsupportedSqlOperation

UnsupportedSqlOperation

Error message

We encountered an unsupported SQL operation.

What it means

The parsed SQL uses an operation the S3 Select engine does not implement (e.g. unsupported aggregate, alias, or clause semantics). Fires at query planning; the request is rejected per S3 Select compatibility limits rather than answered.

Source

Thrown at crates/s3select-api/src/lib.rs:115

    #[error("{message}")]
    ParseSelectFailure { message: String },

    #[error("The SQL expression is invalid.")]
    InvalidQuery,

    #[error("The SQL expression contains a data type that is not valid.")]
    InvalidDataType,

    #[error("An incorrect argument type was specified in a function call in the SQL expression.")]
    IncorrectSqlFunctionArgumentType,

    #[error("The data source path in the SQL expression is not supported.")]
    DataSourcePathUnsupported,

    #[error("Unsupported S3 Select SQL structure: {message}")]
    UnsupportedSqlStructure { message: String },

    #[error("We encountered an unsupported SQL operation.")]
    UnsupportedSqlOperation,

    #[error("A column name or a path provided does not exist in the SQL expression.")]
    EvaluatorBindingDoesNotExist,

    #[error("The field name matches to multiple fields in the file. Check the SQL expression and the file, and try again.")]
    AmbiguousFieldName,

    #[error("The value of a parameter in ScanRange element is invalid. Check the service API documentation and try again.")]
    InvalidScanRange,

    #[error("S3 Select query concurrency limit reached")]
    QueryConcurrencyLimit,

    #[error("S3 Select query exceeded the {seconds}-second execution limit")]
    QueryTimeout { seconds: u64 },

    #[error("S3 Select query resource limit exceeded")]

View on GitHub (pinned to 35af688cd9)

Solutions

  1. Replace the unsupported operation with a supported equivalent
  2. Download and process the object client-side instead
Defensive patterns

Strategy: validation

When it happens

Trigger: Thrown at crates/s3select-api/src/lib.rs:115 when the library encounters an invalid state.

Common situations: See trigger scenarios.


AI-assisted analysis of rustfs/rustfs@35af688cd9 (2026-08-20). Data as JSON: /api/errors/f270f97956e2e0a2. Report an issue: GitHub.