{"record":{"id":"bf4781d9d418bb70","repo":"apache/seatunnel","slug":"versions-prior-to-starrocks-3-3-2-do-not-support-r","errorCode":null,"errorMessage":"versions prior to starrocks 3.3.2 do not support rename column operations","messagePattern":"versions prior to starrocks 3\\.3\\.2 do not support rename column operations","errorType":"console","errorClass":null,"httpStatus":null,"severity":"warning","filePath":"seatunnel-connectors-v2/connector-starrocks/src/main/java/org/apache/seatunnel/connectors/seatunnel/starrocks/util/SchemaUtils.java","lineNumber":173,"sourceCode":"                        .append(\"COMMENT \")\n                        .append(\"'\")\n                        .append(event.getColumn().getComment())\n                        .append(\"'\");\n            }\n            if (event.getAfterColumn() != null) {\n                sqlBuilder\n                        .append(\" \")\n                        .append(\"AFTER \")\n                        .append(quoteIdentifier(event.getAfterColumn()));\n            }\n\n            String changeColumnSQL = sqlBuilder.toString();\n            try (Statement statement = connection.createStatement()) {\n                log.info(\"Executing change column SQL: \" + changeColumnSQL);\n                statement.execute(changeColumnSQL);\n            }\n        } else {\n            log.warn(\"versions prior to starrocks 3.3.2 do not support rename column operations\");\n        }\n    }\n\n    public static void applySchemaChange(\n            Connection connection, TablePath tablePath, AlterTableModifyColumnEvent event)\n            throws SQLException {\n        BasicTypeDefine<StarRocksType> typeDefine =\n                StarRocksTypeConverter.INSTANCE.reconvert(event.getColumn());\n        StringBuilder sqlBuilder =\n                new StringBuilder()\n                        .append(\"ALTER TABLE\")\n                        .append(\" \")\n                        .append(tablePath.getFullName())\n                        .append(\" \")\n                        .append(\"MODIFY COLUMN\")\n                        .append(\" \")\n                        .append(quoteIdentifier(event.getColumn().getName()))\n                        .append(\" \")","sourceCodeStart":155,"sourceCodeEnd":191,"githubUrl":"https://github.com/apache/seatunnel/blob/cf67b549a7a6c35fa0beb12d83c62892427ea919/seatunnel-connectors-v2/connector-starrocks/src/main/java/org/apache/seatunnel/connectors/seatunnel/starrocks/util/SchemaUtils.java#L155-L191","documentation":"When applying an AlterTableRenameColumnEvent, SchemaUtils checks whether the connected StarRocks server version supports RENAME COLUMN (added in StarRocks 3.3.2). On older versions it only logs this warning and does nothing — the rename is silently not applied, so the StarRocks schema will diverge from the source schema.","triggerScenarios":"applySchemaChange(connection, tablePath, AlterTableRenameColumnEvent) is invoked against a StarRocks instance whose version is below 3.3.2 (version comparison in the rename branch fails and the else branch logs the warning).","commonSituations":"Syncing CDC schema changes from MySQL/other sources into an older StarRocks cluster (e.g. 2.5.x or 3.2.x); upgrading the pipeline before upgrading the database; assuming rename support that the deployed StarRocks version lacks.","solutions":["Upgrade the StarRocks cluster to 3.3.2 or later so RENAME COLUMN DDL is supported.","As a workaround, apply the rename as an equivalent ADD COLUMN + data backfill + DROP COLUMN manually on the cluster.","If renames are not needed, filter out AlterTableRenameColumnEvent from the schema-change pipeline on old clusters."],"exampleFix":"// before: silently skipped on old StarRocks\nlog.warn(\"versions prior to starrocks 3.3.2 do not support rename column operations\");\n// after: manual equivalent executed\nstatement.execute(\"ALTER TABLE \" + tablePath.getFullName() + \" ADD COLUMN new_col <type>\");\n// backfill data, then:\nstatement.execute(\"ALTER TABLE \" + tablePath.getFullName() + \" DROP COLUMN old_col\");","handlingStrategy":"fallback","validationCode":"// before enabling rename events, check server version\nResultSet rs = connection.createStatement().executeQuery(\"SELECT @@version\");\nrs.next();\nboolean supportsRename = compareVersion(rs.getString(1), \"3.3.2\") >= 0;","typeGuard":null,"tryCatchPattern":null,"preventionTips":["Verify StarRocks >= 3.3.2 before routing rename events to the connector","Avoid RENAME COLUMN in upstream migrations on older clusters","Prefer add+backfill+drop as portable rename equivalent"],"tags":["starrocks","schema-change","version-compatibility","rename"],"backgroundTag":"feature-not-enabled","analyzedSha":"cf67b549a7a6c35fa0beb12d83c62892427ea919","analyzedAt":"2026-09-10T21:44:55.265Z","contentChangedAt":"2026-09-10T21:44:55.265Z","schemaVersion":2},"datasetVersion":"2026-09-23T08:17:48.524Z"}