{"record":{"id":"4a75066a654e3374","repo":"apache/druid","slug":"unknown-residualfiltermode-s-valid-values-are","errorCode":null,"errorMessage":"Unknown residualFilterMode: %s. Valid values are: ignore, fail","messagePattern":"Unknown residualFilterMode: (.+?)\\. Valid values are: ignore, fail","errorType":"validation","errorClass":"IllegalArgumentException","httpStatus":null,"severity":"error","filePath":"extensions-contrib/druid-iceberg-extensions/src/main/java/org/apache/druid/iceberg/input/ResidualFilterMode.java","lineNumber":67,"sourceCode":"  ResidualFilterMode(String value)\n  {\n    this.value = value;\n  }\n\n  @JsonValue\n  public String getValue()\n  {\n    return value;\n  }\n\n  public static ResidualFilterMode fromString(String value)\n  {\n    for (ResidualFilterMode mode : values()) {\n      if (mode.value.equalsIgnoreCase(value)) {\n        return mode;\n      }\n    }\n    throw new IllegalArgumentException(\n        \"Unknown residualFilterMode: \" + value + \". Valid values are: ignore, fail\"\n    );\n  }\n}\n","sourceCodeStart":49,"sourceCodeEnd":72,"githubUrl":"https://github.com/apache/druid/blob/9b90983fd291f26935af934383ce360473179e4d/extensions-contrib/druid-iceberg-extensions/src/main/java/org/apache/druid/iceberg/input/ResidualFilterMode.java#L49-L72","documentation":"Validation in ResidualFilterMode.fromString(): the residualFilterMode input spec property contained a value other than 'ignore' or 'fail' (case-insensitive). The parser iterates the enum values and, finding no match, rejects the input reader configuration; set the property to one of the two valid values.","triggerScenarios":"Thrown at extensions-contrib/druid-iceberg-extensions/src/main/java/org/apache/druid/iceberg/input/ResidualFilterMode.java:67 when the library encounters an invalid state.","commonSituations":"See trigger scenarios.","solutions":["Set residualFilterMode to `ignore` or `fail` (case-insensitive).","Fix typos and confirm the property value reaches this enum."],"exampleFix":null,"handlingStrategy":"validation","validationCode":null,"typeGuard":null,"tryCatchPattern":null,"preventionTips":[],"tags":[],"backgroundTag":null,"analyzedSha":"9b90983fd291f26935af934383ce360473179e4d","analyzedAt":"2026-09-07T13:32:30.957Z","contentChangedAt":"2026-09-07T13:32:30.957Z","schemaVersion":2},"datasetVersion":"2026-09-17T15:17:12.973Z"}