{"record":{"id":"9698d3dd222ecec3","repo":"apache/seatunnel","slug":"common-19-9698d3","errorCode":"COMMON-19","errorMessage":"'${identifier}' unsupported convert SeaTunnel data type '${dataType}' of '${field}' to connector data type.","messagePattern":"'(.+?)' unsupported convert SeaTunnel data type '(.+?)' of '(.+?)' to connector data type\\.","errorType":"error_code","errorClass":"SeaTunnelRuntimeException","httpStatus":null,"severity":"error","filePath":"seatunnel-connectors-v2/connector-jdbc/src/main/java/org/apache/seatunnel/connectors/seatunnel/jdbc/internal/dialect/xugu/XuguTypeConverter.java","lineNumber":408,"sourceCode":"                    if (column.getScale() > MAX_TIMESTAMP_SCALE) {\n                        timestampTzScale = MAX_TIMESTAMP_SCALE;\n                        log.warn(\n                                \"The timestamp_tz column {} type timestamp_tz({}) is out of\"\n                                        + \" range, which exceeds the maximum scale of {}, \"\n                                        + \"it will be converted to timestamp_tz({})\",\n                                column.getName(),\n                                column.getScale(),\n                                MAX_TIMESTAMP_SCALE,\n                                timestampTzScale);\n                    }\n                    builder.columnType(\n                            String.format(\"TIMESTAMP(%s) WITH TIME ZONE\", timestampTzScale));\n                    builder.scale(timestampTzScale);\n                }\n                builder.dataType(XUGU_TIMESTAMP_WITH_TIME_ZONE);\n                break;\n            default:\n                throw CommonError.convertToConnectorTypeError(\n                        DatabaseIdentifier.XUGU,\n                        column.getDataType().getSqlType().name(),\n                        column.getName());\n        }\n\n        return builder.build();\n    }\n}\n","sourceCodeStart":390,"sourceCodeEnd":417,"githubUrl":"https://github.com/apache/seatunnel/blob/cf67b549a7a6c35fa0beb12d83c62892427ea919/seatunnel-connectors-v2/connector-jdbc/src/main/java/org/apache/seatunnel/connectors/seatunnel/jdbc/internal/dialect/xugu/XuguTypeConverter.java#L390-L417","documentation":"XuGu JDBC dialect type converter's reconvert() throws this when a SeaTunnel column's SQL type has no mapping to a XuGu connector column type. It is thrown from the switch's default branch, meaning the SeaTunnel SqlType (e.g. TIME or another unmapped type) cannot be represented in XuGu DDL. This guards against silently generating an invalid column type.","triggerScenarios":"Calling XuguTypeConverter.reconvert() on a CatalogColumn whose SeaTunnel data type falls into the switch's default branch — e.g. SeaTunnel TIME, ROW, MAP or other types without an explicit XuGu case.","commonSituations":"Catalog auto table creation against XuGu where the source table contains TIME or complex types; schema evolution bringing in a type the XuGu dialect does not map.","solutions":["Check the source schema and exclude or transform unsupported columns (e.g. cast TIME to TIMESTAMP) before table creation","Add or extend the type mapping case in XuguTypeConverter.reconvert() for the missing SqlType","Log/inspect column.getDataType().getSqlType() to identify which type is unmapped"],"exampleFix":"// before\ndefault:\n    throw CommonError.convertToConnectorTypeError(DatabaseIdentifier.XUGU, column.getDataType().getSqlType().name(), column.getName());\n// after\n// transform the field upstream, e.g. in the source config cast TIME to TIMESTAMP,\n// or add a case:\ncase TIME:\n    builder.columnType(\"TIME\");\n    builder.dataType(LocalTimeType.LOCAL_TIME_TYPE);\n    break;","handlingStrategy":"try-catch","validationCode":null,"typeGuard":null,"tryCatchPattern":"try {\n    CatalogTable converted = xuguTypeConverter.reconvert(column);\n} catch (SeaTunnelConvertException e) {\n    LOG.warn(\"Skipping column unsupported by XuGu: {}\", e.getMessage());\n    // fall back: cast the column upstream or exclude it from table creation\n}","preventionTips":["Log the failing SqlType from the exception to decide on a cast strategy"],"tags":["jdbc","xugu","type-conversion","catalog"],"backgroundTag":"unsupported-dtype","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"}