apache/shardingsphere · error · UnsupportedStreamCharsetConversionException

1

1

Error message

Unsupported conversion stream charset '%s'.

What it means

Error "Unsupported conversion stream charset '%s'." thrown in apache/shardingsphere.

Source

Thrown at infra/executor/src/main/java/org/apache/shardingsphere/infra/executor/sql/execute/result/query/impl/driver/jdbc/type/stream/JDBCStreamQueryResult.java:155

        }
        if (Timestamp.class == type) {
            return resultSet.getTimestamp(columnIndex, calendar);
        }
        throw new UnsupportedDataTypeConversionException(type, calendar).toSQLException();
    }
    
    @SuppressWarnings("deprecation")
    @Override
    public InputStream getInputStream(final int columnIndex, final String type) throws SQLException {
        switch (type) {
            case "Ascii":
                return resultSet.getAsciiStream(columnIndex);
            case "Unicode":
                return resultSet.getUnicodeStream(columnIndex);
            case "Binary":
                return resultSet.getBinaryStream(columnIndex);
            default:
                throw new UnsupportedStreamCharsetConversionException(type).toSQLException();
        }
    }
    
    @Override
    public Reader getCharacterStream(final int columnIndex) throws SQLException {
        return resultSet.getCharacterStream(columnIndex);
    }
    
    @Override
    public boolean wasNull() throws SQLException {
        return resultSet.wasNull();
    }
    
    @Override
    public Optional<ResultSet> getJDBCResultSet() {
        return containsJDBCResultSet ? Optional.of(resultSet) : Optional.empty();
    }
    

View on GitHub (pinned to e952770a21)

Solutions

1. Use a supported stream charset such as UTF-8.
2. Configure the client connection with a charset the driver and ShardingSphere both support.
3. Convert the data to a supported encoding before reading it as a stream.

When it happens

Trigger: A character stream is requested with a charset name that JDBCStreamQueryResult does not support.

Common situations: Client connections negotiated with an uncommon or misspelled charset when streaming text columns.

AI-assisted analysis of apache/shardingsphere@e952770a21 (2026-08-14). Data as JSON: /api/errors/efa08b7b73c53f36. Report an issue: GitHub.