{"record":{"id":"b7608643a54670f0","repo":"apache/iceberg","slug":"s-doesn-t-implement-fromsnapshotexclusive","errorCode":null,"errorMessage":"%s doesn't implement fromSnapshotExclusive","messagePattern":"(.+?) doesn't implement fromSnapshotExclusive","errorType":"exception","errorClass":"UnsupportedOperationException","httpStatus":null,"severity":"error","filePath":"api/src/main/java/org/apache/iceberg/IncrementalScan.java","lineNumber":74,"sourceCode":"   *\n   * @param fromSnapshotId the start snapshot ID (exclusive)\n   * @return this for method chaining\n   * @throws IllegalArgumentException if the start snapshot is not an ancestor of the end snapshot\n   */\n  ThisT fromSnapshotExclusive(long fromSnapshotId);\n\n  /**\n   * Instructs this scan to look for changes starting from a particular snapshot (exclusive).\n   *\n   * <p>If the start snapshot is not configured, it defaults to the oldest ancestor of the end\n   * snapshot (inclusive).\n   *\n   * @param ref the start ref name that points to a particular snapshot ID (exclusive)\n   * @return this for method chaining\n   * @throws IllegalArgumentException if the start snapshot is not an ancestor of the end snapshot\n   */\n  default ThisT fromSnapshotExclusive(String ref) {\n    throw new UnsupportedOperationException(\n        this.getClass().getName() + \" doesn't implement fromSnapshotExclusive\");\n  }\n\n  /**\n   * Instructs this scan to look for changes up to a particular snapshot (inclusive).\n   *\n   * <p>If the end snapshot is not configured, it defaults to the current table snapshot\n   * (inclusive).\n   *\n   * @param toSnapshotId the end snapshot ID (inclusive)\n   * @return this for method chaining\n   */\n  ThisT toSnapshot(long toSnapshotId);\n\n  /**\n   * Instructs this scan to look for changes up to a particular snapshot ref (inclusive).\n   *\n   * <p>If the end snapshot is not configured, it defaults to the current table snapshot","sourceCodeStart":56,"sourceCodeEnd":92,"githubUrl":"https://github.com/apache/iceberg/blob/86d9c8fc543e7c56c9f624eb725f76c9baff9570/api/src/main/java/org/apache/iceberg/IncrementalScan.java#L56-L92","documentation":"Default-interface guard on IncrementalScan: thrown only when the concrete scan implementation did not override fromSnapshotExclusive, so setting an exclusive start snapshot is unsupported for that class. The %s names the offending runtime class; it is a capability gap, not an input problem.","triggerScenarios":"Thrown at api/src/main/java/org/apache/iceberg/IncrementalScan.java:74 when the library encounters an invalid state.","commonSituations":"See trigger scenarios.","solutions":["Use a scan implementation that supports incremental scans with exclusive start bounds","Catch UnsupportedOperationException and degrade to a non-incremental scan","Override fromSnapshotExclusive in the custom scan implementation"],"exampleFix":null,"handlingStrategy":"type-guard","validationCode":null,"typeGuard":null,"tryCatchPattern":null,"preventionTips":[],"tags":[],"backgroundTag":null,"analyzedSha":"86d9c8fc543e7c56c9f624eb725f76c9baff9570","analyzedAt":"2026-09-12T00:46:39.097Z","contentChangedAt":"2026-09-12T00:46:39.097Z","schemaVersion":2},"datasetVersion":"2026-09-23T08:17:48.524Z"}