{"record":{"id":"8d30d90ec0fa937e","repo":"apache/seatunnel","slug":"connectoridentify-convertoridentify-is-not-supp","errorCode":null,"errorMessage":"connectorIdentify ${convertorIdentify} is not supported","messagePattern":"connectorIdentify (.+?) is not supported","errorType":"exception","errorClass":"IllegalArgumentException","httpStatus":null,"severity":"error","filePath":"seatunnel-api/src/main/java/org/apache/seatunnel/api/table/factory/DataTypeConvertorFactory.java","lineNumber":51,"sourceCode":"        this(Thread.currentThread().getContextClassLoader());\n    }\n\n    public DataTypeConvertorFactory(ClassLoader classLoader) {\n        ServiceLoader.load(DataTypeConvertor.class, classLoader)\n                .forEach(\n                        dataTypeConvertor -> {\n                            dataTypeConvertorMap.put(\n                                    dataTypeConvertor.getIdentity().toUpperCase(),\n                                    dataTypeConvertor);\n                        });\n    }\n\n    public DataTypeConvertor<?> getDataTypeConvertor(String convertorIdentify) {\n        checkNotNull(convertorIdentify, \"connectorIdentify can not be null\");\n        if (dataTypeConvertorMap.containsKey(convertorIdentify.toUpperCase())) {\n            return dataTypeConvertorMap.get(convertorIdentify.toUpperCase());\n        }\n        throw new IllegalArgumentException(\n                \"connectorIdentify \" + convertorIdentify + \" is not supported\");\n    }\n}\n","sourceCodeStart":33,"sourceCodeEnd":55,"githubUrl":"https://github.com/apache/seatunnel/blob/cf67b549a7a6c35fa0beb12d83c62892427ea919/seatunnel-api/src/main/java/org/apache/seatunnel/api/table/factory/DataTypeConvertorFactory.java#L33-L55","documentation":"DataTypeConvertorFactory.getDataTypeConvertor throws this IllegalArgumentException when the requested convertor identifier is not present in the registry of loaded DataTypeConvertor instances. The lookup is case-insensitive (keys are uppercased), so the identifier simply does not exist among registered convertors.","triggerScenarios":"Calling getDataTypeConvertor(convertorIdentify) with an identifier string that no registered convertor maps to, e.g. a typo like 'mysql-varchar' or a convertor SPI that was never placed on the classpath.","commonSituations":"Catalog/connector plugins reference a convertor name that does not exist in the SeaTunnel distribution; user passes a custom type-mapping name not registered via SPI; copy-pasted identifier from another database connector.","solutions":["Check the exact convertor identifier string against the DataTypeConvertor implementations available in your plugins directory (identifiers are matched uppercased).","Install the missing connector/convertor plugin with sh bin/install-plugin.sh so its convertor SPI file is on the classpath.","If using a custom convertor, register it via META-INF/services/org.apache.seatunnel.api.table.type.DataTypeConvertor and verify its factoryIdentifier."],"exampleFix":"// before\nDataTypeConvertor<?> c = factory.getDataTypeConvertor(\"MySQL-VARCHAR\");\n// after\nDataTypeConvertor<?> c = factory.getDataTypeConvertor(\"MySQL\"); // valid registered identifier","handlingStrategy":"validation","validationCode":"String id = convertorIdentify == null ? null : convertorIdentify.toUpperCase();\nif (id == null || !DataTypeConvertorFactory_KNOWN_IDS.contains(id)) {\n    throw new IllegalArgumentException(\"Unknown convertor identifier: \" + convertorIdentify);\n}","typeGuard":null,"tryCatchPattern":"try {\n    convertor = factory.getDataTypeConvertor(id);\n} catch (IllegalArgumentException e) {\n    LOG.error(\"Unsupported convertor identifier '{}'\", id, e);\n    throw new ConfigException(\"Check convertor identifier / installed plugins\", e);\n}","preventionTips":["Take convertor identifiers from the connector's official documentation, not from memory.","List available convertors via SPI before resolving them in tooling.","Remember matching is uppercase: normalize identifiers before lookup."],"tags":["spi","convertor","unsupported-identifier"],"backgroundTag":"unsupported-enum-value","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"}