{"record":{"id":"f10c79a65b57fb60","repo":"apache/seatunnel","slug":"part-size-is-less-than-set-to-default-value","errorCode":null,"errorMessage":"part size {} is less than {}, set to default value {}","messagePattern":"part size (.+?) is less than (.+?), set to default value (.+?)","errorType":"console","errorClass":null,"httpStatus":null,"severity":"warning","filePath":"seatunnel-connectors-v2/connector-clickhouse/src/main/java/org/apache/seatunnel/connectors/seatunnel/clickhouse/source/split/PartStrategySplitter.java","lineNumber":145,"sourceCode":"            List<String> partNameList =\n                    split.getParts().stream()\n                            .map(ClickhousePart::getName)\n                            .collect(Collectors.toList());\n            log.debug(\"generate shard {} to parts {}\", split.getShard().getNode(), partNameList);\n        }\n\n        log.info(\"generate splits size: {}\", splits.size());\n        return splits;\n    }\n\n    public int partCountLimitForOneSplit(ClickhouseSourceTable clickhouseSourceTable) {\n        int partSize = ClickhouseSourceOptions.CLICKHOUSE_SPLIT_SIZE_DEFAULT;\n        if (clickhouseSourceTable.getSplitSize() != null) {\n            partSize = clickhouseSourceTable.getSplitSize();\n        }\n\n        if (partSize < ClickhouseSourceOptions.CLICKHOUSE_SPLIT_SIZE_MIN) {\n            log.warn(\n                    \"part size {} is less than {}, set to default value {}\",\n                    partSize,\n                    ClickhouseSourceOptions.CLICKHOUSE_SPLIT_SIZE_MIN,\n                    ClickhouseSourceOptions.CLICKHOUSE_SPLIT_SIZE_DEFAULT);\n            partSize = ClickhouseSourceOptions.CLICKHOUSE_SPLIT_SIZE_MIN;\n        }\n        log.debug(\"part size is set to {}\", partSize);\n\n        return partSize;\n    }\n\n    @Override\n    public void close() {}\n}\n","sourceCodeStart":127,"sourceCodeEnd":160,"githubUrl":"https://github.com/apache/seatunnel/blob/cf67b549a7a6c35fa0beb12d83c62892427ea919/seatunnel-connectors-v2/connector-clickhouse/src/main/java/org/apache/seatunnel/connectors/seatunnel/clickhouse/source/split/PartStrategySplitter.java#L127-L160","documentation":"PartStrategySplitter.partCountLimitForOneSplit validates the configured ClickHouse split size. If the user-configured splitSize is below CLICKHOUSE_SPLIT_SIZE_MIN, it logs this warning and silently resets partSize to CLICKHOUSE_SPLIT_SIZE_MIN (the message's 'default value' refers to the default constant used). Execution continues with the corrected value.","triggerScenarios":"clickhouseSourceTable.getSplitSize() returns a value smaller than ClickhouseSourceOptions.CLICKHOUSE_SPLIT_SIZE_MIN (configured 'split.size' or per-table split size too small).","commonSituations":"Users setting split.size=1 or similar very small values expecting fine-grained parallelism; typo'ed config value; copied config from another connector with different units.","solutions":["Set split.size to a value >= CLICKHOUSE_SPLIT_SIZE_MIN to silence the warning and get intended behavior.","Remove the split.size option to use the default value.","Check ClickhouseSourceOptions for the exact MIN/DEFAULT constants and adjust your config accordingly."],"exampleFix":"# before\nsplit.size = 1\n# after\nsplit.size = 20000","handlingStrategy":"validation","validationCode":"// validate before submit\nint min = 20000; // ClickhouseSourceOptions.CLICKHOUSE_SPLIT_SIZE_MIN\nif (configuredSplitSize != null && configuredSplitSize < min) {\n    throw new IllegalArgumentException(\"split.size must be >= \" + min);\n}","typeGuard":null,"tryCatchPattern":null,"preventionTips":["Validate split.size against CLICKHOUSE_SPLIT_SIZE_MIN in your config pipeline","Omit split.size to accept the default","Document units/min values when sharing configs between connectors"],"tags":["clickhouse","configuration","split-size","clamping"],"backgroundTag":"value-out-of-range","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"}