{"record":{"id":"a90138ed6d13e70d","repo":"risingwavelabs/risingwave","slug":"alter-table-rename-is-not-supported-for-iceberg-ta","errorCode":null,"errorMessage":"ALTER TABLE RENAME is not supported for iceberg table: {}.{}","messagePattern":"ALTER TABLE RENAME is not supported for iceberg table: (.+?)\\.(.+?)","errorType":"error_code","errorClass":null,"httpStatus":null,"severity":"error","filePath":"src/frontend/src/handler/mod.rs","lineNumber":1767,"sourceCode":"                    \"ALTER TABLE {} is not supported for iceberg table without auto schema change sink: {}.{}\",\n                    operation,\n                    schema_name,\n                    table_name\n                );\n            }\n        }\n        AlterTableOperation::RenameColumn { .. }\n        | AlterTableOperation::ChangeColumn { .. }\n        | AlterTableOperation::AlterColumn { .. } => {\n            bail!(\n                \"ALTER TABLE {} is not supported for iceberg table: {}.{}. Existing column schema mutation is not supported currently\",\n                operation,\n                schema_name,\n                table_name\n            );\n        }\n        AlterTableOperation::RenameTable { .. } => {\n            bail!(\n                \"ALTER TABLE RENAME is not supported for iceberg table: {}.{}\",\n                schema_name,\n                table_name\n            );\n        }\n        AlterTableOperation::SetParallelism { .. } => {\n            bail!(\n                \"ALTER TABLE SET PARALLELISM is not supported for iceberg table: {}.{}\",\n                schema_name,\n                table_name\n            );\n        }\n        AlterTableOperation::SetBackfillParallelism { .. } => {\n            bail!(\n                \"ALTER TABLE SET BACKFILL PARALLELISM is not supported for iceberg table: {}.{}\",\n                schema_name,\n                table_name\n            );","sourceCodeStart":1749,"sourceCodeEnd":1785,"githubUrl":"https://github.com/risingwavelabs/risingwave/blob/6469eb736d691e8e9b8a419a57edd6429ca77417/src/frontend/src/handler/mod.rs#L1749-L1785","documentation":"Renaming an Iceberg table via `ALTER TABLE ... RENAME` is not supported. The name of an Iceberg-backed table is tied to its sink definition, so renaming it in RisingWave alone would break the association with the external Iceberg table.","triggerScenarios":"Executing `ALTER TABLE <iceberg_table> RENAME TO ...` on a table backed by an Iceberg sink.","commonSituations":"Reorganizing table names/namespaces; renaming conventions during migrations; generic rename scripts run across all tables.","solutions":["Do not rename the Iceberg table; instead create a new table/sink with the desired name and migrate data.","If only a RisingWave alias is needed, create a non-Iceberg view or a new table and drop the old one.","Rename on the Iceberg catalog side if the external tooling supports it, then rebuild the sink."],"exampleFix":"// before\nALTER TABLE iceberg_t RENAME TO new_name;\n// after\n-- create new sink/table with desired name, migrate, then DROP the old one","handlingStrategy":"validation","validationCode":"-- Do not rename iceberg-backed tables\nSELECT relation_kind FROM rw_catalog.rw_relations WHERE name = 't';\n-- if iceberg-backed, create a new table/sink instead of RENAME","typeGuard":"fn is_rename(op: &AlterTableOperation) -> bool {\n    matches!(op, AlterTableOperation::RenameTable {..})\n}","tryCatchPattern":"match client.alter_table_rename(table, new_name).await {\n    Err(e) if e.message().contains(\"RENAME is not supported for iceberg table\") => {\n        // create new table + sink, migrate, drop old\n    }\n    other => other?,\n}","preventionTips":["Exclude Iceberg tables from generic rename/migration scripts.","Plan table naming up front; renaming later requires recreation.","Use views for naming indirection if renames may be needed."],"tags":["sql","iceberg","rename","unsupported-operation"],"backgroundTag":"operation-not-supported","analyzedSha":"6469eb736d691e8e9b8a419a57edd6429ca77417","analyzedAt":"2026-09-11T21:06:21.487Z","contentChangedAt":"2026-09-11T21:06:21.487Z","schemaVersion":2},"datasetVersion":"2026-09-14T16:17:12.679Z"}